@auvira.ai/sdk 0.2.9

package/dist/workspace/cleanupWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupWorkspace.js","sourceRoot":"","sources":["../../src/workspace/cleanupWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,aAAqB;IAC1D,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/workspace/copyLocalRepo.d.ts

@@ -0,0 +1,5 @@
+/** Copies a local repo into the workspace excluding heavy/generated dirs. */
+export declare function copyLocalRepo(sourceCwd: string, workspacePath: string): Promise<string>;
+/** Validates that the local cwd exists. */
+export declare function assertLocalCwdExists(cwd: string): Promise<void>;
+//# sourceMappingURL=copyLocalRepo.d.ts.map

package/dist/workspace/copyLocalRepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyLocalRepo.d.ts","sourceRoot":"","sources":["../../src/workspace/copyLocalRepo.ts"],"names":[],"mappings":"AAaA,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAYD,2CAA2C;AAC3C,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE"}

package/dist/workspace/copyLocalRepo.js

@@ -0,0 +1,34 @@
+import { cp, mkdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { fileExists } from "../tools/fileExists.js";
+const EXCLUDED_DIRS = new Set([
+    "node_modules",
+    ".next",
+    "dist",
+    "build",
+    ".git",
+    "coverage",
+]);
+/** Copies a local repo into the workspace excluding heavy/generated dirs. */
+export async function copyLocalRepo(sourceCwd, workspacePath) {
+    const repoPath = join(workspacePath, basename(sourceCwd) || "repo");
+    await mkdir(repoPath, { recursive: true });
+    await copyDirectory(sourceCwd, repoPath);
+    return repoPath;
+}
+async function copyDirectory(source, destination) {
+    await cp(source, destination, {
+        recursive: true,
+        filter: (src) => {
+            const parts = src.split(/[/\\]/);
+            return !parts.some((part) => EXCLUDED_DIRS.has(part));
+        },
+    });
+}
+/** Validates that the local cwd exists. */
+export async function assertLocalCwdExists(cwd) {
+    if (!(await fileExists(cwd))) {
+        throw new Error(`Local cwd does not exist: ${cwd}`);
+    }
+}
+//# sourceMappingURL=copyLocalRepo.js.map

package/dist/workspace/copyLocalRepo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyLocalRepo.js","sourceRoot":"","sources":["../../src/workspace/copyLocalRepo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc;IACd,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;CACX,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,aAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC;IACpE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,WAAmB;IAC9D,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE;QAC5B,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/workspace/createWorkspace.d.ts

@@ -0,0 +1,7 @@
+export interface CreatedWorkspace {
+    id: string;
+    path: string;
+}
+/** Creates a temporary workspace directory. */
+export declare function createWorkspace(): Promise<CreatedWorkspace>;
+//# sourceMappingURL=createWorkspace.d.ts.map

package/dist/workspace/createWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/createWorkspace.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAGjE"}

package/dist/workspace/createWorkspace.js

@@ -0,0 +1,10 @@
+import { mkdtemp } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+/** Creates a temporary workspace directory. */
+export async function createWorkspace() {
+    const path = await mkdtemp(join(tmpdir(), "auvira-agent-"));
+    return { id: randomUUID(), path };
+}
+//# sourceMappingURL=createWorkspace.js.map

package/dist/workspace/createWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkspace.js","sourceRoot":"","sources":["../../src/workspace/createWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/workspace/prepareWorkspace.d.ts

@@ -0,0 +1,4 @@
+import type { AgentCreateOptions, PreparedWorkspace } from "../agent/types.js";
+/** Prepares a local or GitLab workspace for agent execution. */
+export declare function prepareWorkspace(options: AgentCreateOptions): Promise<PreparedWorkspace>;
+//# sourceMappingURL=prepareWorkspace.d.ts.map

package/dist/workspace/prepareWorkspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareWorkspace.d.ts","sourceRoot":"","sources":["../../src/workspace/prepareWorkspace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAgB/E,gEAAgE;AAChE,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAyC5B"}

package/dist/workspace/prepareWorkspace.js

@@ -0,0 +1,46 @@
+import { createHash } from "node:crypto";
+import { cloneGitLabProject, prepareLocalGitRepo, } from "../git/cloneGitLabProject.js";
+import { assertLocalCwdExists, copyLocalRepo, } from "./copyLocalRepo.js";
+import { createWorkspace } from "./createWorkspace.js";
+import { resolveWorkspaceMode } from "./resolveWorkspaceMode.js";
+function workspaceIdForCwd(cwd) {
+    return createHash("sha256").update(cwd).digest("hex").slice(0, 16);
+}
+/** Prepares a local or GitLab workspace for agent execution. */
+export async function prepareWorkspace(options) {
+    if (options.local) {
+        await assertLocalCwdExists(options.local.cwd);
+        const mode = resolveWorkspaceMode(options);
+        if (mode === "in_place") {
+            const repoPath = options.local.cwd;
+            const branchName = await prepareLocalGitRepo(repoPath);
+            return {
+                id: `inplace-${workspaceIdForCwd(repoPath)}`,
+                path: repoPath,
+                repoPath,
+                branchName,
+            };
+        }
+        const workspace = await createWorkspace();
+        const repoPath = await copyLocalRepo(options.local.cwd, workspace.path);
+        const branchName = await prepareLocalGitRepo(repoPath);
+        return {
+            id: workspace.id,
+            path: workspace.path,
+            repoPath,
+            branchName,
+        };
+    }
+    const workspace = await createWorkspace();
+    if (options.gitlab) {
+        const cloned = await cloneGitLabProject(workspace.path, options.gitlab);
+        return {
+            id: workspace.id,
+            path: workspace.path,
+            repoPath: cloned.repoPath,
+            branchName: cloned.branchName,
+        };
+    }
+    throw new Error("Workspace source not configured");
+}
+//# sourceMappingURL=prepareWorkspace.js.map

package/dist/workspace/prepareWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareWorkspace.js","sourceRoot":"","sources":["../../src/workspace/prepareWorkspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA2B;IAE3B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;YACnC,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACvD,OAAO;gBACL,EAAE,EAAE,WAAW,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBAC5C,IAAI,EAAE,QAAQ;gBACd,QAAQ;gBACR,UAAU;aACX,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEvD,OAAO;YACL,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE,CAAC;IAE1C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,OAAO;YACL,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC"}

package/dist/workspace/resolveWorkspaceMode.d.ts

@@ -0,0 +1,7 @@
+import type { AgentCreateOptions } from "../agent/types.js";
+export type AgentWorkspaceMode = "in_place" | "git_copy";
+/** Resolves how local workspaces are prepared (default: edit owner cwd in place). */
+export declare function resolveWorkspaceMode(options: AgentCreateOptions): AgentWorkspaceMode;
+/** True when edits apply directly to `local.cwd` without a scratch copy. */
+export declare function usesInPlaceWorkspace(options: AgentCreateOptions): boolean;
+//# sourceMappingURL=resolveWorkspaceMode.d.ts.map

package/dist/workspace/resolveWorkspaceMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceMode.d.ts","sourceRoot":"","sources":["../../src/workspace/resolveWorkspaceMode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CAUpB;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAEzE"}

package/dist/workspace/resolveWorkspaceMode.js

@@ -0,0 +1,15 @@
+/** Resolves how local workspaces are prepared (default: edit owner cwd in place). */
+export function resolveWorkspaceMode(options) {
+    if (options.local?.workspaceMode) {
+        return options.local.workspaceMode;
+    }
+    if (options.cleanupWorkspace === true) {
+        return "git_copy";
+    }
+    return "in_place";
+}
+/** True when edits apply directly to `local.cwd` without a scratch copy. */
+export function usesInPlaceWorkspace(options) {
+    return Boolean(options.local) && resolveWorkspaceMode(options) === "in_place";
+}
+//# sourceMappingURL=resolveWorkspaceMode.js.map

package/dist/workspace/resolveWorkspaceMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWorkspaceMode.js","sourceRoot":"","sources":["../../src/workspace/resolveWorkspaceMode.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAClC,OAA2B;IAE3B,IAAI,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC;AAChF,CAAC"}

package/dist/workspace/syncRepoToOwner.d.ts

@@ -0,0 +1,3 @@
+/** Mirrors edited files from an internal repo copy back to the owner workspace. */
+export declare function syncRepoToOwner(repoPath: string, ownerCwd: string, relativePaths: string[]): Promise<void>;
+//# sourceMappingURL=syncRepoToOwner.d.ts.map

package/dist/workspace/syncRepoToOwner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRepoToOwner.d.ts","sourceRoot":"","sources":["../../src/workspace/syncRepoToOwner.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/workspace/syncRepoToOwner.js

@@ -0,0 +1,14 @@
+import { promises as fs } from "node:fs";
+import { dirname, join } from "node:path";
+/** Mirrors edited files from an internal repo copy back to the owner workspace. */
+export async function syncRepoToOwner(repoPath, ownerCwd, relativePaths) {
+    for (const relativePath of relativePaths) {
+        const normalized = relativePath.replace(/^\/+/, "");
+        const from = join(repoPath, normalized);
+        const to = join(ownerCwd, normalized);
+        const content = await fs.readFile(from, "utf8");
+        await fs.mkdir(dirname(to), { recursive: true });
+        await fs.writeFile(to, content, "utf8");
+    }
+}
+//# sourceMappingURL=syncRepoToOwner.js.map

package/dist/workspace/syncRepoToOwner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRepoToOwner.js","sourceRoot":"","sources":["../../src/workspace/syncRepoToOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,QAAgB,EAChB,aAAuB;IAEvB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/workspace/workspaceCheckpoint.d.ts

@@ -0,0 +1,20 @@
+export interface WorkspaceDiffResult {
+    changedFiles: string[];
+    diff: string;
+}
+export interface WorkspaceCheckpoint {
+    id: string;
+    diff(): Promise<WorkspaceDiffResult>;
+    restore?(): Promise<void>;
+    invalidateCache?(): void;
+}
+/** Clears memoized checkpoint diff after mutating tools or restore. */
+export declare function invalidateWorkspaceCheckpointCache(checkpoint?: WorkspaceCheckpoint): void;
+/** Creates an in-memory workspace checkpoint before agent edits. */
+export declare function createWorkspaceCheckpoint(input: {
+    repoPath: string;
+    allowedWritePaths?: string[];
+    includeGlobs?: string[];
+    excludeGlobs?: string[];
+}): Promise<WorkspaceCheckpoint>;
+//# sourceMappingURL=workspaceCheckpoint.d.ts.map

package/dist/workspace/workspaceCheckpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceCheckpoint.d.ts","sourceRoot":"","sources":["../../src/workspace/workspaceCheckpoint.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,eAAe,CAAC,IAAI,IAAI,CAAC;CAC1B;AA8RD,uEAAuE;AACvE,wBAAgB,kCAAkC,CAChD,UAAU,CAAC,EAAE,mBAAmB,GAC/B,IAAI,CAEN;AAED,oEAAoE;AACpE,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+C/B"}

package/dist/workspace/workspaceCheckpoint.js

@@ -0,0 +1,243 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import { join, resolve } from "node:path";
+import { buildUnifiedPatch, capPatch, getDiffMaxChars, } from "../agent/patchUtils.js";
+import { toRepoRelativePath } from "../agent/tools/pathGuard.js";
+import { fileExists } from "../tools/fileExists.js";
+import { matchesPathGlobFilters } from "../util/globMatch.js";
+const DEFAULT_IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    "dist",
+    "build",
+    "coverage",
+    ".turbo",
+    ".cache",
+    ".auvira",
+]);
+const EDITABLE_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".css",
+    ".scss",
+    ".json",
+    ".md",
+    ".html",
+    ".vue",
+    ".svelte",
+]);
+function normalizeRelPath(path) {
+    return path.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+function shouldIgnoreDir(name) {
+    return DEFAULT_IGNORED_DIRS.has(name);
+}
+function isEditableFile(relPath) {
+    const lower = relPath.toLowerCase();
+    const dot = lower.lastIndexOf(".");
+    if (dot === -1) {
+        return false;
+    }
+    return EDITABLE_EXTENSIONS.has(lower.slice(dot));
+}
+function buildCheckpointHunk(relPath, oldContent, newContent) {
+    if (oldContent === null && newContent === null) {
+        return "";
+    }
+    if (oldContent === null && newContent !== null) {
+        return [
+            `--- /dev/null`,
+            `+++ b/${relPath}`,
+            ...buildUnifiedPatch(relPath, "", newContent)
+                .split("\n")
+                .slice(2),
+        ].join("\n");
+    }
+    if (oldContent !== null && newContent === null) {
+        const patch = buildUnifiedPatch(relPath, oldContent, "");
+        const body = patch.split("\n").slice(2);
+        return [`--- a/${relPath}`, `+++ /dev/null`, ...body].join("\n");
+    }
+    return buildUnifiedPatch(relPath, oldContent ?? "", newContent ?? "");
+}
+async function readSnapshotEntry(repoPath, relPath) {
+    const absolute = join(repoPath, relPath);
+    if (!(await fileExists(absolute))) {
+        return { content: null };
+    }
+    const stat = await fs.stat(absolute);
+    if (!stat.isFile()) {
+        return { content: null };
+    }
+    return { content: await fs.readFile(absolute, "utf8") };
+}
+async function snapshotAllowedPaths(repoPath, allowedWritePaths) {
+    const snapshot = new Map();
+    for (const rawPath of allowedWritePaths) {
+        const relPath = normalizeRelPath(rawPath);
+        if (!relPath || relPath.endsWith("/")) {
+            continue;
+        }
+        snapshot.set(relPath, await readSnapshotEntry(repoPath, relPath));
+    }
+    return snapshot;
+}
+async function walkSnapshot(dir, repoPath, snapshot, globFilters) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (shouldIgnoreDir(entry.name)) {
+            continue;
+        }
+        const fullPath = join(dir, entry.name);
+        const relPath = normalizeRelPath(toRepoRelativePath(repoPath, fullPath));
+        if (entry.isDirectory()) {
+            await walkSnapshot(fullPath, repoPath, snapshot, globFilters);
+            continue;
+        }
+        if (!entry.isFile() || !isEditableFile(relPath)) {
+            continue;
+        }
+        if (globFilters &&
+            !matchesPathGlobFilters(relPath, globFilters.includeGlobs, globFilters.excludeGlobs)) {
+            continue;
+        }
+        snapshot.set(relPath, {
+            content: await fs.readFile(fullPath, "utf8"),
+        });
+    }
+}
+async function snapshotProjectPaths(repoPath, includeGlobs, excludeGlobs) {
+    const snapshot = new Map();
+    await walkSnapshot(resolve(repoPath), repoPath, snapshot, {
+        includeGlobs,
+        excludeGlobs,
+    });
+    return snapshot;
+}
+async function readCurrentEntry(repoPath, relPath) {
+    return readSnapshotEntry(repoPath, relPath);
+}
+async function diffSnapshotAsync(repoPath, snapshot, allowedWritePaths, globFilters) {
+    const changedFiles = [];
+    const hunks = [];
+    const seen = new Set();
+    for (const relPath of snapshot.keys()) {
+        const before = snapshot.get(relPath) ?? { content: null };
+        const after = await readCurrentEntry(repoPath, relPath);
+        const beforeContent = before.content;
+        const afterContent = after.content;
+        if (beforeContent === afterContent) {
+            continue;
+        }
+        seen.add(relPath);
+        changedFiles.push(relPath);
+        hunks.push(buildCheckpointHunk(relPath, beforeContent, afterContent));
+    }
+    for (const relPath of await discoverNewFiles(repoPath, snapshot, allowedWritePaths, globFilters)) {
+        if (seen.has(relPath)) {
+            continue;
+        }
+        const after = await readCurrentEntry(repoPath, relPath);
+        if (after.content !== null) {
+            changedFiles.push(relPath);
+            hunks.push(buildCheckpointHunk(relPath, null, after.content));
+        }
+    }
+    changedFiles.sort();
+    const rawDiff = hunks.filter(Boolean).join("\n\n");
+    const { patch } = capPatch(rawDiff, getDiffMaxChars());
+    return {
+        changedFiles,
+        diff: patch,
+    };
+}
+async function discoverNewFiles(repoPath, snapshot, allowedWritePaths, globFilters) {
+    if (allowedWritePaths?.length) {
+        const added = [];
+        for (const rawPath of allowedWritePaths) {
+            const relPath = normalizeRelPath(rawPath);
+            if (!relPath || relPath.endsWith("/") || snapshot.has(relPath)) {
+                continue;
+            }
+            const absolute = join(repoPath, relPath);
+            if (await fileExists(absolute)) {
+                added.push(relPath);
+            }
+        }
+        return added;
+    }
+    const discovered = new Map();
+    await walkSnapshot(resolve(repoPath), repoPath, discovered, globFilters);
+    const added = [];
+    for (const relPath of discovered.keys()) {
+        if (!snapshot.has(relPath)) {
+            added.push(relPath);
+        }
+    }
+    return added;
+}
+async function restoreSnapshot(repoPath, snapshot, globFilters) {
+    const current = new Map();
+    await walkSnapshot(resolve(repoPath), repoPath, current, globFilters);
+    for (const [relPath, entry] of snapshot.entries()) {
+        const absolute = join(repoPath, relPath);
+        if (entry.content === null) {
+            if (await fileExists(absolute)) {
+                await fs.unlink(absolute);
+            }
+            continue;
+        }
+        await fs.mkdir(join(absolute, ".."), { recursive: true });
+        await fs.writeFile(absolute, entry.content, "utf8");
+    }
+    for (const relPath of current.keys()) {
+        if (!snapshot.has(relPath)) {
+            const absolute = join(repoPath, relPath);
+            if (await fileExists(absolute)) {
+                await fs.unlink(absolute);
+            }
+        }
+    }
+}
+/** Clears memoized checkpoint diff after mutating tools or restore. */
+export function invalidateWorkspaceCheckpointCache(checkpoint) {
+    checkpoint?.invalidateCache?.();
+}
+/** Creates an in-memory workspace checkpoint before agent edits. */
+export async function createWorkspaceCheckpoint(input) {
+    const repoPath = resolve(input.repoPath);
+    const globFilters = {
+        includeGlobs: input.includeGlobs,
+        excludeGlobs: input.excludeGlobs,
+    };
+    const snapshot = input.allowedWritePaths?.length
+        ? await snapshotAllowedPaths(repoPath, input.allowedWritePaths)
+        : await snapshotProjectPaths(repoPath, input.includeGlobs, input.excludeGlobs);
+    const id = randomUUID();
+    const allowedWritePaths = input.allowedWritePaths;
+    let cachedDiff = null;
+    const invalidateCache = () => {
+        cachedDiff = null;
+    };
+    return {
+        id,
+        invalidateCache,
+        async diff() {
+            if (cachedDiff) {
+                return cachedDiff;
+            }
+            cachedDiff = await diffSnapshotAsync(repoPath, snapshot, allowedWritePaths, input.allowedWritePaths?.length ? undefined : globFilters);
+            return cachedDiff;
+        },
+        async restore() {
+            invalidateCache();
+            await restoreSnapshot(repoPath, snapshot, input.allowedWritePaths?.length ? undefined : globFilters);
+        },
+    };
+}
+//# sourceMappingURL=workspaceCheckpoint.js.map

