sela-core 0.1.0-alpha.39 → 0.1.0-alpha.41

package/dist/engine/SelaEngine.js

@@ -47,6 +47,8 @@ const ASTSourceUpdater_1 = require("../services/ASTSourceUpdater");
 const SafetyGuard_1 = require("../services/SafetyGuard");
 const HealingCacheService_1 = require("../services/HealingCacheService");
 const ConfigLoader_1 = require("../config/ConfigLoader");
+const ProviderFactory_1 = require("../providers/ProviderFactory");
+const IntentAuditor_1 = require("../services/IntentAuditor");
 const DryRunGuard_1 = require("../config/DryRunGuard");
 const HealBudget_1 = require("../services/HealBudget");
 const HealReportService_1 = require("../services/HealReportService");
@@ -58,6 +60,7 @@ const SelaError_1 = require("../errors/SelaError");
 const SelaHealingRefusalError_1 = require("../errors/SelaHealingRefusalError");
 const FileWriteInterceptor_1 = require("../services/interceptors/FileWriteInterceptor");
 const SelectorSanitizer_1 = require("../services/SelectorSanitizer");
+const VisualSnapshotService_1 = require("../services/VisualSnapshotService");
 /**
  * Graceful percentage formatter for engine-side log lines. Mirrors the helper
  * in PRAutomationService / HealReportService so a missing AI/auditor
@@ -113,13 +116,24 @@ class SelaEngine {
     // immediate in-memory hit without a second LLM round-trip or any page.evaluate
     // call (which would fail when the page is already closed, e.g. unawaited promises).
     bypassedSelectorCache = new Map();
+    // NO_HEAL cache: elementSelectorOnly → reason. Once a selector is identified
+    // as an application logic/state failure (not selector drift) in this run,
+    // all subsequent heal() calls for the same selector skip LLM entirely.
+    noHealCache = new Map();
     constructor() {
         this.config = ConfigLoader_1.ConfigLoader.getInstance();
         // Seed the per-run heal budget (T2). null => unlimited.
         HealBudget_1.sharedHealBudget.configure(this.config.maxHealsPerRun);
-        this.llmService = new LLMService_1.LLMService();
+        // Build provider-abstracted LLM clients from resolved config.
+        // Each model can point to a different provider / endpoint.
+        const healingProvider = (0, ProviderFactory_1.createProvider)(this.config.llm.healingModel, this.config.sanitization);
+        const auditProvider = (0, ProviderFactory_1.createProvider)(this.config.llm.intentAuditModel, this.config.sanitization);
+        this.llmService = new LLMService_1.LLMService({ provider: healingProvider });
         this.snapshotService = new SnapshotService_1.SnapshotService();
-        this.safetyGuard = new SafetyGuard_1.SafetyGuard(this.config.thresholds);
+        this.safetyGuard = new SafetyGuard_1.SafetyGuard({
+            thresholds: this.config.thresholds,
+            intentAuditor: new IntentAuditor_1.IntentAuditor({ provider: auditProvider }),
+        });
         this.fileWriteInterceptor = new FileWriteInterceptor_1.FileWriteInterceptor(this.config.thresholds.vectorThresholds ?? null);
         // Dedicated lightweight ts-morph project used only for the leading-comment
         // pre-scan. Keeping it separate from the SourceUpdater's project avoids
@@ -243,6 +257,30 @@ CRITICAL: Do NOT return a CSS selector like "#my-select". Return plain text only
             }
             throw directiveErr;
         }
+        // ── NO_HEAL cache pre-check ──────────────────────────────────────────
+        // If this selector was already identified as an application logic/state
+        // failure in this run, skip LLM, DNA load, and DOM extraction entirely.
+        // One LLM call pays for 50+ identical state-bug failures in large suites.
+        const cachedNoHealReason = this.noHealCache.get(elementSelectorOnly);
+        if (cachedNoHealReason !== undefined) {
+            logger_1.logger.warn(`[Sela] NO_HEAL cache hit — skipping LLM: ${cachedNoHealReason}`);
+            HealReportService_1.sharedHealReport.record({
+                kind: "FAILED",
+                stableId,
+                deterministicKey: (0, HealReportService_1.computeEventDeterministicKey)(reportFile, line, elementSelectorOnly),
+                sourceFile: reportFile,
+                sourceLine: line,
+                testTitle,
+                timestamp: new Date().toISOString(),
+                framePath: [],
+                inIframe: false,
+                inShadowDom: false,
+                oldSelector: elementSelectorOnly,
+                reason: `NO_HEAL (cached) — ${cachedNoHealReason}`,
+                dnaBefore: null,
+            });
+            return "";
+        }
         // Snapshot for report event context (loaded once below, used at all exit paths).
         let lastKnownStateForReport = null;
         let aiFixForReport = null;
@@ -370,6 +408,61 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 });
             }
             aiFixForReport = aiFix;
+            // ── NO_HEAL gate ──────────────────────────────────────────────────
+            // LLM detected the failure is an application logic/state bug, not
+            // selector drift. Surface the native Playwright error without any
+            // AST mutation. Populate the noHealCache so subsequent calls for
+            // the same selector skip the LLM entirely.
+            if (aiFix?.status === "NO_HEAL") {
+                const noHealReason = aiFix.reason ?? "LLM detected application logic/state mismatch";
+                logger_1.logger.warn(`[Sela] Heal BLOCKED (NO_HEAL): ${noHealReason}`);
+                this.noHealCache.set(elementSelectorOnly, noHealReason);
+                HealReportService_1.sharedHealReport.record({
+                    kind: "FAILED",
+                    stableId,
+                    deterministicKey: (0, HealReportService_1.computeEventDeterministicKey)(reportFile, line, elementSelectorOnly),
+                    sourceFile: reportFile,
+                    sourceLine: line,
+                    testTitle,
+                    timestamp: new Date().toISOString(),
+                    framePath: [],
+                    inIframe: false,
+                    inShadowDom: false,
+                    oldSelector: elementSelectorOnly,
+                    reason: `NO_HEAL — ${noHealReason}`,
+                    dnaBefore: (0, HealReportService_1.summariseSnapshot)(lastKnownStateForReport),
+                });
+                return "";
+            }
+            // ── Sub-threshold confidence gate ─────────────────────────────────
+            // confidence 1–19 = SEMANTIC MISMATCH per the LLM rubric. A proposed
+            // selector with near-zero semantic correlation to the original must
+            // never reach AST mutation. Record a FailedEvent with the exact reason
+            // so CI reports show WHY the heal was blocked.
+            if (aiFix?.status === "FIXED" &&
+                aiFix.confidence !== undefined &&
+                aiFix.confidence < 20) {
+                const mismatchReason = `Semantic Mismatch blocked — confidence ${aiFix.confidence}/100 < threshold 20. ` +
+                    `Proposed: "${aiFix.new_selector ?? "unknown"}". ` +
+                    `Original intent preserved. Check application state for functional regression.`;
+                logger_1.logger.warn(`[Sela] Heal BLOCKED (SEMANTIC_MISMATCH): ${mismatchReason}`);
+                HealReportService_1.sharedHealReport.record({
+                    kind: "FAILED",
+                    stableId,
+                    deterministicKey: (0, HealReportService_1.computeEventDeterministicKey)(reportFile, line, elementSelectorOnly),
+                    sourceFile: reportFile,
+                    sourceLine: line,
+                    testTitle,
+                    timestamp: new Date().toISOString(),
+                    framePath: [],
+                    inIframe: false,
+                    inShadowDom: false,
+                    oldSelector: elementSelectorOnly,
+                    reason: `SEMANTIC_MISMATCH — ${mismatchReason}`,
+                    dnaBefore: (0, HealReportService_1.summariseSnapshot)(lastKnownStateForReport),
+                });
+                return "";
+            }
             if (aiFix && aiFix.status === "FIXED") {
                 logger_1.logger.debug("Step 3: AI responded");
                 // ── Build new selector ────────────────────────────────────
@@ -423,6 +516,41 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 else {
                     logger_1.logger.debug("Step 3.6: live v2 capture skipped");
                 }
+                // ── Step 3.7: Visual element screenshot (async write, heal-only) ─
+                // Capture is fired here while the page is still stable and the healed
+                // selector is confirmed.  Disk I/O is non-blocking.  The result is
+                // attached to the HealedEvent below and, on success, stored in the
+                // DNA record so subsequent heals can show the previous baseline.
+                const _vsKey = (0, VisualSnapshotService_1.snapshotKey)(filePath, stableId);
+                const _vsCandDest = (0, VisualSnapshotService_1.candidateSnapshotPath)(process.cwd(), _vsKey);
+                let _vsCapture = { elementFound: false, capturedAt: null };
+                let _vsLiveRelPath = null;
+                let _vsDnaRelPath = null;
+                let _vsDnaCapturedAt = null;
+                try {
+                    _vsCapture = await (0, VisualSnapshotService_1.captureElementScreenshot)(page, elementOnlySelector, successfulPath, _vsCandDest);
+                    if (_vsCapture.elementFound) {
+                        const _baselineAbsPath = (0, VisualSnapshotService_1.baselineSnapshotPath)(process.cwd(), _vsKey);
+                        if (isCiEnvironment()) {
+                            // CI: keep candidate alongside baseline so the report shows before/after.
+                            _vsLiveRelPath = path.relative(process.cwd(), _vsCandDest).replace(/\\/g, "/");
+                            if (fs.existsSync(_baselineAbsPath)) {
+                                _vsDnaRelPath = path.relative(process.cwd(), _baselineAbsPath).replace(/\\/g, "/");
+                                _vsDnaCapturedAt = lastKnownState?.visualSnapshot?.capturedAt ?? null;
+                            }
+                        }
+                        else {
+                            // Local: immediately overwrite baseline → only 1 file ever exists.
+                            (0, VisualSnapshotService_1.promoteCandidateToBaseline)(process.cwd(), _vsKey);
+                            _vsLiveRelPath = path.relative(process.cwd(), _baselineAbsPath).replace(/\\/g, "/");
+                            // Before-image is gone (overwritten); suppress the before slot.
+                            _vsDnaRelPath = null;
+                        }
+                    }
+                }
+                catch {
+                    // Never block the heal on screenshot failures.
+                }
                 // ── Safety: delegate all go/no-go decisions to SafetyGuard ─
                 const branch = ConfigLoader_1.ConfigLoader.getBranch() ?? undefined;
                 const safetyDecision = await this.safetyGuard.evaluate({ mode: healMode, branch }, {
@@ -837,6 +965,17 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     status: "healed",
                     definitionSite: updateResult.definitionSite,
                     blastRadius: updateResult.blastRadius,
+                    // Store the planned dna path so the next heal cycle can read the
+                    // baseline timestamp.  The image is physically at liveSnapshotPath
+                    // until runCleanRoom() promotes it.
+                    visualSnapshot: _vsCapture.elementFound && _vsCapture.capturedAt
+                        ? {
+                            path: path
+                                .relative(process.cwd(), (0, VisualSnapshotService_1.baselineSnapshotPath)(process.cwd(), _vsKey))
+                                .replace(/\\/g, "/"),
+                            capturedAt: _vsCapture.capturedAt,
+                        }
+                        : undefined,
                 });
                 // ── Report: HEALED event ───────────────────────────────────────
                 const healedEvent = {
@@ -878,6 +1017,13 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     definitionSite: updateResult.definitionSite,
                     contentChange: aiFix.contentChange,
                     confidenceVectors: safetyDecision.meta?.confidenceVectors,
+                    visualDiff: {
+                        dnaSnapshotPath: _vsDnaRelPath,
+                        liveSnapshotPath: _vsLiveRelPath,
+                        dnaSnapshotCapturedAt: _vsDnaCapturedAt,
+                        liveSnapshotCapturedAt: _vsCapture.capturedAt,
+                        elementFound: _vsCapture.elementFound,
+                    },
                 };
                 HealReportService_1.sharedHealReport.record(healedEvent);
                 // ── Cache write - persist this safe heal for future sessions ──
@@ -1378,7 +1524,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
     // Replaces the previous DOMUtils.getElementDNA() path with a single
     // captureElement() call that collects all v2 metrics atomically.
     // ─────────────────────────────────────────────────────────────
-    async captureSuccessfulElement(page, selector, stableId) {
+    async captureSuccessfulElement(page, selector, stableId, sourceFile) {
         try {
             const snapshot = await this.snapshotService.captureElement(page, selector);
             if (snapshot) {
@@ -1390,11 +1536,55 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 };
                 this.dnaBuffer.set(stableId, enriched);
                 logger_1.logger.debug(`DNA v2 captured for: ${stableId}`);
+                // ── Visual baseline capture (guarded) ─────────────────────
+                // Local only: capture a PNG baseline when the file is missing or the
+                // DOM snapshot changed.  CI is read-only — baselines are committed
+                // from local dev and must not be regenerated during CI test runs.
+                if (sourceFile && !isCiEnvironment()) {
+                    try {
+                        const vsKey = (0, VisualSnapshotService_1.snapshotKey)(sourceFile, stableId);
+                        const baseDest = (0, VisualSnapshotService_1.baselineSnapshotPath)(process.cwd(), vsKey);
+                        const baseStat = fs.existsSync(baseDest) ? fs.statSync(baseDest) : null;
+                        const pngMissing = !baseStat || baseStat.size === 0;
+                        let needsCapture = pngMissing;
+                        if (!pngMissing) {
+                            // load() reads from disk — commitUpdates() hasn't run yet,
+                            // so this returns the snapshot from the PREVIOUS run.
+                            const prevSnap = await this.snapshotService.load(stableId);
+                            needsCapture =
+                                !prevSnap ||
+                                    SelaEngine._snapshotFingerprint(prevSnap) !==
+                                        SelaEngine._snapshotFingerprint(enriched);
+                        }
+                        if (needsCapture) {
+                            const candDest = (0, VisualSnapshotService_1.candidateSnapshotPath)(process.cwd(), vsKey);
+                            const result = await (0, VisualSnapshotService_1.captureElementScreenshot)(page, selector, [], candDest);
+                            if (result.elementFound) {
+                                (0, VisualSnapshotService_1.promoteCandidateToBaseline)(process.cwd(), vsKey);
+                                logger_1.logger.debug(`Visual baseline ${pngMissing ? "created" : "refreshed"}: ${vsKey}`);
+                            }
+                        }
+                    }
+                    catch (vsErr) {
+                        logger_1.logger.debug(`Visual baseline skipped: ${vsErr.message}`);
+                    }
+                }
             }
         }
         catch (error) {
             logger_1.logger.debug(`DNA capture skipped: ${error.message}`);
         }
     }
+    // Stable fingerprint of DOM-visible fields only (excludes timestamps, rect,
+    // and metadata). Used to decide whether the visual PNG baseline needs refresh.
+    static _snapshotFingerprint(s) {
+        return JSON.stringify({
+            tagName: s.tagName,
+            text: s.text,
+            role: s.role,
+            classes: [...(s.classes ?? [])].sort(),
+            attributes: Object.fromEntries(Object.entries(s.attributes ?? {}).sort()),
+        });
+    }
 }
 exports.SelaEngine = SelaEngine;

package/dist/errors/SelaError.d.ts

@@ -150,4 +150,11 @@ export declare const CHAIN_VALIDATOR_CODES: {
     readonly SEMANTIC_DOWNGRADE: "CV_SEMANTIC_DOWNGRADE";
 };
 export type ChainValidatorCode = (typeof CHAIN_VALIDATOR_CODES)[keyof typeof CHAIN_VALIDATOR_CODES];
+export declare const ENGINE_CODES: {
+    /** LLM determined the failure is an application logic/state bug, not selector drift. */
+    readonly NO_HEAL_APP_LOGIC: "ENG_NO_HEAL_APP_LOGIC";
+    /** LLM returned a selector containing dynamic expressions — static-output contract violated. */
+    readonly DYNAMIC_OUTPUT_BLOCKED: "ENG_DYNAMIC_OUTPUT_BLOCKED";
+};
+export type EngineCode = (typeof ENGINE_CODES)[keyof typeof ENGINE_CODES];
 //# sourceMappingURL=SelaError.d.ts.map

