@tuned-tensor/cli 0.9.0 → 0.9.2

package/dist/index.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  assertLocalRunInputReady,
+  loadLocalRunInput,
+  loadLocalRunnerConfig,
+  runLocalPipeline
+} from "./chunk-DAP2Z7EZ.js";
 
 // src/cli.ts
 import { spawn as spawn4 } from "child_process";
@@ -120,7 +126,8 @@ import {
   getAgentDir,
   ModelRuntime
 } from "@earendil-works/pi-coding-agent";
-import { join } from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
 function resolveAgentModel(runtime, selection) {
   const resolved = resolveAgentModelDefinition(runtime, selection);
   if (!runtime.hasConfiguredAuth(selection.provider)) {
@@ -154,12 +161,41 @@ function resolveAgentModelDefinition(runtime, selection) {
 }
 async function createPiModelRuntime() {
   const agentDir = getAgentDir();
+  const modelsPath = join(agentDir, "models.json");
+  ensureOpenRouterAppHeaders(modelsPath);
   return await ModelRuntime.create({
     authPath: join(agentDir, "auth.json"),
-    modelsPath: join(agentDir, "models.json"),
+    modelsPath,
     allowModelNetwork: false
   });
 }
+var OPENROUTER_APP_HEADERS = {
+  "HTTP-Referer": "https://tunedtensor.com",
+  "X-Title": "Tuned Tensor"
+};
+function ensureOpenRouterAppHeaders(modelsPath) {
+  let config = {};
+  if (existsSync(modelsPath)) {
+    try {
+      const parsed = JSON.parse(readFileSync(modelsPath, "utf-8"));
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        config = parsed;
+      }
+    } catch {
+      return;
+    }
+  }
+  const before = JSON.stringify(config);
+  const asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+  const empty = () => ({});
+  const providers = asRecord(config.providers) ?? (config.providers = empty());
+  const openrouter = asRecord(providers.openrouter) ?? (providers.openrouter = empty());
+  const headers = asRecord(openrouter.headers) ?? (openrouter.headers = empty());
+  Object.assign(headers, OPENROUTER_APP_HEADERS);
+  if (JSON.stringify(config) === before) return;
+  mkdirSync(dirname(modelsPath), { recursive: true });
+  writeFileSync(modelsPath, JSON.stringify(config, null, 2) + "\n");
+}
 
 // src/agent-tools.ts
 import { randomUUID } from "crypto";
@@ -235,6 +271,77 @@ function canonicalizeSpecBaseModel(body) {
   return body;
 }
 
+// src/pipeline.ts
+import {
+  canonicalPipeline as canonicalPortablePipeline,
+  parsePipeline,
+  pipelineDocumentSchema
+} from "@tuned-tensor/pipeline-contract";
+import {
+  PIPELINE_DOCUMENT_VERSION,
+  PIPELINE_EVALUATORS,
+  PIPELINE_MAX_STEPS,
+  PIPELINE_MAX_TRAIN_STEPS,
+  PIPELINE_STEP_CAPABILITIES,
+  PIPELINE_STEP_USES,
+  PIPELINE_TARGETS,
+  canonicalJson,
+  parsePipeline as parsePipeline2,
+  pipelineDocumentSchema as pipelineDocumentSchema2,
+  pipelineHash
+} from "@tuned-tensor/pipeline-contract";
+function stepReferences(step) {
+  if (step.uses === "evaluate") return step.with.model === "base" ? [] : [step.with.model];
+  if (step.uses === "compare") return [step.with.before, step.with.after];
+  return [];
+}
+function producerId(reference) {
+  return reference.from.slice(0, reference.from.lastIndexOf("."));
+}
+function validatePipeline(pipeline2) {
+  const structural = pipelineDocumentSchema.safeParse(pipeline2);
+  if (!structural.success) {
+    return structural.error.issues.map((issue) => {
+      const path = issue.path.map(String).join(".");
+      return path ? `${path}: ${issue.message}` : issue.message;
+    });
+  }
+  try {
+    parsePipeline(pipeline2);
+    return [];
+  } catch (error) {
+    return [error instanceof Error ? error.message : String(error)];
+  }
+}
+function canonicalPipeline(target = "local") {
+  return canonicalPortablePipeline(target);
+}
+function createExecutionPlan(pipeline2, selection = {}) {
+  const errors = validatePipeline(pipeline2);
+  if (errors.length) throw new Error(`Invalid pipeline:
+- ${errors.join("\n- ")}`);
+  const normalized = parsePipeline(pipeline2);
+  const allIds = new Set(normalized.steps.map((step) => step.id));
+  for (const id of [...selection.only ?? [], ...selection.skip ?? []]) {
+    if (!allIds.has(id)) throw new Error(`Unknown pipeline step: ${id}.`);
+  }
+  const only = selection.only?.length ? new Set(selection.only) : void 0;
+  const skip = new Set(selection.skip ?? []);
+  const steps = normalized.steps.filter((step) => (!only || only.has(step.id)) && !skip.has(step.id));
+  if (!steps.length) throw new Error("Selection leaves no pipeline steps to run.");
+  const retained = new Map(steps.map((step) => [step.id, step]));
+  const resolved = steps.map((step) => {
+    const transfers = [];
+    for (const reference of stepReferences(step)) {
+      const producer = retained.get(producerId(reference));
+      if (!producer) throw new Error(`Step ${step.id} has a dependency on ${producerId(reference)}, which was omitted by --only or --skip.`);
+      if (producer.target !== step.target) transfers.push({ from: reference.from, from_target: producer.target, to_target: step.target });
+    }
+    return { ...step, transfers };
+  });
+  return { version: 1, ...normalized.name ? { name: normalized.name } : {}, steps: resolved };
+}
+
 // src/agent-tools.ts
 var MAX_TOOL_OUTPUT = 32e3;
 var MAX_PREPARED_ACTION = 24e3;
@@ -283,6 +390,17 @@ var RunBody = Type.Object({
 var BaseModel = Type.Union(
   SUPPORTED_BASE_MODELS.map((model) => Type.Literal(model))
 );
+var PipelineDocument = Type.Object({
+  version: Type.Literal(1),
+  name: Type.Optional(Type.String({ minLength: 1, maxLength: 120 })),
+  target: Type.Optional(Type.Union([Type.Literal("local"), Type.Literal("cloud")])),
+  steps: Type.Array(Type.Object({
+    id: Type.String({ minLength: 1, maxLength: 64, pattern: "^[a-z][a-z0-9_-]*$" }),
+    uses: Type.Union([Type.Literal("train"), Type.Literal("evaluate"), Type.Literal("compare")]),
+    target: Type.Optional(Type.Union([Type.Literal("local"), Type.Literal("cloud")])),
+    with: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
+  }, { additionalProperties: false }), { minItems: 1, maxItems: 16 })
+}, { additionalProperties: false });
 var Example = Type.Object({
   input: Type.String({ minLength: 1, maxLength: 1e5 }),
   output: Type.String({ minLength: 1, maxLength: 1e5 })
@@ -460,7 +578,18 @@ function createTunedTensorTools(api) {
     }, { additionalProperties: false }), async (p) => await api.get("/billing/transactions", {
       page: p.page ?? 1,
       per_page: p.per_page ?? 10
-    }))
+    })),
+    define("describe_pipeline", "Describe pipeline", "Describe the built-in v1 pipeline contract and canonical recipe. This never executes anything.", Type.Object({
+      target: Type.Optional(Type.Union([Type.Literal("local"), Type.Literal("cloud")]))
+    }, { additionalProperties: false }), async (p) => ({
+      version: 1,
+      components: ["train", "evaluate", "compare"],
+      canonical: canonicalPipeline(p.target ?? "local")
+    })),
+    define("validate_pipeline", "Validate pipeline", "Validate an ordered pipeline and resolve targets/transfers without filesystem, network, or execution side effects.", Type.Object({ pipeline: PipelineDocument }, { additionalProperties: false }), async (p) => {
+      const errors = validatePipeline(p.pipeline);
+      return { valid: errors.length === 0, errors, ...errors.length ? {} : { plan: createExecutionPlan(p.pipeline) } };
+    })
   ];
   const mutations = [
     define("prepare_create_spec", "Prepare create spec", "Prepare creating a spec. This never mutates; /approve is required.", Type.Object({
@@ -480,6 +609,19 @@ function createTunedTensorTools(api) {
         changes: p.changes,
         expected_spec_updated_at: current.updated_at
       }));
+    }),
+    define("prepare_pipeline_run", "Prepare pipeline run", "Prepare a pipeline action for review only. It never executes a step, transfers an artifact, or reserves credits.", Type.Object({
+      pipeline: PipelineDocument,
+      dry_run: Type.Optional(Type.Boolean())
+    }, { additionalProperties: false }), async (p) => {
+      const errors = validatePipeline(p.pipeline);
+      if (errors.length) throw new Error(`Invalid pipeline:
+- ${errors.join("\n- ")}`);
+      const plan = createExecutionPlan(p.pipeline);
+      return await api.propose(proposal("run_pipeline", "Run pipeline", "Review the resolved pipeline before any separate execution approval flow.", {
+        pipeline: p.pipeline,
+        dry_run: p.dry_run ?? true
+      }, { plan, execution: "not started" }));
     })
   ];
   return [...reads, ...mutations];
