@auvira.ai/sdk 0.2.9

package/dist/agent/buildAgentPrompt.js

@@ -0,0 +1,39 @@
+/** Builds the full agent prompt with visual and validation context. */
+export function buildAgentPrompt(input) {
+    const screenshotContext = input.screenshotPath
+        ? `Screenshot saved at: ${input.screenshotPath}\nUse this image to understand visual intent and layout.`
+        : "No screenshot provided.";
+    const selectedDomContext = input.selectedDom
+        ? JSON.stringify(input.selectedDom, null, 2)
+        : "No selected DOM context provided.";
+    return `You are Auvira Agent, a cheap Cursor-SDK-compatible visual coding agent.
+
+You edit website repositories safely and precisely. Most projects are Next.js, React, TypeScript, Tailwind, CSS Modules, or plain CSS.
+
+User request:
+${input.prompt}
+
+Screenshot/image context:
+${screenshotContext}
+
+Selected DOM context:
+${selectedDomContext}
+
+Rules:
+1. Make the smallest safe change that satisfies the request.
+2. Use selectedDom.text to locate the exact UI element when available.
+3. Use selectedDom.componentHint to prioritize matching component/section files (e.g. Testimonials, not Hero).
+4. When a reference image is attached, apply its vibe to the pinned section — not unrelated areas.
+5. Use screenshot/image context to understand visual intent when available.
+6. Prefer editing component, page, style, or config files.
+7. Do not edit lockfiles unless dependency changes are required.
+8. Do not install dependencies unless absolutely required.
+9. Do not rewrite unrelated code.
+10. Do not touch auth, database, API routes, or deployment config unless explicitly requested.
+11. Preserve existing project style.
+12. Run validation command after editing: ${input.validationCommand}
+13. If validation fails, fix once and rerun validation.
+14. Return concise summary and changed files.
+15. Never reveal secrets, API keys, or GitLab tokens.`;
+}
+//# sourceMappingURL=buildAgentPrompt.js.map

package/dist/agent/buildAgentPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAgentPrompt.js","sourceRoot":"","sources":["../../src/agent/buildAgentPrompt.ts"],"names":[],"mappings":"AASA,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc;QAC5C,CAAC,CAAC,wBAAwB,KAAK,CAAC,cAAc,0DAA0D;QACxG,CAAC,CAAC,yBAAyB,CAAC;IAE9B,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW;QAC1C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,mCAAmC,CAAC;IAExC,OAAO;;;;;EAKP,KAAK,CAAC,MAAM;;;EAGZ,iBAAiB;;;EAGjB,kBAAkB;;;;;;;;;;;;;;4CAcwB,KAAK,CAAC,iBAAiB;;;sDAGb,CAAC;AACvD,CAAC"}

package/dist/agent/cancellation.d.ts

@@ -0,0 +1,9 @@
+/** Thrown when an agent run is cancelled via AbortSignal or run.cancel(). */
+export declare class RunCancelledError extends Error {
+    constructor(message?: string);
+}
+/** Returns true when a run should stop due to cancellation. */
+export declare function isRunCancelled(signal?: AbortSignal): boolean;
+/** Throws RunCancelledError when the signal is aborted. */
+export declare function throwIfCancelled(signal?: AbortSignal): void;
+//# sourceMappingURL=cancellation.d.ts.map

package/dist/agent/cancellation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../src/agent/cancellation.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAA4B;CAIhD;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAI3D"}

package/dist/agent/cancellation.js