package/dist/errors/SelaError.d.ts.map

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

package/dist/errors/SelaError.js

@@ -13,7 +13,7 @@
 // Public message regex (used by tests/unit/engine/error-indicativity.test.ts):
 //   /^\[Sela-(SafetyGuard|IntentAuditor|ASTUpdater|Proxy|LLMService|Registry|ChainValidator|Engine)\] [A-Z][A-Z0-9_]+: .+$/
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHAIN_VALIDATOR_CODES = exports.REPORT_CODES = exports.REGISTRY_CODES = exports.PROXY_CODES = exports.AST_UPDATER_CODES = exports.LLM_SERVICE_CODES = exports.INTENT_AUDITOR_CODES = exports.SAFETY_GUARD_CODES = exports.SelaError = void 0;
+exports.ENGINE_CODES = exports.CHAIN_VALIDATOR_CODES = exports.REPORT_CODES = exports.REGISTRY_CODES = exports.PROXY_CODES = exports.AST_UPDATER_CODES = exports.LLM_SERVICE_CODES = exports.INTENT_AUDITOR_CODES = exports.SAFETY_GUARD_CODES = exports.SelaError = void 0;
 exports.isSelaError = isSelaError;
 exports.isSelaErrorFrom = isSelaErrorFrom;
 // ───────────────────────────────────────────────────────────────────
