@plune-ai/cli 0.6.0 → 0.8.0

package/dist/index.cjs

@@ -150,9 +150,9 @@ var modelPriceSchema = import_zod.z.object({
   input_per_1k_usd: import_zod.z.number().nonnegative(),
   output_per_1k_usd: import_zod.z.number().nonnegative()
 });
-var pricingSchema = import_zod.z.record(modelPriceSchema);
+var pricingSchema = import_zod.z.record(import_zod.z.string(), modelPriceSchema);
 var datasetRowSchema = import_zod.z.object({
-  vars: import_zod.z.record(import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean()])),
+  vars: import_zod.z.record(import_zod.z.string(), import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean()])),
   expected: import_zod.z.string().optional()
 });
 var datasetRefSchema = import_zod.z.union([
@@ -182,7 +182,7 @@ var containsAllAssertionSchema = import_zod.z.object({
 });
 var jsonSchemaAssertionSchema = import_zod.z.object({
   type: import_zod.z.literal("json-schema"),
-  schema: import_zod.z.record(import_zod.z.unknown()),
+  schema: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()),
   extract: import_zod.z.enum(["auto", "strict"]).optional()
 });
 var llmJudgeAssertionSchema = import_zod.z.object({
@@ -1544,7 +1544,7 @@ var runErrorSchema = import_zod2.z.object({
   message: import_zod2.z.string()
 });
 var rowResultSchema = import_zod2.z.object({
-  vars: import_zod2.z.record(import_zod2.z.unknown()),
+  vars: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()),
   output: import_zod2.z.string().nullable(),
   cached: import_zod2.z.boolean(),
   usage: usageSchema.optional(),
@@ -1579,6 +1579,13 @@ function parseRunResult(value) {
   return runResultSchema.parse(value);
 }
 
+// src/cli/api-url.ts
+var DEFAULT_API_URL = "https://beta-api.plune.ai";
+function resolveApiUrl(explicit) {
+  const raw = explicit ?? process.env["PLUNE_API_URL"] ?? DEFAULT_API_URL;
+  return raw.replace(/\/+$/, "");
+}
+
 // src/cli/credentials.ts
 var import_node_fs = require("fs");
 var import_node_os = require("os");
@@ -1597,7 +1604,6 @@ function loadToken() {
 }
 
 // src/cli/commands/sync.ts
-var DEFAULT_API_URL = "https://beta-api.plune.ai";
 var NotLoggedInError = class extends Error {
   constructor() {
     super('Not logged in. Run "plune login" first to save your API token.');
@@ -1634,10 +1640,6 @@ var SyncHttpError = class extends Error {
   }
   status;
 };
-function resolveApiUrl(explicit) {
-  const raw = explicit ?? process.env["PLUNE_API_URL"] ?? DEFAULT_API_URL;
-  return raw.replace(/\/+$/, "");
-}
 function readRun(cwd, file) {
   const target = file !== void 0 ? path5.resolve(cwd, file) : path5.join(cwd, ".plune", "last-run.json");
   let raw;
@@ -1712,9 +1714,36 @@ var fs7 = __toESM(require("fs/promises"), 1);
 var path6 = __toESM(require("path"), 1);
 var SUPPORTED_ARTIFACT_VERSION = 1;
 var INGEST_SCHEMA_VERSION = 1;
+var NoCairnRunsError = class extends Error {
+  constructor(runsDir) {
+    super(`No Cairn run found under ${runsDir} \u2014 name the directory instead: plune ingest <dir>.`);
+    this.name = "NoCairnRunsError";
+  }
+};
+async function findLatestCairnRun(runsDir = "runs") {
+  const entries = await fs7.readdir(runsDir, { withFileTypes: true }).catch(() => null);
+  if (entries === null) throw new NoCairnRunsError(runsDir);
+  let newest;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const dir = path6.join(runsDir, entry.name);
+    try {
+      const report = await fs7.lstat(path6.join(dir, "report.json"));
+      if (!report.isFile()) continue;
+      if (newest === void 0 || report.mtimeMs > newest.at) {
+        newest = { dir, at: report.mtimeMs };
+      }
+    } catch {
+    }
+  }
+  if (newest === void 0) throw new NoCairnRunsError(runsDir);
+  return newest.dir;
+}
 var CairnRunNotFoundError = class extends Error {
   constructor(dir) {
-    super(`No Cairn run found in ${dir} \u2014 expected a report.json written by "cairn design|explore|api".`);
+    super(
+      `No Cairn run found in ${dir} \u2014 expected a report.json written by "cairn design|explore|api".`
+    );
     this.name = "CairnRunNotFoundError";
   }
 };
@@ -1803,7 +1832,9 @@ async function readCairnRun(dir, deps = {}) {
   }
   const mode = report["mode"];
   if (mode !== "design" && mode !== "explore" && mode !== "api") {
-    throw new CairnRunVersionError(`${SUPPORTED_ARTIFACT_VERSION} (unknown run mode ${String(mode)})`);
+    throw new CairnRunVersionError(
+      `${SUPPORTED_ARTIFACT_VERSION} (unknown run mode ${String(mode)})`
+    );
   }
   let cases;
   if (mode === "api") {
@@ -1829,7 +1860,6 @@ async function readCairnRun(dir, deps = {}) {
 }
 
 // src/cli/commands/ingest.ts
-var DEFAULT_API_URL2 = "https://beta-api.plune.ai";
 var IngestNotLoggedInError = class extends Error {
   constructor() {
     super('Not logged in. Run "plune login" first to save your API token.');
@@ -1856,10 +1886,6 @@ var IngestHttpError = class extends Error {
   }
   status;
 };
-function resolveApiUrl2(explicit) {
-  const raw = explicit ?? process.env["PLUNE_API_URL"] ?? DEFAULT_API_URL2;
-  return raw.replace(/\/+$/, "");
-}
 async function safeErrorDetail2(res) {
   try {
     const body = await res.json();
@@ -1869,10 +1895,11 @@ async function safeErrorDetail2(res) {
   }
 }
 async function handleIngest(deps) {
-  const apiUrl = resolveApiUrl2(deps.apiUrl);
+  const apiUrl = resolveApiUrl(deps.apiUrl);
   const token = (deps.loadToken ?? loadToken)();
   if (token === null) throw new IngestNotLoggedInError();
-  const payload = await readCairnRun(deps.dir);
+  const dir = deps.dir ?? await findLatestCairnRun(deps.runsDir);
+  const payload = await readCairnRun(dir);
   const doFetch = deps.fetchImpl ?? fetch;
   const endpoint = `${apiUrl}/v1/ingest/cairn`;
   let res;
@@ -1899,7 +1926,7 @@ async function handleIngest(deps) {
   };
 }
 function reportIngestFailure(err, write) {
-  if (err instanceof IngestNotLoggedInError || err instanceof IngestTokenRejectedError || err instanceof CairnRunNotFoundError || err instanceof CairnRunVersionError || err instanceof CairnRunPartialError || err instanceof CairnEvidenceAmbiguousError) {
+  if (err instanceof IngestNotLoggedInError || err instanceof IngestTokenRejectedError || err instanceof CairnRunNotFoundError || err instanceof NoCairnRunsError || err instanceof CairnRunVersionError || err instanceof CairnRunPartialError || err instanceof CairnEvidenceAmbiguousError) {
     write(`${err.message}
 `);
     return 2;

package/dist/index.d.cts

@@ -265,176 +265,65 @@ declare function handleSync(deps?: SyncDeps): Promise<SyncResult>;
  */
 declare function reportSyncFailure(err: unknown, write: (s: string) => void): number | null;
 
-declare const assertionConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+declare const assertionConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"exact-match">;
     value: z.ZodString;
     trim: z.ZodOptional<z.ZodBoolean>;
     ignore_case: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    type: "exact-match";
-    value: string;
-    trim?: boolean | undefined;
-    ignore_case?: boolean | undefined;
-}, {
-    type: "exact-match";
-    value: string;
-    trim?: boolean | undefined;
-    ignore_case?: boolean | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"contains">;
     value: z.ZodString;
     ignore_case: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    type: "contains";
-    value: string;
-    ignore_case?: boolean | undefined;
-}, {
-    type: "contains";
-    value: string;
-    ignore_case?: boolean | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"contains-any">;
-    values: z.ZodArray<z.ZodString, "many">;
+    values: z.ZodArray<z.ZodString>;
     ignore_case: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    type: "contains-any";
-    values: string[];
-    ignore_case?: boolean | undefined;
-}, {
-    type: "contains-any";
-    values: string[];
-    ignore_case?: boolean | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"contains-all">;
-    values: z.ZodArray<z.ZodString, "many">;
+    values: z.ZodArray<z.ZodString>;
     ignore_case: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    type: "contains-all";
-    values: string[];
-    ignore_case?: boolean | undefined;
-}, {
-    type: "contains-all";
-    values: string[];
-    ignore_case?: boolean | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"json-schema">;
     schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    extract: z.ZodOptional<z.ZodEnum<["auto", "strict"]>>;
-}, "strip", z.ZodTypeAny, {
-    type: "json-schema";
-    schema: Record<string, unknown>;
-    extract?: "auto" | "strict" | undefined;
-}, {
-    type: "json-schema";
-    schema: Record<string, unknown>;
-    extract?: "auto" | "strict" | undefined;
-}>, z.ZodObject<{
+    extract: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        strict: "strict";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"llm-judge">;
     criteria: z.ZodString;
     provider: z.ZodOptional<z.ZodObject<{
-        type: z.ZodOptional<z.ZodEnum<["anthropic", "openai", "openrouter"]>>;
+        type: z.ZodOptional<z.ZodEnum<{
+            anthropic: "anthropic";
+            openai: "openai";
+            openrouter: "openrouter";
+        }>>;
         model: z.ZodOptional<z.ZodString>;
         temperature: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         max_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         concurrency: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         timeout: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         max_retries: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
-    }, "strip", z.ZodTypeAny, {
-        type?: "anthropic" | "openai" | "openrouter" | undefined;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        max_tokens?: number | undefined;
-        concurrency?: number | undefined;
-        timeout?: number | undefined;
-        max_retries?: number | undefined;
-    }, {
-        type?: "anthropic" | "openai" | "openrouter" | undefined;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        max_tokens?: number | undefined;
-        concurrency?: number | undefined;
-        timeout?: number | undefined;
-        max_retries?: number | undefined;
-    }>>;
+    }, z.core.$strip>>;
     pass_threshold: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    type: "llm-judge";
-    criteria: string;
-    provider?: {
-        type?: "anthropic" | "openai" | "openrouter" | undefined;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        max_tokens?: number | undefined;
-        concurrency?: number | undefined;
-        timeout?: number | undefined;
-        max_retries?: number | undefined;
-    } | undefined;
-    pass_threshold?: number | undefined;
-}, {
-    type: "llm-judge";
-    criteria: string;
-    provider?: {
-        type?: "anthropic" | "openai" | "openrouter" | undefined;
-        model?: string | undefined;
-        temperature?: number | undefined;
-        max_tokens?: number | undefined;
-        concurrency?: number | undefined;
-        timeout?: number | undefined;
-        max_retries?: number | undefined;
-    } | undefined;
-    pass_threshold?: number | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"semantic-similarity">;
     reference: z.ZodString;
     threshold: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    type: "semantic-similarity";
-    reference: string;
-    threshold?: number | undefined;
-}, {
-    type: "semantic-similarity";
-    reference: string;
-    threshold?: number | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"faithfulness">;
     context: z.ZodString;
     threshold: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    type: "faithfulness";
-    context: string;
-    threshold?: number | undefined;
-}, {
-    type: "faithfulness";
-    context: string;
-    threshold?: number | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"answer-relevance">;
     question: z.ZodString;
     threshold: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    type: "answer-relevance";
-    question: string;
-    threshold?: number | undefined;
-}, {
-    type: "answer-relevance";
-    question: string;
-    threshold?: number | undefined;
-}>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"context-precision">;
     context: z.ZodString;
     question: z.ZodString;
     threshold: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    type: "context-precision";
-    context: string;
-    question: string;
-    threshold?: number | undefined;
-}, {
-    type: "context-precision";
-    context: string;
-    question: string;
-    threshold?: number | undefined;
-}>]>;
+}, z.core.$strip>], "type">;
 
 /**
  * Runtime validation for the RunResult contract — the JSON that `plune run --format json` emits.
@@ -458,13 +347,7 @@ declare const RUN_RESULT_SCHEMA_VERSION: RunResult['schemaVersion'];
 declare const binaryVerdictSchema: z.ZodObject<{
     question: z.ZodString;
     passed: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    question: string;
-    passed: boolean;
-}, {
-    question: string;
-    passed: boolean;
-}>;
+}, z.core.$strip>;
 declare const assertionResultRecordSchema: z.ZodObject<{
     type: z.ZodString;
     passed: z.ZodBoolean;
@@ -473,32 +356,8 @@ declare const assertionResultRecordSchema: z.ZodObject<{
     binaryVerdicts: z.ZodOptional<z.ZodArray<z.ZodObject<{
         question: z.ZodString;
         passed: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        question: string;
-        passed: boolean;
-    }, {
-        question: string;
-        passed: boolean;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    type: string;
-    passed: boolean;
-    score?: number | undefined;
-    reason?: string | undefined;
-    binaryVerdicts?: {
-        question: string;
-        passed: boolean;
-    }[] | undefined;
-}, {
-    type: string;
-    passed: boolean;
-    score?: number | undefined;
-    reason?: string | undefined;
-    binaryVerdicts?: {
-        question: string;
-        passed: boolean;
-    }[] | undefined;
-}>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 declare const runResultSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
     plune_version: z.ZodString;
@@ -512,24 +371,10 @@ declare const runResultSchema: z.ZodObject<{
         errored: z.ZodNumber;
         cost_usd: z.ZodNumber;
         duration_ms: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        cost_usd: number;
-        passed: number;
-        failed: number;
-        errored: number;
-        total: number;
-        duration_ms: number;
-    }, {
-        cost_usd: number;
-        passed: number;
-        failed: number;
-        errored: number;
-        total: number;
-        duration_ms: number;
-    }>;
+    }, z.core.$strip>;
     evals: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        tags: z.ZodArray<z.ZodString, "many">;
+        tags: z.ZodArray<z.ZodString>;
         rows: z.ZodArray<z.ZodObject<{
             vars: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             output: z.ZodNullable<z.ZodString>;
@@ -538,26 +383,12 @@ declare const runResultSchema: z.ZodObject<{
                 input_tokens: z.ZodNumber;
                 output_tokens: z.ZodNumber;
                 cost_usd: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            }, {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            }>>;
+            }, z.core.$strip>>;
             latency_ms: z.ZodOptional<z.ZodNumber>;
             error: z.ZodOptional<z.ZodObject<{
                 code: z.ZodString;
                 message: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                code: string;
-                message: string;
-            }, {
-                code: string;
-                message: string;
-            }>>;
+            }, z.core.$strip>>;
             assertions: z.ZodArray<z.ZodObject<{
                 type: z.ZodString;
                 passed: z.ZodBoolean;
@@ -566,230 +397,12 @@ declare const runResultSchema: z.ZodObject<{
                 binaryVerdicts: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     question: z.ZodString;
                     passed: z.ZodBoolean;
-                }, "strip", z.ZodTypeAny, {
-                    question: string;
-                    passed: boolean;
-                }, {
-                    question: string;
-                    passed: boolean;
-                }>, "many">>;
-            }, "strip", z.ZodTypeAny, {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }, {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }, {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }>, "many">;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         passed: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        tags: string[];
-        passed: boolean;
-        rows: {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }[];
-    }, {
-        id: string;
-        tags: string[];
-        passed: boolean;
-        rows: {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }[];
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    evals: {
-        id: string;
-        tags: string[];
-        passed: boolean;
-        rows: {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }[];
-    }[];
-    schemaVersion: 1;
-    plune_version: string;
-    summary: {
-        cost_usd: number;
-        passed: number;
-        failed: number;
-        errored: number;
-        total: number;
-        duration_ms: number;
-    };
-    started_at: string;
-    finished_at: string;
-    config_hash: string;
-}, {
-    evals: {
-        id: string;
-        tags: string[];
-        passed: boolean;
-        rows: {
-            vars: Record<string, unknown>;
-            assertions: {
-                type: string;
-                passed: boolean;
-                score?: number | undefined;
-                reason?: string | undefined;
-                binaryVerdicts?: {
-                    question: string;
-                    passed: boolean;
-                }[] | undefined;
-            }[];
-            output: string | null;
-            cached: boolean;
-            error?: {
-                code: string;
-                message: string;
-            } | undefined;
-            usage?: {
-                cost_usd: number;
-                input_tokens: number;
-                output_tokens: number;
-            } | undefined;
-            latency_ms?: number | undefined;
-        }[];
-    }[];
-    schemaVersion: 1;
-    plune_version: string;
-    summary: {
-        cost_usd: number;
-        passed: number;
-        failed: number;
-        errored: number;
-        total: number;
-        duration_ms: number;
-    };
-    started_at: string;
-    finished_at: string;
-    config_hash: string;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Type inferred from the zod mirror — structurally a superset of the frozen `RunResult`
  * (adds optional `binaryVerdicts`). The canonical `RunResult` remains the source of truth.
@@ -800,8 +413,10 @@ type BinaryVerdict = z.infer<typeof binaryVerdictSchema>;
 declare function parseRunResult(value: unknown): ParsedRunResult;
 
 interface IngestDeps {
-    /** The Cairn run directory to read. */
-    dir: string;
+    /** The Cairn run directory to read. Omit it and the newest run under `runsDir` is used. */
+    dir?: string;
+    /** Where to look when `dir` is omitted; relative paths resolve against the process's cwd. */
+    runsDir?: string;
     apiUrl?: string;
     loadToken?: () => string | null;
     fetchImpl?: typeof fetch;