@@ -876,16 +1018,16 @@ var LocalAgentStore = class {
 };
 
 // src/client.ts
-import { readFileSync as readFileSync2, statSync } from "fs";
+import { readFileSync as readFileSync3, statSync } from "fs";
 import { basename } from "path";
 
 // src/config.ts
 import {
   chmodSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  writeFileSync
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  writeFileSync as writeFileSync2
 } from "fs";
 import { homedir } from "os";
 import { join as join3 } from "path";
@@ -910,19 +1052,19 @@ function getConfigPath() {
 }
 function readConfig() {
   const path = getConfigPath();
-  if (!existsSync(path)) return {};
+  if (!existsSync2(path)) return {};
   try {
-    return JSON.parse(readFileSync(path, "utf-8"));
+    return JSON.parse(readFileSync2(path, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeConfig(config) {
   const dir = getConfigDir();
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true, mode: 448 });
+  if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true, mode: 448 });
   chmodSync(dir, 448);
   const path = getConfigPath();
-  writeFileSync(path, JSON.stringify(config, null, 2) + "\n", {
+  writeFileSync2(path, JSON.stringify(config, null, 2) + "\n", {
     mode: 384
   });
   chmodSync(path, 384);
@@ -933,7 +1075,7 @@ function updateConfig(partial) {
 }
 function clearConfig() {
   const path = getConfigPath();
-  if (existsSync(path)) writeConfig({});
+  if (existsSync2(path)) writeConfig({});
 }
 var DEFAULT_BASE_URL = "https://tunedtensor.com";
 function getBaseUrl(opts) {
@@ -963,10 +1105,10 @@ function getAgentSelection(env = process.env) {
 
 // src/client.ts
 var ApiError = class extends Error {
-  constructor(status2, code, message) {
+  constructor(status2, code2, message) {
     super(message);
     this.status = status2;
-    this.code = code;
+    this.code = code2;
     this.name = "ApiError";
   }
 };
@@ -1194,7 +1336,7 @@ function createCommandCompleter(getMode) {
 // src/shell-context.ts
 import { readFile as readFile2, readdir as readdir2, stat as stat2 } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { basename as basename2, dirname, isAbsolute, join as join4, resolve } from "path";
+import { basename as basename2, dirname as dirname2, isAbsolute, join as join4, resolve } from "path";
 async function readJsonObject(path) {
   try {
     const parsed = JSON.parse(await readFile2(path, "utf8"));
@@ -1312,7 +1454,7 @@ async function discoverShellContext(options = {}) {
   if (localConfigJson.invalid) {
     warnings.push("local-runner.json could not be parsed.");
   }
-  const localConfigDirectory = hasAdjacentLocalConfig ? dirname(localConfigPath) : cwd;
+  const localConfigDirectory = hasAdjacentLocalConfig ? dirname2(localConfigPath) : cwd;
   const configuredArtifactRoot = stringField(localConfigJson.value, "artifactRoot");
   const configuredStoreRoot = stringField(localConfigJson.value, "storeRoot");
   const artifactRoot = configuredArtifactRoot ? expandPath(configuredArtifactRoot, localConfigDirectory, homeDirectory) : resolve(cwd, ".tt-local", "artifacts");
@@ -1742,9 +1884,9 @@ function renderShellBanner(snapshot) {
   const heading = snapshot.version ? `${accent.bold("tt")} ${chalk.dim(`v${snapshot.version}`)}` : accent.bold("tt");
   const lines = [
     heading,
-    chalk.dim(
-      `${snapshot.mode} \xB7 ${snapshot.context.projectName} \xB7 ${spec} \xB7 model ${activeModelLabel(snapshot)}`
-    ),
+    `${accent(snapshot.mode)}${chalk.dim(
+      ` \xB7 ${snapshot.context.projectName} \xB7 ${spec} \xB7 model ${activeModelLabel(snapshot)}`
+    )}`,
     chalk.dim("ctrl+c stop/clear \xB7 ctrl+d exit \xB7 /help commands \xB7 tab complete"),
     "",
     chalk.dim("Ask TT anything. Known commands run directly.")
@@ -2101,6 +2243,7 @@ function shouldStartInteractiveShell(options) {
 import chalk2 from "chalk";
 import { stripVTControlCharacters as stripVTControlCharacters2 } from "util";
 var accent2 = chalk2.hex("#8B5CF6");
+var code = chalk2.hex("#A78BFA");
 function sanitizeTerminalText(text2) {
   return stripVTControlCharacters2(text2).replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g, "");
 }
@@ -2138,7 +2281,7 @@ function renderInlineMarkdown(text2) {
     if (text2[index] === "`") {
       const close = closingDelimiter(text2, "`", index);
       if (close > index + 1) {
-        rendered += chalk2.cyan(text2.slice(index + 1, close));
+        rendered += code(text2.slice(index + 1, close));
         index = close + 1;
         continue;
       }
@@ -2160,7 +2303,7 @@ function renderInlineMarkdown(text2) {
   return rendered;
 }
 function renderMarkdownLine(line, inCodeBlock) {
-  if (inCodeBlock) return chalk2.cyan(`  ${line}`);
+  if (inCodeBlock) return code(`  ${line}`);
   const heading = line.match(/^\s{0,3}#{1,6}\s+(.+)$/);
   if (heading) return chalk2.bold(renderInlineMarkdown(heading[1]));
   const bullet = line.match(/^(\s*)[-+*]\s+(.+)$/);
@@ -2646,8 +2789,9 @@ ${chalk3.yellow.bold("Approval required")}  ${chalk3.dim(action.id.slice(0, 8))}
 // src/local-runner.ts
 import { constants as osConstants } from "os";
 import { randomUUID as randomUUID4 } from "crypto";
-import { createRequire } from "module";
 import { spawn } from "child_process";
+import { existsSync as existsSync3 } from "fs";
+import { fileURLToPath } from "url";
 import {
   readFile as readFile3,
   rm,
@@ -2656,7 +2800,7 @@ import {
 } from "fs/promises";
 import {
   basename as basename3,
-  dirname as dirname2,
+  dirname as dirname3,
   isAbsolute as isAbsolute3,
   join as join5,
   resolve as resolve3
@@ -2728,6 +2872,7 @@ function unknownProjectSpecKeys(raw) {
 // src/output.ts
 import chalk4 from "chalk";
 import Table from "cli-table3";
+var labelStyle = chalk4.bold.hex("#A78BFA");
 var jsonMode = false;
 function setJsonMode(enabled) {
   jsonMode = enabled;
@@ -2740,7 +2885,7 @@ function printJson(data3) {
 }
 function printTable(headers, rows2, meta) {
   const table = new Table({
-    head: headers.map((h) => chalk4.bold.cyan(h)),
+    head: headers.map((h) => labelStyle(h)),
     style: { head: [], border: [] }
   });
   for (const row of rows2) {
@@ -2761,7 +2906,7 @@ function printDetail(fields) {
   const maxLabel = Math.max(...fields.map(([l]) => l.length));
   for (const [label, value] of fields) {
     const paddedLabel = label.padEnd(maxLabel);
-    console.log(`${chalk4.bold.cyan(paddedLabel)}  ${value ?? chalk4.dim("\u2014")}`);
+    console.log(`${labelStyle(paddedLabel)}  ${value ?? chalk4.dim("\u2014")}`);
   }
 }
 function printSuccess(message) {
@@ -2797,9 +2942,9 @@ function formatDate(iso) {
 function formatStatus(status2) {
   const map = {
     completed: chalk4.green,
-    running: chalk4.blue,
-    training: chalk4.blue,
-    evaluating: chalk4.blue,
+    running: chalk4.hex("#A78BFA"),
+    training: chalk4.hex("#A78BFA"),
+    evaluating: chalk4.hex("#A78BFA"),
     preparing: chalk4.yellow,
     pending: chalk4.yellow,
     uploading: chalk4.yellow,
@@ -3274,7 +3419,6 @@ function renderLocalOutput(payload, options = {}) {
 }
 
 // src/local-runner.ts
-var localRequire = createRequire(import.meta.url);
 var DEFAULT_SPEC_NAME = "tunedtensor.json";
 var VALUE_OPTIONS = /* @__PURE__ */ new Set([
   "--config",
@@ -3439,7 +3583,7 @@ async function projectSpecArguments(originalArgs, cwd) {
     };
   }
   const temporaryPath = join5(
-    dirname2(sourcePath),
+    dirname3(sourcePath),
     `.${basename3(sourcePath)}.tt-local-${process.pid}-${randomUUID4()}.json`
   );
   await writeFile2(
@@ -3460,14 +3604,13 @@ async function projectSpecArguments(originalArgs, cwd) {
   };
 }
 function resolveLocalCliEntrypoint() {
-  try {
-    return localRequire.resolve("@tuned-tensor/local");
-  } catch (error) {
+  const entrypoint = fileURLToPath(new URL("./local-runtime.js", import.meta.url));
+  if (!existsSync3(entrypoint)) {
     throw new Error(
-      "TT Local is not installed. Reinstall @tuned-tensor/cli with its local runtime dependency.",
-      { cause: error }
+      "The bundled local runtime is missing. Rebuild or reinstall @tuned-tensor/cli."
     );
   }
+  return entrypoint;
 }
 function localCommandStreamsStdout(args2) {
   const serves = args2[0] === "serve" || args2[0] === "models" && args2[1] === "serve";
@@ -3572,10 +3715,10 @@ async function spawnLocalCli(args2) {
     child.once("error", (error) => {
       spawnError = error;
     });
-    child.once("close", (code, signal) => {
+    child.once("close", (code2, signal) => {
       cleanup();
       resolveChild({
-        exitCode: spawnError ? 1 : code ?? signalExitCode(signal),
+        exitCode: spawnError ? 1 : code2 ?? signalExitCode(signal),
         signal,
         stdout: stdout2,
         stderr,
@@ -3695,7 +3838,7 @@ function registerAuthCommands(parent) {
       console.log(
         `  To get your API key, go to ${chalk5.bold("Settings \u2192 API Keys")} in the Tuned Tensor dashboard:`
       );
-      console.log(`  ${chalk5.cyan.underline(settingsUrl)}`);
+      console.log(`  ${chalk5.hex("#A78BFA").underline(settingsUrl)}`);
       console.log();
       apiKey = await promptForApiKey();
     }
@@ -3754,7 +3897,7 @@ function registerAuthCommands(parent) {
 }
 
 // src/commands/specs.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 
 // src/resolve.ts
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -3858,7 +4001,7 @@ var SpecBodyError = class extends Error {
 function loadSpecBody(filePath, mode) {
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync3(filePath, "utf-8"));
+    parsed = JSON.parse(readFileSync4(filePath, "utf-8"));
   } catch (e) {
     throw new SpecBodyError(
       `Could not parse ${filePath}: ${e.message}`
@@ -4527,7 +4670,7 @@ Eval Results (${data3._evals.length}):`);
 }
 
 // src/commands/datasets.ts
-import { existsSync as existsSync2, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
 var DOCUMENT_OCR_MIME_TYPES = /* @__PURE__ */ new Set(["image/png", "image/jpeg", "image/webp"]);
 function formatBytes(bytes) {
   if (bytes < 1024) return `${bytes} B`;
@@ -4563,24 +4706,24 @@ var FORBIDDEN_CONTROL_CODEPOINTS = [
 ];
 function findControlChar(value) {
   for (let i = 0; i < value.length; i++) {
-    const code = value.charCodeAt(i);
-    if (code < 32 && code !== 9 && code !== 10 && code !== 13) {
-      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code);
-      return { codepoint: code, offset: i, name: named?.name ?? "CONTROL CHARACTER" };
+    const code2 = value.charCodeAt(i);
+    if (code2 < 32 && code2 !== 9 && code2 !== 10 && code2 !== 13) {
+      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code2);
+      return { codepoint: code2, offset: i, name: named?.name ?? "CONTROL CHARACTER" };
     }
-    if (code >= 128 && code <= 159) {
-      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code);
-      return { codepoint: code, offset: i, name: named?.name ?? "C1 CONTROL CHARACTER" };
+    if (code2 >= 128 && code2 <= 159) {
+      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code2);
+      return { codepoint: code2, offset: i, name: named?.name ?? "C1 CONTROL CHARACTER" };
     }
-    if (code === 8232 || code === 8233) {
-      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code);
-      return { codepoint: code, offset: i, name: named?.name ?? "LINE BREAK" };
+    if (code2 === 8232 || code2 === 8233) {
+      const named = FORBIDDEN_CONTROL_CODEPOINTS.find((entry) => entry.code === code2);
+      return { codepoint: code2, offset: i, name: named?.name ?? "LINE BREAK" };
     }
   }
   return null;
 }
-function formatCodepoint(code) {
-  return `U+${code.toString(16).toUpperCase().padStart(4, "0")}`;
+function formatCodepoint(code2) {
+  return `U+${code2.toString(16).toUpperCase().padStart(4, "0")}`;
 }
 function detectRowFormat(record4) {
   const input = record4.input;
@@ -4657,7 +4800,7 @@ function parseDatasetFormat(value) {
   throw new Error("--format must be one of: jsonl, document_ocr_jsonl");
 }
 function validateDatasetFile(file, requestedFormat) {
-  const lines = readFileSync4(file, "utf8").split(/\r?\n/);
+  const lines = readFileSync5(file, "utf8").split(/\r?\n/);
   const errors = [];
   let rowCount = 0;
   let detectedFormat = null;
@@ -4783,13 +4926,13 @@ function registerDatasetsCommands(parent) {
   });
   datasets.command("upload").description("Upload a JSONL dataset file").argument("<file>", "Path to JSONL file").option("-n, --name <name>", "Dataset name (defaults to filename)").option("-d, --description <desc>", "Dataset description").option("--format <format>", "Dataset format: jsonl or document_ocr_jsonl").action(async (file, cmdOpts) => {
     const opts = parent.opts();
-    if (!existsSync2(file)) {
+    if (!existsSync4(file)) {
       printError(`File not found: ${file}`);
       process.exit(1);
     }
     const format = validateDatasetFile(file, parseDatasetFormat(cmdOpts.format));
     const name = cmdOpts.name || file.split("/").pop().replace(/\.jsonl?$/, "");
-    const fileBytes = readFileSync4(file);
+    const fileBytes = readFileSync5(file);
     const uploadUrl = await post(
       "/datasets/upload-url",
       {
@@ -4834,12 +4977,12 @@ function registerDatasetsCommands(parent) {
 }
 
 // src/commands/label.ts
-import { existsSync as existsSync3, readFileSync as readFileSync5, statSync as statSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync6, statSync as statSync3 } from "fs";
 function formatCents2(cents) {
   return `$${(cents / 100).toFixed(2)}`;
 }
 function sleep(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 function parseCsvHeader(line) {
   const fields = [];
@@ -4878,7 +5021,7 @@ function validateUnlabeledFile(file, inputColumn) {
         "CSV uploads need --input-column <name> to say which column holds the input text."
       );
     }
-    const firstLine = readFileSync5(file, "utf8").split(/\r?\n/, 1)[0] ?? "";
+    const firstLine = readFileSync6(file, "utf8").split(/\r?\n/, 1)[0] ?? "";
     const columns = parseCsvHeader(firstLine);
     if (!columns.includes(inputColumn)) {
       throw new Error(
@@ -4890,7 +5033,7 @@ function validateUnlabeledFile(file, inputColumn) {
   if (!lower.endsWith(".jsonl") && !lower.endsWith(".json")) {
     throw new Error("Labeling source file must be .jsonl or .csv");
   }
-  const lines = readFileSync5(file, "utf8").split(/\r?\n/);
+  const lines = readFileSync6(file, "utf8").split(/\r?\n/);
   const errors = [];
   let rowCount = 0;
   for (const [index, rawLine] of lines.entries()) {
@@ -5006,14 +5149,14 @@ function registerLabelCommands(parent) {
   const label = parent.command("label").description("Teacher-label real data into training datasets");
   label.command("upload").description("Upload unlabeled inputs (.jsonl or .csv) and start a labeling job").argument("<file>", 'Path to JSONL ({"input": ...} per line) or CSV file').requiredOption("-s, --spec <id>", "Behaviour spec the teacher labels under").option("-c, --input-column <name>", "CSV column that holds the input text").option("-n, --name <name>", "Job name (defaults to filename)").option("--watch", "Block and show progress until labeling finishes").action(async (file, cmdOpts) => {
     const opts = parent.opts();
-    if (!existsSync3(file)) {
+    if (!existsSync5(file)) {
       printError(`File not found: ${file}`);
       process.exit(1);
     }
     const { format } = validateUnlabeledFile(file, cmdOpts.inputColumn);
     const specId = await resolveSpecId(cmdOpts.spec, opts);
     const name = cmdOpts.name || file.split("/").pop().replace(/\.(jsonl|json|csv)$/, "");
-    const fileBytes = readFileSync5(file);
+    const fileBytes = readFileSync6(file);
     const contentType = format === "csv" ? "text/csv" : "application/jsonl";
     const { data: uploadUrl } = await post(
       "/labeling-jobs/upload-url",
@@ -5186,7 +5329,7 @@ function registerLabelCommands(parent) {
       printError("Provide --output <text> or --file <path>.");
       process.exit(1);
     }
-    const output = cmdOpts.output ?? readFileSync5(cmdOpts.file, "utf8");
+    const output = cmdOpts.output ?? readFileSync6(cmdOpts.file, "utf8");
     const jobId = await resolveLabelingJobId(id, opts);
     const indexes = parseIndexList(cmdOpts.row);
     const rowIds = await resolveRowIds(jobId, indexes, opts);
@@ -5235,23 +5378,23 @@ function registerLabelCommands(parent) {
 import { spawn as spawn3, execFileSync } from "child_process";
 import { createHash } from "crypto";
 import {
-  existsSync as existsSync5,
-  mkdirSync as mkdirSync3,
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync4,
   statSync as statSync4,
   createWriteStream,
   unlinkSync,
-  readFileSync as readFileSync7,
-  writeFileSync as writeFileSync3,
+  readFileSync as readFileSync8,
+  writeFileSync as writeFileSync4,
   readdirSync,
   rmSync
 } from "fs";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname4, join as join6, resolve as resolve5, basename as basename4, normalize, isAbsolute as isAbsolute4 } from "path";
+import { dirname as dirname5, join as join6, resolve as resolve5, basename as basename4, normalize, isAbsolute as isAbsolute4 } from "path";
 import { Readable, Transform } from "stream";
 import { pipeline } from "stream/promises";
 
 // src/commands/init.ts
-import { existsSync as existsSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync3 } from "fs";
 import { resolve as resolve4 } from "path";
 var DEFAULT_SPEC_FILE = "tunedtensor.json";
 var SCAFFOLD = {
@@ -5272,7 +5415,7 @@ var SCAFFOLD = {
 function registerInitCommand(parent) {
   parent.command("init").description("Create a behaviour spec project file").option("-n, --name <name>", "Spec name").option("--model <model>", "Base model ID").option("-f, --file <path>", "Output file path", DEFAULT_SPEC_FILE).action(async (cmdOpts) => {
     const filePath = resolve4(cmdOpts.file);
-    if (existsSync4(filePath)) {
+    if (existsSync6(filePath)) {
       if (isJsonMode()) {
         printJson({ created: false, path: filePath });
         return;
@@ -5286,7 +5429,7 @@ function registerInitCommand(parent) {
     };
     if (cmdOpts.name) spec.name = cmdOpts.name;
     if (cmdOpts.model) spec.base_model = canonicalizeBaseModel(cmdOpts.model);
-    writeFileSync2(filePath, JSON.stringify(spec, null, 2) + "\n");
+    writeFileSync3(filePath, JSON.stringify(spec, null, 2) + "\n");
     if (isJsonMode()) {
       printJson({ created: true, path: filePath, spec });
       return;
@@ -5301,36 +5444,36 @@ function registerInitCommand(parent) {
 }
 function loadSpec(filePath) {
   const resolved = resolve4(filePath || DEFAULT_SPEC_FILE);
-  if (!existsSync4(resolved)) {
+  if (!existsSync6(resolved)) {
     printError(
       `Spec file not found: ${filePath || DEFAULT_SPEC_FILE}
 Run \`tt init\` to create one.`
     );
     process.exit(1);
   }
-  const raw = JSON.parse(readFileSync6(resolved, "utf-8"));
+  const raw = JSON.parse(readFileSync7(resolved, "utf-8"));
   return raw;
 }
 
 // src/serve-manager.ts
 import { spawn as spawn2 } from "child_process";
 import { randomUUID as randomUUID5 } from "crypto";
-import { appendFileSync, mkdirSync as mkdirSync2 } from "fs";
+import { appendFileSync, mkdirSync as mkdirSync3 } from "fs";
 import { createServer } from "http";
 import { createServer as createNetServer } from "net";
-import { dirname as dirname3 } from "path";
+import { dirname as dirname4 } from "path";
 var COMPLETION_ROUTES = /* @__PURE__ */ new Set(["/v1/chat/completions", "/chat/completions"]);
 function parsePositiveInteger(value, fallback) {
   return Number.isInteger(value) && value >= 0 ? value : fallback;
 }
 function sleep2(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 function readRequestBody(req) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     const chunks = [];
     req.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
-    req.on("end", () => resolve7(Buffer.concat(chunks)));
+    req.on("end", () => resolve8(Buffer.concat(chunks)));
     req.on("error", reject);
   });
 }
@@ -5398,7 +5541,7 @@ function errorSummary(response, fallback) {
   return typeof message === "string" ? message : fallback;
 }
 async function allocatePort(host) {
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     const server = createNetServer();
     server.on("error", reject);
     server.listen(0, host, () => {
@@ -5408,7 +5551,7 @@ async function allocatePort(host) {
         return;
       }
       const port = address.port;
-      server.close(() => resolve7(port));
+      server.close(() => resolve8(port));
     });
   });
 }
@@ -5448,11 +5591,11 @@ var ManagedModelServer = class {
         sendJson(res, 500, { error: { message: err instanceof Error ? err.message : String(err) } });
       });
     });
-    await new Promise((resolve7, reject) => {
+    await new Promise((resolve8, reject) => {
       this.server?.once("error", reject);
       this.server?.listen(this.options.publicPort, this.options.publicHost, () => {
         this.server?.off("error", reject);
-        resolve7();
+        resolve8();
       });
     });
   }
@@ -5462,15 +5605,15 @@ var ManagedModelServer = class {
     if (!this.server) return;
     const server = this.server;
     this.server = null;
-    await new Promise((resolve7, reject) => {
-      server.close((err) => err ? reject(err) : resolve7());
+    await new Promise((resolve8, reject) => {
+      server.close((err) => err ? reject(err) : resolve8());
     });
   }
   async run() {
     await this.start();
-    await new Promise((resolve7, reject) => {
+    await new Promise((resolve8, reject) => {
       this.server?.once("error", reject);
-      this.server?.once("close", resolve7);
+      this.server?.once("close", resolve8);
     });
   }
   async handle(req, res) {
@@ -5644,7 +5787,7 @@ var ManagedModelServer = class {
     try {
       child.kill("SIGTERM");
       await Promise.race([
-        new Promise((resolve7) => child.once("exit", () => resolve7())),
+        new Promise((resolve8) => child.once("exit", () => resolve8())),
         sleep2(5e3).then(() => {
           if (child.exitCode == null && child.signalCode == null) child.kill("SIGKILL");
         })
@@ -5722,7 +5865,7 @@ var ManagedModelServer = class {
     const line = `${JSON.stringify(record4)}
 `;
     if (this.options.logFile) {
-      mkdirSync2(dirname3(this.options.logFile), { recursive: true });
+      mkdirSync3(dirname4(this.options.logFile), { recursive: true });
       appendFileSync(this.options.logFile, line, "utf8");
       return;
     }
@@ -6269,7 +6412,7 @@ if __name__ == "__main__":
 `;
 function resolveOutputPath(output, filename) {
   if (!output) return filename;
-  if (existsSync5(output) && statSync4(output).isDirectory()) {
+  if (existsSync7(output) && statSync4(output).isDirectory()) {
     return join6(output, filename);
   }
   return output;
@@ -6346,7 +6489,7 @@ async function downloadUrlToFile(url, outputPath) {
   if (!res.body) {
     throw new Error("Download failed: response body was empty");
   }
-  mkdirSync3(dirname4(outputPath), { recursive: true });
+  mkdirSync4(dirname5(outputPath), { recursive: true });
   const file = createWriteStream(outputPath);
   const contentLength = parseContentLength(res.headers.get("content-length"));
   const progress = createDownloadProgress(
@@ -6390,7 +6533,7 @@ function runtimePythonPath(cacheDir) {
 function resolveServePython(cacheDir, explicitPython) {
   if (explicitPython) return explicitPython;
   const managedPython = runtimePythonPath(cacheDir);
-  return existsSync5(managedPython) ? managedPython : "python3";
+  return existsSync7(managedPython) ? managedPython : "python3";
 }
 function commandExists(command) {
   try {
@@ -6469,7 +6612,7 @@ function safeSegment(value) {
   return value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "model";
 }
 function directoryHasFiles(path) {
-  return existsSync5(path) && statSync4(path).isDirectory() && readdirSync(path).length > 0;
+  return existsSync7(path) && statSync4(path).isDirectory() && readdirSync(path).length > 0;
 }
 function validateArchiveEntryPath(entry) {
   const normalized = normalize(entry).replace(/^[\\/]+/, "");
@@ -6490,8 +6633,8 @@ function validateArchiveEntries(archivePath) {
 function extractArchive(archivePath, targetDir, force) {
   if (directoryHasFiles(targetDir) && !force) return targetDir;
   validateArchiveEntries(archivePath);
-  if (existsSync5(targetDir)) rmSync(targetDir, { recursive: true, force: true });
-  mkdirSync3(targetDir, { recursive: true });
+  if (existsSync7(targetDir)) rmSync(targetDir, { recursive: true, force: true });
+  mkdirSync4(targetDir, { recursive: true });
   execFileSync("tar", ["-xzf", archivePath, "-C", targetDir], { stdio: "inherit" });
   return targetDir;
 }
@@ -6517,21 +6660,21 @@ function findSpecPath(explicitPath, modelPath) {
   const candidates = explicitPath ? [explicitPath] : [join6(process.cwd(), DEFAULT_SPEC_FILE), join6(modelPath, DEFAULT_SPEC_FILE)];
   for (const candidate of candidates) {
     const resolved = resolve5(candidate);
-    if (existsSync5(resolved) && statSync4(resolved).isFile()) return resolved;
+    if (existsSync7(resolved) && statSync4(resolved).isFile()) return resolved;
   }
   return null;
 }
 function loadSystemPromptFromSpec(specPath) {
-  const spec = JSON.parse(readFileSync7(specPath, "utf8"));
+  const spec = JSON.parse(readFileSync8(specPath, "utf8"));
   return buildSystemPrompt(spec);
 }
 function loadJsonSchemaForServe(schemaPath) {
   const resolved = resolve5(schemaPath);
-  if (!existsSync5(resolved) || !statSync4(resolved).isFile()) {
+  if (!existsSync7(resolved) || !statSync4(resolved).isFile()) {
     throw new Error(`JSON schema file not found: ${schemaPath}`);
   }
   try {
-    const schema = JSON.parse(readFileSync7(resolved, "utf8"));
+    const schema = JSON.parse(readFileSync8(resolved, "utf8"));
     return JSON.stringify(schema);
   } catch (err) {
     throw new Error(`JSON schema file is not valid JSON: ${schemaPath}`);
@@ -6539,13 +6682,13 @@ function loadJsonSchemaForServe(schemaPath) {
 }
 function writeReferenceServerScript(cacheDir) {
   const scriptDir = join6(cacheDir, "_server");
-  mkdirSync3(scriptDir, { recursive: true });
+  mkdirSync4(scriptDir, { recursive: true });
   const scriptPath = join6(scriptDir, "openai_reference_server.py");
-  writeFileSync3(scriptPath, REFERENCE_SERVER_SCRIPT, "utf8");
+  writeFileSync4(scriptPath, REFERENCE_SERVER_SCRIPT, "utf8");
   return scriptPath;
 }
 async function resolveServeTarget(target, opts, cacheDir, forceDownload) {
-  if (existsSync5(target)) {
+  if (existsSync7(target)) {
     const resolved = resolve5(target);
     const stats = statSync4(resolved);
     if (stats.isDirectory()) {
@@ -6571,7 +6714,7 @@ async function resolveServeTarget(target, opts, cacheDir, forceDownload) {
   const modelCacheDir = join6(cacheDir, fullId);
   const archivePath = join6(modelCacheDir, data3.filename);
   const extractDir = join6(modelCacheDir, "model");
-  if (!existsSync5(archivePath) || forceDownload) {
+  if (!existsSync7(archivePath) || forceDownload) {
     await downloadUrlToFile(data3.url, archivePath);
   }
   extractArchive(archivePath, extractDir, forceDownload);
@@ -6675,7 +6818,7 @@ function ollamaSlug(name) {
 }
 function firstExisting(candidates) {
   for (const candidate of candidates) {
-    if (candidate && existsSync5(candidate) && statSync4(candidate).isFile()) {
+    if (candidate && existsSync7(candidate) && statSync4(candidate).isFile()) {
       return resolve5(candidate);
     }
   }
@@ -6687,7 +6830,7 @@ function llamaCppDir(explicit) {
 function resolveConvertScript(opts, required) {
   if (opts.convertScript) {
     const resolved = resolve5(opts.convertScript);
-    if (required && !existsSync5(resolved)) {
+    if (required && !existsSync7(resolved)) {
       throw new Error(`Conversion script not found: ${opts.convertScript}`);
     }
     return resolved;
@@ -6706,7 +6849,7 @@ function resolveConvertScript(opts, required) {
 function resolveQuantizeBin(opts, required) {
   if (opts.quantizeBin) {
     const resolved = resolve5(opts.quantizeBin);
-    if (required && !existsSync5(resolved)) {
+    if (required && !existsSync7(resolved)) {
       throw new Error(`llama-quantize binary not found: ${opts.quantizeBin}`);
     }
     return resolved;
@@ -6841,7 +6984,7 @@ function registerModelsCommands(parent) {
       opts
     );
     const outputPath = resolveOutputPath(cmdOpts.output, data3.filename);
-    if (existsSync5(outputPath) && !cmdOpts.force) {
+    if (existsSync7(outputPath) && !cmdOpts.force) {
       throw new Error(`Output file already exists: ${outputPath}. Use --force to overwrite.`);
     }
     const bytes = await downloadUrlToFile(data3.url, outputPath);
@@ -6866,7 +7009,7 @@ function registerModelsCommands(parent) {
     const quantPlan = planQuant(String(cmdOpts.quant));
     const printOnly = Boolean(cmdOpts.printCommand);
     const cacheDir = resolve5(cmdOpts.cacheDir || defaultCacheDir());
-    mkdirSync3(cacheDir, { recursive: true });
+    mkdirSync4(cacheDir, { recursive: true });
     const serveTarget = await resolveServeTarget(
       target,
       opts,
@@ -6950,10 +7093,10 @@ function registerModelsCommands(parent) {
       ollama: ollamaInfo
     };
     if (printOnly) return printExportPlan(plan);
-    if (existsSync5(finalPath) && !cmdOpts.force) {
+    if (existsSync7(finalPath) && !cmdOpts.force) {
       throw new Error(`Output already exists: ${finalPath}. Use --force to overwrite.`);
     }
-    mkdirSync3(outputDir, { recursive: true });
+    mkdirSync4(outputDir, { recursive: true });
     const runStep = (command, args2) => execFileSync(command, args2, { stdio: "inherit" });
     if (!isJsonMode()) printSuccess(`Converting ${serveTarget.modelName} \u2192 ${quantPlan.convertOuttype} GGUF`);
     runStep(cmdOpts.python, [
@@ -6971,12 +7114,12 @@ function registerModelsCommands(parent) {
         finalPath,
         quantPlan.quantizeType
       ]);
-      if (!cmdOpts.keepIntermediate && intermediatePath && existsSync5(intermediatePath)) {
+      if (!cmdOpts.keepIntermediate && intermediatePath && existsSync7(intermediatePath)) {
         rmSync(intermediatePath, { force: true });
       }
     }
     if (ollamaInfo) {
-      writeFileSync3(modelfilePath, modelfileContent, "utf8");
+      writeFileSync4(modelfilePath, modelfileContent, "utf8");
       if (!isJsonMode()) printSuccess(`Wrote Modelfile to ${modelfilePath}`);
       if (ollamaInfo.create) {
         if (!isJsonMode()) printSuccess(`Creating Ollama model ${ollamaName}`);
@@ -7024,11 +7167,11 @@ function registerModelsCommands(parent) {
       ]);
       return;
     }
-    if (existsSync5(venvDir) && cmdOpts.force) {
+    if (existsSync7(venvDir) && cmdOpts.force) {
       rmSync(venvDir, { recursive: true, force: true });
     }
-    if (!existsSync5(venvPython)) {
-      mkdirSync3(cacheDir, { recursive: true });
+    if (!existsSync7(venvPython)) {
+      mkdirSync4(cacheDir, { recursive: true });
       execFileSync(commands[0][0], commands[0].slice(1), { stdio: "inherit" });
     }
     execFileSync(commands[1][0], commands[1].slice(1), { stdio: "inherit" });
@@ -7048,7 +7191,7 @@ function registerModelsCommands(parent) {
   models.command("serve").description("Serve a downloaded model with an OpenAI-compatible local API").argument("<target>", "Model ID/prefix, model directory, or .tar.gz artifact").option("--spec <path>", "Behavior spec JSON to apply as the default system prompt").option("--no-spec-prompt", "Do not auto-apply a behavior spec system prompt").option("--host <host>", "Host to bind", "127.0.0.1").option("--port <port>", "Port to bind", "8000").option("--python <path>", "Python executable").option("--cache-dir <path>", "Cache directory for downloaded/extracted models").option("--device <device>", "Inference device: auto, cpu, cuda, or mps", "auto").option("--force-download", "Re-download and re-extract model artifacts").option("--max-tokens <n>", "Default max completion tokens", "512").option("--temperature <n>", "Default sampling temperature", "0.7").option("--json-schema <path>", "JSON Schema file to enforce by default for chat completions").option("--json-repair-attempts <n>", "Number of JSON/schema repair retries", "1").option("--trust-remote-code", "Pass trust_remote_code=True to transformers").option("--managed", "Run a local lifecycle manager in front of the model server").option("--idle-timeout <seconds>", "Managed mode idle timeout before stopping the model", "300").option("--restart-after-requests <n>", "Managed mode restart threshold; 0 disables request-count restarts", "100").option("--gate-field <field>", "Response JSON field to log as the managed serving gate result", "should_process").option("--log-file <path>", "Write managed serving JSONL request logs to a file").option("--print-command", "Print the underlying Python command without starting it").action(async (target, cmdOpts) => {
     const opts = parent.opts();
     const cacheDir = resolve5(cmdOpts.cacheDir || defaultCacheDir());
-    mkdirSync3(cacheDir, { recursive: true });
+    mkdirSync4(cacheDir, { recursive: true });
     const python = resolveServePython(cacheDir, cmdOpts.python);
     if (!cmdOpts.printCommand) ensureServingRuntime(python, cacheDir);
     const serveTarget = await resolveServeTarget(
@@ -7143,9 +7286,9 @@ function registerModelsCommands(parent) {
         env: { ...process.env, ...env }
       });
       child.on("error", reject);
-      child.on("exit", (code, signal) => {
-        if (code === 0) return resolvePromise();
-        reject(new Error(`Model server exited with ${signal ?? `code ${code}`}`));
+      child.on("exit", (code2, signal) => {
+        if (code2 === 0) return resolvePromise();
+        reject(new Error(`Model server exited with ${signal ?? `code ${code2}`}`));
       });
     });
   });
@@ -7302,7 +7445,7 @@ function registerTopupCommands(parent) {
     }
     const url = data3.checkout_url;
     console.log(
-      `${chalk7.bold("Checkout URL:")} ${chalk7.cyan(url)}
+      `${chalk7.bold("Checkout URL:")} ${chalk7.hex("#A78BFA")(url)}
 ` + chalk7.dim("Complete the payment to credit your account.")
     );
     if (options.open !== false) {
@@ -7510,12 +7653,12 @@ function printValidation(checks) {
 }
 
 // src/commands/push.ts
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "fs";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve6 } from "path";
 function persistRemoteId(filePath, id) {
-  const raw = JSON.parse(readFileSync8(filePath, "utf-8"));
+  const raw = JSON.parse(readFileSync9(filePath, "utf-8"));
   raw.id = id;
-  writeFileSync4(filePath, JSON.stringify(raw, null, 2) + "\n");
+  writeFileSync5(filePath, JSON.stringify(raw, null, 2) + "\n");
 }
 function registerPushCommand(parent) {
   parent.command("push").description("Push local spec to the Tuned Tensor API").option("-f, --file <path>", "Spec file path", DEFAULT_SPEC_FILE).action(async (cmdOpts) => {
@@ -7639,6 +7782,81 @@ function registerAgentCommands(parent, options) {
   });
 }
 
+// src/commands/pipeline.ts
+import { existsSync as existsSync8, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "fs";
+import { resolve as resolve7 } from "path";
+var DEFAULT_PIPELINE_FILE = "tunedtensor.pipeline.json";
+function parseList(value) {
+  if (!value) return void 0;
+  const ids = value.split(",").map((id) => id.trim()).filter(Boolean);
+  if (!ids.length) throw new Error("Step selection must name at least one step.");
+  return ids;
+}
+function loadPipeline(path) {
+  const resolved = resolve7(path);
+  if (!existsSync8(resolved)) throw new Error(`Pipeline file not found: ${path}. Run \`tt pipeline init\` to create one.`);
+  try {
+    return JSON.parse(readFileSync10(resolved, "utf8"));
+  } catch (error) {
+    throw new Error(`Pipeline file must be JSON: ${error.message}`);
+  }
+}
+function outputPlan(plan) {
+  if (isJsonMode()) return printJson(plan);
+  const typed = plan;
+  for (const step of typed.steps) {
+    console.log(`${step.id.padEnd(16)} ${step.uses.padEnd(10)} ${step.target}`);
+    for (const transfer of step.transfers) console.log(`  transfer ${transfer.from}: ${transfer.from_target} -> ${transfer.to_target}`);
+  }
+}
+function registerPipelineCommands(parent) {
+  const pipeline2 = parent.command("pipeline").description("Create, validate, inspect, and safely dry-run ordered pipeline recipes");
+  pipeline2.command("init").description("Write a canonical v1 pipeline recipe").option("-f, --file <path>", "Output file", DEFAULT_PIPELINE_FILE).option("--target <target>", "Default target: local or cloud", "local").action((options) => {
+    if (!PIPELINE_TARGETS.includes(options.target)) throw new Error("--target must be local or cloud.");
+    const path = resolve7(options.file);
+    if (existsSync8(path)) throw new Error(`Pipeline file already exists: ${options.file}.`);
+    const recipe = canonicalPipeline(options.target);
+    writeFileSync6(path, `${JSON.stringify(recipe, null, 2)}
+`);
+    if (isJsonMode()) return printJson({ created: true, path, pipeline: recipe });
+    printSuccess(`Created ${options.file}`);
+  });
+  pipeline2.command("validate").description("Validate a pipeline without any execution or transfer").option("-f, --file <path>", "Pipeline file", DEFAULT_PIPELINE_FILE).action((options) => {
+    const errors = validatePipeline(loadPipeline(options.file));
+    const result2 = { valid: errors.length === 0, errors };
+    if (isJsonMode()) return printJson(result2);
+    if (errors.length) throw new Error(`Invalid pipeline:
+- ${errors.join("\n- ")}`);
+    printSuccess("Pipeline is valid.");
+  });
+  pipeline2.command("plan").description("Resolve step targets and required artifact transfers").option("-f, --file <path>", "Pipeline file", DEFAULT_PIPELINE_FILE).option("--only <ids>", "Comma-separated step IDs to include").option("--skip <ids>", "Comma-separated step IDs to omit").action((options) => {
+    outputPlan(createExecutionPlan(loadPipeline(options.file), { only: parseList(options.only), skip: parseList(options.skip) }));
+  });
+  pipeline2.command("run").description("Run an ordered local pipeline, or safely preview any pipeline").option("--dry-run", "Resolve and display only; never execute, transfer, or reserve credits").option("-f, --file <path>", "Pipeline file", DEFAULT_PIPELINE_FILE).option("--spec <path>", "Local behavior spec", "tunedtensor.json").option("--config <path>", "Local runtime config").option("--only <ids>", "Comma-separated step IDs to include").option("--skip <ids>", "Comma-separated step IDs to omit").action(async (options) => {
+    const plan = createExecutionPlan(loadPipeline(options.file), { only: parseList(options.only), skip: parseList(options.skip) });
+    if (options.dryRun) {
+      if (isJsonMode()) return printJson({ dry_run: true, ...plan });
+      console.log("Dry run only \u2014 no execution, artifact transfer, or credit reservation will occur.");
+      return outputPlan(plan);
+    }
+    const remote = plan.steps.find((step) => step.target !== "local");
+    if (remote) {
+      throw new Error(`Step "${remote.id}" targets cloud execution. Hosted and mixed pipeline execution is not enabled by this CLI build; use --dry-run.`);
+    }
+    const input = await loadLocalRunInput(resolve7(options.spec));
+    assertLocalRunInputReady(input.request);
+    const config = await loadLocalRunnerConfig(options.config ? resolve7(options.config) : void 0);
+    const localPipeline = {
+      version: 1,
+      ...plan.name ? { name: plan.name } : {},
+      steps: plan.steps.map(({ transfers: _transfers, ...step }) => step)
+    };
+    const result2 = await runLocalPipeline({ request: input.request, config, pipeline: localPipeline });
+    if (isJsonMode()) return printJson(result2);
+    printSuccess(`Pipeline completed with status ${result2.status}.`);
+  });
+}
+
 // src/cli.ts
 async function createDefaultAgentClient(runtime, env, cloud) {
   const selection = getAgentSelection(env);
@@ -7681,7 +7899,16 @@ async function createDefaultAgentClient(runtime, env, cloud) {
 }
 function createLazyDefaultAgentClient(runtime, env, cloud) {
   let pending;
-  const client = () => pending ??= createDefaultAgentClient(runtime, env, cloud);
+  const client = () => {
+    if (!pending) {
+      const attempt = createDefaultAgentClient(runtime, env, cloud);
+      pending = attempt;
+      attempt.catch(() => {
+        if (pending === attempt) pending = void 0;
+      });
+    }
+    return pending;
+  };
   return {
     createThread: async () => await (await client()).createThread(),
     listThreads: async () => await (await client()).listThreads(),
@@ -7696,7 +7923,7 @@ async function runSelfCommand(args2, options = {}) {
   if (!entrypoint) {
     throw new Error("Cannot locate the tt CLI entrypoint.");
   }
-  return await new Promise((resolve7, reject) => {
+  return await new Promise((resolve8, reject) => {
     const child = spawn4(process.execPath, [entrypoint, ...args2], {
       cwd: options.cwd,
       env: options.env ?? process.env,
@@ -7732,7 +7959,7 @@ async function runSelfCommand(args2, options = {}) {
     child.once("close", (exitCode, signal) => {
       cleanup();
       const signalNumber = signal ? osConstants2.signals[signal] : void 0;
-      resolve7({
+      resolve8({
         exitCode: exitCode ?? (typeof signalNumber === "number" ? 128 + signalNumber : 1),
         signal
       });
@@ -7836,6 +8063,7 @@ function createProgram(version, runtime = {}) {
   registerInitCommand(program);
   registerEvalCommand(program);
   registerPushCommand(program);
+  registerPipelineCommands(program);
   registerAgentCommands(program, {
     env,
     output: runtime.stdout ?? process.stdout,
@@ -7860,7 +8088,7 @@ function createProgram(version, runtime = {}) {
 `);
       return;
     }
-    output.write(`${chalk9.bold.cyan("Tuned Tensor status")}
+    output.write(`${chalk9.bold.hex("#8B5CF6")("Tuned Tensor status")}
 `);
     output.write(`${formatShellStatus(context, target).join("\n")}
 
@@ -7993,7 +8221,7 @@ async function runCli(version, runtime = {}) {
 }
 
 // src/index.ts
-runCli("0.9.0").catch((err) => {
+runCli("0.9.2").catch((err) => {
   reportError(err);
   process.exit(1);
 });