@@ -173,3 +173,9 @@ exports.CHAIN_VALIDATOR_CODES = {
     PLACEMENT: "CV_PLACEMENT",
     SEMANTIC_DOWNGRADE: "CV_SEMANTIC_DOWNGRADE",
 };
+exports.ENGINE_CODES = {
+    /** LLM determined the failure is an application logic/state bug, not selector drift. */
+    NO_HEAL_APP_LOGIC: "ENG_NO_HEAL_APP_LOGIC",
+    /** LLM returned a selector containing dynamic expressions — static-output contract violated. */
+    DYNAMIC_OUTPUT_BLOCKED: "ENG_DYNAMIC_OUTPUT_BLOCKED",
+};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAqCpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAI/D;AAgoBD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,WAAW,EAAE,MAAM,GAClB,GAAG,CAuCL;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,GAAG,CAiPL;AAQD,eAAO,MAAM,IAAI;YAEL,UAAU,CAAC,OAAO,mBAAmB,CAAC;;IAG9C;;;;;;;;;;;;;OAaG;0BACmB,IAAI;EAmI5B,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAK/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAuCpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAI/D;AAgoBD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,WAAW,EAAE,MAAM,GAClB,GAAG,CAuCL;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,GAAG,CAiPL;AAQD,eAAO,MAAM,IAAI;YAEL,UAAU,CAAC,OAAO,mBAAmB,CAAC;;IAG9C;;;;;;;;;;;;;OAaG;0BACmB,IAAI;EAmI5B,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/fixtures/index.js

