@auvira.ai/sdk 0.2.9 → 0.3.0

package/dist/runner/jobTypes.js

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

package/dist/runner/jobTypes.js.map

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

package/dist/runner/mapStreamEvents.d.ts

@@ -0,0 +1,16 @@
+import type { AgentRunEvent } from "../agent/events.js";
+import type { JobResultContext } from "./buildJobResult.js";
+import type { HarnessProgressEvent, SandboxAuviraRunnerEvent } from "./jobTypes.js";
+/** Mutable state while mapping a stream of SDK events to host progress. */
+export interface MapStreamContext {
+    toolSeq: number;
+    openTools: Map<string, string>;
+    sessionReadyEmitted: boolean;
+    resultCtx: JobResultContext;
+}
+export declare function createMapStreamContext(sessionResumed: boolean): MapStreamContext;
+/** Maps one SDK stream event to zero or more host progress events. */
+export declare function mapAuviraStreamEventToProgress(event: AgentRunEvent, ctx: MapStreamContext): HarnessProgressEvent[];
+/** Parses one NDJSON line from events.ndjson. */
+export declare function parseSandboxAuviraRunnerLine(line: string): SandboxAuviraRunnerEvent | null;
+//# sourceMappingURL=mapStreamEvents.d.ts.map

package/dist/runner/mapStreamEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapStreamEvents.d.ts","sourceRoot":"","sources":["../../src/runner/mapStreamEvents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEpF,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,OAAO,GACtB,gBAAgB,CAOlB;AAED,sEAAsE;AACtE,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,gBAAgB,GACpB,oBAAoB,EAAE,CA+JxB;AAED,iDAAiD;AACjD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,GACX,wBAAwB,GAAG,IAAI,CAyBjC"}

package/dist/runner/mapStreamEvents.js

@@ -0,0 +1,196 @@
+import { getAssistantEventText } from "../agent/assistantEvent.js";
+import { updateJobResultContext } from "./buildJobResult.js";
+export function createMapStreamContext(sessionResumed) {
+    return {
+        toolSeq: 0,
+        openTools: new Map(),
+        sessionReadyEmitted: false,
+        resultCtx: { sessionResumed },
+    };
+}
+/** Maps one SDK stream event to zero or more host progress events. */
+export function mapAuviraStreamEventToProgress(event, ctx) {
+    if (event.type === "run.early_finish" || event.type === "run.failed") {
+        updateJobResultContext(ctx.resultCtx, event);
+    }
+    if (event.type === "run.continue" && event.toolCallCount !== undefined) {
+        updateJobResultContext(ctx.resultCtx, event);
+    }
+    switch (event.type) {
+        case "workspace.prepared": {
+            if (ctx.sessionReadyEmitted) {
+                return [];
+            }
+            ctx.sessionReadyEmitted = true;
+            return [
+                {
+                    type: "step",
+                    id: "cursor_session",
+                    label: "Auvira agent ready",
+                    status: "completed",
+                },
+            ];
+        }
+        case "tool.start": {
+            ctx.toolSeq += 1;
+            const stepId = `tool_${ctx.toolSeq}`;
+            ctx.openTools.set(event.name, stepId);
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "tool_start",
+                        toolName: event.name,
+                        label: event.name,
+                        detail: JSON.stringify(event.input).slice(0, 200),
+                    },
+                },
+                {
+                    type: "step",
+                    id: stepId,
+                    label: event.name,
+                    status: "active",
+                    toolName: event.name,
+                },
+            ];
+        }
+        case "tool.end": {
+            const stepId = ctx.openTools.get(event.name) ?? `tool_${event.name}`;
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "tool_end",
+                        toolName: event.name,
+                        label: event.name,
+                        detail: event.ok ? "completed" : "failed",
+                    },
+                },
+                {
+                    type: "step",
+                    id: stepId,
+                    label: event.name,
+                    status: event.ok ? "completed" : "failed",
+                    toolName: event.name,
+                },
+            ];
+        }
+        case "edit.diff":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "diff",
+                        path: event.path,
+                        patch: event.patch,
+                        truncated: event.truncated,
+                        label: event.path,
+                    },
+                },
+            ];
+        case "run.diff":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "diff",
+                        patch: event.patch,
+                        truncated: event.truncated,
+                        label: "run summary",
+                        detail: event.changedFiles.join(", "),
+                    },
+                },
+            ];
+        case "run.continue":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "info",
+                        label: "Continuing edit",
+                        detail: event.reason === "style_only_incomplete"
+                            ? "Continuing edit — wiring required after style changes"
+                            : `Continuing edit — ${event.reason}`,
+                    },
+                },
+            ];
+        case "run.early_finish":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "info",
+                        label: "Early finish",
+                        detail: `${event.reason}: ${event.changedFiles.join(", ")}`,
+                    },
+                },
+            ];
+        case "run.failed":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "info",
+                        label: "Run failed",
+                        detail: event.message,
+                    },
+                },
+            ];
+        case "model.attempt":
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "info",
+                        label: "Model turn",
+                        detail: `Model turn ${event.attempt}/${event.maxAttempts}`,
+                    },
+                },
+            ];
+        case "assistant": {
+            const text = getAssistantEventText(event);
+            if (!text.trim()) {
+                return [];
+            }
+            return [
+                {
+                    type: "activity_trace",
+                    entry: {
+                        kind: "text",
+                        label: "Auvira agent writing",
+                        detail: text.slice(0, 500),
+                    },
+                },
+            ];
+        }
+        default:
+            return [];
+    }
+}
+/** Parses one NDJSON line from events.ndjson. */
+export function parseSandboxAuviraRunnerLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            !("type" in parsed)) {
+            return null;
+        }
+        const type = parsed.type;
+        if (type === "progress" && "event" in parsed) {
+            return parsed;
+        }
+        if (type === "result" && "result" in parsed) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=mapStreamEvents.js.map

