@alan512/experienceengine 0.1.2 → 0.2.0

package/dist/hybrid/validators.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+const explainDecisionOutputSchema = z.object({
+    task: z.literal("explain_decision"),
+    decision: z.string().min(1),
+    reason: z.string().min(1),
+    confidence: z.enum(["high", "medium", "low"]),
+    evidence_summary: z.string().min(1).optional()
+});
+const postmortemReviewOutputSchema = z.object({
+    task: z.literal("postmortem_review"),
+    review_verdict: z.enum(["review_artifact", "policy_gated"]),
+    candidate_recommendation: z.enum(["capture", "reject", "observe"]),
+    feedback_followup_recommendation: z.enum(["none", "mark_helped", "mark_harmed", "review"]),
+    confidence: z.enum(["high", "medium", "low"]),
+    reason: z.string().min(1),
+    injected_node_reviews: z
+        .array(z.object({
+        node_id: z.string().min(1),
+        feedback_verdict: z.enum(["helped", "harmed", "uncertain"]),
+        confidence: z.enum(["high", "medium", "low"]),
+        delivery_recommendation: z.enum(["keep", "conservative_only", "quarantine", "review"]),
+        reason: z.string().min(1),
+        evidence_summary: z.string().min(1).optional()
+    }))
+        .optional(),
+    review_artifact: z
+        .object({
+        summary: z.string().min(1),
+        notes: z.array(z.string().min(1)).min(1)
+    })
+        .optional(),
+    suggestedFollowUps: z.array(z.string()).optional(),
+    candidateShapingSuggestions: z.array(z.string()).optional(),
+    governanceRecommendations: z.array(z.string()).optional(),
+    lifecycleSuggestions: z.array(z.string()).optional(),
+    writeBackSuggestions: z.array(z.string()).optional()
+});
+export const parsePostmortemReviewOutput = (value) => {
+    const parsed = postmortemReviewOutputSchema.safeParse(value);
+    if (!parsed.success) {
+        return rejected("schema_invalid", parsed.error.issues.map((issue) => issue.message).join("; "));
+    }
+    return parsed.data;
+};
+const isValidationFailure = (value) => "status" in value;
+export const classifyHybridApproval = (value) => {
+    if (value.task === "explain_decision") {
+        return "advisory";
+    }
+    if ((value.lifecycleSuggestions?.length ?? 0) > 0 || (value.writeBackSuggestions?.length ?? 0) > 0) {
+        return "blocked";
+    }
+    if (value.review_verdict === "policy_gated"
+        || value.feedback_followup_recommendation !== "none"
+        || (value.injected_node_reviews?.length ?? 0) > 0
+        || (value.candidateShapingSuggestions?.length ?? 0) > 0
+        || (value.suggestedFollowUps?.length ?? 0) > 0
+        || (value.governanceRecommendations?.length ?? 0) > 0) {
+        return "policy_gated";
+    }
+    return "review_artifact";
+};
+const rejected = (reason, detail) => ({
+    status: "rejected",
+    reason,
+    detail
+});
+export const validateExplainDecisionOutput = (value) => {
+    const parsed = explainDecisionOutputSchema.safeParse(value);
+    if (!parsed.success) {
+        return rejected("schema_invalid", parsed.error.issues.map((issue) => issue.message).join("; "));
+    }
+    return {
+        status: "accepted",
+        approvalClass: "advisory",
+        value: parsed.data
+    };
+};
+export const validatePostmortemReviewOutput = (value) => {
+    const parsed = parsePostmortemReviewOutput(value);
+    if (isValidationFailure(parsed)) {
+        return parsed;
+    }
+    const approvalClass = classifyHybridApproval(parsed);
+    if (approvalClass === "blocked") {
+        return rejected("approval_blocked", "Phase 1 blocks lifecycle changes and write-back suggestions from worker outputs.");
+    }
+    return {
+        status: "accepted",
+        approvalClass,
+        value: parsed
+    };
+};
+//# sourceMappingURL=validators.js.map

package/dist/hybrid/validators.js.map

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

package/dist/hybrid/worker-client.d.ts

