@auvira.ai/sdk 0.2.9

package/dist/git/gitDiff.js

@@ -0,0 +1,34 @@
+import { runCommand } from "../tools/runCommand.js";
+function isAgentInternalPath(relPath) {
+    const normalized = relPath.replace(/\\/g, "/");
+    return normalized === ".auvira" || normalized.startsWith(".auvira/");
+}
+/** Returns changed files and unified diff for the current repo state. */
+export async function gitDiff(repoPath) {
+    const nameResult = await runCommand(["git", "diff", "--name-only", "HEAD"], { cwd: repoPath });
+    const diffResult = await runCommand(["git", "diff", "HEAD"], {
+        cwd: repoPath,
+    });
+    const changedFiles = nameResult.stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => Boolean(line) && !isAgentInternalPath(line));
+    return {
+        changedFiles,
+        diff: diffResult.stdout.trim(),
+    };
+}
+/** Initializes git and creates an initial commit when needed. */
+export async function initGitRepo(repoPath) {
+    await runCommand(["git", "init"], { cwd: repoPath });
+    await runCommand(["git", "add", "-A"], { cwd: repoPath });
+    const status = await runCommand(["git", "status", "--porcelain"], {
+        cwd: repoPath,
+    });
+    if (status.stdout.trim()) {
+        await runCommand(["git", "commit", "-m", "Initial workspace snapshot"], {
+            cwd: repoPath,
+        });
+    }
+}
+//# sourceMappingURL=gitDiff.js.map

package/dist/git/gitDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitDiff.js","sourceRoot":"","sources":["../../src/git/gitDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAOpD,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,UAAU,GAAG,MAAM,UAAU,CACjC,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EACtC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAC3D,GAAG,EAAE,QAAQ;KACd,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM;SACnC,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjE,OAAO;QACL,YAAY;QACZ,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrD,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE;QAChE,GAAG,EAAE,QAAQ;KACd,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,UAAU,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,4BAA4B,CAAC,EAAE;YACtE,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/git/maskSecrets.d.ts

@@ -0,0 +1,3 @@
+/** Masks known secret patterns in error messages. */
+export declare function maskSecrets(message: string, secrets: Array<string | undefined>): string;
+//# sourceMappingURL=maskSecrets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maskSecrets.d.ts","sourceRoot":"","sources":["../../src/git/maskSecrets.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GACjC,MAAM,CAcR"}

package/dist/git/maskSecrets.js

@@ -0,0 +1,15 @@
+/** Masks known secret patterns in error messages. */
+export function maskSecrets(message, secrets) {
+    let masked = message;
+    for (const secret of secrets) {
+        if (!secret || secret.length < 4) {
+            continue;
+        }
+        masked = masked.split(secret).join("[REDACTED]");
+    }
+    return masked
+        .replace(/oauth2:[^@\s]+@/g, "oauth2:[REDACTED]@")
+        .replace(/Bearer\s+[A-Za-z0-9._-]+/gi, "Bearer [REDACTED]")
+        .replace(/api[_-]?key[=:\s]+[^\s]+/gi, "api_key=[REDACTED]");
+}
+//# sourceMappingURL=maskSecrets.js.map

package/dist/git/maskSecrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maskSecrets.js","sourceRoot":"","sources":["../../src/git/maskSecrets.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAAkC;IAElC,IAAI,MAAM,GAAG,OAAO,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM;SACV,OAAO,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;SACjD,OAAO,CAAC,4BAA4B,EAAE,mBAAmB,CAAC;SAC1D,OAAO,CAAC,4BAA4B,EAAE,oBAAoB,CAAC,CAAC;AACjE,CAAC"}

package/dist/git/resolveGitLabProject.d.ts