@@ -58,11 +58,12 @@ function regressionInjector() {
     if (_regressionInjector !== undefined)
         return _regressionInjector;
     const active = process.env["SELA_REGRESSION_ACTIVE"];
-    const manifestPath = process.env["SELA_REGRESSION_MANIFEST"];
-    if (active?.trim().toLowerCase() !== "true" || !manifestPath) {
+    if (active?.trim().toLowerCase() !== "true") {
         _regressionInjector = null;
         return null;
     }
+    const manifestPath = process.env["SELA_REGRESSION_MANIFEST"] ??
+        path.join(process.cwd(), ".sela", RegressionManifestService_1.REGRESSION_MANIFEST_FILE);
     try {
         _regressionInjector = RegressionManifestService_1.RegressionInjector.fromFile(manifestPath);
         logger_1.logger.debug(`Shadow-regression injector loaded from ${manifestPath}`);
@@ -325,7 +326,7 @@ async function runWithHeal(rawPage, prop, args, fullSelector, elementSelectorOnl
         // can pass an explicit timeout in their test code; buildHealedArgs
         // respects an existing timeout object if present.
         const callArgs = buildHealedArgs(prop, args, 3000);
-        await singleton_1.sharedEngine.captureSuccessfulElement(rawPage, effectiveSelector, stableId);
+        await singleton_1.sharedEngine.captureSuccessfulElement(rawPage, effectiveSelector, stableId, callerInfo.filePath);
         const result = await initialLocator[prop](...callArgs);
         return {
             result,
@@ -376,7 +377,7 @@ async function runWithHealSelector(rawPage, prop, args, fullSelector, elementSel
     // We just need to build the locator for THIS call-site's retry.
     const healedLocator = buildLiveLocator(rawPage, newFullSelector);
     try {
-        await singleton_1.sharedEngine.captureSuccessfulElement(rawPage, newFullSelector, stableId);
+        await singleton_1.sharedEngine.captureSuccessfulElement(rawPage, newFullSelector, stableId, callerInfo.filePath);
         const result = await healedLocator[prop](...buildHealedArgs(prop, args, 8000));
         return {
             result,

package/dist/providers/AnthropicProvider.d.ts

@@ -0,0 +1,9 @@
+import Anthropic from "@anthropic-ai/sdk";
+import type { LLMProvider, CompletionParams } from "./LLMProvider";
+export declare class AnthropicProvider implements LLMProvider {
+    private readonly modelId;
+    private readonly client;
+    constructor(modelId: string, apiKeyOrClient: string | Anthropic);
+    complete(params: CompletionParams): Promise<string>;
+}
+//# sourceMappingURL=AnthropicProvider.d.ts.map

package/dist/providers/AnthropicProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicProvider.d.ts","sourceRoot":"","sources":["../../src/providers/AnthropicProvider.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,qBAAa,iBAAkB,YAAW,WAAW;IAIjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAGhB,OAAO,EAAE,MAAM,EAChC,cAAc,EAAE,MAAM,GAAG,SAAS;IAQ9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAU1D"}

package/dist/providers/AnthropicProvider.js

@@ -0,0 +1,33 @@
+"use strict";
+// src/providers/AnthropicProvider.ts
+// LLMProvider adapter for the Anthropic SDK (@anthropic-ai/sdk).
+// Accepts either an API key string (creates a fresh client) or a pre-built
+// Anthropic instance (used by legacy code-paths and tests that inject a mock).
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+class AnthropicProvider {
+    modelId;
+    client;
+    constructor(modelId, apiKeyOrClient) {
+        this.modelId = modelId;
+        this.client =
+            typeof apiKeyOrClient === "string"
+                ? new sdk_1.default({ apiKey: apiKeyOrClient })
+                : apiKeyOrClient;
+    }
+    async complete(params) {
+        const msg = await this.client.messages.create({
+            model: this.modelId,
+            max_tokens: params.maxTokens ?? 1024,
+            ...(params.temperature !== undefined && { temperature: params.temperature }),
+            system: params.system,
+            messages: params.messages,
+        });
+        return msg.content[0]?.type === "text" ? msg.content[0].text : "";
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;

package/dist/providers/LLMProvider.d.ts

@@ -0,0 +1,13 @@
+export interface CompletionParams {
+    system?: string;
+    messages: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    maxTokens?: number;
+    temperature?: number;
+}
+export interface LLMProvider {
+    complete(params: CompletionParams): Promise<string>;
+}
+//# sourceMappingURL=LLMProvider.d.ts.map

package/dist/providers/LLMProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMProvider.d.ts","sourceRoot":"","sources":["../../src/providers/LLMProvider.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD"}

package/dist/providers/LLMProvider.js

@@ -0,0 +1,7 @@
+"use strict";
+// src/providers/LLMProvider.ts
+// Provider-agnostic interface for LLM text completion.
+// All AI calls in Sela (healing + intent audit) route through this contract
+// so the engine never cares whether it's talking to Claude, GPT-4o, or a
+// self-hosted local model behind an OpenAI-compatible endpoint.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/providers/OpenAICompatibleProvider.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider, CompletionParams } from "./LLMProvider";
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    private readonly modelId;
+    private readonly client;
+    constructor(modelId: string, apiKey: string, baseUrl?: string, customHeaders?: Record<string, string>, disableSslVerification?: boolean, timeoutMs?: number);
+    complete(params: CompletionParams): Promise<string>;
+}
+//# sourceMappingURL=OpenAICompatibleProvider.d.ts.map

package/dist/providers/OpenAICompatibleProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAICompatibleProvider.d.ts","sourceRoot":"","sources":["../../src/providers/OpenAICompatibleProvider.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,qBAAa,wBAAyB,YAAW,WAAW;IAIxD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,OAAO,EAAE,MAAM,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,sBAAsB,CAAC,EAAE,OAAO,EAChC,SAAS,CAAC,EAAE,MAAM;IAgBd,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAmB1D"}

package/dist/providers/OpenAICompatibleProvider.js

@@ -0,0 +1,48 @@
+"use strict";
+// src/providers/OpenAICompatibleProvider.ts
+// LLMProvider adapter for any OpenAI-compatible HTTP endpoint.
+// Covers: OpenAI SaaS, local LM Studio / Ollama, vLLM, Together AI,
+// and air-gapped internal clusters reachable at a custom base URL.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAICompatibleProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+const https_1 = __importDefault(require("https"));
+class OpenAICompatibleProvider {
+    modelId;
+    client;
+    constructor(modelId, apiKey, baseUrl, customHeaders, disableSslVerification, timeoutMs) {
+        this.modelId = modelId;
+        this.client = new openai_1.default({
+            // Local servers often have no real key — "local" is a safe sentinel.
+            apiKey: apiKey || "local",
+            baseURL: baseUrl,
+            defaultHeaders: customHeaders,
+            ...(timeoutMs !== undefined && { timeout: timeoutMs }),
+            // Air-gapped corporate proxies may use self-signed certs.
+            // Only skip verification when the user explicitly opts in.
+            ...(disableSslVerification && {
+                httpAgent: new https_1.default.Agent({ rejectUnauthorized: false }),
+            }),
+        });
+    }
+    async complete(params) {
+        const messages = [];
+        if (params.system) {
+            messages.push({ role: "system", content: params.system });
+        }
+        for (const m of params.messages) {
+            messages.push({ role: m.role, content: m.content });
+        }
+        const res = await this.client.chat.completions.create({
+            model: this.modelId,
+            max_tokens: params.maxTokens ?? 1024,
+            ...(params.temperature !== undefined && { temperature: params.temperature }),
+            messages,
+        });
+        return res.choices[0]?.message?.content ?? "";
+    }
+}
+exports.OpenAICompatibleProvider = OpenAICompatibleProvider;

package/dist/providers/ProviderFactory.d.ts

@@ -0,0 +1,4 @@
+import type { LLMProvider } from "./LLMProvider";
+import type { ResolvedLLMModelConfig, ResolvedSanitization } from "../config/SelaConfig";
+export declare function createProvider(cfg: ResolvedLLMModelConfig, sanitization?: ResolvedSanitization): LLMProvider;
+//# sourceMappingURL=ProviderFactory.d.ts.map

package/dist/providers/ProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactory.d.ts","sourceRoot":"","sources":["../../src/providers/ProviderFactory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIzF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,sBAAsB,EAC3B,YAAY,CAAC,EAAE,oBAAoB,GAClC,WAAW,CAab"}

package/dist/providers/ProviderFactory.js

@@ -0,0 +1,50 @@
+"use strict";
+// src/providers/ProviderFactory.ts
+// Single entry-point for constructing LLMProvider instances from config.
+// Wraps the created provider in SanitizingProvider when PII masking is enabled.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProvider = createProvider;
+const AnthropicProvider_1 = require("./AnthropicProvider");
+const OpenAICompatibleProvider_1 = require("./OpenAICompatibleProvider");
+const SanitizingProvider_1 = require("./SanitizingProvider");
+const Sanitizer_1 = require("../services/Sanitizer");
+const SelaError_1 = require("../errors/SelaError");
+function createProvider(cfg, sanitization) {
+    const inner = buildInnerProvider(cfg);
+    if (!sanitization || !sanitization.enabled)
+        return inner;
+    const patterns = (0, Sanitizer_1.compileCustomPatterns)(sanitization.customPatterns ?? []);
+    const scrub = (s) => (0, Sanitizer_1.sanitizeText)(s, {
+        redactInputValues: sanitization.redactInputValues,
+        customPatterns: patterns,
+    });
+    return new SanitizingProvider_1.SanitizingProvider(inner, scrub);
+}
+function buildInnerProvider(cfg) {
+    switch (cfg.provider) {
+        case "anthropic": {
+            // Fall back to process.env at provider-construction time so SelaEngine
+            // integration tests that stub ConfigLoader with an empty env still work,
+            // and so that legacy `ANTHROPIC_API_KEY` env usage is preserved.
+            const key = cfg.apiKey || process.env.ANTHROPIC_API_KEY || "";
+            if (!key) {
+                throw new SelaError_1.SelaError({
+                    subsystem: "LLMService",
+                    code: SelaError_1.LLM_SERVICE_CODES.NO_API_KEY,
+                    reason: "No API key for Anthropic provider. Set ANTHROPIC_API_KEY or provide llm.healingModel.apiKey in sela.config.ts.",
+                });
+            }
+            return new AnthropicProvider_1.AnthropicProvider(cfg.modelId, key);
+        }
+        case "openai":
+        case "openai-compatible":
+        case "local":
+            return new OpenAICompatibleProvider_1.OpenAICompatibleProvider(cfg.modelId, cfg.apiKey, cfg.baseUrl, cfg.customHeaders, cfg.disableSslVerification, cfg.timeoutMs);
+        default:
+            throw new SelaError_1.SelaError({
+                subsystem: "LLMService",
+                code: SelaError_1.LLM_SERVICE_CODES.NO_API_KEY,
+                reason: `Unknown LLM provider: "${cfg.provider}". Valid values: anthropic, openai, openai-compatible, local.`,
+            });
+    }
+}

package/dist/providers/SanitizingProvider.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider, CompletionParams } from "./LLMProvider";
+export declare class SanitizingProvider implements LLMProvider {
+    private readonly inner;
+    private readonly scrub;
+    constructor(inner: LLMProvider, scrub: (s: string) => string);
+    complete(params: CompletionParams): Promise<string>;
+}
+//# sourceMappingURL=SanitizingProvider.d.ts.map

package/dist/providers/SanitizingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SanitizingProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SanitizingProvider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,qBAAa,kBAAmB,YAAW,WAAW;IAElD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM;IAGzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAU1D"}

package/dist/providers/SanitizingProvider.js

@@ -0,0 +1,27 @@
+"use strict";
+// src/providers/SanitizingProvider.ts
+// LLMProvider decorator that scrubs PII/secrets from every outbound
+// completion request before delegating to the inner provider.
+// This is the provider-layer equivalent of the legacy SanitizingAnthropic
+// wrapper — same guarantee, not tied to any specific SDK.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SanitizingProvider = void 0;
+class SanitizingProvider {
+    inner;
+    scrub;
+    constructor(inner, scrub) {
+        this.inner = inner;
+        this.scrub = scrub;
+    }
+    async complete(params) {
+        return this.inner.complete({
+            ...params,
+            system: params.system !== undefined ? this.scrub(params.system) : undefined,
+            messages: params.messages.map((m) => ({
+                ...m,
+                content: this.scrub(m.content),
+            })),
+        });
+    }
+}
+exports.SanitizingProvider = SanitizingProvider;

package/dist/services/ASTSourceUpdater.d.ts.map

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