@ranimontagna/agent-toolkit 0.2.3 → 0.3.1

package/dist/src/ariadne/prompt.d.ts

@@ -0,0 +1,11 @@
+import type { AriadneStory } from "./types.js";
+export type IterationPromptInput = {
+    runId: string;
+    story: AriadneStory;
+    projectRoot: string;
+    resultPath: string;
+    qualityChecks: string[];
+    priorFailure?: string;
+    hasExistingDiff: boolean;
+};
+export declare function buildIterationPrompt(input: IterationPromptInput): string;

package/dist/src/ariadne/prompt.js

@@ -0,0 +1,29 @@
+function json(value) {
+    return `\`\`\`json\n${JSON.stringify(value, null, 2)}\n\`\`\``;
+}
+export function buildIterationPrompt(input) {
+    const { story } = input;
+    const criteria = story.acceptanceCriteria.map((criterion) => `- ${criterion}`);
+    const checks = input.qualityChecks.map((check) => `- ${check}`);
+    const diffGuidance = input.hasExistingDiff
+        ? "An existing uncommitted diff belongs to this story. Preserve it and continue from it."
+        : "Start from the current repository state; do not create unrelated changes.";
+    const priorFailure = input.priorFailure
+        ? `\n## Prior failure\n\n${input.priorFailure}\n`
+        : "";
+    return `# Ariadne iteration\n\nYou are working inside the project described below. Follow the repository instructions before editing. This task is runtime neutral: use the tools available in the repository without assuming a particular model provider or command-line client.\n\n${json({ runId: input.runId, projectRoot: input.projectRoot, resultPath: input.resultPath })}\n\n## Story\n\n${story.id}: ${story.title}\n\n${story.description}\n\n## Acceptance criteria\n\n${criteria.join("\n")}\n\n## Quality checks\n\n${checks.join("\n")}\n\n## Working rules\n\n${diffGuidance}\n\nRead all applicable AGENTS.md files before making changes. Write reusable repository knowledge to an applicable AGENTS.md only when it is genuinely durable.\n\nDo not create commits.\nDo not push or otherwise publish Git changes.\nDo not edit .ariadne/prd.json.\nDo not edit .ariadne/progress.md.\nWork on ${story.id} only.\n${priorFailure}\n## Result file\n\nBefore you finish, write exactly one JSON object to the result path above. Its schema is:\n\n${json({
+        schemaVersion: 1,
+        runId: "string",
+        storyId: "string",
+        outcome: "completed | failed",
+        criteria: [
+            { criterion: "string", passed: "boolean", evidence: "string" },
+        ],
+        summary: "string",
+        filesChanged: ["safe relative path"],
+        checksAttempted: ["string"],
+        learnings: ["string"],
+        failureReason: "string (required when outcome is failed)",
+    })}\n`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/ariadne/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/ariadne/prompt.ts"],"names":[],"mappings":"AAYA,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAC3C,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,EAAE,CAChC,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe;QACxC,CAAC,CAAC,uFAAuF;QACzF,CAAC,CAAC,2EAA2E,CAAC;IAChF,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY;QACrC,CAAC,CAAC,yBAAyB,KAAK,CAAC,YAAY,IAAI;QACjD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,iRAAiR,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,mBAAmB,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,WAAW,iCAAiC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,YAAY,yTAAyT,KAAK,CAAC,EAAE,WAAW,YAAY,oHAAoH,IAAI,CAC3gC;QACE,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE;YACR,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC/D;QACD,OAAO,EAAE,QAAQ;QACjB,YAAY,EAAE,CAAC,oBAAoB,CAAC;QACpC,eAAe,EAAE,CAAC,QAAQ,CAAC;QAC3B,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,aAAa,EAAE,0CAA0C;KAC1D,CACF,IAAI,CAAC;AACR,CAAC"}

package/dist/src/ariadne/render.d.ts

@@ -0,0 +1,7 @@
+import type { AriadneDoctorReport } from "./doctor.js";
+import type { AriadneStatusReport } from "./status.js";
+import type { AriadneRunSummary } from "./types.js";
+export declare function formatAriadneJson(report: AriadneStatusReport | AriadneDoctorReport): string;
+export declare function formatAriadneStatus(report: AriadneStatusReport): string;
+export declare function formatAriadneRun(report: AriadneRunSummary): string;
+export declare function formatAriadneDoctor(report: AriadneDoctorReport): string;

package/dist/src/ariadne/render.js

@@ -0,0 +1,72 @@
+export function formatAriadneJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+export function formatAriadneStatus(report) {
+    const lines = [
+        "Ariadne status",
+        `Project: ${report.project}`,
+        `Branch: ${report.branch.current} (configured: ${report.branch.configured})`,
+        report.runtime
+            ? `Runtime: ${report.runtime.name} (${report.runtime.state}${report.runtime.version ? `, ${report.runtime.version}` : ""})`
+            : "Runtime: not configured",
+        `Stories: ${report.stories.pending} pending, ${report.stories.inProgress} in progress, ${report.stories.completed} completed, ${report.stories.blocked} blocked`,
+        report.activeStory
+            ? `Active story: ${report.activeStory.id} ${report.activeStory.title} (attempts: ${report.activeStory.attempts})`
+            : "Active story: none",
+        report.blockedStory
+            ? `Blocked story: ${report.blockedStory.id} ${report.blockedStory.title} (attempts: ${report.blockedStory.attempts})`
+            : "Blocked story: none",
+        report.ownershipViolation
+            ? `Ownership violation: run ${report.ownershipViolation.runId} (${report.ownershipViolation.changed.join(", ")})`
+            : "Ownership violation: none",
+        report.lastRun
+            ? `Last run: ${report.lastRun.id} (${report.lastRun.outcome}, ${report.lastRun.durationMs}ms)`
+            : "Last run: none",
+        `Consecutive failures: ${report.consecutiveFailures}`,
+        `Worktree: ${report.dirty ? "dirty" : "clean"}`,
+        `Lock: ${report.lock.state}${report.lock.pid ? ` (PID ${report.lock.pid}${report.lock.runId ? `, run ${report.lock.runId}` : ""})` : ""}`,
+        `Progress: ${report.paths.progress}`,
+        `Runs: ${report.paths.runs}`,
+    ];
+    return lines.join("\n");
+}
+export function formatAriadneRun(report) {
+    if (!report.inspection)
+        return `Ariadne run: ${report.outcome}.`;
+    const inspection = report.inspection;
+    const selected = inspection.selectedStory;
+    const blocked = inspection.blockedStory;
+    return [
+        `Ariadne dry run: ${report.outcome}`,
+        `Project: ${inspection.project.name} (${inspection.project.root})`,
+        `Branch: ${inspection.project.branch}`,
+        selected
+            ? `Selected story: ${selected.id} ${selected.title} (${selected.status}, attempt ${selected.attempts + 1})`
+            : "Selected story: none",
+        blocked
+            ? `Blocked story: ${blocked.id} ${blocked.title} (${blocked.attempts} attempts)`
+            : "Blocked story: none",
+        `Runtime: ${inspection.runtime.name} (${inspection.runtime.state}${inspection.runtime.version ? `, ${inspection.runtime.version}` : ""})`,
+        `Prompt: ${inspection.promptPath}`,
+        `Invocation: ${JSON.stringify([inspection.invocation.command, ...inspection.invocation.args])}`,
+        `Checks: ${inspection.checks.join(", ") || "none"}`,
+        `Limits: attempts ${inspection.limits.maxAttemptsPerStory}, iterations ${inspection.limits.maxIterations ?? "unbounded"}, runtime ${inspection.limits.maxRuntimeMs ?? "unbounded"}`,
+    ].join("\n");
+}
+export function formatAriadneDoctor(report) {
+    const lines = [
+        `Ariadne doctor: ${report.ok ? "ok" : "issues found"}`,
+        "",
+        formatAriadneStatus(report.status),
+    ];
+    if (report.issues.length === 0) {
+        lines.push("", "Issues: none");
+        return lines.join("\n");
+    }
+    lines.push("", "Issues:");
+    for (const issue of report.issues) {
+        lines.push(`- ${issue.severity.toUpperCase()} [${issue.code}] ${issue.message}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/src/ariadne/render.js.map

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

package/dist/src/ariadne/result.d.ts

@@ -0,0 +1,54 @@
+import type { QualityCheckResult } from "./checks.js";
+import type { AriadneExternalFileIdentity } from "./store.js";
+import type { AriadneRuntimeName, AriadneStory } from "./types.js";
+export type AgentCriterionResult = {
+    criterion: string;
+    passed: boolean;
+    evidence: string;
+};
+export type AgentResult = {
+    schemaVersion: 1;
+    runId: string;
+    storyId: string;
+    outcome: "completed" | "failed";
+    criteria: AgentCriterionResult[];
+    summary: string;
+    filesChanged: string[];
+    checksAttempted: string[];
+    learnings: string[];
+    failureReason?: string;
+};
+export type ExpectedAgentResult = {
+    runId: string;
+    storyId: string;
+    acceptanceCriteria: string[];
+    projectRoot: string;
+};
+export type ProgressEntryInput = {
+    timestamp: string;
+    runId: string;
+    story: AriadneStory;
+    runtime: AriadneRuntimeName;
+    result: AgentResult;
+    checks: QualityCheckResult[];
+    outcome?: "completed" | "failed" | "blocked" | "interrupted" | "budget_exhausted";
+    commit?: string;
+    failureCategory?: string;
+    failureReason?: string;
+};
+export type CoordinatorProgressEntryInput = {
+    timestamp: string;
+    runId: string;
+    storyId: string;
+    runtime: AriadneRuntimeName;
+    outcome: "failed" | "blocked" | "interrupted" | "budget_exhausted";
+    failureCategory: string;
+    failureReason: string;
+};
+export type DurableValidatedResult = Pick<AgentResult, "outcome" | "summary" | "filesChanged" | "learnings">;
+export declare function sanitizeDurableValue(value: string): string;
+export declare function sanitizeValidatedResult(result: DurableValidatedResult): DurableValidatedResult;
+export declare function sanitizeQualityCheckResult(check: QualityCheckResult): QualityCheckResult;
+export declare function readAgentResult(resultPath: string, expected: ExpectedAgentResult, certifiedIdentity?: AriadneExternalFileIdentity): AgentResult;
+export declare function formatProgressEntry(input: ProgressEntryInput): string;
+export declare function formatCoordinatorProgressEntry(input: CoordinatorProgressEntryInput): string;

package/dist/src/ariadne/result.js

@@ -0,0 +1,129 @@
+import fs from "node:fs";
+import path from "node:path";
+import { validateAgentResult } from "./schema.js";
+const MAX_DURABLE_VALUE_LENGTH = 500;
+export function sanitizeDurableValue(value) {
+    let sanitized = value
+        .replace(/\b(authorization)\s*([:=])\s*[^\r\n]*/gi, (_match, name, separator) => `${name}${separator === ":" ? ": " : "="}[REDACTED]`)
+        .replace(/\p{Cc}+/gu, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    sanitized = sanitized
+        .replace(/\bbearer\s+\S+/gi, "Bearer [REDACTED]")
+        .replace(/(--(?:api[-_]?key|token|password|secret|authorization|credential))(?:=|\s+)(?:"[^"]*"|'[^']*'|\S+)/gi, "$1 [REDACTED]")
+        .replace(/\b(api[-_]?key|token|password|secret|authorization|credential)\s*([:=])\s*(?:"[^"]*"|'[^']*'|[^\s,;]+)/gi, (_match, name, separator) => `${name}${separator === ":" ? ": " : "="}[REDACTED]`)
+        .replace(/\bgh[pousr]_[A-Za-z0-9_]{16,}\b/g, "[REDACTED]")
+        .replace(/\bsk-[A-Za-z0-9_-]{16,}\b/g, "[REDACTED]");
+    if (sanitized.length <= MAX_DURABLE_VALUE_LENGTH)
+        return sanitized;
+    return `${sanitized.slice(0, MAX_DURABLE_VALUE_LENGTH - 1)}…`;
+}
+export function sanitizeValidatedResult(result) {
+    return {
+        outcome: result.outcome,
+        summary: sanitizeDurableValue(result.summary),
+        filesChanged: result.filesChanged.map(sanitizeDurableValue),
+        learnings: result.learnings.map(sanitizeDurableValue),
+    };
+}
+export function sanitizeQualityCheckResult(check) {
+    return {
+        ...check,
+        command: sanitizeDurableValue(check.command),
+        stdoutPath: path.basename(check.stdoutPath),
+        stderrPath: path.basename(check.stderrPath),
+    };
+}
+export function readAgentResult(resultPath, expected, certifiedIdentity) {
+    let contents;
+    let descriptor;
+    try {
+        descriptor = fs.openSync(resultPath, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
+        const stat = fs.fstatSync(descriptor);
+        if (!stat.isFile() ||
+            stat.nlink !== 1 ||
+            (certifiedIdentity !== undefined &&
+                (certifiedIdentity.source !== resultPath ||
+                    certifiedIdentity.device !== stat.dev ||
+                    certifiedIdentity.inode !== stat.ino ||
+                    certifiedIdentity.links !== stat.nlink))) {
+            throw new Error("unsafe result identity");
+        }
+        contents = fs.readFileSync(descriptor, "utf8");
+    }
+    catch {
+        throw new Error("Unable to read agent result; inspect machine-local result.json.");
+    }
+    finally {
+        if (descriptor !== undefined)
+            fs.closeSync(descriptor);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch {
+        throw new Error("Agent result contains invalid JSON; inspect machine-local result.json.");
+    }
+    try {
+        return validateAgentResult(parsed, expected);
+    }
+    catch {
+        throw new Error("Agent result failed validation; inspect machine-local result.json.");
+    }
+}
+export function formatProgressEntry(input) {
+    const checks = input.checks.map((check) => {
+        const outcome = check.status === 0 ? "passed" : "failed";
+        return `- ${sanitizeDurableValue(check.command)}: ${outcome} (${check.durationMs}ms)`;
+    });
+    const outcome = input.outcome ??
+        (input.failureCategory === undefined ? input.result.outcome : "failed");
+    const lines = [
+        `## ${input.timestamp} — ${input.runId}`,
+        "",
+        `- story: ${sanitizeDurableValue(input.story.id)}`,
+        `- runtime: ${input.runtime}`,
+        `- outcome: ${outcome}`,
+        `- criteria: ${input.result.criteria.filter((criterion) => criterion.passed).length}/${input.result.criteria.length} passed`,
+        `- summary: ${sanitizeDurableValue(input.result.summary)}`,
+        "- changed files:",
+        ...(input.result.filesChanged.length > 0
+            ? input.result.filesChanged.map((file) => `  - ${sanitizeDurableValue(file)}`)
+            : ["  - none"]),
+        "- learnings:",
+        ...(input.result.learnings.length > 0
+            ? input.result.learnings.map((learning) => `  - ${sanitizeDurableValue(learning)}`)
+            : ["  - none"]),
+        `- checks attempted: ${input.result.checksAttempted.length}`,
+        ...checks,
+        ...(input.commit
+            ? [`- commit: ${sanitizeDurableValue(input.commit)}`]
+            : []),
+        ...(input.failureCategory
+            ? [`- failure category: ${sanitizeDurableValue(input.failureCategory)}`]
+            : []),
+        ...(input.failureReason
+            ? [`- failure reason: ${sanitizeDurableValue(input.failureReason)}`]
+            : []),
+        "",
+        "---",
+        "",
+    ];
+    return lines.join("\n");
+}
+export function formatCoordinatorProgressEntry(input) {
+    return [
+        `## ${input.timestamp} — ${input.runId}`,
+        "",
+        `- story: ${sanitizeDurableValue(input.storyId)}`,
+        `- runtime: ${input.runtime}`,
+        `- outcome: ${input.outcome}`,
+        `- failure category: ${sanitizeDurableValue(input.failureCategory)}`,
+        `- failure reason: ${sanitizeDurableValue(input.failureReason)}`,
+        "",
+        "---",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=result.js.map

package/dist/src/ariadne/result.js.map

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

package/dist/src/ariadne/runtimes/antigravity.d.ts

@@ -0,0 +1,2 @@
+import type { AriadneRuntimeAdapter, RuntimeProbeDeps } from "./types.js";
+export declare function createAntigravityRuntime(deps: RuntimeProbeDeps): AriadneRuntimeAdapter;

package/dist/src/ariadne/runtimes/antigravity.js

@@ -0,0 +1,17 @@
+import { createRuntimeAdapter, promptInstruction } from "./shared.js";
+const minimumVersion = "1.1.8";
+export function createAntigravityRuntime(deps) {
+    return createRuntimeAdapter({
+        name: "antigravity",
+        command: "agy",
+        version: { kind: "minimum", version: minimumVersion },
+        helpArgs: ["--help"],
+        requiredHelp: ["--print", "--dangerously-skip-permissions"],
+        invocationArgs: (context) => [
+            "--print",
+            "--dangerously-skip-permissions",
+            promptInstruction(context.relativePromptPath),
+        ],
+    }, deps);
+}
+//# sourceMappingURL=antigravity.js.map

package/dist/src/ariadne/runtimes/antigravity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/antigravity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,MAAM,UAAU,wBAAwB,CACtC,IAAsB;IAEtB,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE;QACrD,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,YAAY,EAAE,CAAC,SAAS,EAAE,gCAAgC,CAAC;QAC3D,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,SAAS;YACT,gCAAgC;YAChC,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAC9C;KACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/runtimes/claude.d.ts

@@ -0,0 +1,2 @@
+import type { AriadneRuntimeAdapter, RuntimeProbeDeps } from "./types.js";
+export declare function createClaudeRuntime(deps: RuntimeProbeDeps, version: string): AriadneRuntimeAdapter;

package/dist/src/ariadne/runtimes/claude.js

@@ -0,0 +1,17 @@
+import { createRuntimeAdapter, promptInstruction } from "./shared.js";
+export function createClaudeRuntime(deps, version) {
+    return createRuntimeAdapter({
+        name: "claude",
+        command: "claude",
+        version: { kind: "exact", version },
+        helpArgs: ["--help"],
+        requiredHelp: ["--print", "--dangerously-skip-permissions"],
+        authArgs: ["auth", "status"],
+        invocationArgs: (context) => [
+            "--print",
+            "--dangerously-skip-permissions",
+            promptInstruction(context.relativePromptPath),
+        ],
+    }, deps);
+}
+//# sourceMappingURL=claude.js.map

package/dist/src/ariadne/runtimes/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,MAAM,UAAU,mBAAmB,CACjC,IAAsB,EACtB,OAAe;IAEf,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACnC,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,YAAY,EAAE,CAAC,SAAS,EAAE,gCAAgC,CAAC;QAC3D,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC5B,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,SAAS;YACT,gCAAgC;YAChC,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAC9C;KACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/runtimes/codex.d.ts

@@ -0,0 +1,2 @@
+import type { AriadneRuntimeAdapter, RuntimeProbeDeps } from "./types.js";
+export declare function createCodexRuntime(deps: RuntimeProbeDeps, version: string): AriadneRuntimeAdapter;

package/dist/src/ariadne/runtimes/codex.js

@@ -0,0 +1,24 @@
+import { createRuntimeAdapter, promptInstruction } from "./shared.js";
+export function createCodexRuntime(deps, version) {
+    return createRuntimeAdapter({
+        name: "codex",
+        command: "codex",
+        version: { kind: "exact", version },
+        helpArgs: ["exec", "--help"],
+        requiredHelp: [
+            "--dangerously-bypass-approvals-and-sandbox",
+            "--ephemeral",
+            "-C",
+        ],
+        authArgs: ["login", "status"],
+        invocationArgs: (context) => [
+            "exec",
+            "--dangerously-bypass-approvals-and-sandbox",
+            "--ephemeral",
+            "-C",
+            context.projectRoot,
+            promptInstruction(context.relativePromptPath),
+        ],
+    }, deps);
+}
+//# sourceMappingURL=codex.js.map

package/dist/src/ariadne/runtimes/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,OAAe;IAEf,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC5B,YAAY,EAAE;YACZ,4CAA4C;YAC5C,aAAa;YACb,IAAI;SACL;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC7B,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,MAAM;YACN,4CAA4C;YAC5C,aAAa;YACb,IAAI;YACJ,OAAO,CAAC,WAAW;YACnB,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAC9C;KACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/runtimes/gemini.d.ts

@@ -0,0 +1,2 @@
+import type { AriadneRuntimeAdapter, RuntimeProbeDeps } from "./types.js";
+export declare function createGeminiRuntime(deps: RuntimeProbeDeps, version: string): AriadneRuntimeAdapter;

package/dist/src/ariadne/runtimes/gemini.js

@@ -0,0 +1,18 @@
+import { createRuntimeAdapter, promptInstruction } from "./shared.js";
+export function createGeminiRuntime(deps, version) {
+    return createRuntimeAdapter({
+        name: "gemini",
+        command: "gemini",
+        version: { kind: "exact", version },
+        helpArgs: ["--help"],
+        requiredHelp: ["--prompt", "--approval-mode", "--skip-trust"],
+        invocationArgs: (context) => [
+            "--prompt",
+            promptInstruction(context.relativePromptPath),
+            "--approval-mode",
+            "yolo",
+            "--skip-trust",
+        ],
+    }, deps);
+}
+//# sourceMappingURL=gemini.js.map

package/dist/src/ariadne/runtimes/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,MAAM,UAAU,mBAAmB,CACjC,IAAsB,EACtB,OAAe;IAEf,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACnC,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,YAAY,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,cAAc,CAAC;QAC7D,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,UAAU;YACV,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAC7C,iBAAiB;YACjB,MAAM;YACN,cAAc;SACf;KACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/runtimes/index.d.ts

@@ -0,0 +1,4 @@
+import { type RuntimeProbeDeps, type RuntimeRegistry, type RuntimeSelection, type RuntimeSelectionInput } from "./types.js";
+export * from "./types.js";
+export declare function createRuntimeRegistry(deps: RuntimeProbeDeps): RuntimeRegistry;
+export declare function selectRuntime(input: RuntimeSelectionInput): Promise<RuntimeSelection>;

package/dist/src/ariadne/runtimes/index.js

@@ -0,0 +1,82 @@
+import { loadToolLock } from "../../tool-lock.js";
+import { createAntigravityRuntime } from "./antigravity.js";
+import { createClaudeRuntime } from "./claude.js";
+import { createCodexRuntime } from "./codex.js";
+import { createGeminiRuntime } from "./gemini.js";
+import { createOpenCodeRuntime } from "./opencode.js";
+import { AriadneRuntimeError, } from "./types.js";
+export * from "./types.js";
+export function createRuntimeRegistry(deps) {
+    const lock = loadToolLock();
+    return Object.freeze({
+        claude: createClaudeRuntime(deps, lock.runtimeClis.claude.version),
+        codex: createCodexRuntime(deps, lock.runtimeClis.codex.version),
+        opencode: createOpenCodeRuntime(deps, lock.runtimeClis.opencode.version),
+        gemini: createGeminiRuntime(deps, lock.runtimeClis.gemini.version),
+        antigravity: createAntigravityRuntime(deps),
+    });
+}
+function selection(name, registry, detections, source) {
+    const adapter = registry[name];
+    const detection = detections.get(name) ?? adapter.detect();
+    return { name, adapter, detection, source };
+}
+function requireSelectablePreference(source, name, registry, detections) {
+    const candidate = selection(name, registry, detections, source);
+    if (candidate.detection.state === "healthy") {
+        return candidate;
+    }
+    if (source === "explicit" && candidate.detection.state === "unverified") {
+        return candidate;
+    }
+    if (source === "configured") {
+        return undefined;
+    }
+    throw new AriadneRuntimeError(`The ${source} runtime ${name} is ${candidate.detection.state}: ${candidate.detection.reason}`);
+}
+export async function selectRuntime(input) {
+    const names = Object.keys(input.registry);
+    const detections = new Map(names.map((name) => [name, input.registry[name].detect()]));
+    if (input.explicit) {
+        const explicit = requireSelectablePreference("explicit", input.explicit, input.registry, detections);
+        if (explicit)
+            return explicit;
+    }
+    if (input.configured) {
+        const configured = requireSelectablePreference("configured", input.configured, input.registry, detections);
+        if (configured)
+            return configured;
+    }
+    const healthy = names.filter((name) => detections.get(name)?.state === "healthy");
+    if (healthy.length === 1) {
+        return selection(healthy[0], input.registry, detections, "automatic");
+    }
+    if (healthy.length > 1 &&
+        input.globalPreferred &&
+        healthy.includes(input.globalPreferred)) {
+        return selection(input.globalPreferred, input.registry, detections, "global");
+    }
+    if (healthy.length > 1) {
+        if (!input.interactive) {
+            throw new AriadneRuntimeError(`Multiple healthy runtimes are available (${healthy.join(", ")}); pass --runtime to choose one.`);
+        }
+        if (!input.choose) {
+            throw new AriadneRuntimeError("Interactive runtime selection requires a choose callback.");
+        }
+        const choices = healthy.map((name) => detections.get(name));
+        const chosen = await input.choose(choices);
+        if (!healthy.includes(chosen)) {
+            throw new AriadneRuntimeError(`Interactive runtime selection returned invalid choice: ${chosen}.`);
+        }
+        return selection(chosen, input.registry, detections, "interactive");
+    }
+    const unverified = names.filter((name) => detections.get(name)?.state === "unverified");
+    if (unverified.length === 1) {
+        return selection(unverified[0], input.registry, detections, "automatic");
+    }
+    if (unverified.length > 1) {
+        throw new AriadneRuntimeError(`Multiple unverified runtimes are available (${unverified.join(", ")}); pass --runtime to choose one.`);
+    }
+    throw new AriadneRuntimeError("No healthy or unverified runtime is available. Run ariadne doctor for details.");
+}
+//# sourceMappingURL=index.js.map

package/dist/src/ariadne/runtimes/index.js.map

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

package/dist/src/ariadne/runtimes/opencode.d.ts

@@ -0,0 +1,2 @@
+import type { AriadneRuntimeAdapter, RuntimeProbeDeps } from "./types.js";
+export declare function createOpenCodeRuntime(deps: RuntimeProbeDeps, version: string): AriadneRuntimeAdapter;

package/dist/src/ariadne/runtimes/opencode.js

@@ -0,0 +1,19 @@
+import { createRuntimeAdapter, promptInstruction } from "./shared.js";
+export function createOpenCodeRuntime(deps, version) {
+    return createRuntimeAdapter({
+        name: "opencode",
+        command: "opencode",
+        version: { kind: "exact", version },
+        helpArgs: ["run", "--help"],
+        requiredHelp: ["--auto", "--dir"],
+        authArgs: ["providers", "list"],
+        invocationArgs: (context) => [
+            "run",
+            "--auto",
+            "--dir",
+            context.projectRoot,
+            promptInstruction(context.relativePromptPath),
+        ],
+    }, deps);
+}
+//# sourceMappingURL=opencode.js.map

package/dist/src/ariadne/runtimes/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,MAAM,UAAU,qBAAqB,CACnC,IAAsB,EACtB,OAAe;IAEf,OAAO,oBAAoB,CACzB;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACjC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3B,KAAK;YACL,QAAQ;YACR,OAAO;YACP,OAAO,CAAC,WAAW;YACnB,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAC9C;KACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/runtimes/shared.d.ts

@@ -0,0 +1,24 @@
+import type { AriadneRuntimeName, ProcessResult } from "../types.js";
+import type { AgentOutcome, AriadneRuntimeAdapter, IterationContext, RuntimeProbeDeps } from "./types.js";
+type RuntimeVersionPolicy = {
+    kind: "exact";
+    version: string;
+} | {
+    kind: "minimum";
+    version: string;
+};
+export type RuntimeAdapterDefinition = {
+    name: AriadneRuntimeName;
+    command: string;
+    version: RuntimeVersionPolicy;
+    helpArgs: string[];
+    requiredHelp: string[];
+    authArgs?: string[];
+    invocationArgs: (context: IterationContext) => string[];
+};
+export declare function parseVersionToken(output: string): string | undefined;
+export declare function compareNumericVersions(left: string, right: string): number;
+export declare function promptInstruction(relativePromptPath: string): string;
+export declare function interpretProcessResult(result: ProcessResult): AgentOutcome;
+export declare function createRuntimeAdapter(definition: RuntimeAdapterDefinition, deps: RuntimeProbeDeps): AriadneRuntimeAdapter;
+export {};