@@ -0,0 +1,61 @@
+import type { ExplainDecisionCapsule, ExplainDecisionWorkerOutput, HybridValidationFailure, HybridValidationSuccess, PostmortemReviewCapsule, PostmortemReviewWorkerOutput } from "./types.js";
+import type { DistillerEndpoint } from "../distillation/providers/types.js";
+export type HybridExplainFallback = {
+    status: "fallback";
+    reason: "disabled" | "timeout" | "circuit_open" | "provider_unavailable";
+} | {
+    status: "fallback";
+    reason: "validation_failed";
+    validation: HybridValidationFailure;
+};
+export type HybridExplainResult = HybridValidationSuccess<ExplainDecisionWorkerOutput> | HybridExplainFallback;
+export type HybridPostmortemFallback = {
+    status: "fallback";
+    reason: "disabled" | "timeout" | "circuit_open" | "provider_unavailable";
+} | {
+    status: "fallback";
+    reason: "validation_failed";
+    validation: HybridValidationFailure;
+};
+export type HybridPostmortemResult = HybridValidationSuccess<PostmortemReviewWorkerOutput> | HybridPostmortemFallback;
+export type HybridWorkerClientOptions = {
+    explainDecisionEnabled?: boolean;
+    explainDecisionTimeoutMs?: number;
+    explainDecisionProviderTimeoutMs?: number;
+    explainDecisionExecutor?: (capsule: ExplainDecisionCapsule) => Promise<ExplainDecisionWorkerOutput> | ExplainDecisionWorkerOutput;
+    explainDecisionLlmEnabled?: boolean;
+    explainDecisionLlmExecutor?: (capsule: ExplainDecisionCapsule, endpoint: DistillerEndpoint) => Promise<ExplainDecisionWorkerOutput> | ExplainDecisionWorkerOutput;
+    postmortemReviewEnabled?: boolean;
+    postmortemReviewTimeoutMs?: number;
+    postmortemReviewProviderTimeoutMs?: number;
+    postmortemReviewExecutor?: (capsule: PostmortemReviewCapsule) => Promise<PostmortemReviewWorkerOutput> | PostmortemReviewWorkerOutput;
+    postmortemReviewLlmEnabled?: boolean;
+    postmortemReviewLlmExecutor?: (capsule: PostmortemReviewCapsule, endpoint: DistillerEndpoint) => Promise<PostmortemReviewWorkerOutput> | PostmortemReviewWorkerOutput;
+    timeoutCircuitThreshold?: number;
+};
+export declare class HybridWorkerClient {
+    private readonly explainDecisionEnabled;
+    private readonly explainDecisionTimeoutMs;
+    private readonly explainDecisionProviderTimeoutMs;
+    private readonly explainDecisionExecutor;
+    private readonly explainDecisionLlmEnabled;
+    private readonly explainDecisionLlmExecutor;
+    private readonly postmortemReviewEnabled;
+    private readonly postmortemReviewTimeoutMs;
+    private readonly postmortemReviewProviderTimeoutMs;
+    private readonly postmortemReviewExecutor;
+    private readonly postmortemReviewLlmEnabled;
+    private readonly postmortemReviewLlmExecutor;
+    private readonly timeoutCircuitThreshold;
+    private explainTimeoutStreak;
+    private postmortemTimeoutStreak;
+    constructor(options?: HybridWorkerClientOptions);
+    runExplainDecision(capsule: ExplainDecisionCapsule, options?: {
+        mode?: "deterministic" | "provider";
+        endpoint?: DistillerEndpoint;
+    }): Promise<HybridExplainResult>;
+    runPostmortemReview(capsule: PostmortemReviewCapsule, options?: {
+        mode?: "deterministic" | "provider";
+        endpoint?: DistillerEndpoint;
+    }): Promise<HybridPostmortemResult>;
+}

package/dist/hybrid/worker-client.js