package/dist/workspace/workspaceCheckpoint.js.map

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

package/dist/workspace/writeScreenshot.d.ts

@@ -0,0 +1,15 @@
+import type { AgentImageInput } from "../agent/types.js";
+export interface WriteScreenshotInput {
+    workspacePath: string;
+    screenshotBase64?: string;
+    screenshotPath?: string;
+    images?: AgentImageInput[];
+}
+export interface WriteScreenshotResult {
+    absolutePath: string;
+    relativePath: string;
+    imageCount: number;
+}
+/** Writes reference images into the workspace `.auvira` directory. */
+export declare function writeScreenshot(input: WriteScreenshotInput): Promise<WriteScreenshotResult | undefined>;
+//# sourceMappingURL=writeScreenshot.d.ts.map

package/dist/workspace/writeScreenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeScreenshot.d.ts","sourceRoot":"","sources":["../../src/workspace/writeScreenshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD,sEAAsE;AACtE,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAgD5C"}

package/dist/workspace/writeScreenshot.js

@@ -0,0 +1,56 @@
+import { mkdir, writeFile, copyFile } from "node:fs/promises";
+import { join } from "node:path";
+import { normalizeScreenshotBase64 } from "../util/screenshotBase64.js";
+const SCREENSHOT_RELATIVE = ".auvira/input-screenshot.png";
+function extensionForMime(mimeType) {
+    if (mimeType.includes("jpeg") || mimeType.includes("jpg")) {
+        return "jpg";
+    }
+    if (mimeType.includes("webp")) {
+        return "webp";
+    }
+    return "png";
+}
+/** Writes reference images into the workspace `.auvira` directory. */
+export async function writeScreenshot(input) {
+    const images = input.images && input.images.length > 0
+        ? input.images
+        : input.screenshotBase64
+            ? [
+                {
+                    data: normalizeScreenshotBase64(input.screenshotBase64),
+                    mimeType: "image/png",
+                },
+            ]
+            : [];
+    if (images.length === 0 && !input.screenshotPath) {
+        return undefined;
+    }
+    const auviraDir = join(input.workspacePath, ".auvira");
+    await mkdir(auviraDir, { recursive: true });
+    if (images.length > 0) {
+        for (let index = 0; index < images.length; index += 1) {
+            const image = images[index];
+            const ext = extensionForMime(image.mimeType);
+            const fileName = index === 0 ? "input-screenshot.png" : `input-screenshot-${index}.${ext}`;
+            const absolutePath = join(auviraDir, fileName);
+            const buffer = Buffer.from(normalizeScreenshotBase64(image.data), "base64");
+            await writeFile(absolutePath, buffer);
+        }
+        return {
+            absolutePath: join(auviraDir, "input-screenshot.png"),
+            relativePath: SCREENSHOT_RELATIVE,
+            imageCount: images.length,
+        };
+    }
+    const absolutePath = join(input.workspacePath, SCREENSHOT_RELATIVE);
+    if (input.screenshotPath) {
+        await copyFile(input.screenshotPath, absolutePath);
+    }
+    return {
+        absolutePath,
+        relativePath: SCREENSHOT_RELATIVE,
+        imageCount: 1,
+    };
+}
+//# sourceMappingURL=writeScreenshot.js.map

