kevlar-4u 1.0.0

package/dist/execution/config.js

@@ -0,0 +1,95 @@
+/**
+ * Kevlar Configuration Management
+ *
+ * Reads and writes the kevlar-config.json file for user preferences.
+ * API keys are NEVER stored here - only environment variables.
+ */
+import { readFileSync, writeFileSync } from "fs";
+import * as path from "path";
+import { logger, getErrorInfo } from "../utils/observability.js";
+// ── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    mode: "auto",
+    multiAgent: {
+        maxConcurrency: 3,
+        timeoutMs: 60000,
+    },
+    personaOrder: [],
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+};
+// ── Config File Path ─────────────────────────────────────────────────────────
+let configPath = null;
+export function setConfigPath(skillsDir) {
+    configPath = path.join(skillsDir, "kevlar-config.json");
+}
+// ── Read Config ──────────────────────────────────────────────────────────────
+export function readConfig() {
+    if (!configPath) {
+        logger.warn("Config path not initialized, using defaults", { event: "config_not_initialized" });
+        return { ...DEFAULT_CONFIG };
+    }
+    let result;
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        result = { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        // Config doesn't exist or is invalid - use defaults
+        result = { ...DEFAULT_CONFIG };
+    }
+    const envMaxConcurrency = process.env.KEVLAR_MAX_CONCURRENT;
+    if (envMaxConcurrency) {
+        const parsed = parseInt(envMaxConcurrency, 10);
+        if (!isNaN(parsed) && isValidConcurrency(parsed)) {
+            result.multiAgent = { ...result.multiAgent, maxConcurrency: parsed };
+        }
+    }
+    return result;
+}
+export async function readConfigAsync() {
+    // Kept for backward compatibility, using synchronous read for safety
+    return readConfig();
+}
+export async function updateConfig(options) {
+    if (!configPath) {
+        throw new Error("Config path not initialized");
+    }
+    // Use synchronous atomic read-merge-write to prevent async race conditions
+    const current = readConfig();
+    const updated = {
+        ...current,
+        multiAgent: {
+            ...current.multiAgent,
+        },
+        updatedAt: new Date().toISOString(),
+    };
+    if (options.mode !== undefined) {
+        updated.mode = options.mode;
+    }
+    if (options.maxConcurrency !== undefined) {
+        updated.multiAgent.maxConcurrency = options.maxConcurrency;
+    }
+    if (options.personaOrder !== undefined) {
+        updated.personaOrder = options.personaOrder;
+    }
+    try {
+        writeFileSync(configPath, JSON.stringify(updated, null, 2), "utf-8");
+        logger.info("Config updated", { event: "config_update", path: configPath, options });
+        return updated;
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        logger.error("Failed to write config", { event: "config_write_error", error: info.code, message: info.message });
+        throw err;
+    }
+}
+// ── Config Validation ─────────────────────────────────────────────────────────
+export function isValidMode(mode) {
+    return ["auto", "orchestration", "mcp_sampling", "direct_api"].includes(mode);
+}
+export function isValidConcurrency(concurrency) {
+    return Number.isInteger(concurrency) && concurrency >= 1 && concurrency <= 10;
+}
+//# sourceMappingURL=config.js.map