@@ -0,0 +1,196 @@
+import { validateExplainDecisionOutput, validatePostmortemReviewOutput } from "./validators.js";
+import { runExplainDecisionWorker } from "./workers/explain-decision.js";
+import { runExplainDecisionLlmWorker } from "./workers/explain-decision-llm.js";
+import { runPostmortemReviewWorker } from "./workers/postmortem-review.js";
+import { runPostmortemReviewLlmWorker } from "./workers/postmortem-review-llm.js";
+const DEFAULT_TIMEOUT_MS = 150;
+const DEFAULT_PROVIDER_TIMEOUT_MS = 5000;
+const DEFAULT_POSTMORTEM_PROVIDER_TIMEOUT_MS = 15000;
+const DEFAULT_CIRCUIT_THRESHOLD = 3;
+export class HybridWorkerClient {
+    explainDecisionEnabled;
+    explainDecisionTimeoutMs;
+    explainDecisionProviderTimeoutMs;
+    explainDecisionExecutor;
+    explainDecisionLlmEnabled;
+    explainDecisionLlmExecutor;
+    postmortemReviewEnabled;
+    postmortemReviewTimeoutMs;
+    postmortemReviewProviderTimeoutMs;
+    postmortemReviewExecutor;
+    postmortemReviewLlmEnabled;
+    postmortemReviewLlmExecutor;
+    timeoutCircuitThreshold;
+    explainTimeoutStreak = 0;
+    postmortemTimeoutStreak = 0;
+    constructor(options = {}) {
+        this.explainDecisionEnabled = options.explainDecisionEnabled ?? true;
+        this.explainDecisionTimeoutMs = options.explainDecisionTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.explainDecisionProviderTimeoutMs =
+            options.explainDecisionProviderTimeoutMs ?? DEFAULT_PROVIDER_TIMEOUT_MS;
+        this.explainDecisionExecutor = options.explainDecisionExecutor ?? runExplainDecisionWorker;
+        this.explainDecisionLlmEnabled = options.explainDecisionLlmEnabled ?? false;
+        this.explainDecisionLlmExecutor =
+            options.explainDecisionLlmExecutor
+                ?? ((capsule, endpoint) => runExplainDecisionLlmWorker(capsule, { endpoint }));
+        this.postmortemReviewEnabled = options.postmortemReviewEnabled ?? true;
+        this.postmortemReviewTimeoutMs = options.postmortemReviewTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.postmortemReviewProviderTimeoutMs =
+            options.postmortemReviewProviderTimeoutMs ?? DEFAULT_POSTMORTEM_PROVIDER_TIMEOUT_MS;
+        this.postmortemReviewExecutor = options.postmortemReviewExecutor ?? runPostmortemReviewWorker;
+        this.postmortemReviewLlmEnabled = options.postmortemReviewLlmEnabled ?? false;
+        this.postmortemReviewLlmExecutor =
+            options.postmortemReviewLlmExecutor
+                ?? ((capsule, endpoint) => runPostmortemReviewLlmWorker(capsule, { endpoint }));
+        this.timeoutCircuitThreshold = options.timeoutCircuitThreshold ?? DEFAULT_CIRCUIT_THRESHOLD;
+    }
+    async runExplainDecision(capsule, options = {}) {
+        if (!this.explainDecisionEnabled) {
+            return {
+                status: "fallback",
+                reason: "disabled"
+            };
+        }
+        if (this.explainTimeoutStreak >= this.timeoutCircuitThreshold) {
+            return {
+                status: "fallback",
+                reason: "circuit_open"
+            };
+        }
+        let timer;
+        try {
+            const timeoutMs = options.mode === "provider" ? this.explainDecisionProviderTimeoutMs : this.explainDecisionTimeoutMs;
+            const run = options.mode === "provider"
+                ? () => {
+                    if (!this.explainDecisionLlmEnabled || !options.endpoint) {
+                        throw new Error("provider_disabled");
+                    }
+                    return this.explainDecisionLlmExecutor(capsule, options.endpoint);
+                }
+                : () => this.explainDecisionExecutor(capsule);
+            const result = await Promise.race([
+                Promise.resolve(run()),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error("timeout")), timeoutMs);
+                })
+            ]);
+            const validated = validateExplainDecisionOutput(result);
+            if (validated.status === "rejected") {
+                this.explainTimeoutStreak = 0;
+                return {
+                    status: "fallback",
+                    reason: "validation_failed",
+                    validation: validated
+                };
+            }
+            this.explainTimeoutStreak = 0;
+            return validated;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === "provider_disabled") {
+                this.explainTimeoutStreak = 0;
+                return {
+                    status: "fallback",
+                    reason: "disabled"
+                };
+            }
+            if (error instanceof Error && error.message === "timeout") {
+                this.explainTimeoutStreak += 1;
+                return {
+                    status: "fallback",
+                    reason: "timeout"
+                };
+            }
+            this.explainTimeoutStreak = 0;
+            return {
+                status: "fallback",
+                reason: "validation_failed",
+                validation: {
+                    status: "rejected",
+                    reason: "policy_violation",
+                    detail: error instanceof Error ? error.message : String(error)
+                }
+            };
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+    }
+    async runPostmortemReview(capsule, options = {}) {
+        if (!this.postmortemReviewEnabled) {
+            return {
+                status: "fallback",
+                reason: "disabled"
+            };
+        }
+        if (this.postmortemTimeoutStreak >= this.timeoutCircuitThreshold) {
+            return {
+                status: "fallback",
+                reason: "circuit_open"
+            };
+        }
+        let timer;
+        try {
+            const timeoutMs = options.mode === "provider" ? this.postmortemReviewProviderTimeoutMs : this.postmortemReviewTimeoutMs;
+            const run = options.mode === "provider"
+                ? () => {
+                    if (!this.postmortemReviewLlmEnabled || !options.endpoint) {
+                        throw new Error("provider_disabled");
+                    }
+                    return this.postmortemReviewLlmExecutor(capsule, options.endpoint);
+                }
+                : () => this.postmortemReviewExecutor(capsule);
+            const result = await Promise.race([
+                Promise.resolve(run()),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error("timeout")), timeoutMs);
+                })
+            ]);
+            const validated = validatePostmortemReviewOutput(result);
+            if (validated.status === "rejected") {
+                this.postmortemTimeoutStreak = 0;
+                return {
+                    status: "fallback",
+                    reason: "validation_failed",
+                    validation: validated
+                };
+            }
+            this.postmortemTimeoutStreak = 0;
+            return validated;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === "provider_disabled") {
+                this.postmortemTimeoutStreak = 0;
+                return {
+                    status: "fallback",
+                    reason: "provider_unavailable"
+                };
+            }
+            if (error instanceof Error && error.message === "timeout") {
+                this.postmortemTimeoutStreak += 1;
+                return {
+                    status: "fallback",
+                    reason: "timeout"
+                };
+            }
+            this.postmortemTimeoutStreak = 0;
+            return {
+                status: "fallback",
+                reason: "validation_failed",
+                validation: {
+                    status: "rejected",
+                    reason: "policy_violation",
+                    detail: error instanceof Error ? error.message : String(error)
+                }
+            };
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+    }
+}
+//# sourceMappingURL=worker-client.js.map