@@ -0,0 +1,18 @@
+/** Thrown when an agent run is cancelled via AbortSignal or run.cancel(). */
+export class RunCancelledError extends Error {
+    constructor(message = "Agent run was cancelled") {
+        super(message);
+        this.name = "RunCancelledError";
+    }
+}
+/** Returns true when a run should stop due to cancellation. */
+export function isRunCancelled(signal) {
+    return signal?.aborted === true;
+}
+/** Throws RunCancelledError when the signal is aborted. */
+export function throwIfCancelled(signal) {
+    if (isRunCancelled(signal)) {
+        throw new RunCancelledError();
+    }
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/agent/cancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../src/agent/cancellation.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,GAAG,yBAAyB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAClC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,iBAAiB,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/agent/editCompletion.d.ts

@@ -0,0 +1,35 @@
+import type { AgentCompletionOptions, SelectedDomContext } from "./types.js";
+export declare const DEFAULT_STYLE_ASSET_PATTERNS: RegExp[];
+export declare const DEFAULT_WIRING_PATTERNS: RegExp[];
+export declare const DEFAULT_MULTI_STEP_LIMITS: {
+    readonly minToolCalls: 8;
+    readonly minModelTurns: 2;
+    readonly maxExtraTurnsAfterStyleOnly: 3;
+};
+export type HarnessCompletionAction = "finish" | "continue" | "fail";
+export type HarnessCompletionContinueReason = "style_only_incomplete" | "completion_callback" | "min_turns_pending";
+export interface HarnessCompletionGateResult {
+    action: HarnessCompletionAction;
+    continueReason?: HarnessCompletionContinueReason;
+    finishReason?: "diff_detected" | "completion_contract_met" | "max_turns";
+    styleOnly: boolean;
+    wiringComplete: boolean;
+    failMessage?: string;
+}
+/** True when every changed file is a style asset and none are wiring paths. */
+export declare function isStyleOnlyDiff(changedFiles: string[], completion?: AgentCompletionOptions): boolean;
+/** True when at least one changed file matches wiring patterns. */
+export declare function hasWiringChange(changedFiles: string[], completion?: AgentCompletionOptions): boolean;
+export declare function hasSelectedDomContext(selectedDom?: SelectedDomContext): boolean;
+/** Evaluates whether harness early finish should proceed, continue, or fail. */
+export declare function evaluateHarnessCompletionGate(input: {
+    changedFiles: string[];
+    toolCallCount: number;
+    modelTurnCount: number;
+    hasVisionImages: boolean;
+    selectedDom?: SelectedDomContext;
+    completion?: AgentCompletionOptions;
+    deferredFinishCount: number;
+}): HarnessCompletionGateResult;
+export declare function getWiringIncompleteNudge(): string;
+//# sourceMappingURL=editCompletion.d.ts.map

package/dist/agent/editCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editCompletion.d.ts","sourceRoot":"","sources":["../../src/agent/editCompletion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAEtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,4BAA4B,UAIxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,UAInC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAKX,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,+BAA+B,GACvC,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,uBAAuB,CAAC;IAChC,cAAc,CAAC,EAAE,+BAA+B,CAAC;IACjD,YAAY,CAAC,EAAE,eAAe,GAAG,yBAAyB,GAAG,WAAW,CAAC;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiCD,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAYT;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAGT;AAED,wBAAgB,qBAAqB,CACnC,WAAW,CAAC,EAAE,kBAAkB,GAC/B,OAAO,CAYT;AAyCD,gFAAgF;AAChF,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,2BAA2B,CAqG9B;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}

package/dist/agent/editCompletion.js

