@burtson-labs/stealth-core-runtime 1.4.7

package/dist/runtime/projectSummary.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeScanResponse = describeScanResponse;
+exports.buildProjectSummary = buildProjectSummary;
+function describeScanResponse(data) {
+    if (!data) {
+        return undefined;
+    }
+    const fileCount = Array.isArray(data.files) ? data.files.length : undefined;
+    const scripts = data.scripts && typeof data.scripts === 'object'
+        ? Object.keys(data.scripts).join(', ')
+        : '';
+    const parts = [];
+    if (typeof fileCount === 'number') {
+        parts.push(`${fileCount} files`);
+    }
+    if (scripts) {
+        parts.push(`scripts: ${scripts}`);
+    }
+    return parts.length > 0 ? parts.join('; ') : undefined;
+}
+function buildProjectSummary(data) {
+    if (!data) {
+        return 'Project metadata unavailable.';
+    }
+    const files = Array.isArray(data.files) ? data.files.slice(0, 10) : [];
+    const scripts = data.scripts && typeof data.scripts === 'object'
+        ? Object.keys(data.scripts)
+        : [];
+    const pkg = data.packageJson && typeof data.packageJson === 'object'
+        ? data.packageJson
+        : undefined;
+    const deps = pkg && typeof pkg.dependencies === 'object'
+        ? Object.keys(pkg.dependencies)
+        : [];
+    return [
+        files.length > 0 ? `Notable files: ${files.join(', ')}` : 'No files captured.',
+        scripts.length > 0 ? `Scripts: ${scripts.join(', ')}` : 'No npm scripts found.',
+        deps.length > 0 ? `Dependencies: ${deps.slice(0, 8).join(', ')}` : 'Dependencies not detected.'
+    ].join(' | ');
+}
+//# sourceMappingURL=projectSummary.js.map

package/dist/runtime/projectSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectSummary.js","sourceRoot":"","sources":["../../src/runtime/projectSummary.ts"],"names":[],"mappings":";;AAAA,oDAiBC;AAED,kDAsBC;AAzCD,SAAgB,oBAAoB,CAAC,IAAyC;IAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAC9C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAkC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAAyC;IAC3E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,+BAA+B,CAAC;IACzC,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAC9C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAkC,CAAC;QACtD,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,GAAG,GACP,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;QACtD,CAAC,CAAE,IAAI,CAAC,WAAuC;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GACR,GAAG,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;QACzC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAuC,CAAC;QAC1D,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB;QAC9E,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB;QAC/E,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,4BAA4B;KAChG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChB,CAAC"}

package/dist/runtime/providerSettings.d.ts

@@ -0,0 +1,28 @@
+import type { ProviderKind, ProviderSettings } from '../internalTypes';
+export declare const DEFAULT_OLLAMA_MODEL = "gemma3:12b";
+export declare const DEFAULT_OLLAMA_URL = "http://localhost:11434";
+export interface ProviderConfiguration {
+    get<T>(section: string, defaultValue: T): T;
+}
+export declare function getProviderKind(configuration: ProviderConfiguration): ProviderKind;
+export declare function getProviderModel(configuration: ProviderConfiguration, providerKind: ProviderKind): string;
+/**
+ * Returns the model ID to use for agent rewrite/coding tasks.
+ * When `banditStealth.agentOllamaModel` is set (Ollama provider only), that model
+ * is used instead of `ollamaModel`, allowing a separate coding model (e.g.
+ * `qwen2.5-coder:32b`) while keeping a different chat model (`bandit-core:27b-it-qat`).
+ * Falls back to `getProviderModel` when no agent-specific model is configured.
+ */
+export declare function getAgentProviderModel(configuration: ProviderConfiguration, providerKind: ProviderKind): string;
+export declare function buildProviderSettings(configuration: ProviderConfiguration, apiKey: string): ProviderSettings;
+/**
+ * Resolves the actual Ollama URL + headers the chat engine will use, mirroring
+ * the resolution in {@link ../banditEngineProvider.ts}. Shared so the model
+ * picker and other UI never show a different endpoint than chat actually hits.
+ */
+export declare function resolveOllamaEndpoint(configuration: ProviderConfiguration): {
+    url: string;
+    headers: Record<string, string>;
+    isNodeOverride: boolean;
+};
+//# sourceMappingURL=providerSettings.d.ts.map