package/dist/hybrid/worker-client.js.map

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

package/dist/hybrid/workers/explain-decision-llm.d.ts

@@ -0,0 +1,8 @@
+import type { DistillerEndpoint } from "../../distillation/providers/types.js";
+import type { ExplainDecisionCapsule, ExplainDecisionWorkerOutput } from "../types.js";
+type ExplainDecisionLlmOptions = {
+    endpoint: DistillerEndpoint;
+    fetchImpl?: typeof fetch;
+};
+export declare const runExplainDecisionLlmWorker: (capsule: ExplainDecisionCapsule, options: ExplainDecisionLlmOptions) => Promise<ExplainDecisionWorkerOutput>;
+export {};

package/dist/hybrid/workers/explain-decision-llm.js

@@ -0,0 +1,152 @@
+import { validateExplainDecisionOutput } from "../validators.js";
+const SYSTEM_PROMPT = [
+    "You are ExperienceEngine's bounded explain_decision worker.",
+    "Use only the supplied route metadata and bounded evidence.",
+    "Do not invent evidence or speculate beyond the capsule.",
+    "Return only JSON with keys: decision, reason, confidence, evidence_summary.",
+    "Keep the wording concise and user-readable."
+].join(" ");
+const buildUserPayload = (capsule) => JSON.stringify({
+    route: capsule.trusted.route,
+    inspection: capsule.trusted.inspection,
+    scorecard: capsule.trusted.scorecard,
+    evidence: capsule.evidence.map((entry) => ({
+        source: entry.source,
+        text: entry.text
+    }))
+}, null, 2);
+const buildRequestUrl = (endpoint) => {
+    if (endpoint.kind === "anthropic" || endpoint.kind === "gemini" || endpoint.kind === "bedrock") {
+        return endpoint.baseUrl;
+    }
+    if (/\/chat\/completions(?:\?.*)?$/.test(endpoint.baseUrl)) {
+        return endpoint.baseUrl;
+    }
+    if (/\/v1\/?$/.test(endpoint.baseUrl)) {
+        return `${endpoint.baseUrl.replace(/\/$/, "")}/chat/completions`;
+    }
+    return `${endpoint.baseUrl.replace(/\/$/, "")}/v1/chat/completions`;
+};
+const buildRequestBody = (endpoint, capsule) => {
+    const payload = buildUserPayload(capsule);
+    if (endpoint.kind === "anthropic") {
+        return {
+            model: endpoint.model,
+            max_tokens: 512,
+            system: SYSTEM_PROMPT,
+            messages: [{ role: "user", content: payload }],
+            temperature: 0
+        };
+    }
+    if (endpoint.kind === "gemini") {
+        return {
+            system_instruction: {
+                parts: [{ text: SYSTEM_PROMPT }]
+            },
+            contents: [{ role: "user", parts: [{ text: payload }] }],
+            generationConfig: {
+                temperature: 0,
+                responseMimeType: "application/json"
+            }
+        };
+    }
+    if (endpoint.kind === "bedrock") {
+        return {
+            system: [{ text: SYSTEM_PROMPT }],
+            messages: [{ role: "user", content: [{ text: payload }] }],
+            inferenceConfig: {
+                maxTokens: 512,
+                temperature: 0
+            }
+        };
+    }
+    return {
+        model: endpoint.model,
+        response_format: { type: "json_object" },
+        messages: [
+            { role: "system", content: SYSTEM_PROMPT },
+            { role: "user", content: payload }
+        ],
+        temperature: 0
+    };
+};
+const parseResponseContent = async (endpoint, response) => {
+    if (endpoint.kind === "anthropic") {
+        const payload = (await response.json());
+        const textBlock = payload.content?.find((entry) => entry.type === "text" && typeof entry.text === "string");
+        if (!textBlock?.text) {
+            throw new Error("Explain response did not include a text payload");
+        }
+        return textBlock.text;
+    }
+    if (endpoint.kind === "gemini") {
+        const payload = (await response.json());
+        const text = payload.candidates?.[0]?.content?.parts?.find((entry) => typeof entry.text === "string")?.text;
+        if (!text) {
+            throw new Error("Explain response did not include a Gemini text payload");
+        }
+        return text;
+    }
+    if (endpoint.kind === "bedrock") {
+        const payload = (await response.json());
+        const text = payload.output?.message?.content?.find((entry) => typeof entry.text === "string")?.text;
+        if (!text) {
+            throw new Error("Explain response did not include a Bedrock text payload");
+        }
+        return text;
+    }
+    const payload = (await response.json());
+    const content = payload.choices?.[0]?.message?.content;
+    if (!content) {
+        throw new Error("Explain response did not include a message payload");
+    }
+    return content;
+};
+const normalizeConfidence = (value) => {
+    if (typeof value === "string" && (value === "high" || value === "medium" || value === "low")) {
+        return value;
+    }
+    const numeric = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim().length > 0
+            ? Number(value)
+            : Number.NaN;
+    if (Number.isNaN(numeric)) {
+        return value;
+    }
+    if (numeric >= 0.8) {
+        return "high";
+    }
+    if (numeric >= 0.5) {
+        return "medium";
+    }
+    return "low";
+};
+export const runExplainDecisionLlmWorker = async (capsule, options) => {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const response = await fetchImpl(buildRequestUrl(options.endpoint), {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            ...options.endpoint.headers
+        },
+        body: JSON.stringify(buildRequestBody(options.endpoint, capsule))
+    });
+    if (!response.ok) {
+        throw new Error(`Explain worker failed with ${response.status}`);
+    }
+    const content = await parseResponseContent(options.endpoint, response);
+    const parsed = JSON.parse(content);
+    const validated = validateExplainDecisionOutput({
+        task: "explain_decision",
+        decision: parsed.decision,
+        reason: parsed.reason,
+        confidence: normalizeConfidence(parsed.confidence),
+        evidence_summary: parsed.evidence_summary
+    });
+    if (validated.status !== "accepted") {
+        throw new Error(validated.detail);
+    }
+    return validated.value;
+};
+//# sourceMappingURL=explain-decision-llm.js.map