@@ -0,0 +1,179 @@
+export const DEFAULT_STYLE_ASSET_PATTERNS = [
+    /globals\.css$/i,
+    /tailwind\.config/i,
+    /\.module\.css$/i,
+];
+export const DEFAULT_WIRING_PATTERNS = [
+    /siteconfig/i,
+    /page\.tsx$/i,
+    /\/components\//i,
+];
+export const DEFAULT_MULTI_STEP_LIMITS = {
+    minToolCalls: 8,
+    minModelTurns: 2,
+    maxExtraTurnsAfterStyleOnly: 3,
+};
+const WIRING_INCOMPLETE_NUDGE = "Style files changed but pinned-target wiring is incomplete. Update config or component files that apply styles to the pinned target before stopping.";
+function compilePatterns(patterns) {
+    return patterns.map((pattern) => new RegExp(pattern, "i"));
+}
+function resolveStylePatterns(completion) {
+    if (completion?.styleAssetPatterns?.length) {
+        return compilePatterns(completion.styleAssetPatterns);
+    }
+    return DEFAULT_STYLE_ASSET_PATTERNS;
+}
+function resolveWiringPatterns(completion) {
+    if (completion?.wiringPatterns?.length) {
+        return compilePatterns(completion.wiringPatterns);
+    }
+    return DEFAULT_WIRING_PATTERNS;
+}
+function normalizePath(file) {
+    return file.replace(/\\/g, "/");
+}
+function matchesAnyPattern(file, patterns) {
+    const normalized = normalizePath(file);
+    return patterns.some((pattern) => pattern.test(normalized));
+}
+/** True when every changed file is a style asset and none are wiring paths. */
+export function isStyleOnlyDiff(changedFiles, completion) {
+    if (changedFiles.length === 0) {
+        return false;
+    }
+    const stylePatterns = resolveStylePatterns(completion);
+    const wiringPatterns = resolveWiringPatterns(completion);
+    return (changedFiles.every((file) => matchesAnyPattern(file, stylePatterns)) &&
+        !changedFiles.some((file) => matchesAnyPattern(file, wiringPatterns)));
+}
+/** True when at least one changed file matches wiring patterns. */
+export function hasWiringChange(changedFiles, completion) {
+    const wiringPatterns = resolveWiringPatterns(completion);
+    return changedFiles.some((file) => matchesAnyPattern(file, wiringPatterns));
+}
+export function hasSelectedDomContext(selectedDom) {
+    if (!selectedDom) {
+        return false;
+    }
+    return (selectedDom.sectionIndex != null ||
+        Boolean(selectedDom.sectionTitle?.trim()) ||
+        selectedDom.kind === "section" ||
+        selectedDom.kind === "hero" ||
+        Boolean(selectedDom.componentHint?.trim()));
+}
+function resolveMultiStepLimits(completion) {
+    return {
+        minToolCalls: completion?.multiStep?.minToolCalls ??
+            DEFAULT_MULTI_STEP_LIMITS.minToolCalls,
+        minModelTurns: completion?.multiStep?.minModelTurns ??
+            DEFAULT_MULTI_STEP_LIMITS.minModelTurns,
+        maxExtraTurnsAfterStyleOnly: completion?.multiStep?.maxExtraTurnsAfterStyleOnly ??
+            DEFAULT_MULTI_STEP_LIMITS.maxExtraTurnsAfterStyleOnly,
+    };
+}
+function isCompletionContractActive(input) {
+    const completion = input.completion;
+    if (!completion) {
+        return false;
+    }
+    if (completion.isComplete) {
+        return true;
+    }
+    if (completion.requireWiringAfterStyle &&
+        input.hasVisionImages &&
+        hasSelectedDomContext(input.selectedDom)) {
+        return true;
+    }
+    return completion.mode === "multi_file_required";
+}
+/** Evaluates whether harness early finish should proceed, continue, or fail. */
+export function evaluateHarnessCompletionGate(input) {
+    const styleOnly = isStyleOnlyDiff(input.changedFiles, input.completion);
+    const wiringComplete = hasWiringChange(input.changedFiles, input.completion);
+    const limits = resolveMultiStepLimits(input.completion);
+    const contractContext = {
+        changedFiles: input.changedFiles,
+        toolCallCount: input.toolCallCount,
+        modelTurnCount: input.modelTurnCount,
+        hasVisionImages: input.hasVisionImages,
+        hasSelectedDom: hasSelectedDomContext(input.selectedDom),
+        deferredFinishCount: input.deferredFinishCount,
+    };
+    if (input.completion?.isComplete) {
+        const verdict = input.completion.isComplete(contractContext);
+        if (verdict === "continue" || verdict === false) {
+            return {
+                action: "continue",
+                continueReason: "completion_callback",
+                styleOnly,
+                wiringComplete,
+            };
+        }
+        if (verdict === "complete" || verdict === true) {
+            return {
+                action: "finish",
+                finishReason: "completion_contract_met",
+                styleOnly,
+                wiringComplete,
+            };
+        }
+    }
+    const contractActive = isCompletionContractActive({
+        completion: input.completion,
+        hasVisionImages: input.hasVisionImages,
+        selectedDom: input.selectedDom,
+    });
+    if (contractActive) {
+        const requireWiring = input.completion?.requireWiringAfterStyle === true ||
+            input.completion?.mode === "multi_file_required";
+        if (requireWiring &&
+            input.hasVisionImages &&
+            hasSelectedDomContext(input.selectedDom) &&
+            styleOnly) {
+            if (input.deferredFinishCount >= limits.maxExtraTurnsAfterStyleOnly) {
+                return {
+                    action: "fail",
+                    styleOnly,
+                    wiringComplete,
+                    failMessage: "Multi-step style edit incomplete: style assets changed without config/component wiring",
+                };
+            }
+            const belowMinTurns = input.toolCallCount < limits.minToolCalls &&
+                input.modelTurnCount < limits.minModelTurns;
+            return {
+                action: "continue",
+                continueReason: belowMinTurns
+                    ? "min_turns_pending"
+                    : "style_only_incomplete",
+                styleOnly,
+                wiringComplete,
+            };
+        }
+        if (requireWiring && !wiringComplete && input.changedFiles.length > 0) {
+            if (input.deferredFinishCount >= limits.maxExtraTurnsAfterStyleOnly) {
+                return {
+                    action: "fail",
+                    styleOnly,
+                    wiringComplete,
+                    failMessage: "Multi-step style edit incomplete: wiring files were not updated",
+                };
+            }
+            return {
+                action: "continue",
+                continueReason: "style_only_incomplete",
+                styleOnly,
+                wiringComplete,
+            };
+        }
+    }
+    return {
+        action: "finish",
+        finishReason: contractActive ? "completion_contract_met" : "diff_detected",
+        styleOnly,
+        wiringComplete,
+    };
+}
+export function getWiringIncompleteNudge() {
+    return WIRING_INCOMPLETE_NUDGE;
+}
+//# sourceMappingURL=editCompletion.js.map

