@auvira.ai/sdk 0.2.9

package/dist/agent/evaluateTaskCompletion.js

@@ -0,0 +1,257 @@
+import { createHash } from "node:crypto";
+import { withApiConcurrencyLimit } from "../util/apiThrottle.js";
+import { postJsonWithRetry } from "../util/modelApiClient.js";
+const EVALUATOR_SYSTEM_PROMPT = `You are evaluating whether a code edit task is complete.
+
+You are given:
+- the owner request
+- selected DOM / pinned target context if available
+- reference image presence/content if available
+- changed files
+- workspace checkpoint diff patch
+- recent tool results
+
+Decide whether the current diff fully satisfies the user's requested edit.
+
+Do not rely on keywords alone.
+Do not assume all visual edits need wiring.
+Do not assume all single-file edits are complete.
+Judge from the actual diff and task evidence.
+
+Return JSON only:
+{
+  "isComplete": true | false,
+  "confidence": number,
+  "reason": string,
+  "missingWork": string[],
+  "nextActionHint": string
+}
+
+Rules:
+- isComplete=true only if the diff appears sufficient to satisfy the requested visible/functional change.
+- isComplete=false if the diff only changes assets/styles/config but the requested target likely still needs component wiring, prop changes, route updates, content mapping, or validation.
+- If uncertain, use confidence below 0.75.
+- missingWork should be short and actionable.
+- nextActionHint should suggest the smallest next action, not broad exploration.`;
+/** Stable cache key for completion evaluator verdicts within a run. */
+export function computeCompletionEvaluationKey(input) {
+    const payload = JSON.stringify({
+        ownerRequest: input.ownerRequest,
+        selectedDom: input.selectedDom ?? null,
+        changedFiles: [...input.changedFiles].sort(),
+        diffPatch: input.diffPatch,
+        recentToolResults: input.recentToolResults,
+        threshold: input.threshold,
+        includeReferenceImages: input.includeReferenceImages,
+    });
+    return createHash("sha256").update(payload).digest("hex");
+}
+function parsePositiveFloat(raw, fallback) {
+    if (!raw?.trim()) {
+        return fallback;
+    }
+    const value = Number.parseFloat(raw);
+    return Number.isFinite(value) ? value : fallback;
+}
+function parsePositiveInt(raw, fallback) {
+    if (!raw?.trim()) {
+        return fallback;
+    }
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) ? value : fallback;
+}
+/** Default confidence threshold for accepting LLM completion verdict. */
+export function getTaskCompletionConfidenceThreshold(override) {
+    if (override !== undefined) {
+        return override;
+    }
+    return parsePositiveFloat(process.env.AUVIRA_TASK_COMPLETION_CONFIDENCE, 0.75);
+}
+/** Default max incomplete-continuation nudges per run. */
+export function getCompletionMaxContinues() {
+    return parsePositiveInt(process.env.AUVIRA_COMPLETION_MAX_CONTINUES, 2);
+}
+function getEvaluatorTimeoutMs(override) {
+    if (override !== undefined) {
+        return override;
+    }
+    return parsePositiveInt(process.env.AUVIRA_TASK_COMPLETION_TIMEOUT_MS, 15_000);
+}
+function resolveEvaluatorModelId(model) {
+    const override = process.env.AUVIRA_TASK_COMPLETION_MODEL?.trim();
+    return override || model.id;
+}
+function tryParseDecision(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.isComplete !== "boolean") {
+            return null;
+        }
+        if (typeof parsed.confidence !== "number" || !Number.isFinite(parsed.confidence)) {
+            return null;
+        }
+        if (typeof parsed.reason !== "string" || !parsed.reason.trim()) {
+            return null;
+        }
+        return {
+            isComplete: parsed.isComplete,
+            confidence: parsed.confidence,
+            reason: parsed.reason.trim(),
+            missingWork: Array.isArray(parsed.missingWork)
+                ? parsed.missingWork.filter((item) => typeof item === "string")
+                : undefined,
+            nextActionHint: typeof parsed.nextActionHint === "string"
+                ? parsed.nextActionHint.trim()
+                : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function formatSelectedDom(selectedDom) {
+    if (!selectedDom) {
+        return "None";
+    }
+    return JSON.stringify(selectedDom, null, 2);
+}
+function formatRecentTools(results) {
+    if (results.length === 0) {
+        return "None";
+    }
+    return results
+        .map((result) => {
+        const path = result.path ? ` path=${result.path}` : "";
+        return `- ${result.name} ok=${result.ok}${path}\n  ${result.output.slice(0, 400)}`;
+    })
+        .join("\n");
+}
+function buildEvaluatorUserContent(input) {
+    return [
+        "OWNER REQUEST:",
+        input.ownerRequest,
+        "",
+        "SELECTED DOM:",
+        formatSelectedDom(input.selectedDom),
+        "",
+        "ALLOWED WRITE PATHS:",
+        input.allowedWritePaths?.map((path) => `- ${path}`).join("\n") || "None",
+        "",
+        "CHANGED FILES:",
+        input.changedFiles.map((file) => `- ${file}`).join("\n") || "None",
+        "",
+        "WORKSPACE CHECKPOINT DIFF PATCH:",
+        input.diffPatch.slice(0, 12_000) || "(empty)",
+        "",
+        "RECENT TOOL RESULTS:",
+        formatRecentTools(input.recentToolResults),
+    ].join("\n");
+}
+function buildEvaluatorMessages(input) {
+    const text = buildEvaluatorUserContent(input);
+    const includeImages = input.includeReferenceImages !== false;
+    const images = includeImages ? (input.referenceImages?.filter(Boolean) ?? []) : [];
+    if (images.length === 0) {
+        return [
+            { role: "system", content: EVALUATOR_SYSTEM_PROMPT },
+            { role: "user", content: text },
+        ];
+    }
+    return [
+        { role: "system", content: EVALUATOR_SYSTEM_PROMPT },
+        {
+            role: "user",
+            content: [
+                { type: "text", text },
+                ...images.map((url) => ({
+                    type: "image_url",
+                    image_url: { url },
+                })),
+            ],
+        },
+    ];
+}
+/** Evaluates whether the current workspace checkpoint diff satisfies the owner request. */
+export async function evaluateTaskCompletion(input) {
+    const baseURL = input.model.baseURL?.trim();
+    const apiKey = input.model.apiKey?.trim();
+    if (!baseURL || !apiKey) {
+        return null;
+    }
+    const startedMs = Date.now();
+    const timeoutMs = getEvaluatorTimeoutMs(input.timeoutMs);
+    const modelId = resolveEvaluatorModelId(input.model);
+    const requestBody = {
+        model: modelId,
+        messages: buildEvaluatorMessages(input),
+        temperature: 0,
+        response_format: { type: "json_object" },
+        max_completion_tokens: 512,
+    };
+    try {
+        const { value: result } = await withApiConcurrencyLimit((queueWaitMs) => postJsonWithRetry({
+            url: `${baseURL}/chat/completions`,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: requestBody,
+            timeoutMs,
+            signal: input.signal,
+        }, queueWaitMs));
+        const evaluatorMs = Date.now() - startedMs;
+        if (!result.ok || !result.data) {
+            input.bus?.emit({
+                type: "completion.evaluated",
+                source: "error",
+                changedFiles: input.changedFiles,
+                evaluatorMs,
+                reason: result.errorMessage ?? "Evaluator API request failed",
+            });
+            return null;
+        }
+        const content = result.data.choices?.[0]?.message?.content?.trim() ?? "";
+        const decision = tryParseDecision(content);
+        if (!decision) {
+            input.bus?.emit({
+                type: "completion.evaluated",
+                source: "error",
+                changedFiles: input.changedFiles,
+                evaluatorMs,
+                reason: "Failed to parse evaluator JSON response",
+            });
+            return null;
+        }
+        input.bus?.emit({
+            type: "completion.evaluated",
+            source: "llm",
+            isComplete: decision.isComplete,
+            confidence: decision.confidence,
+            reason: decision.reason,
+            missingWork: decision.missingWork,
+            nextActionHint: decision.nextActionHint,
+            changedFiles: input.changedFiles,
+            evaluatorMs,
+        });
+        return decision;
+    }
+    catch (error) {
+        input.bus?.emit({
+            type: "completion.evaluated",
+            source: "error",
+            changedFiles: input.changedFiles,
+            evaluatorMs: Date.now() - startedMs,
+            reason: error instanceof Error ? error.message : "Evaluator failed",
+        });
+        return null;
+    }
+}
+export function buildIncompleteContinuationNudge(decision) {
+    const missing = decision.missingWork?.filter(Boolean).join("; ") || decision.reason;
+    const hint = decision.nextActionHint?.trim();
+    const hintLine = hint ? `\nNext action: ${hint}` : "";
+    return (`The current diff is not complete yet.\n` +
+        `Missing work: ${missing}\n` +
+        `Continue with the next smallest safe edit on ALLOWED WRITE PATHS.${hintLine}`);
+}
+//# sourceMappingURL=evaluateTaskCompletion.js.map

package/dist/agent/evaluateTaskCompletion.js.map

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

package/dist/agent/events.d.ts

@@ -0,0 +1,182 @@
+/** Base fields present on every streamed run event. */
+export interface AgentRunEventBase {
+    type: string;
+    runId: string;
+    timestamp: number;
+}
+export interface RunStartedEvent extends AgentRunEventBase {
+    type: "run.started";
+    promptPreview: string;
+}
+export interface WorkspacePreparedEvent extends AgentRunEventBase {
+    type: "workspace.prepared";
+    workspaceId: string;
+    branchName: string;
+    repoPath: string;
+}
+export interface ScreenshotSavedEvent extends AgentRunEventBase {
+    type: "screenshot.saved";
+    path: string;
+}
+export interface ContextFilesSelectedEvent extends AgentRunEventBase {
+    type: "context.files_selected";
+    files: string[];
+}
+export interface ModelAttemptEvent extends AgentRunEventBase {
+    type: "model.attempt";
+    attempt: number;
+    maxAttempts: number;
+}
+export interface ModelRequestEvent extends AgentRunEventBase {
+    type: "model.request";
+    provider: string;
+    model: string;
+    hasVision: boolean;
+}
+export interface ModelResponseEvent extends AgentRunEventBase {
+    type: "model.response";
+    contentPreview: string;
+    timingMs: number;
+    httpRetries: number;
+}
+export interface ModelRepairEvent extends AgentRunEventBase {
+    type: "model.repair";
+    reason: string;
+    priorOutputSnippet: string;
+}
+export interface ThinkingEvent extends AgentRunEventBase {
+    type: "thinking";
+    text: string;
+}
+export interface AssistantContentBlock {
+    type: "text";
+    text: string;
+}
+export interface AssistantEvent extends AgentRunEventBase {
+    type: "assistant";
+    message: {
+        role: "assistant";
+        content: AssistantContentBlock[];
+    };
+    /** Flat text alias for backward compatibility. */
+    text: string;
+}
+export type AssistantEventInput = {
+    type: "assistant";
+    message: AssistantEvent["message"];
+    text: string;
+};
+export interface ToolStartEvent extends AgentRunEventBase {
+    type: "tool.start";
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolEndEvent extends AgentRunEventBase {
+    type: "tool.end";
+    name: string;
+    ok: boolean;
+    output: Record<string, unknown>;
+}
+export interface EditParsedEvent extends AgentRunEventBase {
+    type: "edit.parsed";
+    editCount: number;
+    paths: string[];
+}
+export interface EditAppliedEvent extends AgentRunEventBase {
+    type: "edit.applied";
+    path: string;
+    applied: boolean;
+    linesAdded?: number;
+    linesRemoved?: number;
+    errorMessage?: string;
+}
+export interface EditDiffEvent extends AgentRunEventBase {
+    type: "edit.diff";
+    path: string;
+    patch: string;
+    truncated: boolean;
+    linesAdded?: number;
+    linesRemoved?: number;
+    applied: true;
+}
+export interface RunDiffEvent extends AgentRunEventBase {
+    type: "run.diff";
+    changedFiles: string[];
+    patch: string;
+    truncated: boolean;
+}
+export interface CompletionEvaluatedEvent extends AgentRunEventBase {
+    type: "completion.evaluated";
+    source: "llm" | "skipped" | "error" | "cached";
+    isComplete?: boolean;
+    confidence?: number;
+    reason?: string;
+    missingWork?: string[];
+    nextActionHint?: string;
+    changedFiles?: string[];
+    evaluatorMs?: number;
+}
+export interface RunContinueEvent extends AgentRunEventBase {
+    type: "run.continue";
+    reason: "style_only_incomplete" | "completion_callback" | "min_turns_pending";
+    changedFiles: string[];
+    toolCallCount?: number;
+    deferredFinishCount: number;
+    styleOnly: boolean;
+    wiringComplete: boolean;
+}
+export interface RunEarlyFinishEvent extends AgentRunEventBase {
+    type: "run.early_finish";
+    reason: "diff_detected" | "completion_contract_met" | "completion_satisfied" | "max_turns";
+    changedFiles: string[];
+    toolCallCount?: number;
+    elapsedMs?: number;
+    styleOnly?: boolean;
+    wiringComplete?: boolean;
+    deferredFinishCount?: number;
+    confidence?: number;
+    completionReason?: string;
+}
+export interface ValidationStartedEvent extends AgentRunEventBase {
+    type: "validation.started";
+    command: string;
+}
+export interface ValidationCompletedEvent extends AgentRunEventBase {
+    type: "validation.completed";
+    command: string;
+    ok: boolean;
+    exitCode: number | null;
+    stdoutPreview: string;
+    stderrPreview: string;
+}
+export interface RunCompletedEvent extends AgentRunEventBase {
+    type: "run.completed";
+    ok: true;
+}
+export interface RunFailedEvent extends AgentRunEventBase {
+    type: "run.failed";
+    ok: false;
+    code: string;
+    message: string;
+    abortReason?: string;
+    toolCallCount?: number;
+    editsApplied?: number;
+    changedFiles?: string[];
+    providerCode?: string;
+}
+export interface ConversationUpdatedEvent extends AgentRunEventBase {
+    type: "conversation.updated";
+    turnCount: number;
+}
+export type AgentRunEvent = RunStartedEvent | WorkspacePreparedEvent | ScreenshotSavedEvent | ContextFilesSelectedEvent | ModelAttemptEvent | ModelRequestEvent | ModelResponseEvent | ModelRepairEvent | ThinkingEvent | AssistantEvent | ToolStartEvent | ToolEndEvent | EditParsedEvent | EditAppliedEvent | EditDiffEvent | RunDiffEvent | CompletionEvaluatedEvent | RunContinueEvent | RunEarlyFinishEvent | ValidationStartedEvent | ValidationCompletedEvent | RunCompletedEvent | RunFailedEvent | ConversationUpdatedEvent;
+export type AgentRunEventType = AgentRunEvent["type"];
+/** Payload for emitting a typed run event (without runId/timestamp). */
+export type AgentRunEventInput<T extends AgentRunEventType = AgentRunEventType> = Omit<Extract<AgentRunEvent, {
+    type: T;
+}>, keyof AgentRunEventBase>;
+/** Synthetic tool names emitted in the run timeline. */
+export declare const AGENT_TOOL_NAMES: readonly ["prepare_workspace", "write_screenshot", "select_context_files", "model_completion", "parse_edit_plan", "apply_file_edit", "git_diff", "run_validation", "openhands_cli", "grep", "read", "glob", "list_dir", "search_replace", "write"];
+export type AgentToolName = (typeof AGENT_TOOL_NAMES)[number];
+export declare function isToolEvent(event: AgentRunEvent): event is ToolStartEvent | ToolEndEvent;
+export declare function isAssistantEvent(event: AgentRunEvent): event is AssistantEvent;
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/agent/events.js

@@ -0,0 +1,25 @@
+/** Synthetic tool names emitted in the run timeline. */
+export const AGENT_TOOL_NAMES = [
+    "prepare_workspace",
+    "write_screenshot",
+    "select_context_files",
+    "model_completion",
+    "parse_edit_plan",
+    "apply_file_edit",
+    "git_diff",
+    "run_validation",
+    "openhands_cli",
+    "grep",
+    "read",
+    "glob",
+    "list_dir",
+    "search_replace",
+    "write",
+];
+export function isToolEvent(event) {
+    return event.type === "tool.start" || event.type === "tool.end";
+}
+export function isAssistantEvent(event) {
+    return event.type === "assistant";
+}
+//# sourceMappingURL=events.js.map

package/dist/agent/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/agent/events.ts"],"names":[],"mappings":"AAyOA,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB;IACnB,kBAAkB;IAClB,sBAAsB;IACtB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,UAAU;IACV,gBAAgB;IAChB,eAAe;IACf,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,gBAAgB;IAChB,OAAO;CACC,CAAC;AAIX,MAAM,UAAU,WAAW,CACzB,KAAoB;IAEpB,OAAO,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AACpC,CAAC"}

package/dist/agent/parseSendPayload.d.ts

@@ -0,0 +1,24 @@
+import type { AgentImageInput, AgentSendOptions } from "./types.js";
+export type AgentSendPayload = string | {
+    text: string;
+    images?: AgentImageInput[];
+};
+export interface ParsedSendPayload {
+    prompt: string;
+    images: AgentImageInput[];
+    /** @deprecated First image as raw base64 for legacy screenshot writers. */
+    screenshotBase64?: string;
+}
+/** Normalizes Cursor-style send payloads into prompt text and vision fields. */
+export declare function parseSendPayload(payload: AgentSendPayload, options?: AgentSendOptions): ParsedSendPayload;
+/** Splits harness bootstrap/continue prompts on the Cursor delimiter. */
+export declare function splitHarnessPrompt(prompt: string): {
+    system: string;
+    user: string;
+};
+export declare function isHarnessPrompt(prompt: string): boolean;
+export declare function isHarnessRepairTurn(prompt: string): boolean;
+export declare function isHarnessZeroChangeRetry(prompt: string): boolean;
+/** Builds an internal SDK repair user block when harness did not send one. */
+export declare function buildInternalBuildRepairPrompt(stderr: string): string;
+//# sourceMappingURL=parseSendPayload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseSendPayload.d.ts","sourceRoot":"","sources":["../../src/agent/parseSendPayload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAgBD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,gBAAqB,GAC7B,iBAAiB,CA0BnB;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAWA;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQrE"}

package/dist/agent/parseSendPayload.js

@@ -0,0 +1,71 @@
+import { normalizeScreenshotBase64 } from "../util/screenshotBase64.js";
+function imagesFromDeprecatedOptions(options) {
+    if (options.screenshotBase64) {
+        return [
+            {
+                data: normalizeScreenshotBase64(options.screenshotBase64),
+                mimeType: "image/png",
+            },
+        ];
+    }
+    return [];
+}
+/** Normalizes Cursor-style send payloads into prompt text and vision fields. */
+export function parseSendPayload(payload, options = {}) {
+    if (typeof payload === "string") {
+        const images = imagesFromDeprecatedOptions(options);
+        return {
+            prompt: payload,
+            images,
+            screenshotBase64: images[0]?.data,
+        };
+    }
+    const payloadImages = payload.images?.map((image) => ({
+        data: normalizeScreenshotBase64(image.data),
+        mimeType: image.mimeType || "image/png",
+    })) ?? [];
+    const images = payloadImages.length > 0
+        ? payloadImages
+        : imagesFromDeprecatedOptions(options);
+    return {
+        prompt: payload.text,
+        images,
+        screenshotBase64: images[0]?.data,
+    };
+}
+/** Splits harness bootstrap/continue prompts on the Cursor delimiter. */
+export function splitHarnessPrompt(prompt) {
+    const delimiter = "\n\n---\n\n";
+    const index = prompt.indexOf(delimiter);
+    if (index === -1) {
+        return { system: "", user: prompt };
+    }
+    return {
+        system: prompt.slice(0, index).trim(),
+        user: prompt.slice(index + delimiter.length).trim(),
+    };
+}
+export function isHarnessPrompt(prompt) {
+    return (prompt.includes("\n\n---\n\n") ||
+        prompt.includes("APPLY RETRY") ||
+        prompt.includes("BUILD VALIDATION FAILED") ||
+        prompt.includes("NEW EDIT TURN"));
+}
+export function isHarnessRepairTurn(prompt) {
+    return (prompt.includes("BUILD VALIDATION FAILED") ||
+        prompt.includes("Failure reason: build_failed"));
+}
+export function isHarnessZeroChangeRetry(prompt) {
+    return prompt.includes("APPLY RETRY");
+}
+/** Builds an internal SDK repair user block when harness did not send one. */
+export function buildInternalBuildRepairPrompt(stderr) {
+    const excerpt = stderr.trim().slice(0, 4_000);
+    return [
+        "BUILD VALIDATION FAILED — repair this edit.",
+        "Failure reason: build_failed",
+        `ERROR LOG (excerpt):\n${excerpt || "(no stderr captured)"}`,
+        "Return JSON edits that fix the build while preserving the owner intent.",
+    ].join("\n\n");
+}
+//# sourceMappingURL=parseSendPayload.js.map

package/dist/agent/parseSendPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSendPayload.js","sourceRoot":"","sources":["../../src/agent/parseSendPayload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAcxE,SAAS,2BAA2B,CAClC,OAAyB;IAEzB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO;YACL;gBACE,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,gBAAgB,CAAC;gBACzD,QAAQ,EAAE,WAAW;aACtB;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC9B,OAAyB,EACzB,UAA4B,EAAE;IAE9B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO;YACL,MAAM,EAAE,OAAO;YACf,MAAM;YACN,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI;SAClC,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GACjB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC;QAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,WAAW;KACxC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEZ,MAAM,MAAM,GACV,aAAa,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAE3C,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,MAAM;QACN,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI;KAClC,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAI/C,MAAM,SAAS,GAAG,aAAa,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE;QACrC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,CACL,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,8BAA8B,CAAC,MAAc;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO;QACL,6CAA6C;QAC7C,8BAA8B;QAC9B,yBAAyB,OAAO,IAAI,sBAAsB,EAAE;QAC5D,yEAAyE;KAC1E,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC"}

package/dist/agent/patchUtils.d.ts

@@ -0,0 +1,17 @@
+/** Max chars for edit.diff / run.diff patch fields (`AUVIRA_EVENT_DIFF_MAX_CHARS`). */
+export declare function getDiffMaxChars(): number;
+/** Returns a prefix preview of text (no masking — bus handles that). */
+export declare function previewText(text: string, max?: number): string;
+/** Counts added/removed lines between two file snapshots. */
+export declare function countLineStats(before: string, after: string): {
+    linesAdded: number;
+    linesRemoved: number;
+};
+/** Best-effort unified diff without external dependencies. */
+export declare function buildUnifiedPatch(relPath: string, before: string, after: string): string;
+/** Caps patch length for stream emission. */
+export declare function capPatch(patch: string, maxChars: number): {
+    patch: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=patchUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patchUtils.d.ts","sourceRoot":"","sources":["../../src/agent/patchUtils.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,wBAAgB,eAAe,IAAI,MAAM,CAUxC;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAK1D;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAyB9C;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAiDR;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAKvC"}