package/dist/hybrid/workers/explain-decision-llm.js.map

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

package/dist/hybrid/workers/explain-decision.d.ts

@@ -0,0 +1,2 @@
+import type { ExplainDecisionCapsule, ExplainDecisionWorkerOutput } from "../types.js";
+export declare const runExplainDecisionWorker: (capsule: ExplainDecisionCapsule) => Promise<ExplainDecisionWorkerOutput>;

package/dist/hybrid/workers/explain-decision.js

@@ -0,0 +1,40 @@
+const explainDecisionSummary = (capsule) => {
+    const intervention = capsule.trusted.inspection.intervention;
+    if (intervention === "inject") {
+        return "ExperienceEngine injected reusable guidance for this task.";
+    }
+    if (intervention === "shadow" || intervention === "holdout") {
+        return "ExperienceEngine found reusable guidance but did not deliver it live.";
+    }
+    return "ExperienceEngine did not deliver guidance for this turn.";
+};
+const explainDecisionReason = (capsule) => {
+    const scorecard = capsule.trusted.scorecard;
+    if (capsule.trusted.inspection.intervention === "shadow") {
+        return "The match was usable, but this run stayed in a non-live delivery mode.";
+    }
+    if (capsule.trusted.inspection.intervention === "holdout") {
+        return "The match was usable, but delivery was withheld for evaluation.";
+    }
+    if (scorecard?.decisionReason === "mature_validated_candidate") {
+        return "The best candidate was already validated and strong enough to clear the fast path.";
+    }
+    if (scorecard?.mode === "inject_conservative") {
+        return "The best candidate looked promising, but ExperienceEngine kept delivery cautious until it has stronger runtime proof.";
+    }
+    return "The supplied route and evidence point to the current bounded ExperienceEngine decision.";
+};
+export const runExplainDecisionWorker = async (capsule) => ({
+    task: "explain_decision",
+    decision: explainDecisionSummary(capsule),
+    reason: explainDecisionReason(capsule),
+    confidence: capsule.trusted.inspection.intervention === "inject"
+        ? "high"
+        : capsule.trusted.inspection.intervention === "skip"
+            ? "medium"
+            : "low",
+    evidence_summary: [...new Set(capsule.evidence.map((entry) => entry.source.replaceAll("_", " ")))]
+        .slice(0, 3)
+        .join(", ") || undefined
+});
+//# sourceMappingURL=explain-decision.js.map

