@tuned-tensor/cli 0.13.0-beta.0 → 0.13.0-beta.1

package/dist/{chunk-HDGBDHOB.js → chunk-2VJ3VVZF.js}

@@ -1079,337 +1079,16 @@ var localRunnerConfigSchema = z.object({
   })
 }).strict();
 
-// src/local-runtime/local-project.ts
-import { createHash as createHash2, randomUUID as randomUUID2 } from "crypto";
-import { readFile as readFile2, stat as stat2, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute2, resolve as resolve3 } from "path";
-import { homedir } from "os";
-import { mkdir as mkdir2 } from "fs/promises";
-var DEFAULT_LOCAL_SPEC_PATH = "tunedtensor.json";
-function resolveLocalReference(value, baseDirectory) {
-  if (typeof value !== "string" || !value || isAbsolute2(value) || /^[a-z][a-z0-9+.-]*:/i.test(value)) {
-    return value;
-  }
-  if (value === "~") return homedir();
-  if (value.startsWith("~/")) return resolve3(homedir(), value.slice(2));
-  return resolve3(baseDirectory, value);
-}
-function resolveLocalRunInputPaths(raw, inputPath) {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return raw;
-  const baseDirectory = dirname2(resolve3(inputPath));
-  const value = structuredClone(raw);
-  const dataset = value.dataset_prebuilt;
-  if (dataset && typeof dataset === "object" && !Array.isArray(dataset)) {
-    const fields = dataset;
-    for (const key of ["training", "validation", "test"]) {
-      if (fields[key] !== void 0) fields[key] = resolveLocalReference(fields[key], baseDirectory);
-    }
-  }
-  return value;
-}
-async function exists(path) {
-  try {
-    await stat2(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function initLocalSpecFile(args) {
-  if (!args.force && await exists(args.outputPath)) {
-    throw new Error(`Refusing to overwrite existing file: ${args.outputPath}`);
-  }
-  const spec = localBehaviorSpecFileSchema.parse({
-    id: randomUUID2(),
-    name: args.name,
-    description: "",
-    system_prompt: "Describe the behavior this local model should learn.",
-    guidelines: [
-      "Return concise, task-specific answers."
-    ],
-    constraints: [],
-    base_model: args.baseModel,
-    examples: [
-      {
-        input: "Replace this with representative training input.",
-        output: "Replace this with the expected training output."
-      },
-      {
-        input: "Replace this with a different validation input.",
-        output: "Replace this with the expected validation output."
-      }
-    ],
-    hyperparameters: {
-      n_epochs: 1
-    }
-  });
-  await mkdir2(dirname2(args.outputPath), { recursive: true });
-  await writeFile2(args.outputPath, `${JSON.stringify(spec, null, 2)}
-`, "utf8");
-  return spec;
-}
-async function initLocalRunnerConfigFile(args) {
-  if (!args.force && await exists(args.outputPath)) {
-    throw new Error(`Refusing to overwrite existing file: ${args.outputPath}`);
-  }
-  const config = {
-    artifactRoot: ".tt-local/artifacts",
-    storeRoot: ".tt-local/store",
-    evaluation: {
-      inference: {
-        device: "cuda"
-      },
-      scoring: {
-        mode: "exact_match"
-      },
-      timeoutMs: 18e5
-    }
-  };
-  await mkdir2(dirname2(args.outputPath), { recursive: true });
-  await writeFile2(args.outputPath, `${JSON.stringify(config, null, 2)}
-`, "utf8");
-  return config;
-}
-function generatedPlaceholderIssues(request) {
-  const issues = [];
-  if (/describe the behavior this local model should learn/i.test(request.spec_snapshot.system_prompt)) {
-    issues.push("system_prompt still contains the generated placeholder");
-  }
-  request.spec_snapshot.examples.forEach((example, index) => {
-    if (/replace this with/i.test(example.input) || /replace this with/i.test(example.output)) {
-      issues.push(`examples[${index}] still contains generated placeholder text`);
-    }
-  });
-  return issues;
-}
-function assertLocalRunInputReady(request) {
-  const issues = generatedPlaceholderIssues(request);
-  if (issues.length > 0) {
-    throw new Error(`Edit the generated behavior spec before training: ${issues.join("; ")}.`);
-  }
-}
-function runRequestFromLocalSpec(spec, options = {}) {
-  const {
-    id,
-    hyperparameters,
-    dataset_prebuilt: datasetPrebuilt,
-    ...specSnapshot
-  } = spec;
-  const behaviorSpecId = id ?? deterministicBehaviorSpecId(specSnapshot);
-  return fineTuneRunRequestSchema.parse({
-    run_id: options.runId ?? randomUUID2(),
-    user_id: "local-user",
-    behavior_spec_id: behaviorSpecId,
-    run_number: 1,
-    spec_snapshot: specSnapshot,
-    hyperparameters,
-    dataset_prebuilt: datasetPrebuilt
-  });
-}
-function deterministicBehaviorSpecId(spec) {
-  const namespace = Buffer.from("9f783f01340457bea061942004259253", "hex");
-  const digest = createHash2("sha1").update(namespace).update(JSON.stringify(spec)).digest().subarray(0, 16);
-  digest[6] = digest[6] & 15 | 80;
-  digest[8] = digest[8] & 63 | 128;
-  const hex = digest.toString("hex");
-  return [
-    hex.slice(0, 8),
-    hex.slice(8, 12),
-    hex.slice(12, 16),
-    hex.slice(16, 20),
-    hex.slice(20)
-  ].join("-");
-}
-async function loadLocalRunInput(path, options = {}) {
-  const raw = resolveLocalRunInputPaths(JSON.parse(await readFile2(path, "utf8")), path);
-  const request = fineTuneRunRequestSchema.safeParse(raw);
-  if (request.success) {
-    return { kind: "request", path, request: request.data };
-  }
-  const spec = localBehaviorSpecFileSchema.parse(raw);
-  return {
-    kind: "spec",
-    path,
-    spec,
-    request: runRequestFromLocalSpec(spec, options)
-  };
-}
-
-// src/local-runtime/dataset.ts
-import { readFile as readFile3 } from "fs/promises";
-async function loadNormalizedChatJsonl(path) {
-  const text = await readFile3(path, "utf8");
-  const rows = [];
-  const jsonLines = [];
-  for (const [index, line] of text.split(/\r?\n/).entries()) {
-    if (!line.trim()) continue;
-    let value;
-    try {
-      value = JSON.parse(line);
-    } catch (error) {
-      throw new Error(`Invalid chat JSONL row ${index + 1}: malformed JSON`, { cause: error });
-    }
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      throw new Error(`Invalid chat JSONL row ${index + 1}: expected an object`);
-    }
-    const messages = value.messages;
-    if (!Array.isArray(messages) || ![2, 3].includes(messages.length) || messages.some(
-      (message) => !message || typeof message !== "object" || Array.isArray(message) || !["system", "user", "assistant"].includes(String(message.role)) || typeof message.content !== "string"
-    )) {
-      throw new Error(
-        `Invalid chat JSONL row ${index + 1}: expected an optional system message, one user message, and one assistant answer`
-      );
-    }
-    const row = { messages };
-    const offset = row.messages.length === 3 ? 1 : 0;
-    if (offset === 1 && row.messages[0]?.role !== "system" || row.messages[offset]?.role !== "user" || !row.messages[offset]?.content.trim() || row.messages[offset + 1]?.role !== "assistant" || !row.messages[offset + 1]?.content.trim()) {
-      throw new Error(
-        `Invalid chat JSONL row ${index + 1}: expected an optional system message, one non-empty user message, and one non-empty assistant answer`
-      );
-    }
-    rows.push(row);
-    jsonLines.push(JSON.stringify(row));
-  }
-  if (rows.length === 0) throw new Error(`Chat JSONL contains no examples: ${path}`);
-  return {
-    rows,
-    jsonl: jsonLines.join("\n")
-  };
-}
-async function normalizeChatJsonlForRelocation(path) {
-  return (await loadNormalizedChatJsonl(path)).jsonl;
-}
-function buildSystemMessage(spec) {
-  const parts = [];
-  if (spec.system_prompt.trim()) parts.push(spec.system_prompt.trim());
-  if (spec.guidelines.length > 0) {
-    parts.push(`Guidelines:
-${spec.guidelines.map((guideline) => `- ${guideline}`).join("\n")}`);
-  }
-  if (spec.constraints.length > 0) {
-    parts.push(`Constraints:
-${spec.constraints.map((constraint) => `- ${constraint}`).join("\n")}`);
-  }
-  return parts.join("\n\n") || "Follow the demonstrated behavior.";
-}
-function exampleToChatRow(spec, example) {
-  const system = buildSystemMessage(spec);
-  return {
-    messages: [
-      { role: "system", content: system },
-      { role: "user", content: example.input },
-      { role: "assistant", content: example.output }
-    ]
-  };
-}
-function compileSpecToJsonl(spec) {
-  return spec.examples.map((example) => JSON.stringify(exampleToChatRow(spec, example))).join("\n");
-}
-function examplesFromSpec(spec) {
-  return spec.examples;
-}
-async function examplesFromChatJsonl(path) {
-  const normalized = await loadNormalizedChatJsonl(path);
-  const examples = [];
-  for (const [index, row] of normalized.rows.entries()) {
-    const user = row.messages.at(-2);
-    const assistant = row.messages.at(-1);
-    examples.push({
-      input: user.content,
-      output: assistant.content
-    });
-  }
-  return examples;
-}
-async function evaluationSuiteFromChatJsonl(path, configuredSystem) {
-  const normalized = await loadNormalizedChatJsonl(path);
-  const inputIdentities = /* @__PURE__ */ new Set();
-  for (const row of normalized.rows) {
-    const input = row.messages.at(-2).content;
-    const identity = input.trim().replace(/\s+/g, " ").toLowerCase();
-    if (inputIdentities.has(identity)) {
-      throw new Error(
-        "General regression data contains duplicate inputs; evaluation prompts must be unique."
-      );
-    }
-    inputIdentities.add(identity);
-  }
-  const systems = new Set(
-    normalized.rows.map((row) => row.messages.find((message) => message.role === "system")?.content).filter((value) => value !== void 0)
-  );
-  if (systems.size > 1) {
-    throw new Error("General regression rows must use one consistent system message.");
-  }
-  const embeddedSystem = [...systems][0];
-  if (configuredSystem !== void 0 && embeddedSystem !== void 0 && configuredSystem !== embeddedSystem) {
-    throw new Error(
-      "evaluation.generalRegression.systemPrompt must match the system message embedded in the dataset."
-    );
-  }
-  return {
-    examples: normalized.rows.map((row) => ({
-      input: row.messages.at(-2).content,
-      output: row.messages.at(-1).content
-    })),
-    system: configuredSystem ?? embeddedSystem ?? "You are a helpful assistant."
-  };
-}
-
-// src/local-runtime/run-reporter.ts
-function reportInBackground(action) {
-  try {
-    void Promise.resolve(action()).catch(() => void 0);
-  } catch {
-  }
-}
-function sanitizeLogLine(line) {
-  return line.replace(/(Bearer\s+)[A-Za-z0-9._~+/=-]+/gi, "$1[redacted]").replace(/((?:api[_-]?key|token|secret|password)=)[^\s]+/gi, "$1[redacted]");
-}
-function forwardStreamLines(stream, onLine) {
-  let buffered = "";
-  stream.setEncoding("utf8");
-  stream.on("data", (chunk) => {
-    buffered += chunk;
-    const lines = buffered.split(/\r\n|\n|\r/);
-    buffered = lines.pop() ?? "";
-    for (const line of lines) {
-      if (line.trim()) onLine(sanitizeLogLine(line));
-    }
-  });
-  stream.on("end", () => {
-    if (buffered.trim()) onLine(sanitizeLogLine(buffered));
-  });
-}
-
-// src/local-runtime/package-root.ts
-import { existsSync } from "fs";
-import { dirname as dirname3, resolve as resolve4 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-function localRuntimePackageRoot(moduleUrl) {
-  const moduleDirectory = dirname3(fileURLToPath2(moduleUrl));
-  const candidates = [
-    dirname3(moduleDirectory),
-    dirname3(dirname3(moduleDirectory))
-  ];
-  const root = candidates.find(
-    (candidate) => existsSync(resolve4(candidate, "package.json")) && existsSync(resolve4(candidate, "training/local-runner"))
-  );
-  if (!root) {
-    throw new Error("Unable to locate the bundled Tuned Tensor local runtime assets.");
-  }
-  return root;
-}
-
 // src/local-runtime/store.ts
-import { appendFile, copyFile as copyFile2, mkdir as mkdir3, readdir as readdir3, readFile as readFile4, rename as rename2, rm, stat as stat3, writeFile as writeFile3 } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { dirname as dirname4, join as join2, resolve as resolve5 } from "path";
-import { randomUUID as randomUUID3 } from "crypto";
+import { appendFile, copyFile as copyFile2, mkdir as mkdir2, readdir as readdir3, readFile as readFile2, rename as rename2, rm, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { homedir } from "os";
+import { dirname as dirname2, join as join2, resolve as resolve3, sep as sep2 } from "path";
+import { randomUUID as randomUUID2 } from "crypto";
 function isTerminalRunState(state) {
   return state.status === "stage_completed" || state.status === "completed" || state.status === "failed" || state.status === "cancelled" && state.current_stage === "cancelled" && Boolean(state.completed_at);
 }
 function defaultLocalHome() {
-  return resolve5(process.env.TT_LOCAL_HOME ?? join2(homedir2(), ".tuned-tensor-local"));
+  return resolve3(process.env.TT_LOCAL_HOME ?? join2(homedir(), ".tuned-tensor-local"));
 }
 function localStorePaths(root) {
   return {
@@ -1420,36 +1099,36 @@ function localStorePaths(root) {
     datasetsDir: join2(root, "datasets")
   };
 }
-async function exists2(path) {
+async function exists(path) {
   try {
-    await stat3(path);
+    await stat2(path);
     return true;
   } catch {
     return false;
   }
 }
 async function writeJsonAtomic2(path, value) {
-  await mkdir3(dirname4(path), { recursive: true });
-  const tmp = `${path}.${process.pid}.${Date.now()}.${randomUUID3()}.tmp`;
-  await writeFile3(tmp, `${JSON.stringify(value, null, 2)}
+  await mkdir2(dirname2(path), { recursive: true });
+  const tmp = `${path}.${process.pid}.${Date.now()}.${randomUUID2()}.tmp`;
+  await writeFile2(tmp, `${JSON.stringify(value, null, 2)}
 `, "utf8");
   await rename2(tmp, path);
 }
 async function readJson2(path) {
-  return JSON.parse(await readFile4(path, "utf8"));
+  return JSON.parse(await readFile2(path, "utf8"));
 }
 async function appendJsonl(path, value) {
-  await mkdir3(dirname4(path), { recursive: true });
+  await mkdir2(dirname2(path), { recursive: true });
   await appendFile(path, `${JSON.stringify(value)}
 `, "utf8");
 }
 async function readJsonl(path) {
-  if (!await exists2(path)) return [];
-  return (await readFile4(path, "utf8")).split(/\r?\n/).filter(Boolean).map((line) => JSON.parse(line));
+  if (!await exists(path)) return [];
+  return (await readFile2(path, "utf8")).split(/\r?\n/).filter(Boolean).map((line) => JSON.parse(line));
 }
 async function copyIfExists(from, to) {
-  if (!await exists2(from)) return;
-  await mkdir3(dirname4(to), { recursive: true });
+  if (!await exists(from)) return;
+  await mkdir2(dirname2(to), { recursive: true });
   await copyFile2(from, to);
 }
 async function childDirectoryNames(path) {
@@ -1476,8 +1155,13 @@ function compareCreatedAt(left, right) {
 function findByIdOrPrefix(records, id) {
   return records.find((record) => record.id === id) ?? records.find((record) => record.id.startsWith(id));
 }
+function isPathInside(root, candidate) {
+  const resolvedRoot = resolve3(root);
+  const resolvedCandidate = resolve3(candidate);
+  return resolvedCandidate === resolvedRoot || resolvedCandidate.startsWith(`${resolvedRoot}${sep2}`);
+}
 function createLocalStore(root = defaultLocalHome()) {
-  const resolvedRoot = resolve5(root);
+  const resolvedRoot = resolve3(root);
   const paths = localStorePaths(resolvedRoot);
   const runDir = (id) => join2(paths.runsDir, id);
   const runStatePath = (id) => join2(runDir(id), "state.json");
@@ -1490,10 +1174,10 @@ function createLocalStore(root = defaultLocalHome()) {
   const modelPath = (id) => join2(paths.modelsDir, id, "model.json");
   async function ensure() {
     await Promise.all([
-      mkdir3(paths.specsDir, { recursive: true }),
-      mkdir3(paths.runsDir, { recursive: true }),
-      mkdir3(paths.modelsDir, { recursive: true }),
-      mkdir3(paths.datasetsDir, { recursive: true })
+      mkdir2(paths.specsDir, { recursive: true }),
+      mkdir2(paths.runsDir, { recursive: true }),
+      mkdir2(paths.modelsDir, { recursive: true }),
+      mkdir2(paths.datasetsDir, { recursive: true })
     ]);
   }
   async function writeRunState(state) {
@@ -1502,11 +1186,11 @@ function createLocalStore(root = defaultLocalHome()) {
   }
   async function readSpecRecord(id) {
     const path = specPath(id);
-    if (!await exists2(path)) return null;
+    if (!await exists(path)) return null;
     const [spec, fileStats, directoryStats] = await Promise.all([
       readJson2(path),
-      stat3(path),
-      stat3(specDir(id))
+      stat2(path),
+      stat2(specDir(id))
     ]);
     const createdAt = directoryStats.birthtimeMs > 0 ? directoryStats.birthtime : directoryStats.ctime;
     return {
@@ -1532,7 +1216,7 @@ function createLocalStore(root = defaultLocalHome()) {
     const records = [];
     for (const id of await childDirectoryNames(paths.runsDir)) {
       const path = runStatePath(id);
-      if (await exists2(path)) records.push(await readJson2(path));
+      if (await exists(path)) records.push(await readJson2(path));
     }
     return records.sort(compareUpdatedAt);
   }
@@ -1541,13 +1225,13 @@ function createLocalStore(root = defaultLocalHome()) {
     const records = [];
     for (const id of await childDirectoryNames(paths.modelsDir)) {
       const path = modelPath(id);
-      if (await exists2(path)) records.push(await readJson2(path));
+      if (await exists(path)) records.push(await readJson2(path));
     }
     return records.sort(compareCreatedAt);
   }
   async function importSpecRecord(specId, spec) {
     await ensure();
-    await mkdir3(specDir(specId), { recursive: true });
+    await mkdir2(specDir(specId), { recursive: true });
     await writeJsonAtomic2(specPath(specId), spec);
     const record = await readSpecRecord(specId);
     if (!record) throw new Error(`Failed to persist spec: ${specId}`);
@@ -1555,7 +1239,7 @@ function createLocalStore(root = defaultLocalHome()) {
   }
   async function appendRunEvent(state, event) {
     const row = {
-      id: randomUUID3(),
+      id: randomUUID2(),
       run_id: state.id,
       occurred_at: (/* @__PURE__ */ new Date()).toISOString(),
       ...event
@@ -1605,7 +1289,7 @@ function createLocalStore(root = defaultLocalHome()) {
   }
   async function resolveRunId(id) {
     await ensure();
-    if (await exists2(runStatePath(id))) return id;
+    if (await exists(runStatePath(id))) return id;
     const record = findByIdOrPrefix(await listRunRecords(), id);
     if (!record) throw new Error(`Run not found: ${id}`);
     return record.id;
@@ -1617,7 +1301,7 @@ function createLocalStore(root = defaultLocalHome()) {
     if (!args.training.model_artifact_uri || args.training.metrics?.dry_run === true) return null;
     const previous = await getRun(args.request.run_id);
     const modelId = `local-${args.request.run_id}`;
-    const existingModel = await exists2(modelPath(modelId)) ? await readJson2(modelPath(modelId)) : void 0;
+    const existingModel = await exists(modelPath(modelId)) ? await readJson2(modelPath(modelId)) : void 0;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const model = {
       id: modelId,
@@ -1707,7 +1391,7 @@ function createLocalStore(root = defaultLocalHome()) {
     },
     async updateRun({ runId, status, stage, message, details }) {
       const previous = await getRun(runId);
-      if (status !== "cancelled" && await exists2(cancellationPath(previous.id))) {
+      if (status !== "cancelled" && await exists(cancellationPath(previous.id))) {
         return preserveCancellationRequestState(previous.id);
       }
       const active = status !== "stage_completed" && status !== "completed" && status !== "failed" && status !== "cancelled";
@@ -1722,7 +1406,7 @@ function createLocalStore(root = defaultLocalHome()) {
         updated_at: now
       };
       await writeRunState(state);
-      if (status !== "cancelled" && await exists2(cancellationPath(previous.id))) {
+      if (status !== "cancelled" && await exists(cancellationPath(previous.id))) {
         return preserveCancellationRequestState(previous.id);
       }
       await appendRunEvent(state, {
@@ -1734,7 +1418,7 @@ function createLocalStore(root = defaultLocalHome()) {
       return state;
     },
     async completeRun(report, artifactDir, reportPath) {
-      if (await exists2(cancellationPath(report.run_id))) {
+      if (await exists(cancellationPath(report.run_id))) {
         return preserveCancellationRequestState(report.run_id);
       }
       const request = await readJson2(runRequestPath(report.run_id));
@@ -1761,7 +1445,7 @@ function createLocalStore(root = defaultLocalHome()) {
         updated_at: completedAt
       };
       await writeRunState(state);
-      if (await exists2(cancellationPath(report.run_id))) {
+      if (await exists(cancellationPath(report.run_id))) {
         return preserveCancellationRequestState(report.run_id);
       }
       await copyIfExists(reportPath, runReportPath(report.run_id));
@@ -1793,7 +1477,7 @@ function createLocalStore(root = defaultLocalHome()) {
     async failRun(runId, error) {
       const previous = await getRun(runId);
       const now = (/* @__PURE__ */ new Date()).toISOString();
-      if (await exists2(cancellationPath(previous.id))) {
+      if (await exists(cancellationPath(previous.id))) {
         return preserveCancellationRequestState(previous.id);
       }
       const state = {
@@ -1806,7 +1490,7 @@ function createLocalStore(root = defaultLocalHome()) {
         updated_at: now
       };
       await writeRunState(state);
-      if (await exists2(cancellationPath(previous.id))) {
+      if (await exists(cancellationPath(previous.id))) {
         return preserveCancellationRequestState(previous.id);
       }
       await appendRunEvent(state, { stage: "failed", status: "failed", message: error });
@@ -1817,7 +1501,7 @@ function createLocalStore(root = defaultLocalHome()) {
       if (isTerminalRunState(state) || state.status === "cancelled" && state.current_stage === "cancel_requested") {
         return;
       }
-      await writeFile3(cancellationPath(state.id), `${(/* @__PURE__ */ new Date()).toISOString()}
+      await writeFile2(cancellationPath(state.id), `${(/* @__PURE__ */ new Date()).toISOString()}
 `, "utf8");
       const latest = await getRun(state.id);
       if (isTerminalRunState(latest)) {
@@ -1841,7 +1525,7 @@ function createLocalStore(root = defaultLocalHome()) {
     },
     async isCancellationRequested(runId) {
       const state = await getRun(runId);
-      return state.status === "cancelled" || await exists2(cancellationPath(state.id));
+      return state.status === "cancelled" || await exists(cancellationPath(state.id));
     },
     async listRuns() {
       return listRunRecords();
@@ -1853,11 +1537,19 @@ function createLocalStore(root = defaultLocalHome()) {
     },
     async getRunReport(id) {
       const state = await getRun(id);
-      if (state.report_path && await exists2(state.report_path)) {
-        return readJson2(state.report_path);
+      const candidates = [];
+      if (state.report_path) {
+        const reportPath = resolve3(state.report_path);
+        const allowedRoots = [resolvedRoot];
+        if (state.artifact_dir) allowedRoots.push(resolve3(state.artifact_dir));
+        if (allowedRoots.some((allowed) => isPathInside(allowed, reportPath))) {
+          candidates.push(reportPath);
+        }
+      }
+      candidates.push(runReportPath(state.id));
+      for (const path of candidates) {
+        if (await exists(path)) return readJson2(path);
       }
-      const copiedReportPath = runReportPath(state.id);
-      if (await exists2(copiedReportPath)) return readJson2(copiedReportPath);
       throw new Error(`Run has no report yet: ${id}`);
     },
     async listModels() {
@@ -1871,11 +1563,332 @@ function createLocalStore(root = defaultLocalHome()) {
   };
 }
 
+// src/local-runtime/local-project.ts
+import { createHash as createHash2, randomUUID as randomUUID3 } from "crypto";
+import { readFile as readFile3, stat as stat3, writeFile as writeFile3 } from "fs/promises";
+import { dirname as dirname3, isAbsolute as isAbsolute2, resolve as resolve4 } from "path";
+import { homedir as homedir2 } from "os";
+import { mkdir as mkdir3 } from "fs/promises";
+var DEFAULT_LOCAL_SPEC_PATH = "tunedtensor.json";
+function resolveLocalReference(value, baseDirectory) {
+  if (typeof value !== "string" || !value || isAbsolute2(value) || /^[a-z][a-z0-9+.-]*:/i.test(value)) {
+    return value;
+  }
+  if (value === "~") return homedir2();
+  if (value.startsWith("~/")) return resolve4(homedir2(), value.slice(2));
+  return resolve4(baseDirectory, value);
+}
+function resolveLocalRunInputPaths(raw, inputPath) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return raw;
+  const baseDirectory = dirname3(resolve4(inputPath));
+  const value = structuredClone(raw);
+  const dataset = value.dataset_prebuilt;
+  if (dataset && typeof dataset === "object" && !Array.isArray(dataset)) {
+    const fields = dataset;
+    for (const key of ["training", "validation", "test"]) {
+      if (fields[key] !== void 0) fields[key] = resolveLocalReference(fields[key], baseDirectory);
+    }
+  }
+  return value;
+}
+async function exists2(path) {
+  try {
+    await stat3(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function initLocalSpecFile(args) {
+  if (!args.force && await exists2(args.outputPath)) {
+    throw new Error(`Refusing to overwrite existing file: ${args.outputPath}`);
+  }
+  const spec = localBehaviorSpecFileSchema.parse({
+    id: randomUUID3(),
+    name: args.name,
+    description: "",
+    system_prompt: "Describe the behavior this local model should learn.",
+    guidelines: [
+      "Return concise, task-specific answers."
+    ],
+    constraints: [],
+    base_model: args.baseModel,
+    examples: [
+      {
+        input: "Replace this with representative training input.",
+        output: "Replace this with the expected training output."
+      },
+      {
+        input: "Replace this with a different validation input.",
+        output: "Replace this with the expected validation output."
+      }
+    ],
+    hyperparameters: {
+      n_epochs: 1
+    }
+  });
+  await mkdir3(dirname3(args.outputPath), { recursive: true });
+  await writeFile3(args.outputPath, `${JSON.stringify(spec, null, 2)}
+`, "utf8");
+  return spec;
+}
+async function initLocalRunnerConfigFile(args) {
+  if (!args.force && await exists2(args.outputPath)) {
+    throw new Error(`Refusing to overwrite existing file: ${args.outputPath}`);
+  }
+  const config = {
+    artifactRoot: ".tt-local/artifacts",
+    storeRoot: ".tt-local/store",
+    evaluation: {
+      inference: {
+        device: "cuda"
+      },
+      scoring: {
+        mode: "exact_match"
+      },
+      timeoutMs: 18e5
+    }
+  };
+  await mkdir3(dirname3(args.outputPath), { recursive: true });
+  await writeFile3(args.outputPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  return config;
+}
+function generatedPlaceholderIssues(request) {
+  const issues = [];
+  if (/describe the behavior this local model should learn/i.test(request.spec_snapshot.system_prompt)) {
+    issues.push("system_prompt still contains the generated placeholder");
+  }
+  request.spec_snapshot.examples.forEach((example, index) => {
+    if (/replace this with/i.test(example.input) || /replace this with/i.test(example.output)) {
+      issues.push(`examples[${index}] still contains generated placeholder text`);
+    }
+  });
+  return issues;
+}
+function assertLocalRunInputReady(request) {
+  const issues = generatedPlaceholderIssues(request);
+  if (issues.length > 0) {
+    throw new Error(`Edit the generated behavior spec before training: ${issues.join("; ")}.`);
+  }
+}
+function runRequestFromLocalSpec(spec, options = {}) {
+  const {
+    id,
+    hyperparameters,
+    dataset_prebuilt: datasetPrebuilt,
+    ...specSnapshot
+  } = spec;
+  const behaviorSpecId = id ?? deterministicBehaviorSpecId(specSnapshot);
+  return fineTuneRunRequestSchema.parse({
+    run_id: options.runId ?? randomUUID3(),
+    user_id: "local-user",
+    behavior_spec_id: behaviorSpecId,
+    run_number: 1,
+    spec_snapshot: specSnapshot,
+    hyperparameters,
+    dataset_prebuilt: datasetPrebuilt
+  });
+}
+function deterministicBehaviorSpecId(spec) {
+  const namespace = Buffer.from("9f783f01340457bea061942004259253", "hex");
+  const digest = createHash2("sha1").update(namespace).update(JSON.stringify(spec)).digest().subarray(0, 16);
+  digest[6] = digest[6] & 15 | 80;
+  digest[8] = digest[8] & 63 | 128;
+  const hex = digest.toString("hex");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20)
+  ].join("-");
+}
+async function loadLocalRunInput(path, options = {}) {
+  const raw = resolveLocalRunInputPaths(JSON.parse(await readFile3(path, "utf8")), path);
+  const request = fineTuneRunRequestSchema.safeParse(raw);
+  if (request.success) {
+    return { kind: "request", path, request: request.data };
+  }
+  const spec = localBehaviorSpecFileSchema.parse(raw);
+  return {
+    kind: "spec",
+    path,
+    spec,
+    request: runRequestFromLocalSpec(spec, options)
+  };
+}
+
+// src/local-runtime/dataset.ts
+import { readFile as readFile4 } from "fs/promises";
+async function loadNormalizedChatJsonl(path) {
+  const text = await readFile4(path, "utf8");
+  const rows = [];
+  const jsonLines = [];
+  for (const [index, line] of text.split(/\r?\n/).entries()) {
+    if (!line.trim()) continue;
+    let value;
+    try {
+      value = JSON.parse(line);
+    } catch (error) {
+      throw new Error(`Invalid chat JSONL row ${index + 1}: malformed JSON`, { cause: error });
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new Error(`Invalid chat JSONL row ${index + 1}: expected an object`);
+    }
+    const messages = value.messages;
+    if (!Array.isArray(messages) || ![2, 3].includes(messages.length) || messages.some(
+      (message) => !message || typeof message !== "object" || Array.isArray(message) || !["system", "user", "assistant"].includes(String(message.role)) || typeof message.content !== "string"
+    )) {
+      throw new Error(
+        `Invalid chat JSONL row ${index + 1}: expected an optional system message, one user message, and one assistant answer`
+      );
+    }
+    const row = { messages };
+    const offset = row.messages.length === 3 ? 1 : 0;
+    if (offset === 1 && row.messages[0]?.role !== "system" || row.messages[offset]?.role !== "user" || !row.messages[offset]?.content.trim() || row.messages[offset + 1]?.role !== "assistant" || !row.messages[offset + 1]?.content.trim()) {
+      throw new Error(
+        `Invalid chat JSONL row ${index + 1}: expected an optional system message, one non-empty user message, and one non-empty assistant answer`
+      );
+    }
+    rows.push(row);
+    jsonLines.push(JSON.stringify(row));
+  }
+  if (rows.length === 0) throw new Error(`Chat JSONL contains no examples: ${path}`);
+  return {
+    rows,
+    jsonl: jsonLines.join("\n")
+  };
+}
+async function normalizeChatJsonlForRelocation(path) {
+  return (await loadNormalizedChatJsonl(path)).jsonl;
+}
+function buildSystemMessage(spec) {
+  const parts = [];
+  if (spec.system_prompt.trim()) parts.push(spec.system_prompt.trim());
+  if (spec.guidelines.length > 0) {
+    parts.push(`Guidelines:
+${spec.guidelines.map((guideline) => `- ${guideline}`).join("\n")}`);
+  }
+  if (spec.constraints.length > 0) {
+    parts.push(`Constraints:
+${spec.constraints.map((constraint) => `- ${constraint}`).join("\n")}`);
+  }
+  return parts.join("\n\n") || "Follow the demonstrated behavior.";
+}
+function exampleToChatRow(spec, example) {
+  const system = buildSystemMessage(spec);
+  return {
+    messages: [
+      { role: "system", content: system },
+      { role: "user", content: example.input },
+      { role: "assistant", content: example.output }
+    ]
+  };
+}
+function compileSpecToJsonl(spec) {
+  return spec.examples.map((example) => JSON.stringify(exampleToChatRow(spec, example))).join("\n");
+}
+function examplesFromSpec(spec) {
+  return spec.examples;
+}
+async function examplesFromChatJsonl(path) {
+  const normalized = await loadNormalizedChatJsonl(path);
+  const examples = [];
+  for (const [index, row] of normalized.rows.entries()) {
+    const user = row.messages.at(-2);
+    const assistant = row.messages.at(-1);
+    examples.push({
+      input: user.content,
+      output: assistant.content
+    });
+  }
+  return examples;
+}
+async function evaluationSuiteFromChatJsonl(path, configuredSystem) {
+  const normalized = await loadNormalizedChatJsonl(path);
+  const inputIdentities = /* @__PURE__ */ new Set();
+  for (const row of normalized.rows) {
+    const input = row.messages.at(-2).content;
+    const identity = input.trim().replace(/\s+/g, " ").toLowerCase();
+    if (inputIdentities.has(identity)) {
+      throw new Error(
+        "General regression data contains duplicate inputs; evaluation prompts must be unique."
+      );
+    }
+    inputIdentities.add(identity);
+  }
+  const systems = new Set(
+    normalized.rows.map((row) => row.messages.find((message) => message.role === "system")?.content).filter((value) => value !== void 0)
+  );
+  if (systems.size > 1) {
+    throw new Error("General regression rows must use one consistent system message.");
+  }
+  const embeddedSystem = [...systems][0];
+  if (configuredSystem !== void 0 && embeddedSystem !== void 0 && configuredSystem !== embeddedSystem) {
+    throw new Error(
+      "evaluation.generalRegression.systemPrompt must match the system message embedded in the dataset."
+    );
+  }
+  return {
+    examples: normalized.rows.map((row) => ({
+      input: row.messages.at(-2).content,
+      output: row.messages.at(-1).content
+    })),
+    system: configuredSystem ?? embeddedSystem ?? "You are a helpful assistant."
+  };
+}
+
+// src/local-runtime/run-reporter.ts
+function reportInBackground(action) {
+  try {
+    void Promise.resolve(action()).catch(() => void 0);
+  } catch {
+  }
+}
+function sanitizeLogLine(line) {
+  return line.replace(/(Bearer\s+)[A-Za-z0-9._~+/=-]+/gi, "$1[redacted]").replace(/((?:api[_-]?key|token|secret|password)=)[^\s]+/gi, "$1[redacted]");
+}
+function forwardStreamLines(stream, onLine) {
+  let buffered = "";
+  stream.setEncoding("utf8");
+  stream.on("data", (chunk) => {
+    buffered += chunk;
+    const lines = buffered.split(/\r\n|\n|\r/);
+    buffered = lines.pop() ?? "";
+    for (const line of lines) {
+      if (line.trim()) onLine(sanitizeLogLine(line));
+    }
+  });
+  stream.on("end", () => {
+    if (buffered.trim()) onLine(sanitizeLogLine(buffered));
+  });
+}
+
+// src/local-runtime/package-root.ts
+import { existsSync } from "fs";
+import { dirname as dirname4, resolve as resolve5 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function localRuntimePackageRoot(moduleUrl) {
+  const moduleDirectory = dirname4(fileURLToPath2(moduleUrl));
+  const candidates = [
+    dirname4(moduleDirectory),
+    dirname4(dirname4(moduleDirectory))
+  ];
+  const root = candidates.find(
+    (candidate) => existsSync(resolve5(candidate, "package.json")) && existsSync(resolve5(candidate, "training/local-runner"))
+  );
+  if (!root) {
+    throw new Error("Unable to locate the bundled Tuned Tensor local runtime assets.");
+  }
+  return root;
+}
+
 // src/local-runtime/prefetch.ts
 import { createHash as createHash4 } from "crypto";
 import { createReadStream as createReadStream2 } from "fs";
 import { lstat as lstat3, mkdir as mkdir5, readFile as readFile5, readdir as readdir4, realpath as realpath2, stat as stat4 } from "fs/promises";
-import { isAbsolute as isAbsolute3, join as join5, relative as relative2, resolve as resolve8, sep as sep2 } from "path";
+import { isAbsolute as isAbsolute3, join as join5, relative as relative2, resolve as resolve8, sep as sep3 } from "path";
 
 // src/local-runtime/process-runner.ts
 import { createHash as createHash3 } from "crypto";
@@ -2221,7 +2234,7 @@ async function certifiedFileDigest(path, expected) {
 }
 function isStrictPhysicalDescendant(parent, child) {
   const candidate = relative2(parent, child);
-  return candidate !== "" && candidate !== ".." && !candidate.startsWith(`..${sep2}`) && !isAbsolute3(candidate);
+  return candidate !== "" && candidate !== ".." && !candidate.startsWith(`..${sep3}`) && !isAbsolute3(candidate);
 }
 async function verifySnapshotCacheLocation(path, modelId, revision, modelCache) {
   const repository = `models--${modelId.replaceAll("/", "--")}`;
@@ -4753,6 +4766,10 @@ export {
   trainingReportSchema,
   runReportSchema,
   localRunnerConfigSchema,
+  isTerminalRunState,
+  defaultLocalHome,
+  localStorePaths,
+  createLocalStore,
   DEFAULT_LOCAL_SPEC_PATH,
   resolveLocalRunInputPaths,
   initLocalSpecFile,
@@ -4774,10 +4791,6 @@ export {
   localRuntimePackageRoot,
   buildBundledPythonCommand,
   withBundledPythonEnvironment,
-  isTerminalRunState,
-  defaultLocalHome,
-  localStorePaths,
-  createLocalStore,
   minimalMachineLearningEnvironment,
   withHuggingFaceCacheEnvironment,
   withOfflineHuggingFaceCacheEnvironment,
@@ -4797,4 +4810,4 @@ export {
   runLocalPipeline,
   runLocalFineTune
 };
-//# sourceMappingURL=chunk-HDGBDHOB.js.map
+//# sourceMappingURL=chunk-2VJ3VVZF.js.map