@auvira.ai/sdk 0.2.9

package/dist/agent/tools/read.js

@@ -0,0 +1,41 @@
+import { promises as fs } from "node:fs";
+import { fileExists } from "../../tools/fileExists.js";
+import { resolveRepoPath, toRepoRelativePath } from "./pathGuard.js";
+const MAX_READ_CHARS = 48_000;
+/** Reads a file from the workspace with optional line range. */
+export async function executeReadTool(ctx, input) {
+    if (!input.path?.trim()) {
+        return { ok: false, output: "read requires path" };
+    }
+    const absolutePath = resolveRepoPath(ctx.repoPath, input.path);
+    if (!(await fileExists(absolutePath))) {
+        return { ok: false, output: `File not found: ${input.path}` };
+    }
+    const content = await fs.readFile(absolutePath, "utf8");
+    const lines = content.split("\n");
+    const offset = Math.max(1, input.offset ?? 1);
+    const limit = input.limit ?? lines.length;
+    const slice = lines.slice(offset - 1, offset - 1 + limit);
+    const numbered = slice
+        .map((line, index) => `${offset + index}|${line}`)
+        .join("\n");
+    const relPath = toRepoRelativePath(ctx.repoPath, absolutePath);
+    const output = numbered.length > MAX_READ_CHARS
+        ? `${numbered.slice(0, MAX_READ_CHARS)}\n... (truncated)`
+        : numbered;
+    const previewLines = slice.slice(0, 8);
+    const preview = previewLines
+        .map((line, index) => `${offset + index}|${line}`)
+        .join("\n");
+    return {
+        ok: true,
+        output: `--- ${relPath} ---\n${output}`,
+        path: relPath,
+        meta: {
+            path: relPath,
+            lineCount: slice.length,
+            preview,
+        },
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/agent/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/agent/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGrE,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAyB,EACzB,KAAoB;IAEpB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,KAAK;SACnB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,MAAM,GACV,QAAQ,CAAC,MAAM,GAAG,cAAc;QAC9B,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,mBAAmB;QACzD,CAAC,CAAC,QAAQ,CAAC;IAEf,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,YAAY;SACzB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,OAAO,OAAO,SAAS,MAAM,EAAE;QACvC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/tools/types.d.ts

@@ -0,0 +1,46 @@
+export interface ToolExecutionResult {
+    ok: boolean;
+    output: string;
+    /** True when a mutating tool changed file content. */
+    applied?: boolean;
+    path?: string;
+    error?: string;
+    meta?: Record<string, unknown>;
+    patch?: {
+        path: string;
+        before: string;
+        after: string;
+    };
+}
+export interface ToolExecutionContext {
+    repoPath: string;
+    allowedWritePaths?: string[];
+    enforceAllowlist?: boolean;
+}
+export interface GrepToolInput {
+    pattern: string;
+    path?: string;
+    glob?: string;
+}
+export interface ReadToolInput {
+    path: string;
+    offset?: number;
+    limit?: number;
+}
+export interface GlobToolInput {
+    globPattern: string;
+    targetDirectory?: string;
+}
+export interface SearchReplaceToolInput {
+    path: string;
+    old_string: string;
+    new_string: string;
+}
+export interface WriteToolInput {
+    path: string;
+    contents: string;
+}
+export interface ListDirToolInput {
+    path?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/agent/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":""}

package/dist/agent/tools/write.d.ts

@@ -0,0 +1,4 @@
+import type { ToolExecutionContext, ToolExecutionResult, WriteToolInput } from "./types.js";
+/** Writes full file contents (Cursor write tool / full-file fallback). */
+export declare function executeWriteTool(ctx: ToolExecutionContext, input: WriteToolInput): Promise<ToolExecutionResult>;
+//# sourceMappingURL=write.d.ts.map

package/dist/agent/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/write.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5F,0EAA0E;AAC1E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,mBAAmB,CAAC,CA8D9B"}

package/dist/agent/tools/write.js

@@ -0,0 +1,63 @@
+import { promises as fs } from "node:fs";
+import { dirname } from "node:path";
+import { fileExists } from "../../tools/fileExists.js";
+import { countLineStats, previewText } from "../../agent/patchUtils.js";
+import { isPathAllowlisted, resolveRepoPath, toRepoRelativePath } from "./pathGuard.js";
+/** Writes full file contents (Cursor write tool / full-file fallback). */
+export async function executeWriteTool(ctx, input) {
+    if (!input.path?.trim()) {
+        return { ok: false, output: "write requires path" };
+    }
+    if (input.contents === undefined) {
+        return { ok: false, output: "write requires contents" };
+    }
+    const absolutePath = resolveRepoPath(ctx.repoPath, input.path);
+    const relPath = toRepoRelativePath(ctx.repoPath, absolutePath);
+    if (ctx.enforceAllowlist && ctx.allowedWritePaths?.length) {
+        if (!isPathAllowlisted(relPath, ctx.allowedWritePaths)) {
+            const error = `Write blocked: ${relPath} is not under ALLOWED_WRITE_PATHS`;
+            return {
+                ok: false,
+                output: error,
+                path: relPath,
+                applied: false,
+                error,
+                meta: { path: relPath, applied: false },
+            };
+        }
+    }
+    const existed = await fileExists(absolutePath);
+    const original = existed ? await fs.readFile(absolutePath, "utf8") : "";
+    if (existed && original === input.contents) {
+        return {
+            ok: true,
+            output: `No change: ${relPath} already matches contents`,
+            path: relPath,
+            applied: false,
+            meta: { path: relPath, applied: false },
+        };
+    }
+    if (!existed) {
+        await fs.mkdir(dirname(absolutePath), { recursive: true });
+    }
+    await fs.writeFile(absolutePath, input.contents, "utf8");
+    const stats = countLineStats(original, input.contents);
+    const bytesWritten = Buffer.byteLength(input.contents, "utf8");
+    return {
+        ok: true,
+        output: existed ? `Wrote ${relPath}` : `Created ${relPath}`,
+        path: relPath,
+        applied: true,
+        patch: { path: relPath, before: original, after: input.contents },
+        meta: {
+            path: relPath,
+            bytesWritten,
+            applied: true,
+            oldPreview: previewText(original),
+            newPreview: previewText(input.contents),
+            linesAdded: stats.linesAdded,
+            linesRemoved: stats.linesRemoved,
+        },
+    };
+}
+//# sourceMappingURL=write.js.map

package/dist/agent/tools/write.js.map

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

package/dist/agent/types.d.ts

@@ -0,0 +1,193 @@
+export interface AgentModelConfig {
+    id: string;
+    provider?: "openhands" | "custom";
+    baseURL?: string;
+    apiKey?: string;
+}
+export type AgentWorkspaceMode = "in_place" | "git_copy";
+export interface AgentLocalConfig {
+    cwd: string;
+    /**
+     * `in_place` (default): edit `cwd` directly — Cursor website harness parity.
+     * `git_copy`: isolated scratch copy (legacy tests / sandbox experiments).
+     */
+    workspaceMode?: AgentWorkspaceMode;
+}
+export interface AgentGitLabConfig {
+    projectUrl?: string;
+    /** GitLab numeric project ID resolved via GITLAB_BASE_URL API. */
+    projectId?: string | number;
+    token?: string;
+    branch?: string;
+}
+export interface SelectedDomContext {
+    tagName?: string;
+    text?: string;
+    className?: string;
+    id?: string;
+    testId?: string;
+    href?: string;
+    boundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    componentHint?: string;
+    route?: string;
+    /** Pinned section index from preview UI. */
+    sectionIndex?: number;
+    sectionType?: string;
+    sectionTitle?: string;
+    kind?: "hero" | "section";
+}
+export interface AgentValidationOptions {
+    command?: string;
+    timeoutMs?: number;
+    /** When true, skips post-edit validation (useful for repos with known build issues). */
+    skip?: boolean;
+}
+/** Context passed to harness completion callbacks after each diff check. */
+export interface CompletionContractContext {
+    changedFiles: string[];
+    toolCallCount: number;
+    modelTurnCount: number;
+    hasVisionImages: boolean;
+    hasSelectedDom: boolean;
+    deferredFinishCount: number;
+}
+/** Optional harness completion contract for multi-step vibe/style edits. */
+export interface AgentCompletionOptions {
+    /** Harness marks multi-step edits that need more than one file class. */
+    mode?: "default" | "multi_file_required";
+    /** When true, block early finish until a wiring/config path changes after style assets. */
+    requireWiringAfterStyle?: boolean;
+    /** In-process callback — not serializable over HTTP. */
+    isComplete?: (ctx: CompletionContractContext) => boolean | "continue" | "complete";
+    multiStep?: {
+        minToolCalls?: number;
+        minModelTurns?: number;
+        maxExtraTurnsAfterStyleOnly?: number;
+    };
+    /** Optional regex pattern overrides for style-asset paths. */
+    styleAssetPatterns?: string[];
+    /** Optional regex pattern overrides for wiring paths. */
+    wiringPatterns?: string[];
+    /** When false, skips LLM post-checkpoint completion evaluation. Default true in harness mode. */
+    auto?: boolean;
+    /** Optional per-run confidence threshold override for completion evaluation. */
+    confidenceThreshold?: number;
+}
+export interface AgentCreateOptions {
+    apiKey?: string;
+    model: AgentModelConfig;
+    local?: AgentLocalConfig;
+    gitlab?: AgentGitLabConfig;
+    timeoutMs?: number;
+    /**
+     * @deprecated Use `local.workspaceMode: 'git_copy'` instead.
+     * `true` forces git_copy; omitted defaults to in_place for local cwd.
+     */
+    cleanupWorkspace?: boolean;
+}
+export interface AgentImageInput {
+    data: string;
+    mimeType: string;
+}
+export type AgentSendPayload = string | {
+    text: string;
+    images?: AgentImageInput[];
+};
+export interface AgentSendOptions {
+    screenshotBase64?: string;
+    screenshotPath?: string;
+    selectedDom?: SelectedDomContext;
+    validation?: AgentValidationOptions;
+    /** Harness completion hints for multi-step vibe/style edits. */
+    completion?: AgentCompletionOptions;
+    timeoutMs?: number;
+    /** External abort signal (merged with run.cancel()). */
+    signal?: AbortSignal;
+    /** Reuse the last prepared workspace for multi-turn follow-ups. */
+    reuseWorkspace?: boolean;
+}
+export type AgentPromptOptions = AgentCreateOptions & AgentSendOptions;
+export type AgentRunStatus = "finished" | "error" | "cancelled";
+export interface ConversationTurn {
+    role: "user" | "assistant";
+    content: string;
+    runId?: string;
+}
+export interface AgentRunResult {
+    ok: boolean;
+    /** Cursor-compatible terminal status. */
+    status: AgentRunStatus;
+    /** Run id (matches AgentRun.id / stream runId). */
+    id: string;
+    /** Stable session id for `Agent.resume` across turns. */
+    agentId?: string;
+    response: string;
+    summary: string;
+    changedFiles: string[];
+    diff: string;
+    validation?: {
+        command: string;
+        ok: boolean;
+        stdout: string;
+        stderr: string;
+        exitCode: number | null;
+    };
+    workspace?: {
+        id: string;
+        path: string;
+        repoPath: string;
+        branchName: string;
+    };
+    usage?: {
+        model: string;
+        provider: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    };
+    error?: {
+        message: string;
+        code: string;
+        rateLimit?: {
+            httpStatus?: number;
+            providerStatusCode?: number;
+            retryAfterMs?: number;
+            headers?: Record<string, string>;
+        };
+        timing?: {
+            queueWaitMs: number;
+            requestMs: number;
+            totalMs: number;
+            retries: number;
+        };
+        /** Number of model completion attempts (including repairs). */
+        attempts?: number;
+        /** Last parse/apply failure before giving up. */
+        lastFailure?: string;
+        /** Truncated raw model output from the final attempt. */
+        lastOutputSnippet?: string;
+        /** Whether the failure is safe to retry (Cursor SDK parity). */
+        isRetryable?: boolean;
+    };
+}
+export interface PreparedWorkspace {
+    id: string;
+    path: string;
+    repoPath: string;
+    branchName: string;
+}
+export declare class AgentConfigError extends Error {
+    readonly code: string;
+    readonly isRetryable: boolean;
+    constructor(message: string, code?: string, isRetryable?: boolean);
+}
+/** Cursor SDK alias for startup/config failures. */
+export declare class CursorAgentError extends AgentConfigError {
+    constructor(message: string, code?: string, isRetryable?: boolean);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agent/types.js

@@ -0,0 +1,18 @@
+export class AgentConfigError extends Error {
+    code;
+    isRetryable;
+    constructor(message, code = "INVALID_CONFIG", isRetryable = false) {
+        super(message);
+        this.code = code;
+        this.isRetryable = isRetryable;
+        this.name = "AgentConfigError";
+    }
+}
+/** Cursor SDK alias for startup/config failures. */
+export class CursorAgentError extends AgentConfigError {
+    constructor(message, code = "INVALID_CONFIG", isRetryable = false) {
+        super(message, code, isRetryable);
+        this.name = "CursorAgentError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAuMA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,OAAe,gBAAgB,EAC/B,cAAuB,KAAK;QAE5C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA2B;QAC/B,gBAAW,GAAX,WAAW,CAAiB;QAG5C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,oDAAoD;AACpD,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,YACE,OAAe,EACf,OAAe,gBAAgB,EAC/B,cAAuB,KAAK;QAE5B,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/agent/validateOptions.d.ts

@@ -0,0 +1,12 @@
+import { AgentCreateOptions, AgentSendOptions } from "./types.js";
+/** Validates agent creation options; throws AgentConfigError on failure. */
+export declare function validateCreateOptions(options: AgentCreateOptions): void;
+/** Async validation that resolves GitLab project URL from projectId when needed. */
+export declare function resolveCreateOptions(options: AgentCreateOptions): Promise<AgentCreateOptions>;
+/** Validates send options; throws AgentConfigError on failure. */
+export declare function validateSendOptions(options?: AgentSendOptions): void;
+export declare function splitPromptOptions(options: AgentCreateOptions & AgentSendOptions): {
+    createOptions: AgentCreateOptions;
+    sendOptions: AgentSendOptions;
+};
+//# sourceMappingURL=validateOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateOptions.d.ts","sourceRoot":"","sources":["../../src/agent/validateOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA2DvE;AAED,oFAAoF;AACpF,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAWpE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,GAAG;IAClF,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,gBAAgB,CAAC;CAC/B,CAwBA"}

package/dist/agent/validateOptions.js

@@ -0,0 +1,91 @@
+import { resolveGitLabProject } from "../git/resolveGitLabProject.js";
+import { GitLabUrlError, sanitizeGitLabUrl } from "../git/sanitizeGitLabUrl.js";
+import { resolveModelConfig } from "./resolveModelConfig.js";
+import { AgentConfigError, } from "./types.js";
+/** Validates agent creation options; throws AgentConfigError on failure. */
+export function validateCreateOptions(options) {
+    if (!options.model?.id?.trim()) {
+        throw new AgentConfigError("model.id is required", "INVALID_CONFIG");
+    }
+    const hasLocal = Boolean(options.local);
+    const hasGitlab = Boolean(options.gitlab);
+    if (hasLocal && hasGitlab) {
+        throw new AgentConfigError("Provide exactly one of local or gitlab, not both", "INVALID_CONFIG");
+    }
+    if (!hasLocal && !hasGitlab) {
+        throw new AgentConfigError("Provide exactly one of local or gitlab", "INVALID_CONFIG");
+    }
+    if (options.local && !options.local.cwd?.trim()) {
+        throw new AgentConfigError("local.cwd is required", "INVALID_CONFIG");
+    }
+    if (options.gitlab) {
+        const hasProjectUrl = Boolean(options.gitlab.projectUrl?.trim());
+        const hasProjectId = options.gitlab.projectId !== undefined &&
+            String(options.gitlab.projectId).trim() !== "";
+        if (!hasProjectUrl && !hasProjectId) {
+            throw new AgentConfigError("gitlab.projectUrl or gitlab.projectId is required", "INVALID_CONFIG");
+        }
+        const token = options.gitlab.token?.trim() || process.env.GITLAB_TOKEN?.trim();
+        if (!token) {
+            throw new AgentConfigError("gitlab.token or GITLAB_TOKEN env var is required", "INVALID_CONFIG");
+        }
+        if (hasProjectUrl) {
+            try {
+                sanitizeGitLabUrl(options.gitlab.projectUrl);
+            }
+            catch (error) {
+                if (error instanceof GitLabUrlError) {
+                    throw new AgentConfigError(error.message, "INVALID_CONFIG");
+                }
+                throw error;
+            }
+        }
+    }
+}
+/** Async validation that resolves GitLab project URL from projectId when needed. */
+export async function resolveCreateOptions(options) {
+    validateCreateOptions(options);
+    const resolved = {
+        ...options,
+        model: resolveModelConfig(options.model),
+    };
+    if (!resolved.gitlab) {
+        return resolved;
+    }
+    const gitlabResolved = await resolveGitLabProject(resolved.gitlab);
+    return {
+        ...resolved,
+        gitlab: {
+            ...resolved.gitlab,
+            projectUrl: gitlabResolved.projectUrl,
+            token: gitlabResolved.token,
+            branch: gitlabResolved.branch,
+            projectId: gitlabResolved.gitlabProjectId ?? resolved.gitlab.projectId,
+        },
+    };
+}
+/** Validates send options; throws AgentConfigError on failure. */
+export function validateSendOptions(options) {
+    if (!options) {
+        return;
+    }
+    if (options.screenshotBase64 && options.screenshotPath) {
+        throw new AgentConfigError("Provide screenshotBase64 or screenshotPath, not both", "INVALID_CONFIG");
+    }
+}
+export function splitPromptOptions(options) {
+    const { screenshotBase64, screenshotPath, selectedDom, validation, completion, timeoutMs: sendTimeoutMs, ...createFields } = options;
+    const sendOptions = {
+        screenshotBase64,
+        screenshotPath,
+        selectedDom,
+        validation,
+        completion,
+        timeoutMs: sendTimeoutMs,
+    };
+    return {
+        createOptions: createFields,
+        sendOptions,
+    };
+}
+//# sourceMappingURL=validateOptions.js.map

package/dist/agent/validateOptions.js.map

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

package/dist/git/cloneGitLabProject.d.ts

@@ -0,0 +1,10 @@
+import type { AgentGitLabConfig } from "../agent/types.js";
+export interface CloneGitLabResult {
+    repoPath: string;
+    branchName: string;
+}
+/** Clones a GitLab project into the workspace and creates an agent branch. */
+export declare function cloneGitLabProject(workspacePath: string, config: AgentGitLabConfig): Promise<CloneGitLabResult>;
+/** Initializes git in a copied local repo. */
+export declare function prepareLocalGitRepo(repoPath: string): Promise<string>;
+//# sourceMappingURL=cloneGitLabProject.d.ts.map

package/dist/git/cloneGitLabProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneGitLabProject.d.ts","sourceRoot":"","sources":["../../src/git/cloneGitLabProject.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;AAED,8CAA8C;AAC9C,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3E"}

package/dist/git/cloneGitLabProject.js

@@ -0,0 +1,24 @@
+import { runCommand } from "../tools/runCommand.js";
+import { createAgentBranch } from "./createAgentBranch.js";
+import { initGitRepo } from "./gitDiff.js";
+import { buildGitLabCloneUrl } from "./sanitizeGitLabUrl.js";
+import { resolveGitLabProject } from "./resolveGitLabProject.js";
+/** Clones a GitLab project into the workspace and creates an agent branch. */
+export async function cloneGitLabProject(workspacePath, config) {
+    const resolved = await resolveGitLabProject(config);
+    const repoPath = `${workspacePath}/repo`;
+    const cloneUrl = buildGitLabCloneUrl(resolved.projectUrl, resolved.token);
+    const branch = resolved.branch;
+    const clone = await runCommand(["git", "clone", "--depth", "1", "--branch", branch, cloneUrl, repoPath], { cwd: workspacePath, timeoutMs: 180_000 });
+    if (!clone.ok) {
+        throw new Error(`GitLab clone failed: ${clone.stderr || clone.stdout}`);
+    }
+    const branchName = await createAgentBranch(repoPath);
+    return { repoPath, branchName };
+}
+/** Initializes git in a copied local repo. */
+export async function prepareLocalGitRepo(repoPath) {
+    await initGitRepo(repoPath);
+    return createAgentBranch(repoPath);
+}
+//# sourceMappingURL=cloneGitLabProject.js.map

package/dist/git/cloneGitLabProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneGitLabProject.js","sourceRoot":"","sources":["../../src/git/cloneGitLabProject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAQjE,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAqB,EACrB,MAAyB;IAEzB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,GAAG,aAAa,OAAO,CAAC;IACzC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE/B,MAAM,KAAK,GAAG,MAAM,UAAU,CAC5B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACxE,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,CAC3C,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAErD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB;IACxD,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/git/createAgentBranch.d.ts

@@ -0,0 +1,3 @@
+/** Creates a new agent branch in the repository. */
+export declare function createAgentBranch(repoPath: string): Promise<string>;
+//# sourceMappingURL=createAgentBranch.d.ts.map

package/dist/git/createAgentBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentBranch.d.ts","sourceRoot":"","sources":["../../src/git/createAgentBranch.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAezE"}

package/dist/git/createAgentBranch.js

@@ -0,0 +1,14 @@
+import { runCommand } from "../tools/runCommand.js";
+/** Creates a new agent branch in the repository. */
+export async function createAgentBranch(repoPath) {
+    const shortRandom = Math.random().toString(36).slice(2, 8);
+    const branchName = `auvira/edit-${Date.now()}-${shortRandom}`;
+    const checkout = await runCommand(["git", "checkout", "-b", branchName], {
+        cwd: repoPath,
+    });
+    if (!checkout.ok) {
+        throw new Error(`Failed to create agent branch: ${checkout.stderr || checkout.stdout}`);
+    }
+    return branchName;
+}
+//# sourceMappingURL=createAgentBranch.js.map

package/dist/git/createAgentBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAgentBranch.js","sourceRoot":"","sources":["../../src/git/createAgentBranch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,EAAE,CAAC;IAE9D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE;QACvE,GAAG,EAAE,QAAQ;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/git/gitDiff.d.ts

@@ -0,0 +1,9 @@
+export interface GitDiffResult {
+    changedFiles: string[];
+    diff: string;
+}
+/** Returns changed files and unified diff for the current repo state. */
+export declare function gitDiff(repoPath: string): Promise<GitDiffResult>;
+/** Initializes git and creates an initial commit when needed. */
+export declare function initGitRepo(repoPath: string): Promise<void>;
+//# sourceMappingURL=gitDiff.d.ts.map

package/dist/git/gitDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitDiff.d.ts","sourceRoot":"","sources":["../../src/git/gitDiff.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,yEAAyE;AACzE,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBtE;AAED,iEAAiE;AACjE,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE"}