package/dist/hybrid/workers/explain-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-decision.js","sourceRoot":"","sources":["../../../src/hybrid/workers/explain-decision.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,CAAC,OAA+B,EAAU,EAAE;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;IAC7D,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,4DAA4D,CAAC;IACtE,CAAC;IACD,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,uEAAuE,CAAC;IACjF,CAAC;IACD,OAAO,0DAA0D,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,OAA+B,EAAU,EAAE;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,wEAAwE,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,iEAAiE,CAAC;IAC3E,CAAC;IACD,IAAI,SAAS,EAAE,cAAc,KAAK,4BAA4B,EAAE,CAAC;QAC/D,OAAO,oFAAoF,CAAC;IAC9F,CAAC;IACD,IAAI,SAAS,EAAE,IAAI,KAAK,qBAAqB,EAAE,CAAC;QAC9C,OAAO,uHAAuH,CAAC;IACjI,CAAC;IAED,OAAO,yFAAyF,CAAC;AACnG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,OAA+B,EACO,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC;IACzC,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC;IACtC,UAAU,EACR,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,QAAQ;QAClD,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,KAAK,MAAM;YAClD,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,KAAK;IACb,gBAAgB,EACd,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;SAC7E,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;CAC7B,CAAC,CAAC"}

package/dist/hybrid/workers/postmortem-review-llm.d.ts

@@ -0,0 +1,8 @@
+import type { DistillerEndpoint } from "../../distillation/providers/types.js";
+import type { PostmortemReviewCapsule, PostmortemReviewWorkerOutput } from "../types.js";
+type PostmortemReviewLlmOptions = {
+    endpoint: DistillerEndpoint;
+    fetchImpl?: typeof fetch;
+};
+export declare const runPostmortemReviewLlmWorker: (capsule: PostmortemReviewCapsule, options: PostmortemReviewLlmOptions) => Promise<PostmortemReviewWorkerOutput>;
+export {};