@polpo-ai/core 0.1.0

package/dist/escalation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-manager.d.ts","sourceRoot":"","sources":["../src/escalation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,WAAW,CAAC;IALtB,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,MAAM,CAAoD;gBAGxD,GAAG,EAAE,mBAAmB,EACxB,WAAW,CAAC,EAAE,eAAe,YAAA;IAGvC,IAAI,IAAI,IAAI;IA8BZ,OAAO,CAAC,aAAa;YAOP,QAAQ;YAoCR,eAAe;YAwCf,sBAAsB;YAqEtB,eAAe;YA6Cf,YAAY;YAkBZ,SAAS;IAYvB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,UAAU;IAQlB,OAAO,IAAI,IAAI;CAOhB"}

package/dist/escalation-manager.js

@@ -0,0 +1,281 @@
+import { findAgent } from "./types.js";
+/**
+ * Manages the escalation chain when tasks fail repeatedly.
+ *
+ * 4-level hybrid escalation:
+ *   Level 0: Retry with same agent (handled by AssessmentOrchestrator — not managed here)
+ *   Level 1: Escalate to fallback agent (handled by RetryPolicy — not managed here)
+ *   Level 2: Orchestrator LLM analysis — reformulate the task and retry
+ *   Level 3: Human-in-the-loop — notify humans and create approval request
+ */
+export class EscalationManager {
+    ctx;
+    approvalMgr;
+    taskLevels = new Map();
+    timers = new Map();
+    constructor(ctx, approvalMgr) {
+        this.ctx = ctx;
+        this.approvalMgr = approvalMgr;
+    }
+    init() {
+        const policy = this.ctx.config.settings.escalationPolicy;
+        if (!policy)
+            return;
+        this.ctx.hooks.register({
+            hook: "task:fail",
+            phase: "before",
+            priority: 60,
+            name: "escalation-manager",
+            handler: (hookCtx) => {
+                const { taskId, task, reason } = hookCtx.data;
+                if (reason !== "maxRetries")
+                    return;
+                const currentLevel = this.taskLevels.get(taskId) ?? this.getStartLevel(policy);
+                const level = policy.levels.find(l => l.level === currentLevel);
+                if (!level)
+                    return;
+                hookCtx.cancel(`Escalating to level ${currentLevel}: ${level.handler}`);
+                this.escalate(taskId, task, level, policy).catch(err => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    this.ctx.emitter.emit("log", {
+                        level: "error",
+                        message: `[escalation] Level ${currentLevel} failed for task ${taskId}: ${msg}`,
+                    });
+                });
+            },
+        });
+    }
+    getStartLevel(policy) {
+        for (const level of policy.levels) {
+            if (level.handler !== "agent")
+                return level.level;
+        }
+        return policy.levels[policy.levels.length - 1]?.level ?? 0;
+    }
+    async escalate(taskId, task, level, policy) {
+        this.taskLevels.set(taskId, level.level);
+        this.ctx.emitter.emit("escalation:triggered", {
+            taskId,
+            level: level.level,
+            handler: level.handler,
+            target: level.target,
+        });
+        if (level.notifyChannels && level.notifyChannels.length > 0) {
+            this.ctx.emitter.emit("escalation:human", {
+                taskId,
+                message: `Task "${task.title}" escalated to level ${level.level} (${level.handler})`,
+                channels: level.notifyChannels,
+            });
+        }
+        switch (level.handler) {
+            case "agent":
+                await this.escalateToAgent(taskId, task, level, policy);
+                break;
+            case "orchestrator":
+                await this.escalateToOrchestrator(taskId, task, level, policy);
+                break;
+            case "human":
+                await this.escalateToHuman(taskId, task, level, policy);
+                break;
+        }
+    }
+    async escalateToAgent(taskId, task, level, policy) {
+        const targetAgent = level.target;
+        if (!targetAgent) {
+            this.ctx.emitter.emit("log", {
+                level: "warn",
+                message: `[escalation] Agent level ${level.level} has no target — skipping to next level`,
+            });
+            await this.advanceLevel(taskId, task, level, policy);
+            return;
+        }
+        const agent = findAgent(this.ctx.config.teams, targetAgent);
+        if (!agent) {
+            this.ctx.emitter.emit("log", {
+                level: "warn",
+                message: `[escalation] Agent "${targetAgent}" not found — skipping to next level`,
+            });
+            await this.advanceLevel(taskId, task, level, policy);
+            return;
+        }
+        await this.ctx.registry.updateTask(taskId, { assignTo: targetAgent });
+        await this.ctx.registry.unsafeSetStatus(taskId, "pending", `escalation level ${level.level}: reassign to ${targetAgent}`);
+        this.ctx.emitter.emit("escalation:resolved", {
+            taskId,
+            level: level.level,
+            action: `reassigned to agent "${targetAgent}"`,
+        });
+        if (level.timeoutMs) {
+            this.startTimer(taskId, task, level, policy, level.timeoutMs);
+        }
+    }
+    async escalateToOrchestrator(taskId, task, level, policy) {
+        if (!this.ctx.queryLLM) {
+            this.ctx.emitter.emit("log", {
+                level: "warn",
+                message: `[escalation] No LLM query function available — skipping to next level`,
+            });
+            await this.advanceLevel(taskId, task, level, policy);
+            return;
+        }
+        try {
+            const failureContext = this.buildFailureContext(task);
+            const prompt = [
+                "A task in an automated development pipeline has failed after all retry attempts.",
+                "Analyze the failure and suggest a reformulated task description that might succeed.",
+                "",
+                `Task title: ${task.title}`,
+                `Original description: ${task.originalDescription ?? task.description}`,
+                `Agent: ${task.assignTo}`,
+                `Retries: ${task.retries}/${task.maxRetries}`,
+                "",
+                "Failure details:",
+                failureContext,
+                "",
+                "Provide a reformulated task description that addresses the failure.",
+                "Focus on being more specific, adding constraints, or simplifying the scope.",
+                "Return ONLY the new description text, no explanation.",
+            ].join("\n");
+            const newDescription = (await this.ctx.queryLLM(prompt, this.ctx.config.settings.orchestratorModel)).text;
+            if (newDescription && newDescription.length > 20) {
+                await this.ctx.registry.updateTask(taskId, {
+                    description: `[Escalation: Reformulated by orchestrator]\n\n${newDescription}`,
+                    phase: "execution",
+                    fixAttempts: 0,
+                });
+                await this.ctx.registry.unsafeSetStatus(taskId, "pending", `escalation level ${level.level}: orchestrator reformulation`);
+                this.ctx.emitter.emit("escalation:resolved", {
+                    taskId,
+                    level: level.level,
+                    action: "task reformulated by orchestrator LLM",
+                });
+                if (level.timeoutMs) {
+                    this.startTimer(taskId, task, level, policy, level.timeoutMs);
+                }
+            }
+            else {
+                await this.advanceLevel(taskId, task, level, policy);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.ctx.emitter.emit("log", {
+                level: "error",
+                message: `[escalation] Orchestrator analysis failed: ${msg}`,
+            });
+            await this.advanceLevel(taskId, task, level, policy);
+        }
+    }
+    async escalateToHuman(taskId, task, level, _policy) {
+        const failureContext = this.buildFailureContext(task);
+        await this.ctx.registry.unsafeSetStatus(taskId, "awaiting_approval", `escalation level ${level.level}: human intervention`);
+        this.ctx.emitter.emit("escalation:human", {
+            taskId,
+            message: [
+                `Task "${task.title}" has failed after all automated attempts and requires human intervention.`,
+                "",
+                `Agent: ${task.assignTo}`,
+                `Retries: ${task.retries}/${task.maxRetries}`,
+                "",
+                "Failure details:",
+                failureContext,
+                "",
+                "Actions available:",
+                "- Approve: retry with current description",
+                "- Reject: mark as permanently failed",
+                "- Modify: update description/assignment via API",
+            ].join("\n"),
+            channels: level.notifyChannels,
+        });
+        this.ctx.emitter.emit("escalation:resolved", {
+            taskId,
+            level: level.level,
+            action: "awaiting human intervention",
+        });
+        if (this.approvalMgr) {
+            this.ctx.emitter.emit("approval:requested", {
+                requestId: `esc-${taskId}`,
+                gateId: "escalation",
+                gateName: `Escalation: ${task.title}`,
+                taskId,
+            });
+        }
+    }
+    async advanceLevel(taskId, task, currentLevel, policy) {
+        const nextLevel = policy.levels.find(l => l.level > currentLevel.level);
+        if (nextLevel) {
+            try {
+                await this.escalate(taskId, task, nextLevel, policy);
+            }
+            catch {
+                await this.finalFail(taskId);
+            }
+        }
+        else {
+            await this.finalFail(taskId);
+        }
+    }
+    async finalFail(taskId) {
+        this.taskLevels.delete(taskId);
+        this.clearTimer(taskId);
+        const task = await this.ctx.registry.getTask(taskId);
+        if (!task)
+            return;
+        if (task.status !== "done" && task.status !== "failed" && task.status !== "awaiting_approval") {
+            await this.ctx.registry.unsafeSetStatus(taskId, "failed", "escalation exhausted");
+        }
+    }
+    buildFailureContext(task) {
+        const lines = [];
+        if (task.result) {
+            if (task.result.exitCode !== 0) {
+                lines.push(`Exit code: ${task.result.exitCode}`);
+            }
+            if (task.result.stderr) {
+                const stderr = task.result.stderr.slice(-500);
+                lines.push(`Last stderr: ${stderr}`);
+            }
+            if (task.result.assessment) {
+                const a = task.result.assessment;
+                lines.push(`Assessment: ${a.passed ? "PASSED" : "FAILED"}`);
+                if (a.globalScore !== undefined) {
+                    lines.push(`Score: ${a.globalScore.toFixed(1)}/5`);
+                }
+                for (const check of a.checks.filter(c => !c.passed)) {
+                    lines.push(`  Failed: ${check.type} — ${check.message}`);
+                }
+            }
+        }
+        return lines.join("\n") || "No failure details available.";
+    }
+    startTimer(taskId, task, currentLevel, policy, ms) {
+        this.clearTimer(taskId);
+        const timer = setTimeout(async () => {
+            this.timers.delete(taskId);
+            const currentTask = await this.ctx.registry.getTask(taskId);
+            if (currentTask && (currentTask.status === "pending" || currentTask.status === "in_progress" || currentTask.status === "failed")) {
+                this.ctx.emitter.emit("log", {
+                    level: "warn",
+                    message: `[escalation] Level ${currentLevel.level} timed out for task ${taskId} — advancing`,
+                });
+                await this.advanceLevel(taskId, task, currentLevel, policy);
+            }
+        }, ms);
+        this.timers.set(taskId, timer);
+    }
+    clearTimer(taskId) {
+        const timer = this.timers.get(taskId);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(taskId);
+        }
+    }
+    dispose() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        this.taskLevels.clear();
+    }
+}
+//# sourceMappingURL=escalation-manager.js.map