@@ -0,0 +1,26 @@
+import type { AgentGitLabConfig } from "../agent/types.js";
+export interface ResolvedGitLabProject {
+    projectUrl: string;
+    token: string;
+    branch: string;
+    gitlabProjectId?: number;
+    pathWithNamespace?: string;
+}
+export interface GitLabProjectApiRecord {
+    id: number;
+    http_url_to_repo: string;
+    path_with_namespace: string;
+    default_branch?: string;
+}
+/** Normalizes GITLAB_BASE_URL to the GitLab API v4 root. */
+export declare function normalizeGitLabApiBaseUrl(baseUrl?: string): string;
+/** Returns GitLab web origin (e.g. https://gitlab.com) from API base URL. */
+export declare function gitLabWebOriginFromApiBase(apiBaseUrl: string): string;
+/** Fetches GitLab project metadata from the API. */
+export declare function fetchGitLabProjectById(projectId: string | number, options?: {
+    apiBaseUrl?: string;
+    token?: string;
+}): Promise<GitLabProjectApiRecord>;
+/** Resolves GitLab config from projectUrl, numeric projectId, or env defaults. */
+export declare function resolveGitLabProject(config: AgentGitLabConfig): Promise<ResolvedGitLabProject>;
+//# sourceMappingURL=resolveGitLabProject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveGitLabProject.d.ts","sourceRoot":"","sources":["../../src/git/resolveGitLabProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErE;AAaD,oDAAoD;AACpD,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,sBAAsB,CAAC,CA4BjC;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAgChC"}

package/dist/git/resolveGitLabProject.js

@@ -0,0 +1,68 @@
+import { AgentConfigError } from "../agent/types.js";
+import { sanitizeGitLabUrl } from "./sanitizeGitLabUrl.js";
+/** Normalizes GITLAB_BASE_URL to the GitLab API v4 root. */
+export function normalizeGitLabApiBaseUrl(baseUrl) {
+    const raw = (baseUrl ?? process.env.GITLAB_BASE_URL ?? "https://gitlab.com/api/v4").trim();
+    return raw.replace(/\/+$/, "");
+}
+/** Returns GitLab web origin (e.g. https://gitlab.com) from API base URL. */
+export function gitLabWebOriginFromApiBase(apiBaseUrl) {
+    return apiBaseUrl.replace(/\/api\/v4\/?$/, "");
+}
+function resolveToken(config) {
+    const token = config?.token?.trim() || process.env.GITLAB_TOKEN?.trim();
+    if (!token) {
+        throw new AgentConfigError("gitlab.token or GITLAB_TOKEN env var is required", "INVALID_CONFIG");
+    }
+    return token;
+}
+/** Fetches GitLab project metadata from the API. */
+export async function fetchGitLabProjectById(projectId, options) {
+    const apiBaseUrl = normalizeGitLabApiBaseUrl(options?.apiBaseUrl);
+    const token = options?.token ?? process.env.GITLAB_TOKEN?.trim();
+    if (!token) {
+        throw new AgentConfigError("GITLAB_TOKEN is required", "INVALID_CONFIG");
+    }
+    const encodedId = encodeURIComponent(String(projectId));
+    const response = await fetch(`${apiBaseUrl}/projects/${encodedId}`, {
+        headers: {
+            "PRIVATE-TOKEN": token,
+        },
+    });
+    const payload = (await response.json());
+    if (!response.ok) {
+        throw new Error(payload.message ?? `GitLab project lookup failed (${response.status})`);
+    }
+    if (!payload.http_url_to_repo) {
+        throw new Error("GitLab project response missing http_url_to_repo");
+    }
+    return payload;
+}
+/** Resolves GitLab config from projectUrl, numeric projectId, or env defaults. */
+export async function resolveGitLabProject(config) {
+    const token = resolveToken(config);
+    const apiBaseUrl = normalizeGitLabApiBaseUrl(process.env.GITLAB_BASE_URL);
+    if (config.projectUrl?.trim()) {
+        const projectUrl = sanitizeGitLabUrl(config.projectUrl);
+        return {
+            projectUrl,
+            token,
+            branch: config.branch ?? "main",
+        };
+    }
+    if (config.projectId !== undefined && String(config.projectId).trim()) {
+        const record = await fetchGitLabProjectById(config.projectId, {
+            apiBaseUrl,
+            token,
+        });
+        return {
+            projectUrl: sanitizeGitLabUrl(record.http_url_to_repo),
+            token,
+            branch: config.branch ?? record.default_branch ?? "main",
+            gitlabProjectId: record.id,
+            pathWithNamespace: record.path_with_namespace,
+        };
+    }
+    throw new AgentConfigError("gitlab.projectUrl or gitlab.projectId is required", "INVALID_CONFIG");
+}
+//# sourceMappingURL=resolveGitLabProject.js.map