package/dist/workspace/writeScreenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeScreenshot.js","sourceRoot":"","sources":["../../src/workspace/writeScreenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAe3D,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B;IAE3B,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,MAAM;QACd,CAAC,CAAC,KAAK,CAAC,gBAAgB;YACtB,CAAC,CAAC;gBACE;oBACE,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,gBAAgB,CAAC;oBACvD,QAAQ,EAAE,WAAW;iBACtB;aACF;YACH,CAAC,CAAC,EAAE,CAAC;IAEX,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,QAAQ,GACZ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,oBAAoB,KAAK,IAAI,GAAG,EAAE,CAAC;YAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC5E,MAAM,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC;YACrD,YAAY,EAAE,mBAAmB;YACjC,UAAU,EAAE,MAAM,CAAC,MAAM;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,MAAM,QAAQ,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,YAAY;QACZ,YAAY,EAAE,mBAAmB;QACjC,UAAU,EAAE,CAAC;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@auvira.ai/sdk",
+  "version": "0.2.9",
+  "description": "Cursor-SDK-compatible visual coding agent with custom model support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/athan37/auvira-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/athan37/auvira-sdk/issues"
+  },
+  "homepage": "https://github.com/athan37/auvira-sdk#readme",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --env-file=.env ./node_modules/vitest/vitest.mjs run",
+    "test:unit": "node --env-file=.env ./node_modules/vitest/vitest.mjs run src/__tests__ --exclude 'src/__tests__/real/**' --exclude 'src/__tests__/flex/real-*.e2e.test.ts'",
+    "test:flex": "node --env-file=.env ./node_modules/vitest/vitest.mjs run src/__tests__/flex",
+    "test:flex:unit": "node --env-file=.env ./node_modules/vitest/vitest.mjs run src/__tests__/flex --exclude 'src/__tests__/flex/real-*.e2e.test.ts'",
+    "test:real": "node --env-file=.env ./node_modules/vitest/vitest.mjs run src/__tests__/real src/__tests__/flex/real-*.e2e.test.ts"
+  },
+  "keywords": [
+    "agent",
+    "cursor-sdk",
+    "openhands",
+    "visual-coding"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}