package/dist/runtime/providerSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerSettings.d.ts","sourceRoot":"","sources":["../../src/runtime/providerSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;CAC7C;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,qBAAqB,GAAG,YAAY,CAIlF;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EACpC,YAAY,EAAE,YAAY,GACzB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EACpC,YAAY,EAAE,YAAY,GACzB,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,qBAAqB,EACpC,MAAM,EAAE,MAAM,GACb,gBAAgB,CAsBlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,qBAAqB,GAAG;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACzB,CAaA"}

package/dist/runtime/providerSettings.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_OLLAMA_URL = exports.DEFAULT_OLLAMA_MODEL = void 0;
+exports.getProviderKind = getProviderKind;
+exports.getProviderModel = getProviderModel;
+exports.getAgentProviderModel = getAgentProviderModel;
+exports.buildProviderSettings = buildProviderSettings;
+exports.resolveOllamaEndpoint = resolveOllamaEndpoint;
+exports.DEFAULT_OLLAMA_MODEL = 'gemma3:12b';
+exports.DEFAULT_OLLAMA_URL = 'http://localhost:11434';
+function getProviderKind(configuration) {
+    const rawProvider = configuration.get('provider', 'ollama');
+    const normalized = typeof rawProvider === 'string' ? rawProvider.trim().toLowerCase() : 'ollama';
+    return normalized === 'ollama' ? 'ollama' : 'bandit';
+}
+function getProviderModel(configuration, providerKind) {
+    if (providerKind === 'ollama') {
+        return configuration.get('ollamaModel', exports.DEFAULT_OLLAMA_MODEL) || exports.DEFAULT_OLLAMA_MODEL;
+    }
+    return configuration.get('model', 'bandit-core-1') || 'bandit-core-1';
+}
+/**
+ * Returns the model ID to use for agent rewrite/coding tasks.
+ * When `banditStealth.agentOllamaModel` is set (Ollama provider only), that model
+ * is used instead of `ollamaModel`, allowing a separate coding model (e.g.
+ * `qwen2.5-coder:32b`) while keeping a different chat model (`bandit-core:27b-it-qat`).
+ * Falls back to `getProviderModel` when no agent-specific model is configured.
+ */
+function getAgentProviderModel(configuration, providerKind) {
+    if (providerKind === 'ollama') {
+        const agentModel = configuration.get('agentOllamaModel', '');
+        if (agentModel)
+            return agentModel;
+        const codingModel = configuration.get('ollamaCodingModel', '');
+        if (codingModel)
+            return codingModel;
+    }
+    return getProviderModel(configuration, providerKind);
+}
+function buildProviderSettings(configuration, apiKey) {
+    const rawHeaders = configuration.get('ollamaHeaders', {}) || {};
+    const ollamaHeaders = sanitizeOllamaHeaders(rawHeaders);
+    return {
+        kind: getProviderKind(configuration),
+        apiKey,
+        apiUrl: configuration.get('apiUrl', 'https://api.burtson.ai/completions'),
+        // ollamaUrl: primary local endpoint (Mac localhost or LAN). Never RunPod.
+        // Accepts both ollamaUrl (legacy) and ollamaBaseUrl (new setting name).
+        ollamaUrl: configuration.get('ollamaBaseUrl', '') ||
+            configuration.get('ollamaUrl', exports.DEFAULT_OLLAMA_URL) ||
+            exports.DEFAULT_OLLAMA_URL,
+        // ollamaNodeUrl: optional secondary endpoint for external node (e.g. RTX 5090).
+        // When set, Ollama requests are routed here instead of ollamaUrl.
+        ollamaNodeUrl: configuration.get('ollamaNodeUrl', '') || undefined,
+        ollamaModel: configuration.get('ollamaModel', exports.DEFAULT_OLLAMA_MODEL) || exports.DEFAULT_OLLAMA_MODEL,
+        // ollamaHeaders: extra HTTP headers (Bearer token, Cloudflare Access, etc.).
+        // Undefined when empty so banditEngineProvider can skip the merge fast-path.
+        ollamaHeaders: Object.keys(ollamaHeaders).length > 0 ? ollamaHeaders : undefined
+    };
+}
+/**
+ * Resolves the actual Ollama URL + headers the chat engine will use, mirroring
+ * the resolution in {@link ../banditEngineProvider.ts}. Shared so the model
+ * picker and other UI never show a different endpoint than chat actually hits.
+ */
+function resolveOllamaEndpoint(configuration) {
+    const base = configuration.get('ollamaBaseUrl', '') ||
+        configuration.get('ollamaUrl', exports.DEFAULT_OLLAMA_URL) ||
+        exports.DEFAULT_OLLAMA_URL;
+    const nodeRaw = configuration.get('ollamaNodeUrl', '') ?? '';
+    const node = typeof nodeRaw === 'string' ? nodeRaw.trim() : '';
+    const rawUrl = node.length > 0 ? node : base;
+    const url = (rawUrl || exports.DEFAULT_OLLAMA_URL).replace(/\/+$/, '');
+    const headers = sanitizeOllamaHeaders(configuration.get('ollamaHeaders', {}) || {});
+    return { url, headers, isNodeOverride: node.length > 0 };
+}
+function sanitizeOllamaHeaders(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {};
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (!key || typeof key !== 'string')
+            continue;
+        if (key.toLowerCase() === 'content-type')
+            continue; // always forced to JSON
+        if (typeof value === 'string' && value.length > 0) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=providerSettings.js.map

package/dist/runtime/providerSettings.js.map

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

package/dist/runtime/pythonActions.d.ts

@@ -0,0 +1,78 @@
+import type { PlanStep, PythonScanProjectAction, PythonReadFileAction, PythonWriteFileAction, PythonRunCommandAction } from '../internalTypes';
+import type { HelperStepMetadata, AdditionalWrite, StepOutcome, StatusPayload, LogPayload, PythonResponse, IUndoManager } from '../internalTypes';
+export type PythonAction = PythonScanProjectAction | PythonReadFileAction | PythonWriteFileAction | PythonRunCommandAction;
+export interface PythonActionDeps {
+    ensureSession(): {
+        workspaceRoot: string;
+    };
+    getContextValue<T>(key: string): T | undefined;
+    setContextValue(key: string, value: unknown): void;
+    normalizeRelativePath(value: string): string | undefined;
+    getHelperStepMetadata(step: PlanStep | undefined): HelperStepMetadata | undefined;
+    resolveRootParam(ref?: string): string;
+    isDryRunEnabled(): boolean;
+    isPreviewOnly(): boolean;
+    telemetry: {
+        status(payload: StatusPayload): Promise<void>;
+        log(payload: LogPayload): Promise<void>;
+    };
+    embeddingCache: {
+        indexFiles(workspaceRoot: string, files: string[]): Promise<{
+            reused: number;
+            computed: number;
+        }>;
+    };
+    embeddingManager: {
+        scheduleEmbeddingUpsert(path: string, content: string): void;
+    };
+    postEmbeddingStatus(stats: {
+        reused: number;
+        computed: number;
+    }, total: number): Promise<void>;
+    captureExtractionSection(content: string): void;
+    buildProjectSummary(data: Record<string, unknown> | undefined): string;
+    describeScanResponse(data: Record<string, unknown> | undefined): string | undefined;
+    buildContentSample(content: string, maxLines?: number, maxLength?: number): string;
+    applyIncrementalEdits(original: string, content: string, relativePath: string): {
+        content: string;
+        replaced: number;
+        total: number;
+        confidence: number;
+    };
+    helperManager: {
+        applyImportHints(meta: HelperStepMetadata | undefined, content: string): string;
+    };
+    diffManager: {
+        registerPendingDiff(path: string, original: string, updated: string, confidence?: number): Promise<{
+            diff?: string;
+            summary?: {
+                added: number;
+                removed: number;
+            };
+            changed?: boolean;
+            confidence?: number;
+        }>;
+    };
+    additionalWriteManager: {
+        applyAdditionalWrites(config: {
+            workspaceRoot: string;
+            writes: AdditionalWrite[];
+            encoding: BufferEncoding;
+            dryRun: boolean;
+            stepId?: string;
+        }): Promise<Array<Record<string, unknown>>>;
+    };
+    undoManager: Pick<IUndoManager, 'createBackup' | 'capturePreWriteState' | 'recordSnapshot'>;
+    recordWriteContext(paths: (string | undefined)[], helperStep: boolean): void;
+    clearPendingWriteContext(): void;
+    pendingInferenceTracker: {
+        flagMissingFiles(relativePath: string, writes: AdditionalWrite[]): Promise<void>;
+    };
+    filterAdditionalWrites(raw: unknown, normalize: (value: string) => string | undefined): AdditionalWrite[];
+    resolveAdditionalWritesRef(action: PythonWriteFileAction): string | undefined;
+    runPython(action: string, payload: unknown): Promise<PythonResponse>;
+}
+export declare function createPythonActionExecutor(deps: PythonActionDeps): {
+    execute: (action: PythonAction, stepId?: string, step?: PlanStep) => Promise<StepOutcome>;
+};
+//# sourceMappingURL=pythonActions.d.ts.map

package/dist/runtime/pythonActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythonActions.d.ts","sourceRoot":"","sources":["../../src/runtime/pythonActions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,aAAa,EACb,UAAU,EACV,cAAc,EAEd,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,YAAY,GACpB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,IAAI;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/C,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzD,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAClF,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvC,eAAe,IAAI,OAAO,CAAC;IAC3B,aAAa,IAAI,OAAO,CAAC;IACzB,SAAS,EAAE;QACT,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzC,CAAC;IACF,cAAc,EAAE;QACd,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnG,CAAC;IACF,gBAAgB,EAAE;QAChB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9D,CAAC;IACF,mBAAmB,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC;IACvE,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACpF,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnF,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,aAAa,EAAE;QACb,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KACjF,CAAC;IACF,WAAW,EAAE;QACX,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrH,CAAC;IACF,sBAAsB,EAAE;QACtB,qBAAqB,CAAC,MAAM,EAAE;YAC5B,aAAa,EAAE,MAAM,CAAC;YACtB,MAAM,EAAE,eAAe,EAAE,CAAC;YAC1B,QAAQ,EAAE,cAAc,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC;YAChB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;KAC7C,CAAC;IACF,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,sBAAsB,GAAG,gBAAgB,CAAC,CAAC;IAC5F,kBAAkB,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7E,wBAAwB,IAAI,IAAI,CAAC;IACjC,uBAAuB,EAAE;QACvB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClF,CAAC;IACF,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,eAAe,EAAE,CAAC;IAC1G,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtE;AAoCD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB;sBAChC,YAAY,WAAW,MAAM,SAAS,QAAQ,KAAG,OAAO,CAAC,WAAW,CAAC;EAuWrG"}

package/dist/runtime/pythonActions.js

@@ -0,0 +1,392 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPythonActionExecutor = createPythonActionExecutor;
+const path = __importStar(require("path"));
+const coerceNumber = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+const coerceRewriteGuard = (value) => {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    const maxRemovedLineRatio = coerceNumber(record.maxRemovedLineRatio);
+    const maxChangedLineRatio = coerceNumber(record.maxChangedLineRatio);
+    const minOriginalLineCount = coerceNumber(record.minOriginalLineCount);
+    const reason = typeof record.reason === 'string' ? record.reason : undefined;
+    if (maxRemovedLineRatio === undefined && maxChangedLineRatio === undefined) {
+        return undefined;
+    }
+    return {
+        maxRemovedLineRatio,
+        maxChangedLineRatio,
+        minOriginalLineCount,
+        reason
+    };
+};
+const countLines = (value) => value.split(/\r\n|\r|\n/).length;
+const formatPercent = (ratio) => `${(ratio * 100).toFixed(1)}%`;
+function createPythonActionExecutor(deps) {
+    async function execute(action, stepId, step) {
+        const session = deps.ensureSession();
+        const helperMeta = deps.getHelperStepMetadata(step);
+        if (action.name === 'scanProject') {
+            const payload = {
+                root: deps.resolveRootParam(action.params?.rootRef),
+                maxDepth: action.params?.maxDepth ?? 5,
+                maxFiles: action.params?.maxFiles ?? 400,
+                includeExtensions: action.params?.includeExtensions ?? []
+            };
+            await deps.telemetry.status({
+                text: 'Scanning project files…',
+                phase: 'progress',
+                detail: `Root ${path.basename(payload.root)} (max ${payload.maxFiles} files)`,
+                stepId,
+                icon: 'search'
+            });
+            await deps.telemetry.log({
+                message: `Scanning project at ${payload.root} (depth ${payload.maxDepth}, max ${payload.maxFiles} files)…`,
+                stepId,
+                level: 'info'
+            });
+            const response = await deps.runPython('scanProject', payload);
+            if (response.status === 'SUCCESS' && action.storeKey) {
+                const storedData = {
+                    ...(response.data ?? {}),
+                    root: payload.root
+                };
+                deps.setContextValue(action.storeKey, storedData);
+                deps.setContextValue('project.root', payload.root);
+                deps.setContextValue('project.summary', deps.buildProjectSummary(response.data));
+            }
+            const files = Array.isArray(response.data?.files) ? response.data?.files : [];
+            if (files.length > 0) {
+                const indexedPaths = files.filter((file) => typeof file === 'string');
+                if (indexedPaths.length > 0) {
+                    const stats = await deps.embeddingCache.indexFiles(session.workspaceRoot, indexedPaths);
+                    deps.setContextValue('project.embeddingStats', { ...stats, total: indexedPaths.length, refreshedAt: Date.now() });
+                    await deps.telemetry.log({
+                        message: `Embedding cache hydrated — reused ${stats.reused}, computed ${stats.computed}.`,
+                        stepId,
+                        level: 'info'
+                    });
+                    await deps.postEmbeddingStatus(stats, indexedPaths.length).catch(() => undefined);
+                }
+            }
+            await deps.telemetry.log({
+                message: response.status === 'SUCCESS'
+                    ? `Project scan complete — indexed ${files.length} file${files.length === 1 ? '' : 's'}.`
+                    : `Project scan failed${response.error ? `: ${response.error}` : ''}`,
+                stepId,
+                level: response.status === 'SUCCESS' ? 'info' : 'error'
+            });
+            return {
+                ok: response.status === 'SUCCESS',
+                output: response.output ?? deps.describeScanResponse(response.data),
+                error: response.status === 'FAILED' ? response.error?.toString() : undefined,
+                data: response.data ? { storedKey: action.storeKey, ...response.data } : undefined
+            };
+        }
+        if (action.name === 'readFile') {
+            const relativePath = deps.getContextValue(action.pathRef);
+            if (!relativePath) {
+                return { ok: false, error: `Missing path for ${action.pathRef}` };
+            }
+            const payload = {
+                root: session.workspaceRoot,
+                path: relativePath,
+                encoding: action.encoding ?? 'utf-8'
+            };
+            const response = await deps.runPython('readFile', payload);
+            if (response.status === 'SUCCESS' && action.storeKey) {
+                deps.setContextValue(action.storeKey, response.data?.content ?? response.output ?? '');
+            }
+            const contentText = typeof response.data?.content === 'string' ? response.data.content : undefined;
+            const fetchedContent = contentText ?? (typeof response.output === 'string' ? response.output : '');
+            if (response.status === 'SUCCESS' && contentText) {
+                deps.embeddingManager.scheduleEmbeddingUpsert(relativePath, contentText);
+            }
+            if (response.status === 'SUCCESS' && action.storeKey === 'focus.primary.content') {
+                deps.captureExtractionSection(fetchedContent);
+                deps.setContextValue('focus.extract.sourcePath', relativePath);
+            }
+            return {
+                ok: response.status === 'SUCCESS',
+                output: response.status === 'SUCCESS' ? `Read ${relativePath}` : undefined,
+                error: response.status === 'FAILED' ? response.error?.toString() : undefined,
+                data: response.data
+                    ? {
+                        storedKey: action.storeKey,
+                        path: response.data.path,
+                        bytes: contentText?.length ?? 0,
+                        sample: contentText ? deps.buildContentSample(contentText) : undefined
+                    }
+                    : undefined
+            };
+        }
+        if (action.name === 'writeFile') {
+            const contextualPath = action.pathRef ? deps.getContextValue(action.pathRef) : undefined;
+            const helperPath = helperMeta?.helperPath;
+            const relativePath = helperPath ?? contextualPath;
+            const content = deps.getContextValue(action.contentRef);
+            const original = action.originalContentRef ? deps.getContextValue(action.originalContentRef) : undefined;
+            if (!relativePath || typeof content !== 'string') {
+                return { ok: false, error: 'Missing path or content for writeFile action.' };
+            }
+            const additionalWritesRef = deps.resolveAdditionalWritesRef(action);
+            const additionalWritesRaw = additionalWritesRef ? deps.getContextValue(additionalWritesRef) : undefined;
+            const additionalWrites = deps.filterAdditionalWrites(additionalWritesRaw, (value) => deps.normalizeRelativePath(value));
+            if (helperPath && additionalWrites.length > 0) {
+                additionalWrites[0] = { ...additionalWrites[0], path: helperPath };
+            }
+            const requiredFileEntries = Array.isArray(step?.metadata?.requiredFileEntries)
+                ? step?.metadata?.requiredFileEntries
+                : [];
+            if (requiredFileEntries.length > 0) {
+                const normalizedPrimary = (deps.normalizeRelativePath(relativePath) ?? relativePath).toLowerCase();
+                const requiredNormalized = requiredFileEntries
+                    .map((entry) => deps.normalizeRelativePath(entry) ?? entry)
+                    .filter((entry) => Boolean(entry))
+                    .map((entry) => entry.toLowerCase())
+                    .filter((entry) => entry !== normalizedPrimary);
+                if (requiredNormalized.length > 0) {
+                    const actualAdditional = new Map();
+                    for (const entry of additionalWrites) {
+                        const normalizedEntry = deps.normalizeRelativePath(entry.path) ?? entry.path;
+                        if (!normalizedEntry) {
+                            continue;
+                        }
+                        const contentValue = typeof entry.content === 'string' ? entry.content : '';
+                        actualAdditional.set(normalizedEntry.toLowerCase(), contentValue);
+                    }
+                    const missing = requiredNormalized.filter((entry) => {
+                        const contentValue = actualAdditional.get(entry);
+                        if (contentValue === undefined) {
+                            return true;
+                        }
+                        return contentValue.trim().length === 0;
+                    });
+                    if (missing.length > 0) {
+                        return {
+                            ok: false,
+                            error: `Missing required additional file writes or content: ${missing.join(', ')}.`
+                        };
+                    }
+                }
+            }
+            const dryRun = deps.isPreviewOnly() || deps.isDryRunEnabled();
+            const encoding = action.encoding ?? 'utf-8';
+            const incremental = typeof original === 'string'
+                ? deps.applyIncrementalEdits(original, content, relativePath)
+                : { content, replaced: 0, total: 0, confidence: 0.9 };
+            let finalContent = incremental.content;
+            finalContent = deps.helperManager.applyImportHints(helperMeta, finalContent);
+            const baselineOriginal = typeof original === 'string' ? original : '';
+            const pendingDiff = await deps.diffManager.registerPendingDiff(relativePath, baselineOriginal, finalContent, incremental.confidence);
+            const shouldWritePrimary = pendingDiff.changed !== false;
+            let backupPath;
+            let preWriteState;
+            if (shouldWritePrimary && !dryRun && typeof original === 'string') {
+                try {
+                    backupPath = await deps.undoManager.createBackup(session.workspaceRoot, relativePath, original);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await deps.telemetry.log({
+                        message: `Backup failed for ${relativePath}: ${message}`,
+                        level: 'warn'
+                    });
+                }
+            }
+            const diffText = pendingDiff.diff;
+            let diffSummary = pendingDiff.summary;
+            if (diffText === undefined) {
+                return { ok: false, error: `Unable to compute diff for ${relativePath}. Aborting write.` };
+            }
+            const summaryForLog = diffSummary ?? { added: 0, removed: 0 };
+            diffSummary = summaryForLog;
+            await deps.telemetry.log({
+                message: `Diff summary for ${relativePath}: +${summaryForLog.added} / -${summaryForLog.removed}${pendingDiff.confidence ? ` (confidence ${(100 * pendingDiff.confidence).toFixed(1)}%)` : ''}`,
+                level: 'info'
+            });
+            if (action.diffStoreKey) {
+                deps.setContextValue(action.diffStoreKey, diffText);
+            }
+            const rewriteGuard = coerceRewriteGuard(step?.metadata?.rewriteGuard);
+            if (rewriteGuard && shouldWritePrimary && typeof original === 'string') {
+                const originalLineCount = countLines(original);
+                if (!rewriteGuard.minOriginalLineCount || originalLineCount >= rewriteGuard.minOriginalLineCount) {
+                    const baselineLines = Math.max(1, originalLineCount);
+                    const removedRatio = summaryForLog.removed / baselineLines;
+                    const changedRatio = (summaryForLog.added + summaryForLog.removed) / baselineLines;
+                    const violations = [];
+                    if (rewriteGuard.maxRemovedLineRatio !== undefined
+                        && removedRatio > rewriteGuard.maxRemovedLineRatio) {
+                        violations.push(`removed ${formatPercent(removedRatio)} of lines (max ${formatPercent(rewriteGuard.maxRemovedLineRatio)})`);
+                    }
+                    if (rewriteGuard.maxChangedLineRatio !== undefined
+                        && changedRatio > rewriteGuard.maxChangedLineRatio) {
+                        violations.push(`changed ${formatPercent(changedRatio)} of lines (max ${formatPercent(rewriteGuard.maxChangedLineRatio)})`);
+                    }
+                    if (violations.length > 0) {
+                        const reason = rewriteGuard.reason ? ` (${rewriteGuard.reason})` : '';
+                        return {
+                            ok: false,
+                            error: `Rewrite guard blocked update for ${relativePath}${reason}: ${violations.join('; ')}.`
+                        };
+                    }
+                }
+            }
+            if (!shouldWritePrimary) {
+                await deps.telemetry.status({
+                    text: `No changes detected for ${relativePath}`,
+                    phase: 'progress',
+                    detail: 'Skipping disk write because the file is unchanged.',
+                    stepId,
+                    icon: 'code'
+                });
+            }
+            if (!dryRun && shouldWritePrimary) {
+                preWriteState = await deps.undoManager.capturePreWriteState(session.workspaceRoot, relativePath, encoding, original);
+            }
+            let response = { status: 'SUCCESS', data: { path: relativePath } };
+            if (dryRun) {
+                await deps.telemetry.status({
+                    text: `Dry run prepared for ${relativePath}`,
+                    phase: 'progress',
+                    detail: 'Changes staged for review without writing to disk.',
+                    stepId,
+                    icon: 'code'
+                });
+            }
+            else if (shouldWritePrimary) {
+                const payload = {
+                    root: session.workspaceRoot,
+                    path: relativePath,
+                    content: finalContent,
+                    encoding
+                };
+                response = await deps.runPython('writeFile', payload);
+            }
+            const ok = response.status === 'SUCCESS';
+            if (!dryRun && ok && preWriteState) {
+                deps.undoManager.recordSnapshot({
+                    path: relativePath,
+                    absolutePath: preWriteState.absolutePath,
+                    before: preWriteState.before,
+                    after: finalContent,
+                    encoding,
+                    timestamp: Date.now(),
+                    existedBefore: preWriteState.existedBefore
+                });
+            }
+            if (ok && !dryRun && shouldWritePrimary) {
+                deps.embeddingManager.scheduleEmbeddingUpsert(relativePath, finalContent);
+            }
+            const bytesWritten = shouldWritePrimary ? Buffer.byteLength(finalContent, encoding) : 0;
+            let additionalWriteDetails = [];
+            if (additionalWrites.length > 0) {
+                additionalWriteDetails = await deps.additionalWriteManager.applyAdditionalWrites({
+                    workspaceRoot: session.workspaceRoot,
+                    writes: additionalWrites,
+                    encoding,
+                    dryRun,
+                    stepId
+                });
+                if (additionalWritesRef) {
+                    deps.setContextValue(additionalWritesRef, []);
+                }
+            }
+            if (!dryRun) {
+                if (ok) {
+                    const extraPaths = additionalWriteDetails
+                        .map((entry) => (typeof entry.path === 'string' ? entry.path : undefined))
+                        .filter((value) => Boolean(value));
+                    deps.recordWriteContext([relativePath, ...extraPaths], Boolean(helperMeta));
+                }
+                else {
+                    deps.clearPendingWriteContext();
+                }
+            }
+            else {
+                deps.clearPendingWriteContext();
+            }
+            if (!dryRun) {
+                await deps.pendingInferenceTracker.flagMissingFiles(relativePath, additionalWrites);
+            }
+            return {
+                ok,
+                output: ok ? (dryRun ? `Prepared dry run for ${relativePath}` : `Wrote ${relativePath}`) : undefined,
+                error: ok ? undefined : response.error?.toString(),
+                data: {
+                    ...(response.data ?? {}),
+                    diff: diffText,
+                    diffSummary,
+                    backupPath,
+                    backupContent: typeof original === 'string' ? original : undefined,
+                    path: relativePath,
+                    dryRun,
+                    astEdits: {
+                        replaced: incremental.replaced,
+                        total: incremental.total,
+                        confidence: incremental.confidence
+                    },
+                    bytesWritten,
+                    additionalWrites: additionalWriteDetails
+                }
+            };
+        }
+        if (action.name === 'runCommand') {
+            const payload = {
+                command: action.command,
+                cwd: deps.resolveRootParam(action.cwdRef),
+                root: session.workspaceRoot
+            };
+            const response = await deps.runPython('runCommand', payload);
+            const ok = response.status === 'SUCCESS' || Boolean(action.allowFailure);
+            return {
+                ok,
+                output: response.output,
+                error: response.status === 'FAILED' ? response.error?.toString() : undefined,
+                data: {
+                    code: response.code,
+                    status: response.status
+                }
+            };
+        }
+        return { ok: false, error: 'Unsupported python action.' };
+    }
+    return { execute };
+}
+//# sourceMappingURL=pythonActions.js.map