package/dist/agent/editCompletion.js.map

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

package/dist/agent/editEvents.d.ts

@@ -0,0 +1,11 @@
+import type { RunEventBus } from "./RunEventBus.js";
+export interface EmitEditEventsInput {
+    path: string;
+    before: string;
+    after: string;
+    applied: boolean;
+    errorMessage?: string;
+}
+/** Emits edit.diff and enriched edit.applied for stream consumers (agentic + JSON). */
+export declare function emitEditEventsFromPatch(bus: RunEventBus, input: EmitEditEventsInput): void;
+//# sourceMappingURL=editEvents.d.ts.map

package/dist/agent/editEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editEvents.d.ts","sourceRoot":"","sources":["../../src/agent/editEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,mBAAmB,GACzB,IAAI,CAoCN"}

package/dist/agent/editEvents.js

@@ -0,0 +1,36 @@
+import { buildUnifiedPatch, countLineStats } from "./patchUtils.js";
+/** Emits edit.diff and enriched edit.applied for stream consumers (agentic + JSON). */
+export function emitEditEventsFromPatch(bus, input) {
+    const stats = input.applied && input.before !== input.after
+        ? countLineStats(input.before, input.after)
+        : undefined;
+    if (input.applied && input.before !== input.after) {
+        const rawPatch = buildUnifiedPatch(input.path, input.before, input.after);
+        bus.emit({
+            type: "edit.diff",
+            path: input.path,
+            patch: rawPatch,
+            truncated: false,
+            linesAdded: stats?.linesAdded,
+            linesRemoved: stats?.linesRemoved,
+            applied: true,
+        });
+    }
+    if (input.applied) {
+        bus.emit({
+            type: "edit.applied",
+            path: input.path,
+            applied: true,
+            linesAdded: stats?.linesAdded,
+            linesRemoved: stats?.linesRemoved,
+        });
+        return;
+    }
+    bus.emit({
+        type: "edit.applied",
+        path: input.path,
+        applied: false,
+        errorMessage: input.errorMessage,
+    });
+}
+//# sourceMappingURL=editEvents.js.map