package/dist/git/resolveGitLabProject.js.map

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

package/dist/git/sanitizeGitLabUrl.d.ts

@@ -0,0 +1,8 @@
+export declare class GitLabUrlError extends Error {
+    constructor(message: string);
+}
+/** Validates and returns a sanitized GitLab HTTPS project URL. */
+export declare function sanitizeGitLabUrl(url: string): string;
+/** Builds an authenticated clone URL without logging the token. */
+export declare function buildGitLabCloneUrl(projectUrl: string, token: string): string;
+//# sourceMappingURL=sanitizeGitLabUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeGitLabUrl.d.ts","sourceRoot":"","sources":["../../src/git/sanitizeGitLabUrl.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAcD,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBrD;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7E"}

package/dist/git/sanitizeGitLabUrl.js

@@ -0,0 +1,38 @@
+export class GitLabUrlError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GitLabUrlError";
+    }
+}
+const GITLAB_HOST_PATTERN = /^https:\/\/gitlab\.com\/[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*\.git$/;
+const UNSAFE_URL_PATTERNS = [
+    /^git@/,
+    /^ssh:/,
+    /^file:/,
+    /^https:\/\/[^/]+@/,
+    /^https:\/\/[^:]+:[^@]+@/,
+    /[;&|`$()<>]/,
+];
+/** Validates and returns a sanitized GitLab HTTPS project URL. */
+export function sanitizeGitLabUrl(url) {
+    const trimmed = url.trim();
+    for (const pattern of UNSAFE_URL_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            throw new GitLabUrlError(`Rejected GitLab URL: ${trimmed}`);
+        }
+    }
+    if (!trimmed.startsWith("https://gitlab.com/")) {
+        throw new GitLabUrlError("Only https://gitlab.com project URLs are supported");
+    }
+    if (!GITLAB_HOST_PATTERN.test(trimmed)) {
+        throw new GitLabUrlError(`Invalid GitLab project URL format: ${trimmed}`);
+    }
+    return trimmed;
+}
+/** Builds an authenticated clone URL without logging the token. */
+export function buildGitLabCloneUrl(projectUrl, token) {
+    const sanitized = sanitizeGitLabUrl(projectUrl);
+    const withoutProtocol = sanitized.replace(/^https:\/\//, "");
+    return `https://oauth2:${encodeURIComponent(token)}@${withoutProtocol}`;
+}
+//# sourceMappingURL=sanitizeGitLabUrl.js.map

package/dist/git/sanitizeGitLabUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizeGitLabUrl.js","sourceRoot":"","sources":["../../src/git/sanitizeGitLabUrl.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,mBAAmB,GACvB,qEAAqE,CAAC;AAExE,MAAM,mBAAmB,GAAG;IAC1B,OAAO;IACP,OAAO;IACP,QAAQ;IACR,mBAAmB;IACnB,yBAAyB;IACzB,aAAa;CACd,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,cAAc,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,cAAc,CACtB,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,cAAc,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,KAAa;IACnE,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { Agent } from "./agent/Agent.js";
+export { AgentRun } from "./agent/AgentRun.js";
+export { AgentConfigError, CursorAgentError, } from "./agent/types.js";
+export { AgentNotFoundError } from "./agent/AgentRegistry.js";
+export type { AgentCreateOptions, AgentPromptOptions, AgentSendOptions, AgentSendPayload, AgentImageInput, AgentWorkspaceMode, AgentRunResult, AgentRunStatus, AgentModelConfig, AgentCompletionOptions, CompletionContractContext, SelectedDomContext, ConversationTurn, } from "./agent/types.js";
+export type { HarnessPinnedTarget } from "./providers/custom/harnessPinTypes.js";
+export type { WorkspaceCheckpoint, WorkspaceDiffResult } from "./workspace/workspaceCheckpoint.js";
+export type { TaskCompletionDecision } from "./agent/evaluateTaskCompletion.js";
+export type { AgentRunEvent, AgentRunEventType, AgentToolName, AssistantContentBlock, CompletionEvaluatedEvent, EditDiffEvent, RunContinueEvent, RunDiffEvent, RunEarlyFinishEvent, } from "./agent/events.js";
+export { AGENT_TOOL_NAMES, isToolEvent, isAssistantEvent, } from "./agent/events.js";
+export { getAssistantEventText } from "./agent/assistantEvent.js";
+export type { AgentRunOperation } from "./agent/AgentRun.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACnG,YAAY,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Agent } from "./agent/Agent.js";
+export { AgentRun } from "./agent/AgentRun.js";
+export { AgentConfigError, CursorAgentError, } from "./agent/types.js";
+export { AgentNotFoundError } from "./agent/AgentRegistry.js";
+export { AGENT_TOOL_NAMES, isToolEvent, isAssistantEvent, } from "./agent/events.js";
+export { getAssistantEventText } from "./agent/assistantEvent.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA8B9D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/providers/agentic/AgenticCustomProvider.d.ts

@@ -0,0 +1,9 @@
+import type { ProviderRunInput, ProviderRunOutput } from "../types.js";
+/** Agentic custom provider: multi-turn grep/read/edit tool loop. */
+export declare function runAgenticCustomProvider(input: ProviderRunInput): Promise<ProviderRunOutput>;
+export type AgentMode = "agentic" | "json";
+/** Resolves agent mode from env and harness context. */
+export declare function resolveAgentMode(input: {
+    harnessPrompt?: boolean;
+}): AgentMode;
+//# sourceMappingURL=AgenticCustomProvider.d.ts.map

package/dist/providers/agentic/AgenticCustomProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticCustomProvider.d.ts","sourceRoot":"","sources":["../../../src/providers/agentic/AgenticCustomProvider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqFvE,oEAAoE;AACpE,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAmU5B;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3C,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,SAAS,CASZ"}

package/dist/providers/agentic/AgenticCustomProvider.js

@@ -0,0 +1,366 @@
+import { buildAssistantEvent } from "../../agent/assistantEvent.js";
+import { buildAgentPrompt } from "../../agent/buildAgentPrompt.js";
+import { throwIfCancelled } from "../../agent/cancellation.js";
+import { splitHarnessPrompt } from "../../agent/parseSendPayload.js";
+import { gitDiff } from "../../git/gitDiff.js";
+import { hasAllowlistedChanges } from "../../agent/tools/pathGuard.js";
+import { extractAllowedWritePaths, extractPinnedTargetFromHarness, formatPinnedTargetLabel, harnessTargetFromDom, mergePinnedTarget, } from "../custom/harnessPrompt.js";
+import { imagesToDataUrls } from "../custom/visionImages.js";
+import { buildUserMessage, runAgentToolLoop } from "./agentLoop.js";
+import { compilePriomptContext, } from "./priomptContext.js";
+import { buildSeedContextBlocks } from "./seedRetrieval.js";
+import { getRepairMaxToolCalls } from "./toolPolicy.js";
+async function loadScreenshotDataUrl(screenshotPath) {
+    if (!screenshotPath) {
+        return undefined;
+    }
+    const { fileExists } = await import("../../tools/fileExists.js");
+    const { promises: fs } = await import("node:fs");
+    if (!(await fileExists(screenshotPath))) {
+        return undefined;
+    }
+    const buffer = await fs.readFile(screenshotPath);
+    const mime = screenshotPath.endsWith(".png") ? "image/png" : "image/jpeg";
+    return `data:${mime};base64,${buffer.toString("base64")}`;
+}
+function buildAgenticSystemRules(harnessPrompt) {
+    if (harnessPrompt) {
+        const lines = [
+            "You are Auvira Agent, a Cursor-compatible coding agent.",
+            "HARNESS EDIT CONTRACT:",
+            "- Seed excerpts are authoritative.",
+            "- Apply focused mutations to ALLOWED WRITE PATHS as soon as the target is identified.",
+            "- The loop may continue if the current diff does not yet satisfy the owner request.",
+            "- Do not grep/read after a satisfying edit.",
+            "- Max 2 verify reads after editing.",
+            "- For style/vibe edits, use Tailwind/CSS/siteConfig instead of broad repo exploration.",
+            "Only edit files under ALLOWED_WRITE PATHS. Do not run shell/terminal commands.",
+            "When finished, respond with a concise summary of what you changed.",
+        ];
+        return lines.join("\n");
+    }
+    return [
+        "You are Auvira Agent, a Cursor-compatible coding agent.",
+        "Use tools to explore the repository before editing.",
+        "Workflow: grep to locate files → read to copy exact strings → search_replace to edit.",
+        "Use write only when search_replace cannot apply or for full-file updates.",
+        "Make the smallest safe change that satisfies the request.",
+        "When finished, respond with a concise summary of what you changed.",
+    ].join("\n");
+}
+function buildPinnedBlock(selectedDom, pinnedLabel) {
+    if (!selectedDom && !pinnedLabel) {
+        return undefined;
+    }
+    const content = [
+        pinnedLabel ? `Pinned target: ${pinnedLabel}` : undefined,
+        selectedDom ? JSON.stringify(selectedDom, null, 2) : undefined,
+    ]
+        .filter(Boolean)
+        .join("\n");
+    return {
+        id: "pinned-target",
+        priority: 1,
+        label: "pinned",
+        content,
+    };
+}
+/** Agentic custom provider: multi-turn grep/read/edit tool loop. */
+export async function runAgenticCustomProvider(input) {
+    const model = input.model;
+    const bus = input.events;
+    const baseURL = model.baseURL?.replace(/\/+$/, "");
+    const apiKey = model.apiKey;
+    if (!baseURL || !apiKey) {
+        return {
+            ok: false,
+            response: "",
+            summary: "Custom model provider requires baseURL and apiKey",
+            error: {
+                message: "model.baseURL and model.apiKey are required for custom provider",
+                code: "PROVIDER_ERROR",
+            },
+        };
+    }
+    throwIfCancelled(input.signal);
+    const harnessPrompt = input.harnessPrompt === true;
+    const allowedWritePaths = harnessPrompt
+        ? extractAllowedWritePaths(input.prompt)
+        : undefined;
+    const pinnedTargetStruct = harnessPrompt
+        ? mergePinnedTarget(harnessTargetFromDom(input.selectedDom), extractPinnedTargetFromHarness(input.prompt))
+        : harnessTargetFromDom(input.selectedDom);
+    const pinnedLabel = formatPinnedTargetLabel(pinnedTargetStruct) ??
+        (input.selectedDom?.componentHint ?? input.selectedDom?.sectionTitle);
+    const seedBlocks = await buildSeedContextBlocks({
+        repoPath: input.repoPath,
+        prompt: input.prompt,
+        selectedDom: input.selectedDom,
+        harnessPrompt,
+        pinnedTarget: pinnedTargetStruct,
+    });
+    bus?.emit({
+        type: "context.files_selected",
+        files: seedBlocks
+            .map((block) => block.id.startsWith("seed-") && block.id !== "seed-grep-selectedDom"
+            ? block.id.slice("seed-".length)
+            : block.label)
+            .filter((file) => !file.startsWith("grep:")),
+    });
+    const screenshotDataUrl = await loadScreenshotDataUrl(input.screenshotPath);
+    const imageDataUrls = input.images && input.images.length > 0
+        ? imagesToDataUrls(input.images)
+        : screenshotDataUrl
+            ? [screenshotDataUrl]
+            : [];
+    const hasVision = imageDataUrls.length > 0;
+    const harnessSplit = harnessPrompt ? splitHarnessPrompt(input.prompt) : undefined;
+    const ownerRequest = harnessSplit?.user ?? input.prompt;
+    const blocks = [];
+    if (harnessPrompt) {
+        const { system, user } = harnessSplit;
+        blocks.push({
+            id: "harness-system",
+            priority: 0,
+            label: "harness-system",
+            content: system.trim() || buildAgenticSystemRules(true),
+        });
+        if (allowedWritePaths?.length) {
+            blocks.push({
+                id: "allowlist",
+                priority: 0,
+                label: "allowlist",
+                content: `ALLOWED_WRITE_PATHS:\n${allowedWritePaths.map((p) => `- ${p}`).join("\n")}`,
+            });
+        }
+        const pinned = buildPinnedBlock(input.selectedDom, pinnedLabel);
+        if (pinned) {
+            blocks.push(pinned);
+        }
+        blocks.push({
+            id: "owner-request",
+            priority: 2,
+            label: "owner-request",
+            content: user,
+        });
+    }
+    else {
+        blocks.push({
+            id: "system",
+            priority: 0,
+            label: "system",
+            content: buildAgenticSystemRules(false),
+        });
+        const pinned = buildPinnedBlock(input.selectedDom, pinnedLabel);
+        if (pinned) {
+            blocks.push(pinned);
+        }
+        blocks.push({
+            id: "user-request",
+            priority: 2,
+            label: "user-request",
+            content: buildAgentPrompt({
+                prompt: input.prompt,
+                screenshotPath: input.screenshotPath,
+                selectedDom: input.selectedDom,
+                validationCommand: "npm run build",
+            }),
+        });
+    }
+    blocks.push(...seedBlocks);
+    const compiled = compilePriomptContext({ blocks });
+    const messages = [
+        { role: "system", content: compiled.system },
+    ];
+    for (const turn of input.conversationHistory ?? []) {
+        if (turn.role === "user" || turn.role === "assistant") {
+            messages.push({ role: turn.role, content: turn.content });
+        }
+    }
+    messages.push({
+        role: "user",
+        content: buildUserMessage(compiled.user, imageDataUrls),
+    });
+    const loopResult = await runAgentToolLoop({
+        baseURL,
+        apiKey,
+        modelId: model.id,
+        model,
+        messages,
+        repoPath: input.repoPath,
+        allowedWritePaths,
+        enforceAllowlist: harnessPrompt,
+        harnessMode: harnessPrompt,
+        hasVision,
+        selectedDom: input.selectedDom,
+        completion: input.completion,
+        workspaceCheckpoint: input.workspaceCheckpoint,
+        completionAuto: input.completion?.auto !== false,
+        completionEvaluationEnabled: harnessPrompt,
+        completionConfidenceThreshold: input.completion?.confidenceThreshold,
+        referenceImages: imageDataUrls,
+        ownerRequest,
+        timeoutMs: input.timeoutMs,
+        signal: input.signal,
+        bus,
+    });
+    let diffResult = input.workspaceCheckpoint
+        ? await input.workspaceCheckpoint.diff()
+        : await gitDiff(input.repoPath);
+    const harnessDiffOk = harnessPrompt &&
+        hasAllowlistedChanges(diffResult.changedFiles, allowedWritePaths);
+    const changedBeforeRetry = diffResult.changedFiles.length;
+    if (harnessPrompt &&
+        loopResult.editsApplied === 0 &&
+        changedBeforeRetry === 0 &&
+        !loopResult.ok) {
+        const retryMessage = "APPLY RETRY — your last turn did not change any allowlisted files. Use search_replace or write on ALLOWED_WRITE_PATHS now.";
+        messages.push({ role: "user", content: retryMessage });
+        const retryResult = await runAgentToolLoop({
+            baseURL,
+            apiKey,
+            modelId: model.id,
+            model,
+            messages,
+            repoPath: input.repoPath,
+            allowedWritePaths,
+            enforceAllowlist: true,
+            harnessMode: harnessPrompt,
+            hasVision,
+            selectedDom: input.selectedDom,
+            completion: input.completion,
+            workspaceCheckpoint: input.workspaceCheckpoint,
+            completionAuto: input.completion?.auto !== false,
+            completionEvaluationEnabled: harnessPrompt,
+            completionConfidenceThreshold: input.completion?.confidenceThreshold,
+            referenceImages: imageDataUrls,
+            ownerRequest,
+            timeoutMs: input.timeoutMs,
+            signal: input.signal,
+            bus,
+            maxToolCalls: getRepairMaxToolCalls(),
+        });
+        diffResult = input.workspaceCheckpoint
+            ? await input.workspaceCheckpoint.diff()
+            : await gitDiff(input.repoPath);
+        if (retryResult.editsApplied > 0 || diffResult.changedFiles.length > 0) {
+            return {
+                ok: true,
+                response: retryResult.response,
+                summary: retryResult.summary,
+                usage: {
+                    model: model.id,
+                    provider: "custom",
+                    inputTokens: retryResult.usage?.prompt_tokens,
+                    outputTokens: retryResult.usage?.completion_tokens,
+                    totalTokens: retryResult.usage?.total_tokens,
+                },
+            };
+        }
+    }
+    if (harnessDiffOk || loopResult.earlyFinish) {
+        return {
+            ok: true,
+            response: loopResult.response,
+            summary: loopResult.summary,
+            usage: {
+                model: model.id,
+                provider: "custom",
+                inputTokens: loopResult.usage?.prompt_tokens,
+                outputTokens: loopResult.usage?.completion_tokens,
+                totalTokens: loopResult.usage?.total_tokens,
+            },
+            diagnostics: loopResult.abortReason === "tool_budget_exceeded"
+                ? {
+                    abortReason: loopResult.abortReason,
+                    toolCallCount: loopResult.toolCallCount,
+                    editsApplied: loopResult.editsApplied,
+                    changedFiles: diffResult.changedFiles,
+                    providerCode: "PARTIAL_SUCCESS_BUDGET",
+                }
+                : undefined,
+        };
+    }
+    if (loopResult.ok && (loopResult.editsApplied > 0 || diffResult.changedFiles.length > 0)) {
+        return {
+            ok: true,
+            response: loopResult.response,
+            summary: loopResult.summary,
+            usage: {
+                model: model.id,
+                provider: "custom",
+                inputTokens: loopResult.usage?.prompt_tokens,
+                outputTokens: loopResult.usage?.completion_tokens,
+                totalTokens: loopResult.usage?.total_tokens,
+            },
+        };
+    }
+    if (loopResult.error) {
+        if (harnessPrompt &&
+            loopResult.abortReason === "tool_budget_exceeded" &&
+            hasAllowlistedChanges(diffResult.changedFiles, allowedWritePaths)) {
+            return {
+                ok: true,
+                response: loopResult.response,
+                summary: loopResult.summary,
+                usage: {
+                    model: model.id,
+                    provider: "custom",
+                    inputTokens: loopResult.usage?.prompt_tokens,
+                    outputTokens: loopResult.usage?.completion_tokens,
+                    totalTokens: loopResult.usage?.total_tokens,
+                },
+                diagnostics: {
+                    abortReason: loopResult.abortReason,
+                    toolCallCount: loopResult.toolCallCount,
+                    editsApplied: loopResult.editsApplied,
+                    changedFiles: diffResult.changedFiles,
+                    providerCode: "PARTIAL_SUCCESS_BUDGET",
+                },
+            };
+        }
+        return {
+            ok: false,
+            response: loopResult.response,
+            summary: loopResult.summary,
+            error: {
+                message: loopResult.error.message,
+                code: loopResult.error.code,
+            },
+            diagnostics: {
+                abortReason: loopResult.abortReason,
+                toolCallCount: loopResult.toolCallCount,
+                editsApplied: loopResult.editsApplied,
+                providerCode: loopResult.error.code,
+            },
+        };
+    }
+    bus?.emit(buildAssistantEvent(loopResult.response || "No edits applied"));
+    return {
+        ok: false,
+        response: loopResult.response,
+        summary: loopResult.summary,
+        error: {
+            message: loopResult.abortReason ?? "No edits applied",
+            code: "EDIT_NOT_APPLIED",
+        },
+        diagnostics: {
+            abortReason: loopResult.abortReason,
+            toolCallCount: loopResult.toolCallCount,
+            editsApplied: loopResult.editsApplied,
+            providerCode: "EDIT_NOT_APPLIED",
+        },
+    };
+}
+/** Resolves agent mode from env and harness context. */
+export function resolveAgentMode(input) {
+    const raw = process.env.AUVIRA_AGENT_MODE?.trim().toLowerCase();
+    if (raw === "json") {
+        return "json";
+    }
+    if (raw === "agentic") {
+        return "agentic";
+    }
+    return input.harnessPrompt ? "agentic" : "json";
+}
+//# sourceMappingURL=AgenticCustomProvider.js.map