package/dist/escalation-manager.js.map

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

package/dist/event-bus.d.ts

@@ -0,0 +1,18 @@
+/**
+ * EventBus — pure interface for typed event emission.
+ *
+ * TypedEmitter (extends Node.js EventEmitter) implements this in the shell.
+ * Other runtimes (Convex, Workers) can provide their own implementations.
+ */
+import type { PolpoEvent, PolpoEventMap } from "./events.js";
+export interface EventBus {
+    emit<K extends PolpoEvent>(event: K, payload: PolpoEventMap[K]): boolean;
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+    on<K extends PolpoEvent>(event: K, listener: (payload: PolpoEventMap[K]) => void): unknown;
+    on(event: string | symbol, listener: (...args: unknown[]) => void): unknown;
+    off<K extends PolpoEvent>(event: K, listener: (payload: PolpoEventMap[K]) => void): unknown;
+    off(event: string | symbol, listener: (...args: unknown[]) => void): unknown;
+    once?<K extends PolpoEvent>(event: K, listener: (payload: PolpoEventMap[K]) => void): unknown;
+    once?(event: string | symbol, listener: (...args: unknown[]) => void): unknown;
+}
+//# sourceMappingURL=event-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACzE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1D,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC;IAC3F,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAE5E,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC;IAC5F,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAE7E,IAAI,CAAC,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9F,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;CAChF"}

package/dist/event-bus.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":""}