package/dist/execution/config.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Kevlar Execution Engine
+ *
+ * Unified entry point for all execution modes with automatic mode resolution.
+ */
+import { Persona } from "../utils/parser.js";
+import { isSamplingSupported } from "./client.js";
+import type { ExecutionContext, ExecutionResult, ModesInfo, ResolveableMode } from "./base.js";
+export declare const MAX_PERSONAS = 50;
+export declare function executeReview(mode: ResolveableMode, ctx: ExecutionContext): Promise<ExecutionResult>;
+export declare function getModesInfo(): ModesInfo;
+export interface PersonaLoadingResult {
+    personas: Persona[];
+    missingIds?: string[];
+}
+export declare function validatePersonaFields(persona: Persona): void;
+export declare function loadPersonasForReview(skillsDir: string, personaIds?: string[]): Promise<PersonaLoadingResult>;
+export { isSamplingSupported };
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAsC,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,KAAK,EACV,gBAAgB,EAGhB,eAAe,EACf,SAAS,EAET,eAAe,EAChB,MAAM,WAAW,CAAC;AAYnB,eAAO,MAAM,YAAY,KAAK,CAAC;AAI/B,wBAAsB,aAAa,CACjC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAyD1B;AAkCD,wBAAgB,YAAY,IAAI,SAAS,CA4BxC;AAID,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY5D;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAID,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,151 @@
+/**
+ * Kevlar Execution Engine
+ *
+ * Unified entry point for all execution modes with automatic mode resolution.
+ */
+import { loadAllPersonas, loadPersonasByIds } from "../utils/parser.js";
+import { logger } from "../utils/logger.js";
+import { readConfig, isValidMode } from "./config.js";
+import { isSamplingSupported } from "./client.js";
+import { orchestrationHandler } from "./modes/orchestration.js";
+import { samplingHandler } from "./modes/sampling.js";
+import { directApiHandler } from "./modes/direct_api.js";
+// ── Handler Registry ──────────────────────────────────────────────────────────
+const handlers = [
+    orchestrationHandler, // priority: 30 (fallback)
+    samplingHandler, // priority: 10 (preferred)
+    directApiHandler, // priority: 20 (medium)
+];
+// ── Limits ────────────────────────────────────────────────────────────────────
+export const MAX_PERSONAS = 50;
+// ── Core Execution Function ───────────────────────────────────────────────────
+export async function executeReview(mode, ctx) {
+    const resolved = mode === "auto" ? await resolveMode() : mode;
+    const personaCount = ctx.personas.length;
+    if (personaCount > MAX_PERSONAS) {
+        throw new Error(`评论员数量超出限制（最多${MAX_PERSONAS}个，当前${personaCount}个）。`);
+    }
+    const handler = handlers.find((h) => h.mode === resolved);
+    if (!handler) {
+        throw new Error(`未知执行模式: ${resolved}`);
+    }
+    if (!handler.canExecute()) {
+        throw new Error(`${resolved} 模式当前不可用`);
+    }
+    logger.info("Executing review", {
+        event: "review_execute",
+        mode: resolved,
+        personas: ctx.personas.length,
+        contentLength: ctx.content.length,
+    });
+    const startTime = Date.now();
+    let result;
+    if (resolved !== "orchestration") {
+        const { acquireReviewLock, releaseReviewLock, getReviewLock } = await import("./lock.js");
+        if (!acquireReviewLock(resolved)) {
+            const lock = getReviewLock();
+            throw new Error(`已有评测任务正在执行（${lock?.mode || "unknown"}），请等待完成后再试。`);
+        }
+        try {
+            result = await handler.execute(ctx);
+        }
+        finally {
+            releaseReviewLock();
+        }
+    }
+    else {
+        result = await handler.execute(ctx);
+    }
+    const durationMs = Date.now() - startTime;
+    const failedCount = result.partialFailures?.length ?? 0;
+    logger.info("Review summary", {
+        event: "review_summary",
+        mode: resolved,
+        personas: ctx.personas.length,
+        success: ctx.personas.length - failedCount,
+        failure: failedCount,
+        durationMs,
+    });
+    return result;
+}
+// ── Mode Resolution ──────────────────────────────────────────────────────────
+async function resolveMode() {
+    // 1. Check persisted config (user preference, highest priority)
+    const config = readConfig();
+    if (config.mode && config.mode !== "auto") {
+        logger.debug("Using persisted mode", { event: "mode_persist", mode: config.mode });
+        return config.mode;
+    }
+    // 2. Check KEVLAR_MODE env var (global default, overridden by config)
+    const envMode = process.env.KEVLAR_MODE;
+    if (envMode && envMode !== "auto" && isValidMode(envMode)) {
+        logger.debug("Using env var mode", { event: "mode_env", mode: envMode });
+        return envMode;
+    }
+    // 3. Select first available by priority
+    const sorted = [...handlers].sort((a, b) => a.priority - b.priority);
+    for (const h of sorted) {
+        if (h.canExecute()) {
+            logger.debug("Auto-resolved mode", { event: "mode_auto", mode: h.mode });
+            return h.mode;
+        }
+    }
+    // 4. Fallback to orchestration (always available)
+    return "orchestration";
+}
+// ── Mode Information ──────────────────────────────────────────────────────────
+export function getModesInfo() {
+    const config = readConfig();
+    const currentMode = (config.mode || "auto");
+    const modes = handlers.map((h) => ({
+        mode: h.mode,
+        available: h.canExecute(),
+        reason: h.canExecute() ? undefined : "当前环境不支持",
+    }));
+    // Determine recommended mode
+    const sorted = [...handlers].sort((a, b) => a.priority - b.priority);
+    let recommended = "orchestration";
+    for (const h of sorted) {
+        if (h.canExecute()) {
+            recommended = h.mode;
+            break;
+        }
+    }
+    const resolved = currentMode === "auto" ? recommended : currentMode;
+    return {
+        modes,
+        recommendedMode: recommended,
+        currentMode,
+        resolvedMode: resolved,
+    };
+}
+export function validatePersonaFields(persona) {
+    const prompt = persona.systemPrompt || "";
+    const tags = persona.meta.tags ?? [];
+    // Use structured metadata first, fall back to keyword matching in system prompt
+    const hasPlatform = tags.length > 0 || prompt.includes("常用平台") || (persona.meta.description?.includes("平台") ?? false);
+    const hasTraits = (persona.meta.description?.length ?? 0) >= 4 || prompt.includes("性格特质") || prompt.includes("性格");
+    const hasBlindSpot = !!persona.meta.blindSpot || prompt.includes("盲区");
+    if (!hasPlatform || !hasTraits || !hasBlindSpot) {
+        throw new Error(`[${persona.meta.name}] 角色 ${!hasPlatform ? "缺少平台标签/描述, " : ""}${!hasTraits ? "缺少性格描述, " : ""}${!hasBlindSpot ? "缺少盲区" : ""}`);
+    }
+}
+export async function loadPersonasForReview(skillsDir, personaIds) {
+    if (personaIds && personaIds.length > 0) {
+        const personas = await loadPersonasByIds(skillsDir, personaIds);
+        for (const p of personas) {
+            validatePersonaFields(p);
+        }
+        const foundIds = new Set(personas.map((p) => p.meta.id));
+        const missing = personaIds.filter((id) => !foundIds.has(id));
+        return { personas, missingIds: missing.length > 0 ? missing : undefined };
+    }
+    const personas = await loadAllPersonas(skillsDir);
+    for (const p of personas) {
+        validatePersonaFields(p);
+    }
+    return { personas };
+}
+// ── Sampling Support Check ────────────────────────────────────────────────────
+export { isSamplingSupported };
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAW,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAWzD,iFAAiF;AAEjF,MAAM,QAAQ,GAAuB;IACnC,oBAAoB,EAAE,0BAA0B;IAChD,eAAe,EAAO,2BAA2B;IACjD,gBAAgB,EAAM,wBAAwB;CAC/C,CAAC;AAEF,iFAAiF;AAEjF,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAqB,EACrB,GAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEzC,IAAI,YAAY,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,OAAO,YAAY,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;QAC9B,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;QAC7B,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM;KAClC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,MAAuB,CAAC;IAE5B,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;QACjC,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAE1F,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,EAAE,IAAI,IAAI,SAAS,aAAa,CACnD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,iBAAiB,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC5B,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;QAC7B,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAW;QAC1C,OAAO,EAAE,WAAW;QACpB,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAEhF,KAAK,UAAU,WAAW;IACxB,gEAAgE;IAChE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,sEAAsE;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAA0C,CAAC;IACvE,IAAI,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,wCAAwC;IACxC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,OAAO,CAAC,CAAC,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAoB,CAAC;IAE/D,MAAM,KAAK,GAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE;QACzB,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KAC/C,CAAC,CAAC,CAAC;IAEJ,6BAA6B;IAC7B,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,IAAI,WAAW,GAAkB,eAAe,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;YACnB,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;IAEpE,OAAO;QACL,KAAK;QACL,eAAe,EAAE,WAAW;QAC5B,WAAW;QACX,YAAY,EAAE,QAAQ;KACvB,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAErC,gFAAgF;IAChF,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;IACtH,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnH,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEvE,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,UAAqB;IAErB,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5E,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,iFAAiF;AAEjF,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/execution/limiter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rate Limiter with Semaphore and Exponential Backoff
+ *
+ * Shared between mcp_sampling and direct_api modes.
+ */
+interface RateLimitConfig {
+    maxConcurrent: number;
+    minDelayMs: number;
+}
+export declare class RateLimiter {
+    private semaphore;
+    private minDelayMs;
+    private lastExecution;
+    private maxConcurrent;
+    constructor(config?: RateLimitConfig);
+    acquire(): Promise<void>;
+    release(): void;
+    waitForDelay(): Promise<void>;
+    getConfig(): RateLimitConfig;
+}
+export type RetryableErrorType = "rate_limit_exceeded" | "service_unavailable" | "timeout" | "network_error";
+export declare function isRetryableError(errorType: string): errorType is RetryableErrorType;
+interface RetryOptions {
+    maxRetries?: number;
+    backoffMs?: number;
+    backoffMultiplier?: number;
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export declare function getRateLimiter(config?: RateLimitConfig): RateLimiter;
+export {};
+//# sourceMappingURL=limiter.d.ts.map

package/dist/execution/limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.d.ts","sourceRoot":"","sources":["../../src/execution/limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAwCD,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,GAAE,eAAgC;IAM9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,IAAI,IAAI;IAKT,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC,SAAS,IAAI,eAAe;CAM7B;AAgBD,MAAM,MAAM,kBAAkB,GAC1B,qBAAqB,GACrB,qBAAqB,GACrB,SAAS,GACT,eAAe,CAAC;AASpB,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,kBAAkB,CAEnF;AAID,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAqCZ;AAwBD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,CAEpE"}

package/dist/execution/limiter.js

@@ -0,0 +1,147 @@
+/**
+ * Rate Limiter with Semaphore and Exponential Backoff
+ *
+ * Shared between mcp_sampling and direct_api modes.
+ */
+import { logger, getErrorInfo } from "../utils/observability.js";
+const DEFAULT_CONFIG = {
+    maxConcurrent: Number(process.env.KEVLAR_MAX_CONCURRENT) || 3,
+    minDelayMs: Number(process.env.KEVLAR_MIN_DELAY_MS) || 1000,
+};
+// ── Semaphore ─────────────────────────────────────────────────────────────────
+class Semaphore {
+    permits;
+    queue = [];
+    constructor(permits) {
+        this.permits = permits;
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        if (this.queue.length > 0) {
+            const next = this.queue.shift();
+            if (next)
+                next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+}
+// ── Rate Limiter ──────────────────────────────────────────────────────────────
+export class RateLimiter {
+    semaphore;
+    minDelayMs;
+    lastExecution = 0;
+    maxConcurrent;
+    constructor(config = DEFAULT_CONFIG) {
+        this.semaphore = new Semaphore(config.maxConcurrent);
+        this.minDelayMs = config.minDelayMs;
+        this.maxConcurrent = config.maxConcurrent;
+    }
+    async acquire() {
+        await this.semaphore.acquire();
+    }
+    release() {
+        this.semaphore.release();
+        this.lastExecution = Date.now();
+    }
+    async waitForDelay() {
+        const now = Date.now();
+        const elapsed = now - this.lastExecution;
+        if (elapsed < this.minDelayMs) {
+            await new Promise((resolve) => setTimeout(resolve, this.minDelayMs - elapsed));
+        }
+    }
+    getConfig() {
+        return {
+            maxConcurrent: this.maxConcurrent,
+            minDelayMs: this.minDelayMs,
+        };
+    }
+}
+const DEFAULT_RETRY = {
+    maxRetries: 3,
+    backoffMs: 1000,
+    backoffMultiplier: 2,
+};
+const RETRYABLE_ERRORS = [
+    "rate_limit_exceeded",
+    "service_unavailable",
+    "timeout",
+    "network_error",
+];
+export function isRetryableError(errorType) {
+    return RETRYABLE_ERRORS.includes(errorType);
+}
+export async function withRetry(fn, options = {}) {
+    const config = {
+        maxRetries: options.maxRetries ?? DEFAULT_RETRY.maxRetries,
+        backoffMs: options.backoffMs ?? DEFAULT_RETRY.backoffMs,
+        backoffMultiplier: options.backoffMultiplier ?? DEFAULT_RETRY.backoffMultiplier,
+    };
+    let lastError;
+    let delay = config.backoffMs;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(getErrorInfo(err).message);
+            // Check if error is retryable
+            const errorType = getErrorType(lastError);
+            if (attempt < config.maxRetries && isRetryableError(errorType)) {
+                logger.debug("Retrying after error", {
+                    event: "retry",
+                    attempt: attempt + 1,
+                    errorType,
+                    delayMs: delay,
+                });
+                options.onRetry?.(attempt + 1, lastError, delay);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                delay *= config.backoffMultiplier;
+            }
+            else {
+                throw lastError;
+            }
+        }
+    }
+    throw lastError;
+}
+function getErrorType(err) {
+    const message = err.message.toLowerCase();
+    // Check by status code first (structured API error responses)
+    const statusMatch = message.match(/\b(\d{3})\b/);
+    if (statusMatch) {
+        const code = statusMatch[1];
+        if (code === "429")
+            return "rate_limit_exceeded";
+        if (code === "503")
+            return "service_unavailable";
+        if (code === "504" || code === "408")
+            return "timeout";
+        if (code === "502")
+            return "service_unavailable";
+    }
+    if (message.includes("rate limit"))
+        return "rate_limit_exceeded";
+    if (message.includes("unavailable"))
+        return "service_unavailable";
+    if (message.includes("timeout") || message.includes("ETIMEDOUT"))
+        return "timeout";
+    if (message.includes("network") || message.includes("ECONNREFUSED") || message.includes("ENOTFOUND"))
+        return "network_error";
+    return "unknown";
+}
+// ── Factory ─────────────────────────────────────────────────────────────────────
+export function getRateLimiter(config) {
+    return new RateLimiter(config);
+}
+//# sourceMappingURL=limiter.js.map

package/dist/execution/limiter.js.map

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

package/dist/execution/lock.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Review Execution Lock
+ *
+ * Prevents concurrent execution of sampling/direct_api modes.
+ * Orchestration mode is exempt (no external calls).
+ * Includes TTL to prevent deadlocks on crash.
+ */
+interface LockEntry {
+    mode: string;
+    acquiredAt: number;
+}
+export declare function acquireReviewLock(mode: string): boolean;
+export declare function releaseReviewLock(): void;
+export declare function getReviewLock(): LockEntry | null;
+export declare function isLocked(): boolean;
+export {};
+//# sourceMappingURL=lock.d.ts.map

package/dist/execution/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/execution/lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUvD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,aAAa,IAAI,SAAS,GAAG,IAAI,CAKhD;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAMlC"}

package/dist/execution/lock.js

@@ -0,0 +1,37 @@
+/**
+ * Review Execution Lock
+ *
+ * Prevents concurrent execution of sampling/direct_api modes.
+ * Orchestration mode is exempt (no external calls).
+ * Includes TTL to prevent deadlocks on crash.
+ */
+const LOCK_TTL_MS = 300_000; // 5 minutes
+let reviewLock = null;
+export function acquireReviewLock(mode) {
+    if (reviewLock) {
+        if (Date.now() - reviewLock.acquiredAt > LOCK_TTL_MS) {
+            reviewLock = { mode, acquiredAt: Date.now() };
+            return true;
+        }
+        return false;
+    }
+    reviewLock = { mode, acquiredAt: Date.now() };
+    return true;
+}
+export function releaseReviewLock() {
+    reviewLock = null;
+}
+export function getReviewLock() {
+    if (reviewLock && Date.now() - reviewLock.acquiredAt > LOCK_TTL_MS) {
+        reviewLock = null;
+    }
+    return reviewLock;
+}
+export function isLocked() {
+    if (reviewLock && Date.now() - reviewLock.acquiredAt > LOCK_TTL_MS) {
+        reviewLock = null;
+        return false;
+    }
+    return reviewLock !== null;
+}
+//# sourceMappingURL=lock.js.map

package/dist/execution/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/execution/lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,YAAY;AAOzC,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC;YACrD,UAAU,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,UAAU,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC;QACnE,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC;QACnE,UAAU,GAAG,IAAI,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,UAAU,KAAK,IAAI,CAAC;AAC7B,CAAC"}

package/dist/execution/modes/direct_api.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Direct API Execution Mode
+ *
+ * Directly calls third-party LLM APIs (OpenAI / Anthropic / Ollama).
+ * API keys are read ONLY from environment variables.
+ */
+import type { ExecutionHandler } from "../base.js";
+export declare function hasApiKey(): boolean;
+export declare function maskApiKey(key: string, visible?: number): string;
+export declare const directApiHandler: ExecutionHandler;
+//# sourceMappingURL=direct_api.d.ts.map

package/dist/execution/modes/direct_api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct_api.d.ts","sourceRoot":"","sources":["../../../src/execution/modes/direct_api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAoB,gBAAgB,EAAkC,MAAM,YAAY,CAAC;AAgDrG,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CAG3D;AAsKD,eAAO,MAAM,gBAAgB,EAAE,gBAwC9B,CAAC"}