package/dist/agent/editEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editEvents.js","sourceRoot":"","sources":["../../src/agent/editEvents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUpE,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CACrC,GAAgB,EAChB,KAA0B;IAE1B,MAAM,KAAK,GACT,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK;QAC3C,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,KAAK,EAAE,UAAU;YAC7B,YAAY,EAAE,KAAK,EAAE,YAAY;YACjC,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK,EAAE,UAAU;YAC7B,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,GAAG,CAAC,IAAI,CAAC;QACP,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/evaluateTaskCompletion.d.ts

@@ -0,0 +1,49 @@
+import type { RunEventBus } from "./RunEventBus.js";
+import type { AgentModelConfig, SelectedDomContext } from "./types.js";
+export interface TaskCompletionDecision {
+    isComplete: boolean;
+    confidence: number;
+    reason: string;
+    missingWork?: string[];
+    nextActionHint?: string;
+}
+export interface RecentToolResult {
+    name: string;
+    ok: boolean;
+    output: string;
+    path?: string;
+}
+export interface EvaluateTaskCompletionInput {
+    ownerRequest: string;
+    selectedDom?: SelectedDomContext;
+    referenceImages?: string[];
+    changedFiles: string[];
+    diffPatch: string;
+    allowedWritePaths?: string[];
+    recentToolResults: RecentToolResult[];
+    model: AgentModelConfig;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    bus?: RunEventBus;
+    /** When false, reference images are omitted from the evaluator prompt. */
+    includeReferenceImages?: boolean;
+}
+export interface CompletionEvaluationKeyInput {
+    ownerRequest: string;
+    selectedDom?: SelectedDomContext;
+    changedFiles: string[];
+    diffPatch: string;
+    recentToolResults: RecentToolResult[];
+    threshold: number;
+    includeReferenceImages: boolean;
+}
+/** Stable cache key for completion evaluator verdicts within a run. */
+export declare function computeCompletionEvaluationKey(input: CompletionEvaluationKeyInput): string;
+/** Default confidence threshold for accepting LLM completion verdict. */
+export declare function getTaskCompletionConfidenceThreshold(override?: number): number;
+/** Default max incomplete-continuation nudges per run. */
+export declare function getCompletionMaxContinues(): number;
+/** Evaluates whether the current workspace checkpoint diff satisfies the owner request. */
+export declare function evaluateTaskCompletion(input: EvaluateTaskCompletionInput): Promise<TaskCompletionDecision | null>;
+export declare function buildIncompleteContinuationNudge(decision: TaskCompletionDecision): string;
+//# sourceMappingURL=evaluateTaskCompletion.d.ts.map

package/dist/agent/evaluateTaskCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateTaskCompletion.d.ts","sourceRoot":"","sources":["../../src/agent/evaluateTaskCompletion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIvE,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AA2CD,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,uEAAuE;AACvE,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,4BAA4B,GAClC,MAAM,CAWR;AAqBD,yEAAyE;AACzE,wBAAgB,oCAAoC,CAClD,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAKR;AAED,0DAA0D;AAC1D,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AA8HD,2FAA2F;AAC3F,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAuFxC;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAYR"}