package/dist/runner/mapStreamEvents.js.map

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

package/dist/runner/ndjsonWriter.d.ts

@@ -0,0 +1,6 @@
+import type { SandboxAuviraRunnerEvent } from "./jobTypes.js";
+/** Appends a single NDJSON line to events.ndjson with fsync. */
+export declare function appendRunnerEvent(eventsPath: string, event: SandboxAuviraRunnerEvent): Promise<void>;
+/** Appends a progress or result event (convenience wrapper). */
+export declare function appendNdjsonLine(eventsPath: string, payload: SandboxAuviraRunnerEvent): Promise<void>;
+//# sourceMappingURL=ndjsonWriter.d.ts.map

package/dist/runner/ndjsonWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjsonWriter.d.ts","sourceRoot":"","sources":["../../src/runner/ndjsonWriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,gEAAgE;AAChE,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CASf;AAED,gEAAgE;AAChE,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/runner/ndjsonWriter.js

@@ -0,0 +1,18 @@
+import { open } from "node:fs/promises";
+/** Appends a single NDJSON line to events.ndjson with fsync. */
+export async function appendRunnerEvent(eventsPath, event) {
+    const line = `${JSON.stringify(event)}\n`;
+    const handle = await open(eventsPath, "a");
+    try {
+        await handle.write(line);
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Appends a progress or result event (convenience wrapper). */
+export async function appendNdjsonLine(eventsPath, payload) {
+    await appendRunnerEvent(eventsPath, payload);
+}
+//# sourceMappingURL=ndjsonWriter.js.map

package/dist/runner/ndjsonWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjsonWriter.js","sourceRoot":"","sources":["../../src/runner/ndjsonWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,KAA+B;IAE/B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,OAAiC;IAEjC,MAAM,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/runner/resolveRunnerEnv.d.ts

@@ -0,0 +1,10 @@
+import type { AgentModelConfig } from "../agent/types.js";
+/** Resolves model config with API key from environment only (never from job JSON). */
+export declare function resolveRunnerModel(model: AgentModelConfig): AgentModelConfig;
+/** Returns the configured API key from environment variables. */
+export declare function resolveRunnerApiKey(): string | undefined;
+/** Ensures a model API key is available before starting a run. */
+export declare function assertRunnerApiKey(): void;
+/** Resolves jobs root from environment or default. */
+export declare function resolveJobsRoot(): string;
+//# sourceMappingURL=resolveRunnerEnv.d.ts.map

package/dist/runner/resolveRunnerEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRunnerEnv.d.ts","sourceRoot":"","sources":["../../src/runner/resolveRunnerEnv.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAO5E;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAKxD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/runner/resolveRunnerEnv.js

@@ -0,0 +1,28 @@
+import { resolveModelConfig } from "../agent/resolveModelConfig.js";
+import { ENV_AGENT_API_KEY, ENV_JOBS_ROOT, ENV_MODEL_API_KEY } from "./constants.js";
+import { DEFAULT_JOBS_ROOT } from "./constants.js";
+/** Resolves model config with API key from environment only (never from job JSON). */
+export function resolveRunnerModel(model) {
+    const stripped = {
+        id: model.id,
+        provider: model.provider,
+        baseURL: model.baseURL,
+    };
+    return resolveModelConfig(stripped);
+}
+/** Returns the configured API key from environment variables. */
+export function resolveRunnerApiKey() {
+    return (process.env[ENV_MODEL_API_KEY]?.trim() ||
+        process.env[ENV_AGENT_API_KEY]?.trim());
+}
+/** Ensures a model API key is available before starting a run. */
+export function assertRunnerApiKey() {
+    if (!resolveRunnerApiKey()) {
+        throw new Error(`Model API key required: set ${ENV_MODEL_API_KEY} or ${ENV_AGENT_API_KEY}`);
+    }
+}
+/** Resolves jobs root from environment or default. */
+export function resolveJobsRoot() {
+    return process.env[ENV_JOBS_ROOT]?.trim() || DEFAULT_JOBS_ROOT;
+}
+//# sourceMappingURL=resolveRunnerEnv.js.map

package/dist/runner/resolveRunnerEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRunnerEnv.js","sourceRoot":"","sources":["../../src/runner/resolveRunnerEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,QAAQ,GAAqB;QACjC,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IACF,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB;IACjC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE;QACtC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CACvC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,+BAA+B,iBAAiB,OAAO,iBAAiB,EAAE,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC;AACjE,CAAC"}

package/dist/runner/run.d.ts

@@ -0,0 +1,13 @@
+import type { SandboxAuviraJobResult } from "./jobTypes.js";
+export interface RunSandboxJobOptions {
+    jobsRoot?: string;
+}
+export interface RunSandboxJobOutcome {
+    exitCode: number;
+    result: SandboxAuviraJobResult;
+}
+/** Parses --job from argv or AUVIRA_CURSOR_JOB_ID. */
+export declare function parseJobId(argv: string[]): string | undefined;
+/** Executes a sandbox job from jobsRoot/editJobId/job.json. */
+export declare function runSandboxJob(editJobId: string, options?: RunSandboxJobOptions): Promise<RunSandboxJobOutcome>;
+//# sourceMappingURL=run.d.ts.map

package/dist/runner/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAc5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAU7D;AAWD,+DAA+D;AAC/D,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAqF/B"}

package/dist/runner/run.js

@@ -0,0 +1,114 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Agent } from "../agent/Agent.js";
+import { watchAbortFile } from "./abortPoller.js";
+import { buildRunnerFailureResult, buildSandboxJobResult, } from "./buildJobResult.js";
+import { ENV_CURSOR_JOB_ID, EVENTS_FILE, JOB_FILE, RESULT_FILE, } from "./constants.js";
+import { createMapStreamContext, mapAuviraStreamEventToProgress, } from "./mapStreamEvents.js";
+import { appendNdjsonLine } from "./ndjsonWriter.js";
+import { assertRunnerApiKey, resolveJobsRoot, resolveRunnerModel, } from "./resolveRunnerEnv.js";
+import { createAgentFromSession, saveSandboxSession } from "./sessionStore.js";
+import { SandboxJobValidationError, validateSandboxJob } from "./validateJob.js";
+/** Parses --job from argv or AUVIRA_CURSOR_JOB_ID. */
+export function parseJobId(argv) {
+    for (let i = 0; i < argv.length; i += 1) {
+        if (argv[i] === "--job" && argv[i + 1]) {
+            return argv[i + 1].trim();
+        }
+        if (argv[i]?.startsWith("--job=")) {
+            return argv[i].slice("--job=".length).trim();
+        }
+    }
+    return process.env[ENV_CURSOR_JOB_ID]?.trim();
+}
+async function writeResult(jobDir, eventsPath, result) {
+    await writeFile(join(jobDir, RESULT_FILE), JSON.stringify(result, null, 2));
+    await appendNdjsonLine(eventsPath, { type: "result", result });
+}
+/** Executes a sandbox job from jobsRoot/editJobId/job.json. */
+export async function runSandboxJob(editJobId, options = {}) {
+    const jobsRoot = options.jobsRoot ?? resolveJobsRoot();
+    const jobDir = join(jobsRoot, editJobId);
+    const jobPath = join(jobDir, JOB_FILE);
+    const eventsPath = join(jobDir, EVENTS_FILE);
+    let sessionResumed = false;
+    let agentId;
+    try {
+        assertRunnerApiKey();
+        const rawJob = JSON.parse(await readFile(jobPath, "utf8"));
+        const job = validateSandboxJob(rawJob);
+        if (job.editJobId !== editJobId) {
+            throw new SandboxJobValidationError(`job.editJobId (${job.editJobId}) does not match --job (${editJobId})`);
+        }
+        await mkdir(jobDir, { recursive: true });
+        let agent;
+        if (job.resumeAgentId) {
+            const resumed = await createAgentFromSession(job, jobsRoot);
+            agent = resumed.agent;
+            sessionResumed = resumed.sessionResumed;
+        }
+        else {
+            agent = await Agent.create({
+                model: resolveRunnerModel(job.model),
+                local: {
+                    cwd: job.workspacePath,
+                    workspaceMode: "in_place",
+                },
+            });
+        }
+        agentId = agent.agentId;
+        const payload = job.images?.length
+            ? { text: job.promptText, images: job.images }
+            : job.promptText;
+        const run = await agent.send(payload, {
+            selectedDom: job.selectedDom,
+            completion: job.completion,
+            validation: job.validation ?? { skip: true },
+            reuseWorkspace: job.reuseWorkspace,
+            timeoutMs: job.validation?.timeoutMs,
+        });
+        const mapCtx = createMapStreamContext(sessionResumed);
+        const abortWatcher = watchAbortFile(jobDir, run);
+        for await (const event of run.stream()) {
+            const progressEvents = mapAuviraStreamEventToProgress(event, mapCtx);
+            for (const progress of progressEvents) {
+                await appendNdjsonLine(eventsPath, { type: "progress", event: progress });
+            }
+        }
+        await abortWatcher;
+        const result = await run.wait();
+        const jobResult = buildSandboxJobResult(result, mapCtx.resultCtx);
+        if (result.ok && result.status === "finished") {
+            await saveSandboxSession(jobsRoot, agent, job.workspacePath);
+        }
+        await writeResult(jobDir, eventsPath, jobResult);
+        return { exitCode: result.ok ? 0 : 1, result: jobResult };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown runner error";
+        const failure = buildRunnerFailureResult({
+            error: message,
+            agentId,
+            sessionResumed,
+            hostTimeout: message.toLowerCase().includes("timeout"),
+        });
+        await mkdir(jobDir, { recursive: true });
+        await writeResult(jobDir, eventsPath, failure);
+        return { exitCode: 1, result: failure };
+    }
+}
+async function main() {
+    const editJobId = parseJobId(process.argv.slice(2));
+    if (!editJobId) {
+        console.error("Usage: auvira-sdk-run --job <editJobId>");
+        process.exit(1);
+    }
+    const outcome = await runSandboxJob(editJobId);
+    process.exit(outcome.exitCode);
+}
+const isDirectRun = process.argv[1]?.endsWith("/run.js") ||
+    process.argv[1]?.endsWith("/run.mjs");
+if (isDirectRun) {
+    void main();
+}
+//# sourceMappingURL=run.js.map

package/dist/runner/run.js.map

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

package/dist/runner/sessionStore.d.ts

@@ -0,0 +1,12 @@
+import { Agent } from "../agent/Agent.js";
+import type { SandboxAuviraJobInput, SandboxAuviraSession } from "./jobTypes.js";
+/** Loads a persisted sandbox session or returns undefined. */
+export declare function loadSandboxSession(jobsRoot: string, agentId: string): Promise<SandboxAuviraSession | undefined>;
+/** Persists agent state after a successful sandbox run. */
+export declare function saveSandboxSession(jobsRoot: string, agent: Agent, workspacePath: string): Promise<void>;
+/** Creates an agent from a resumed sandbox session. */
+export declare function createAgentFromSession(job: SandboxAuviraJobInput, jobsRoot: string): Promise<{
+    agent: Agent;
+    sessionResumed: boolean;
+}>;
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/runner/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/runner/sessionStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAWjF,8DAA8D;AAC9D,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAO3C;AAED,2DAA2D;AAC3D,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,uDAAuD;AACvD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,qBAAqB,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CAwBpD"}

package/dist/runner/sessionStore.js

@@ -0,0 +1,56 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Agent } from "../agent/Agent.js";
+import { resolveRunnerModel } from "./resolveRunnerEnv.js";
+function sessionsDir(jobsRoot) {
+    return join(jobsRoot, "sessions");
+}
+function sessionPath(jobsRoot, agentId) {
+    return join(sessionsDir(jobsRoot), `${agentId}.json`);
+}
+/** Loads a persisted sandbox session or returns undefined. */
+export async function loadSandboxSession(jobsRoot, agentId) {
+    try {
+        const raw = await readFile(sessionPath(jobsRoot, agentId), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Persists agent state after a successful sandbox run. */
+export async function saveSandboxSession(jobsRoot, agent, workspacePath) {
+    const dir = sessionsDir(jobsRoot);
+    await mkdir(dir, { recursive: true });
+    const session = {
+        agentId: agent.agentId,
+        workspacePath,
+        conversation: agent.getConversationTurns(),
+        lastVisionImages: agent.getLastVisionImages(),
+    };
+    await writeFile(sessionPath(jobsRoot, agent.agentId), JSON.stringify(session, null, 2));
+}
+/** Creates an agent from a resumed sandbox session. */
+export async function createAgentFromSession(job, jobsRoot) {
+    const resumeId = job.resumeAgentId?.trim();
+    if (!resumeId) {
+        throw new Error("resumeAgentId is required for session resume");
+    }
+    const session = await loadSandboxSession(jobsRoot, resumeId);
+    if (!session) {
+        throw new Error(`Sandbox session not found for agent id: ${resumeId}`);
+    }
+    const createOptions = {
+        agentId: session.agentId,
+        initialConversation: session.conversation,
+        initialVisionImages: session.lastVisionImages,
+        model: resolveRunnerModel(job.model),
+        local: {
+            cwd: job.workspacePath,
+            workspaceMode: "in_place",
+        },
+    };
+    const agent = await Agent.create(createOptions);
+    return { agent, sessionResumed: true };
+}
+//# sourceMappingURL=sessionStore.js.map

package/dist/runner/sessionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.js","sourceRoot":"","sources":["../../src/runner/sessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB,EAAE,OAAe;IACpD,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,KAAY,EACZ,aAAqB;IAErB,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,OAAO,GAAyB;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,aAAa;QACb,YAAY,EAAE,KAAK,CAAC,oBAAoB,EAAE;QAC1C,gBAAgB,EAAE,KAAK,CAAC,mBAAmB,EAAE;KAC9C,CAAC;IACF,MAAM,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAA0B,EAC1B,QAAgB;IAEhB,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,aAAa,GAAuB;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,mBAAmB,EAAE,OAAO,CAAC,YAAY;QACzC,mBAAmB,EAAE,OAAO,CAAC,gBAAgB;QAC7C,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC;QACpC,KAAK,EAAE;YACL,GAAG,EAAE,GAAG,CAAC,aAAa;YACtB,aAAa,EAAE,UAAU;SAC1B;KACF,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/runner/validateJob.d.ts

@@ -0,0 +1,7 @@
+import type { SandboxAuviraJobInput } from "./jobTypes.js";
+export declare class SandboxJobValidationError extends Error {
+    constructor(message: string);
+}
+/** Validates and parses raw job JSON into SandboxAuviraJobInput v1. */
+export declare function validateSandboxJob(raw: unknown): SandboxAuviraJobInput;
+//# sourceMappingURL=validateJob.d.ts.map

package/dist/runner/validateJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateJob.d.ts","sourceRoot":"","sources":["../../src/runner/validateJob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAoHD,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,CAoDtE"}