@tuned-tensor/cli 0.5.0 → 0.7.0

package/dist/index.js

@@ -4,163 +4,7 @@
 import { spawn as spawn4 } from "child_process";
 import { constants as osConstants2 } from "os";
 import { Command } from "commander";
-import chalk7 from "chalk";
-
-// src/local-runner.ts
-import { constants as osConstants } from "os";
-import { randomUUID } from "crypto";
-import { createRequire } from "module";
-import { spawn } from "child_process";
-import {
-  readFile,
-  rm,
-  stat,
-  writeFile
-} from "fs/promises";
-import {
-  basename as basename2,
-  dirname,
-  isAbsolute,
-  join as join2,
-  resolve
-} from "path";
-
-// src/base-models.ts
-var SUPPORTED_BASE_MODELS = [
-  "google/gemma-4-E2B-it",
-  "google/gemma-4-E4B-it",
-  "Qwen/Qwen3.5-2B",
-  "Qwen/Qwen3-VL-2B-Instruct",
-  "Qwen/Qwen3.5-4B",
-  "meta-llama/Llama-3.2-3B-Instruct",
-  "microsoft/Phi-4-mini-instruct",
-  "ibm-granite/granite-3.3-2b-instruct",
-  "bigcode/starcoder2-3b"
-];
-var BASE_MODEL_ALIASES = /* @__PURE__ */ new Map();
-for (const model of SUPPORTED_BASE_MODELS) {
-  BASE_MODEL_ALIASES.set(model.toLowerCase(), model);
-}
-for (const [alias, model] of [
-  ["google/gemma-4-E2B", "google/gemma-4-E2B-it"],
-  ["google/gemma-4-e2b", "google/gemma-4-E2B-it"],
-  ["google/gemma-4-e2b-it", "google/gemma-4-E2B-it"],
-  ["google/gemma-4-E4B", "google/gemma-4-E4B-it"],
-  ["google/gemma-4-e4b", "google/gemma-4-E4B-it"],
-  ["google/gemma-4-e4b-it", "google/gemma-4-E4B-it"],
-  ["qwen/qwen3.5-2b", "Qwen/Qwen3.5-2B"],
-  ["Qwen/Qwen3.5-2B-Base", "Qwen/Qwen3.5-2B"],
-  ["qwen/qwen3.5-2b-base", "Qwen/Qwen3.5-2B"],
-  ["qwen/qwen3-vl-2b-instruct", "Qwen/Qwen3-VL-2B-Instruct"],
-  ["Qwen/Qwen3-VL-2B", "Qwen/Qwen3-VL-2B-Instruct"],
-  ["qwen/qwen3-vl-2b", "Qwen/Qwen3-VL-2B-Instruct"],
-  ["qwen/qwen3.5-4b", "Qwen/Qwen3.5-4B"],
-  ["Qwen/Qwen3.5-4B-Base", "Qwen/Qwen3.5-4B"],
-  ["qwen/qwen3.5-4b-base", "Qwen/Qwen3.5-4B"],
-  ["meta-llama/llama-3.2-3b-instruct", "meta-llama/Llama-3.2-3B-Instruct"],
-  ["meta-llama/Llama-3.2-3B", "meta-llama/Llama-3.2-3B-Instruct"],
-  ["meta-llama/llama-3.2-3b", "meta-llama/Llama-3.2-3B-Instruct"],
-  ["microsoft/phi-4-mini-instruct", "microsoft/Phi-4-mini-instruct"],
-  ["phi-4-mini-instruct", "microsoft/Phi-4-mini-instruct"],
-  ["ibm-granite/granite-3.3-2b-instruct", "ibm-granite/granite-3.3-2b-instruct"],
-  ["granite-3.3-2b-instruct", "ibm-granite/granite-3.3-2b-instruct"],
-  ["bigcode/starcoder2-3b", "bigcode/starcoder2-3b"],
-  ["starcoder2-3b", "bigcode/starcoder2-3b"]
-]) {
-  BASE_MODEL_ALIASES.set(alias.toLowerCase(), model);
-}
-var UnsupportedBaseModelError = class extends Error {
-  constructor(model) {
-    const supported = SUPPORTED_BASE_MODELS.join(", ");
-    super(
-      `Unsupported base_model "${String(model)}". Supported base models: ${supported}`
-    );
-    this.name = "UnsupportedBaseModelError";
-  }
-};
-function canonicalizeBaseModel(model) {
-  if (typeof model !== "string" || !model.trim()) {
-    throw new UnsupportedBaseModelError(model);
-  }
-  const canonical = BASE_MODEL_ALIASES.get(model.trim().toLowerCase());
-  if (!canonical) {
-    throw new UnsupportedBaseModelError(model);
-  }
-  return canonical;
-}
-function canonicalizeSpecBaseModel(body) {
-  if ("base_model" in body && body.base_model !== void 0) {
-    return { ...body, base_model: canonicalizeBaseModel(body.base_model) };
-  }
-  return body;
-}
-
-// src/project-spec.ts
-var CLOUD_SPEC_KEYS = [
-  "name",
-  "description",
-  "base_model",
-  "system_prompt",
-  "guidelines",
-  "constraints",
-  "examples",
-  "eval_cases"
-];
-var LOCAL_ONLY_SPEC_KEYS = [
-  "hyperparameters",
-  "dataset_prebuilt"
-];
-var LOCAL_SPEC_KEYS = [
-  "id",
-  "name",
-  "description",
-  "system_prompt",
-  "guidelines",
-  "constraints",
-  "base_model",
-  "examples",
-  ...LOCAL_ONLY_SPEC_KEYS
-];
-var CLOUD_SPEC_KEY_SET = new Set(CLOUD_SPEC_KEYS);
-var LOCAL_ONLY_SPEC_KEY_SET = new Set(LOCAL_ONLY_SPEC_KEYS);
-var LOCAL_SPEC_KEY_SET = new Set(LOCAL_SPEC_KEYS);
-var KNOWN_PROJECT_SPEC_KEY_SET = /* @__PURE__ */ new Set([
-  ...CLOUD_SPEC_KEYS,
-  ...LOCAL_SPEC_KEYS
-]);
-function projectSpec(raw, supportedKeys) {
-  const body = {};
-  const droppedKeys = [];
-  for (const [key, value] of Object.entries(raw)) {
-    if (supportedKeys.has(key)) {
-      body[key] = value;
-    } else {
-      droppedKeys.push(key);
-    }
-  }
-  return {
-    body: canonicalizeSpecBaseModel(body),
-    droppedKeys
-  };
-}
-function projectCloudSpec(raw) {
-  return projectSpec(raw, CLOUD_SPEC_KEY_SET);
-}
-function projectLocalSpec(raw) {
-  return projectSpec(raw, LOCAL_SPEC_KEY_SET);
-}
-function hasLocalOnlySpecFields(raw) {
-  return Object.keys(raw).some((key) => LOCAL_ONLY_SPEC_KEY_SET.has(key));
-}
-function unknownProjectSpecKeys(raw) {
-  return Object.keys(raw).filter(
-    (key) => !KNOWN_PROJECT_SPEC_KEY_SET.has(key)
-  );
-}
-
-// src/output.ts
-import chalk from "chalk";
-import Table from "cli-table3";
+import chalk8 from "chalk";
 
 // src/client.ts
 import { readFileSync as readFileSync2, statSync } from "fs";
@@ -279,6 +123,37 @@ async function request(method, path, options = {}) {
   if (res.status === 204) return { data: null };
   return await res.json();
 }
+async function postStream(path, body, opts) {
+  const key = resolveKey(opts);
+  const url = buildUrl(path, void 0, opts);
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${key}`,
+      Accept: "text/event-stream",
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body),
+    signal: opts?.signal
+  });
+  if (!res.ok) {
+    let errBody;
+    try {
+      errBody = await res.json();
+    } catch {
+      throw new ApiError(res.status, "UNKNOWN", res.statusText);
+    }
+    throw new ApiError(
+      res.status,
+      errBody.error?.code || "UNKNOWN",
+      errBody.error?.message || res.statusText
+    );
+  }
+  if (!res.body) {
+    throw new ApiError(502, "EMPTY_STREAM", "The agent returned an empty response.");
+  }
+  return res;
+}
 function get(path, query, opts) {
   return request("GET", path, { query, opts });
 }
@@ -295,1739 +170,2622 @@ function del(path, opts) {
   return request("DELETE", path, { opts });
 }
 
-// src/output.ts
-var jsonMode = false;
-function setJsonMode(enabled) {
-  jsonMode = enabled;
-}
-function isJsonMode() {
-  return jsonMode;
-}
-function printJson(data) {
-  console.log(JSON.stringify(data, null, 2));
-}
-function printTable(headers, rows2, meta) {
-  const table = new Table({
-    head: headers.map((h) => chalk.bold.cyan(h)),
-    style: { head: [], border: [] }
-  });
-  for (const row of rows2) {
-    table.push(row);
-  }
-  console.log(table.toString());
-  if (meta) {
-    const totalPages = Math.ceil(meta.total / meta.per_page);
-    console.log(
-      chalk.dim(
-        `
-Page ${meta.page}/${totalPages} (${meta.total} total)`
-      )
-    );
-  }
-}
-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(`${chalk.bold.cyan(paddedLabel)}  ${value ?? chalk.dim("\u2014")}`);
+// src/agent-client.ts
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function dataEnvelope(value) {
+  const outer = record(value);
+  return outer && "data" in outer ? outer.data : value;
+}
+function normalizeEvent(block) {
+  let eventName = null;
+  const dataLines = [];
+  for (const rawLine of block.split(/\r?\n/)) {
+    if (!rawLine || rawLine.startsWith(":")) continue;
+    const separator = rawLine.indexOf(":");
+    const field = separator === -1 ? rawLine : rawLine.slice(0, separator);
+    const rawValue = separator === -1 ? "" : rawLine.slice(separator + 1);
+    const value = rawValue.startsWith(" ") ? rawValue.slice(1) : rawValue;
+    if (field === "event") eventName = value;
+    if (field === "data") dataLines.push(value);
+  }
+  const rawData = dataLines.join("\n");
+  if (!eventName && !rawData) return null;
+  if (rawData === "[DONE]") return { type: "final", payload: {} };
+  let decoded = rawData;
+  if (rawData) {
+    try {
+      decoded = JSON.parse(rawData);
+    } catch {
+      decoded = rawData;
+    }
   }
+  const decodedRecord = record(decoded);
+  const inferredType = stringValue(decodedRecord?.type) ?? stringValue(decodedRecord?.event);
+  const nestedData = record(decodedRecord?.data);
+  const payload = decodedRecord && nestedData && inferredType ? nestedData : decodedRecord ?? (rawData ? { text: rawData } : {});
+  const type = (eventName ?? inferredType ?? "message").toLowerCase().replaceAll("-", "_");
+  return { type, payload };
 }
-function printSuccess(message) {
-  console.log(chalk.green("\u2713") + " " + message);
-}
-function printWarning(message) {
-  console.log(chalk.yellow("!") + " " + message);
+function createAgentEventDecoder(onEvent) {
+  let buffer = "";
+  const drain = (flush) => {
+    while (true) {
+      const boundary = buffer.match(/\r?\n\r?\n/);
+      if (!boundary || boundary.index === void 0) break;
+      const block = buffer.slice(0, boundary.index);
+      buffer = buffer.slice(boundary.index + boundary[0].length);
+      const event = normalizeEvent(block);
+      if (event) onEvent(event);
+    }
+    if (flush && buffer) {
+      const event = normalizeEvent(buffer);
+      buffer = "";
+      if (event) onEvent(event);
+    }
+  };
+  return {
+    push(chunk) {
+      buffer += chunk;
+      drain(false);
+    },
+    finish() {
+      drain(true);
+    }
+  };
 }
-function printError(message) {
-  console.error(chalk.red("\u2717") + " " + message);
+async function consumeAgentEventStream(response, onEvent) {
+  if (!response.body) throw new Error("The agent returned an empty response.");
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  const events = createAgentEventDecoder(onEvent);
+  while (true) {
+    const { value, done } = await reader.read();
+    events.push(decoder.decode(value, { stream: !done }));
+    if (done) break;
+  }
+  events.finish();
+}
+function normalizeAction(value) {
+  const input = record(value);
+  const id = stringValue(input?.id);
+  const title = stringValue(input?.title);
+  if (!input || !id || !title) return null;
+  return {
+    id,
+    title,
+    summary: stringValue(input.summary) ?? "",
+    risk: stringValue(input.risk) ?? "unknown",
+    status: stringValue(input.status) ?? void 0,
+    operation: stringValue(input.operation) ?? void 0,
+    thread_id: stringValue(input.thread_id) ?? void 0,
+    turn_id: stringValue(input.turn_id) ?? void 0,
+    arguments: input.arguments,
+    preview: input.preview,
+    method: stringValue(input.method) ?? void 0,
+    path: stringValue(input.path) ?? void 0
+  };
 }
-function reportError(err) {
-  const isApi = err instanceof ApiError;
-  const message = err?.message || String(err);
-  if (jsonMode) {
-    printJson({
-      error: {
-        status: isApi ? err.status : null,
-        code: isApi ? err.code : "CLI_ERROR",
-        message
+async function streamResult(response, fallbackThreadId, onEvent) {
+  let threadId = fallbackThreadId;
+  let turnId = null;
+  let status2 = null;
+  let assistantText = "";
+  let sawFinal = false;
+  const actions = [];
+  await consumeAgentEventStream(response, (event) => {
+    const payload = event.payload;
+    if (event.type === "turn_started") {
+      threadId = stringValue(payload.thread_id) ?? stringValue(payload.threadId) ?? threadId;
+      turnId = stringValue(payload.turn_id) ?? stringValue(payload.turnId) ?? turnId;
+    } else if (event.type === "text_delta") {
+      assistantText += stringValue(payload.delta) ?? stringValue(payload.text) ?? stringValue(payload.content) ?? "";
+    } else if (event.type === "approval_required") {
+      const action = normalizeAction(payload.action ?? payload.approval ?? payload);
+      if (action && !actions.some((candidate) => candidate.id === action.id)) {
+        actions.push(action);
       }
-    });
-  } else if (isApi) {
-    printError(`[${err.status}] ${message}`);
-  } else {
-    printError(message);
+    } else if (event.type === "final") {
+      sawFinal = true;
+      status2 = stringValue(payload.status) ?? status2;
+      threadId = stringValue(payload.thread_id) ?? stringValue(payload.threadId) ?? threadId;
+      turnId = stringValue(payload.turn_id) ?? stringValue(payload.turnId) ?? turnId;
+    }
+    onEvent(event);
+  });
+  if (!sawFinal) {
+    throw new Error("The agent response ended before its final status was confirmed.");
   }
+  return { threadId, turnId, status: status2, response: assistantText, actions };
 }
-function formatDate(iso) {
-  if (!iso) return "\u2014";
-  return new Date(iso).toLocaleString();
-}
-function formatStatus(status2) {
-  const map = {
-    completed: chalk.green,
-    running: chalk.blue,
-    training: chalk.blue,
-    evaluating: chalk.blue,
-    preparing: chalk.yellow,
-    pending: chalk.yellow,
-    uploading: chalk.yellow,
-    failed: chalk.red,
-    cancelled: chalk.dim,
-    validated: chalk.green,
-    invalid: chalk.red
+function createAgentClient(opts) {
+  return {
+    async createThread() {
+      const response = await post("/agent/threads", {}, opts);
+      return dataEnvelope(response);
+    },
+    async listThreads() {
+      const response = await get("/agent/threads", void 0, opts);
+      return dataEnvelope(response);
+    },
+    async getThread(id) {
+      const response = await get(`/agent/threads/${encodeURIComponent(id)}`, void 0, opts);
+      const detail = dataEnvelope(response);
+      return {
+        thread: detail.thread,
+        actions: (detail.actions ?? []).map((action) => normalizeAction(action)).filter((action) => action !== null)
+      };
+    },
+    async runTurn(threadId, prompt, onEvent, signal) {
+      const streamOpts = { ...opts, signal };
+      const response = await postStream(
+        `/agent/threads/${encodeURIComponent(threadId)}/turns`,
+        { prompt },
+        streamOpts
+      );
+      return await streamResult(response, threadId, onEvent);
+    },
+    async approveAction(actionId, onEvent, signal) {
+      const streamOpts = { ...opts, signal };
+      const response = await postStream(
+        `/agent/actions/${encodeURIComponent(actionId)}/approve`,
+        {},
+        streamOpts
+      );
+      return await streamResult(response, "", onEvent);
+    },
+    async rejectAction(actionId) {
+      await post(`/agent/actions/${encodeURIComponent(actionId)}/reject`, {}, opts);
+    }
   };
-  const colorFn = map[status2] || chalk.white;
-  return colorFn(status2);
-}
-function truncate(str, max) {
-  if (str.length <= max) return str;
-  return str.slice(0, max - 1) + "\u2026";
-}
-function shortId(id) {
-  return id.slice(0, 8);
 }
 
-// src/local-output.ts
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+// src/agent.ts
+import chalk2 from "chalk";
+
+// src/shell.ts
+import chalk from "chalk";
+import { stat as stat2 } from "fs/promises";
+import { homedir as homedir3 } from "os";
+import { isAbsolute as isAbsolute2, resolve as resolve2 } from "path";
+import { createInterface } from "readline";
+
+// src/command-catalog.ts
+var CLOUD = ["cloud"];
+var LOCAL = ["local"];
+var BOTH = ["cloud", "local"];
+var COMMAND_CATALOG = [
+  { path: "init", description: "Create a behaviour-spec project.", group: "Workflow", modes: BOTH },
+  { path: "eval", description: "Validate a managed-service behaviour spec.", group: "Workflow", modes: CLOUD },
+  { path: "push", description: "Create or update the cloud behaviour spec.", group: "Workflow", modes: CLOUD },
+  { path: "validate", description: "Validate a local fine-tuning project.", group: "Workflow", modes: LOCAL },
+  { path: "doctor", description: "Check the local host and run prerequisites.", group: "Workflow", modes: LOCAL },
+  { path: "run", description: "Run the local fine-tuning and evaluation workflow.", group: "Workflow", modes: LOCAL },
+  { path: "runs list", description: "List runs.", group: "Inspect", modes: BOTH },
+  { path: "runs get", description: "Show a run.", group: "Inspect", modes: BOTH },
+  { path: "runs report", description: "Show a run report.", group: "Inspect", modes: BOTH },
+  { path: "runs compare", description: "Compare two local run reports.", group: "Inspect", modes: LOCAL },
+  { path: "runs events", description: "Show local run progress events.", group: "Inspect", modes: LOCAL },
+  { path: "runs estimate", description: "Estimate managed run cost and duration.", group: "Workflow", modes: CLOUD },
+  { path: "runs start", description: "Start a managed fine-tuning run.", group: "Workflow", modes: CLOUD },
+  { path: "runs watch", description: "Watch a managed run.", group: "Inspect", modes: CLOUD },
+  { path: "runs diagnose", description: "Show managed run diagnostics.", group: "Inspect", modes: CLOUD },
+  { path: "runs cancel", description: "Cancel a managed run.", group: "Workflow", modes: CLOUD },
+  { path: "models list", description: "List models.", group: "Inspect", modes: BOTH },
+  { path: "models get", description: "Show a model.", group: "Inspect", modes: BOTH },
+  { path: "models base", description: "List managed-service base models.", group: "Inspect", modes: CLOUD },
+  { path: "models download", description: "Download a managed model artifact.", group: "Serving", modes: CLOUD },
+  { path: "models export", description: "Export a managed model to GGUF or Ollama.", group: "Serving", modes: CLOUD },
+  { path: "models setup-runtime", description: "Install the managed model-serving runtime.", group: "Serving", modes: CLOUD },
+  { path: "models serve", description: "Serve a model through an OpenAI-compatible API.", group: "Serving", modes: BOTH },
+  { path: "models delete", description: "Delete a managed model.", group: "Workflow", modes: CLOUD },
+  { path: "models verify", description: "Verify a local model artifact.", group: "Serving", modes: LOCAL },
+  { path: "models prefetch", description: "Download the local base-model snapshot.", group: "Serving", modes: LOCAL },
+  { path: "models verify-base", description: "Verify the local base-model snapshot.", group: "Serving", modes: LOCAL },
+  { path: "models active", description: "Show the active local model.", group: "Serving", modes: LOCAL },
+  { path: "models activate", description: "Activate a verified local model.", group: "Serving", modes: LOCAL },
+  { path: "models rollback", description: "Roll back the active local model.", group: "Serving", modes: LOCAL },
+  { path: "serve", description: "Serve a local adapter, active model, or base model.", group: "Serving", modes: LOCAL },
+  { path: "specs list", description: "List cloud behaviour specs.", group: "Inspect", modes: CLOUD },
+  { path: "specs get", description: "Show a cloud behaviour spec.", group: "Inspect", modes: CLOUD },
+  { path: "specs create", description: "Create a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
+  { path: "specs update", description: "Update a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
+  { path: "specs delete", description: "Delete a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
+  { path: "datasets list", description: "List cloud datasets.", group: "Data", modes: CLOUD },
+  { path: "datasets get", description: "Show a cloud dataset.", group: "Data", modes: CLOUD },
+  { path: "datasets upload", description: "Upload a cloud dataset.", group: "Data", modes: CLOUD },
+  { path: "datasets delete", description: "Delete a cloud dataset.", group: "Data", modes: CLOUD },
+  { path: "label upload", description: "Start a cloud teacher-labeling job.", group: "Data", modes: CLOUD },
+  { path: "label watch", description: "Watch a cloud labeling job.", group: "Data", modes: CLOUD },
+  { path: "label list", description: "List cloud labeling jobs.", group: "Data", modes: CLOUD },
+  { path: "label status", description: "Show cloud labeling-job status.", group: "Data", modes: CLOUD },
+  { path: "label rows", description: "Review labeled rows.", group: "Data", modes: CLOUD },
+  { path: "label accept", description: "Accept labeled rows.", group: "Data", modes: CLOUD },
+  { path: "label reject", description: "Reject labeled rows.", group: "Data", modes: CLOUD },
+  { path: "label edit", description: "Edit a labeled row.", group: "Data", modes: CLOUD },
+  { path: "label promote", description: "Promote reviewed rows to a dataset.", group: "Data", modes: CLOUD },
+  { path: "label cancel", description: "Cancel a labeling job.", group: "Data", modes: CLOUD },
+  { path: "auth login", description: "Store a cloud API key.", group: "Account", modes: CLOUD },
+  { path: "auth logout", description: "Remove stored cloud credentials.", group: "Account", modes: CLOUD },
+  { path: "auth status", description: "Show cloud authentication status.", group: "Account", modes: CLOUD },
+  { path: "balance", description: "Show cloud credit balance.", group: "Account", modes: CLOUD },
+  { path: "topup", description: "Open a cloud credit checkout.", group: "Account", modes: CLOUD },
+  { path: "info", description: "Show TT Local package information.", group: "Inspect", modes: LOCAL }
+];
+var SLASH_COMMANDS = [
+  { path: "/help", description: "Show commands; add a word to filter." },
+  { path: "/status", description: "Show lightweight workflow status." },
+  { path: "/context", description: "Show the current project and backend context." },
+  { path: "/mode cloud", description: "Use the managed cloud workflow." },
+  { path: "/mode local", description: "Use the local GPU workflow." },
+  { path: "/model", description: "Show the active model; /model <id> activates a local model." },
+  { path: "/cd", description: "Change the shell's working directory." },
+  { path: "/clear", description: "Clear the terminal." },
+  { path: "/exit", description: "Exit the TT shell." }
+];
+function catalogForMode(mode) {
+  return COMMAND_CATALOG.filter((command) => command.modes.includes(mode));
 }
-function text(value) {
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value);
+function commandPathsForMode(mode) {
+  return [...new Set(catalogForMode(mode).map((command) => command.path))].sort((left, right) => left.localeCompare(right));
+}
+function groupedCatalog(mode, query) {
+  const normalizedQuery = query?.trim().toLowerCase();
+  const matches = catalogForMode(mode).filter((command) => {
+    if (!normalizedQuery) return true;
+    return command.path.toLowerCase().includes(normalizedQuery) || command.description.toLowerCase().includes(normalizedQuery) || command.group.toLowerCase().includes(normalizedQuery);
+  });
+  const groups = /* @__PURE__ */ new Map();
+  for (const command of matches) {
+    const group = groups.get(command.group) ?? [];
+    group.push(command);
+    groups.set(command.group, group);
   }
-  return void 0;
+  return groups;
 }
-function number(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+function completionTarget(line, activeMode) {
+  const leadingWhitespace = line.match(/^\s*/)?.[0] ?? "";
+  const content = line.slice(leadingWhitespace.length);
+  const override = content.match(/^(cloud|local)(?:\s+|$)/);
+  if (!override) {
+    return { prefix: leadingWhitespace, mode: activeMode, fragment: content };
+  }
+  const mode = override[1];
+  const prefix = `${leadingWhitespace}${mode} `;
+  return {
+    prefix,
+    mode,
+    fragment: content.slice(override[0].length)
+  };
 }
-function record(value) {
-  return isRecord(value) ? value : void 0;
+function createCommandCompleter(getMode) {
+  return (line) => {
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith("/")) {
+      const candidates = [
+        ...SLASH_COMMANDS.map((command) => command.path),
+        "/new",
+        "/threads",
+        "/resume ",
+        "/approve ",
+        "/reject "
+      ];
+      const matches2 = candidates.filter((candidate) => candidate.startsWith(trimmed));
+      return [matches2.length > 0 ? matches2 : candidates, line];
+    }
+    if (trimmed.startsWith("?")) {
+      return [["?"], line];
+    }
+    const { prefix, mode, fragment } = completionTarget(line, getMode());
+    const paths = commandPathsForMode(mode);
+    const targetCandidates = paths.map((path) => `${prefix}${path}`);
+    if (!prefix.trim()) targetCandidates.unshift("cloud ", "local ");
+    const normalizedLine = line.trimStart().toLowerCase();
+    const normalizedFragment = fragment.toLowerCase();
+    const matches = targetCandidates.filter((candidate) => {
+      if (prefix.trim()) return candidate.toLowerCase().startsWith(`${prefix.toLowerCase()}${normalizedFragment}`);
+      return candidate.toLowerCase().startsWith(normalizedLine);
+    });
+    return [matches.length > 0 ? matches : targetCandidates, line];
+  };
 }
-function rows(value) {
-  return Array.isArray(value) ? value.filter(isRecord) : [];
+
+// src/shell-context.ts
+import { readFile, readdir, stat } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { basename as basename2, dirname, isAbsolute, join as join2, resolve } from "path";
+async function readJsonObject(path) {
+  try {
+    const parsed = JSON.parse(await readFile(path, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { found: true, invalid: true };
+    }
+    return {
+      found: true,
+      value: parsed,
+      invalid: false
+    };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return { found: false, invalid: false };
+    }
+    return { found: true, invalid: true };
+  }
 }
-function displayId(value) {
-  const id = text(value);
-  return id ? shortId(id) : "\u2014";
+function stringField(value, key) {
+  const field = value?.[key];
+  return typeof field === "string" && field.trim() ? field : void 0;
 }
-function displayNumber(value, digits = 4) {
-  const parsed = number(value);
-  if (parsed === void 0) return void 0;
-  return parsed.toFixed(digits).replace(/\.?0+$/, "");
+function expandPath(value, baseDirectory, homeDirectory) {
+  if (value === "~") return homeDirectory;
+  if (value.startsWith("~/")) return resolve(homeDirectory, value.slice(2));
+  return isAbsolute(value) ? resolve(value) : resolve(baseDirectory, value);
 }
-function displayBytes(value) {
-  const bytes = number(value);
-  if (bytes === void 0 || bytes < 0) return void 0;
-  const units = ["B", "KiB", "MiB", "GiB", "TiB"];
-  let amount = bytes;
-  let unit = 0;
-  while (amount >= 1024 && unit < units.length - 1) {
-    amount /= 1024;
-    unit += 1;
-  }
-  const precision = amount >= 10 || unit === 0 ? 0 : 1;
-  return `${amount.toFixed(precision)} ${units[unit]}`;
+function environmentHome(env) {
+  return env.HOME ? resolve(env.HOME) : homedir2();
 }
-function displayCommand(value) {
-  if (!Array.isArray(value) || !value.every((part) => typeof part === "string")) {
-    return void 0;
-  }
-  return value.map(
-    (part) => /[\s"'\\]/.test(part) ? JSON.stringify(part) : part
-  ).join(" ");
+function cloudConfigPath(env, homeDirectory) {
+  const configHome = env.XDG_CONFIG_HOME ? resolve(env.XDG_CONFIG_HOME) : join2(homeDirectory, ".config");
+  return join2(configHome, "tuned-tensor", "config.json");
 }
-function status(value) {
-  const parsed = text(value) ?? "unknown";
-  return formatStatus(parsed);
+function redactApiKey(key) {
+  if (!key) return void 0;
+  if (key.length <= 4) return "\u2026";
+  const prefixLength = key.length > 8 ? 8 : Math.max(1, Math.floor(key.length / 2));
+  return `${key.slice(0, prefixLength)}\u2026`;
 }
-function gateFrom(value) {
-  return record(record(value)?.general_regression);
+function targetFromEnvironment(env) {
+  const value = env.TT_TARGET?.trim().toLowerCase();
+  return value === "cloud" || value === "local" ? value : void 0;
 }
-function renderGate(value) {
-  const gate = gateFrom(value);
-  if (!gate) {
-    printWarning(
-      "General regression was not run; this model cannot be activated yet."
-    );
-    return;
-  }
-  if (gate.passed === true) {
-    printSuccess("General regression gate passed");
-    return;
+async function adjacentFile(path) {
+  try {
+    return (await stat(path)).isFile();
+  } catch {
+    return false;
   }
-  printWarning(
-    "The local run completed, but the general regression gate failed."
-  );
-  const failures = Array.isArray(gate.failures) ? gate.failures.filter(
-    (failure) => typeof failure === "string"
-  ) : [];
-  for (const failure of failures) printWarning(failure);
 }
-function renderDoctor(value) {
-  const checks = rows(value.checks);
-  printTable(
-    ["Check", "Status", "Details"],
-    checks.map((check) => [
-      text(check.name) ?? "unknown",
-      check.ok === true ? formatStatus("completed") : formatStatus("failed"),
-      truncate(text(check.message) ?? text(check.detail) ?? "\u2014", 100)
-    ])
-  );
-  if (value.ok === true) {
-    printSuccess("Local environment is ready");
-  } else {
-    printError("Local environment needs attention");
-  }
-  if (value.config_path) {
-    printDetail([["Config", text(value.config_path)]]);
-  }
+async function readActiveModelId(storeRoot) {
+  const result = await readJsonObject(join2(storeRoot, "active-model.json"));
+  if (!result.found || result.invalid) return void 0;
+  const modelId = result.value?.model_id;
+  if (modelId === null) return "base";
+  return typeof modelId === "string" && modelId ? modelId : void 0;
 }
-function renderInit(value) {
-  printSuccess("Created local Tuned Tensor project");
-  printDetail([
-    ["Path", text(value.path)],
-    ["Name", text(value.name)],
-    ["ID", text(value.id)],
-    ["Base model", text(value.base_model)],
-    ["Config", text(value.config_path)]
-  ]);
+async function readLatestRun(storeRoot) {
+  const runsRoot = join2(storeRoot, "runs");
+  let names;
+  try {
+    names = (await readdir(runsRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  } catch {
+    return void 0;
+  }
+  const states = await Promise.all(names.map(async (name) => {
+    const result = await readJsonObject(join2(runsRoot, name, "state.json"));
+    if (!result.found || result.invalid || !result.value) return void 0;
+    const id = stringField(result.value, "id") ?? name;
+    const state = {
+      id,
+      status: stringField(result.value, "status"),
+      specName: stringField(result.value, "spec_name"),
+      updatedAt: stringField(result.value, "updated_at")
+    };
+    return state;
+  }));
+  return states.filter((state) => Boolean(state)).sort((left, right) => {
+    const leftUpdated = left.updatedAt ?? "";
+    const rightUpdated = right.updatedAt ?? "";
+    if (leftUpdated !== rightUpdated) {
+      return rightUpdated.localeCompare(leftUpdated);
+    }
+    return right.id.localeCompare(left.id);
+  })[0];
 }
-function renderValidate(value) {
-  printSuccess("Local behavior spec is valid");
-  printDetail([
-    ["Input", text(value.input_path)],
-    ["Config", text(value.config_path)],
-    ["Spec", text(value.behavior_spec_id)],
-    ["Base model", text(value.base_model)],
-    ["Dataset", text(value.dataset_format)],
-    ["Artifacts", text(value.artifact_root)],
-    ["Store", text(value.store_root)],
-    ["Dry run", text(value.dry_run)]
+async function discoverShellContext(options = {}) {
+  const env = options.env ?? process.env;
+  const cwd = resolve(options.cwd ?? process.cwd());
+  const homeDirectory = environmentHome(env);
+  const warnings = [];
+  const specPath = join2(cwd, "tunedtensor.json");
+  const specJson = await readJsonObject(specPath);
+  let spec;
+  if (specJson.found) {
+    if (specJson.invalid || !specJson.value) {
+      spec = { path: specPath, parseError: true };
+      warnings.push("tunedtensor.json could not be parsed.");
+    } else {
+      const examples = specJson.value.examples;
+      spec = {
+        path: specPath,
+        id: stringField(specJson.value, "id"),
+        name: stringField(specJson.value, "name"),
+        baseModel: stringField(specJson.value, "base_model"),
+        exampleCount: Array.isArray(examples) ? examples.length : void 0,
+        parseError: false
+      };
+    }
+  }
+  const localConfigPath = join2(cwd, "local-runner.json");
+  const hasAdjacentLocalConfig = await adjacentFile(localConfigPath);
+  const localConfigJson = hasAdjacentLocalConfig ? await readJsonObject(localConfigPath) : { found: false, invalid: false };
+  if (localConfigJson.invalid) {
+    warnings.push("local-runner.json could not be parsed.");
+  }
+  const localConfigDirectory = hasAdjacentLocalConfig ? dirname(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");
+  const storeRoot = configuredStoreRoot ? expandPath(configuredStoreRoot, localConfigDirectory, homeDirectory) : env.TT_LOCAL_HOME ? expandPath(env.TT_LOCAL_HOME, cwd, homeDirectory) : join2(homeDirectory, ".tuned-tensor-local");
+  const cloudPath = cloudConfigPath(env, homeDirectory);
+  const cloudConfigJson = await readJsonObject(cloudPath);
+  if (cloudConfigJson.invalid) {
+    warnings.push("The Tuned Tensor cloud config could not be parsed.");
+  }
+  const environmentApiKey = env.TUNED_TENSOR_API_KEY?.trim();
+  const storedApiKey = stringField(cloudConfigJson.value, "api_key");
+  const apiKey = environmentApiKey || storedApiKey;
+  const baseUrl = env.TUNED_TENSOR_URL?.trim() || stringField(cloudConfigJson.value, "base_url") || "https://tunedtensor.com";
+  const environmentTarget = targetFromEnvironment(env);
+  if (env.TT_TARGET && !environmentTarget) {
+    warnings.push(`Ignoring invalid TT_TARGET=${JSON.stringify(env.TT_TARGET)}; use cloud or local.`);
+  }
+  const inferredTarget = environmentTarget ?? (hasAdjacentLocalConfig ? "local" : "cloud");
+  const targetSource = environmentTarget ? "environment" : hasAdjacentLocalConfig ? "adjacent-config" : "default-cloud";
+  const [activeModelId, latestRun] = await Promise.all([
+    readActiveModelId(storeRoot),
+    readLatestRun(storeRoot)
   ]);
+  return {
+    cwd,
+    projectName: basename2(cwd) || cwd,
+    inferredTarget,
+    targetSource,
+    spec,
+    cloud: {
+      authenticated: Boolean(apiKey),
+      keyPrefix: redactApiKey(apiKey),
+      baseUrl,
+      configPath: cloudPath,
+      configFound: cloudConfigJson.found
+    },
+    local: {
+      configPath: hasAdjacentLocalConfig ? localConfigPath : void 0,
+      artifactRoot,
+      storeRoot,
+      activeModelId,
+      latestRun
+    },
+    warnings
+  };
 }
-function renderRun(value) {
-  const runStatus = text(value.status) ?? "unknown";
-  if (runStatus === "completed") {
-    printSuccess("Local run completed");
-  } else {
-    printWarning(`Local run finished with status ${runStatus}`);
+function valueOrDash(value) {
+  return value === void 0 || value === "" ? "\u2014" : String(value);
+}
+function targetSourceLabel(source) {
+  switch (source) {
+    case "environment":
+      return "TT_TARGET";
+    case "adjacent-config":
+      return "adjacent local-runner.json";
+    default:
+      return "default";
   }
-  const comparison = record(value.comparison);
-  printDetail([
-    ["Run", text(value.run_id)],
-    ["Status", status(runStatus)],
-    ["Model", text(value.model_id) ?? text(value.fine_tuned_model_id)],
-    ["Report", text(value.report_path)],
-    ["Artifacts", text(value.artifact_dir)],
-    ["Score delta", displayNumber(comparison?.avg_score_delta)],
-    ["Pass-rate delta", displayNumber(comparison?.pass_rate_delta)]
-  ]);
-  renderGate(value);
 }
-function renderRunsList(value) {
-  const runRows = rows(value);
-  if (runRows.length === 0) {
-    printWarning("No local runs found.");
-    return;
+function formatShellContext(context, selectedTarget, targetSource) {
+  const specLabel = context.spec ? context.spec.parseError ? `${context.spec.path} (invalid JSON)` : context.spec.path : "not found";
+  const sourceLabel = targetSource === "session" ? "session" : targetSource === "command-option" ? "--target" : targetSourceLabel(targetSource);
+  const lines = [
+    `Target         ${selectedTarget} (${sourceLabel})`,
+    `Project        ${context.projectName}`,
+    `Directory      ${context.cwd}`,
+    `Spec           ${specLabel}`,
+    `Spec ID        ${valueOrDash(context.spec?.id)}`,
+    `Base model     ${valueOrDash(context.spec?.baseModel)}`,
+    `Examples       ${valueOrDash(context.spec?.exampleCount)}`,
+    `Cloud endpoint ${context.cloud.baseUrl}`,
+    `Cloud auth     ${context.cloud.authenticated ? `yes (${context.cloud.keyPrefix})` : "no"}`,
+    `Local config   ${context.local.configPath ?? "not found"}`,
+    `Artifact root  ${context.local.artifactRoot}`,
+    `Store root     ${context.local.storeRoot}`
+  ];
+  for (const warning of context.warnings) lines.push(`Warning        ${warning}`);
+  return lines;
+}
+function formatShellStatus(context, selectedTarget) {
+  const lines = [
+    `Workflow       ${selectedTarget}`,
+    `Spec           ${context.spec?.name ?? (context.spec ? "unnamed" : "not found")}`
+  ];
+  if (selectedTarget === "cloud") {
+    lines.push(
+      `Authentication ${context.cloud.authenticated ? `ready (${context.cloud.keyPrefix})` : "not configured"}`,
+      `Endpoint       ${context.cloud.baseUrl}`,
+      "Remote status  not queried"
+    );
+  } else {
+    lines.push(
+      `Local config   ${context.local.configPath ?? "not found"}`,
+      `Active model   ${context.local.activeModelId ?? "base"}`,
+      `Latest run     ${context.local.latestRun ? `${context.local.latestRun.id} (${context.local.latestRun.status ?? "unknown"})` : "none"}`,
+      "Host checks    not run (use doctor)"
+    );
   }
-  printTable(
-    ["Run", "Spec", "Status", "Stage", "Model", "Updated"],
-    runRows.map((run) => [
-      displayId(run.id),
-      truncate(text(run.spec_name) ?? displayId(run.behavior_spec_id), 28),
-      status(run.status),
-      text(run.current_stage) ?? "\u2014",
-      displayId(run.model_id),
-      formatDate(text(run.updated_at))
-    ])
-  );
+  return lines;
 }
-function renderRunEvents(value) {
-  const eventRows = rows(value);
-  if (eventRows.length === 0) {
-    printWarning("No local run events found.");
-    return;
+
+// src/shell.ts
+var AGENT_SLASH_COMMANDS = /* @__PURE__ */ new Set([
+  "new",
+  "threads",
+  "resume",
+  "approve",
+  "reject"
+]);
+var ShellParseError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ShellParseError";
   }
-  printTable(
-    ["Time", "Stage", "Status", "Message"],
-    eventRows.map((event) => [
-      formatDate(text(event.occurred_at)),
-      text(event.stage) ?? "\u2014",
-      status(event.status),
-      truncate(text(event.message) ?? "\u2014", 80)
-    ])
+};
+function operatorError(operator) {
+  return new ShellParseError(
+    `Shell operator ${JSON.stringify(operator)} is not supported. Run TT commands directly; pipes, redirects, and command substitution are disabled.`
   );
 }
-function renderRunRecord(value) {
-  printDetail([
-    ["Run", text(value.id) ?? text(value.run_id)],
-    ["Spec", text(value.spec_name) ?? text(value.behavior_spec_id)],
-    ["Status", status(value.status)],
-    ["Stage", text(value.current_stage)],
-    ["Model", text(value.model_id) ?? text(value.fine_tuned_model_id)],
-    ["Base model", text(value.base_model)],
-    ["Report", text(value.report_path)],
-    ["Artifacts", text(value.artifact_dir)],
-    ["Updated", formatDate(text(value.updated_at) ?? text(value.created_at))]
-  ]);
-}
-function renderRunReport(value) {
-  const baseline = record(value.baseline);
-  const candidate = record(value.candidate);
-  const comparison = record(value.comparison);
-  const metadata = record(value.run_metadata);
-  printDetail([
-    ["Run", text(value.run_id)],
-    ["Status", status(value.status)],
-    ["Base model", text(value.base_model)],
-    ["Tuned model", text(value.fine_tuned_model_id)],
-    ["Training examples", text(metadata?.training_example_count)],
-    ["Evaluation examples", text(metadata?.eval_examples_used)],
-    ["Baseline score", displayNumber(baseline?.avg_score)],
-    ["Candidate score", displayNumber(candidate?.avg_score)],
-    ["Score delta", displayNumber(comparison?.avg_score_delta)],
-    ["Pass-rate delta", displayNumber(comparison?.pass_rate_delta)],
-    ["Regressions", text(comparison?.regressions)],
-    ["Improvements", text(comparison?.improvements)]
-  ]);
-  renderGate(value);
-}
-function renderRunComparison(value) {
-  const runA = record(value.run_a);
-  const runB = record(value.run_b);
-  const shared = record(value.shared);
-  const sharedA = record(shared?.run_a);
-  const sharedB = record(shared?.run_b);
-  printTable(
-    ["Run", "Candidate score", "Token F1", "Examples"],
-    [
-      [
-        displayId(runA?.run_id),
-        displayNumber(sharedA?.candidate_avg_score) ?? "\u2014",
-        displayNumber(sharedA?.candidate_avg_token_f1) ?? "\u2014",
-        text(shared?.examples) ?? "0"
-      ],
-      [
-        displayId(runB?.run_id),
-        displayNumber(sharedB?.candidate_avg_score) ?? "\u2014",
-        displayNumber(sharedB?.candidate_avg_token_f1) ?? "\u2014",
-        text(shared?.examples) ?? "0"
-      ]
-    ]
-  );
-  const notes = Array.isArray(value.notes) ? value.notes.filter((note) => typeof note === "string") : [];
-  for (const note of notes) printWarning(note);
-}
-function renderModelsList(value) {
-  const modelRows = rows(value);
-  if (modelRows.length === 0) {
-    printWarning("No local models found.");
-    return;
-  }
-  printTable(
-    ["Model", "Base model", "Run", "Provider", "Created"],
-    modelRows.map((model) => [
-      displayId(model.id),
-      truncate(text(model.base_model) ?? "\u2014", 32),
-      displayId(model.run_id),
-      text(model.provider) ?? "\u2014",
-      formatDate(text(model.created_at))
-    ])
-  );
-}
-function renderModelRecord(value) {
-  const model = record(value.model) ?? value;
-  const artifact = record(value.artifact);
-  const integrity = record(value.integrity);
-  printDetail([
-    ["Model", text(model.id) ?? text(value.active)],
-    ["Base model", text(model.base_model)],
-    ["Run", text(model.run_id)],
-    ["Provider", text(model.provider)],
-    ["Artifact", text(model.artifact_uri) ?? text(artifact?.path)],
-    ["Manifest", text(value.manifest_path)],
-    ["Verified files", text(integrity?.checked)],
-    ["Created", formatDate(text(model.created_at))]
-  ]);
-}
-function renderModelPrefetch(value) {
-  printSuccess(
-    value.local_files_only === true ? "Verified the local base-model snapshot" : "Base model is ready locally"
-  );
-  printDetail([
-    ["Base model", text(value.base_model)],
-    ["Revision", text(value.snapshot_revision)],
-    ["Snapshot", text(value.snapshot_path)],
-    ["Files", text(value.file_count)],
-    ["Size", displayBytes(value.size_bytes)],
-    ["Cache", text(value.model_cache) ?? text(value.hf_home)]
-  ]);
-}
-function renderActiveModel(value) {
-  const active = text(value.active) ?? "base";
-  const pointer = record(value.pointer);
-  if (pointer?.action === "activate") {
-    printSuccess(`Activated local model ${active}`);
-  } else if (pointer?.action === "rollback") {
-    printSuccess(`Rolled back to ${active}`);
-  }
-  printDetail([
-    ["Active", active],
-    ["Run", text(pointer?.run_id)],
-    ["Previous", text(pointer?.previous_model_id) ?? "base"],
-    ["Changed", formatDate(text(pointer?.activated_at))],
-    ["Manifest", text(value.manifest_path)]
-  ]);
-}
-function renderServePlan(value) {
-  printSuccess("Local serving plan is valid");
-  printDetail([
-    ["Model", text(value.model_id) ?? text(value.base_model)],
-    ["URL", text(value.url)],
-    ["Artifact", text(value.artifact_path)],
-    ["Manifest", text(value.manifest_path)],
-    ["Command", displayCommand(value.command)]
-  ]);
-}
-function renderKnownJson(args, value) {
-  const command = args[0];
-  const subcommand = args[1];
-  if (command === "doctor" && isRecord(value)) {
-    renderDoctor(value);
-    return true;
-  }
-  if (command === "init" && isRecord(value)) {
-    renderInit(value);
-    return true;
+function tokenizeShellInput(input) {
+  if (input.includes("\0")) {
+    throw new ShellParseError("Command input must not contain NUL bytes.");
   }
-  if (command === "validate" && isRecord(value)) {
-    renderValidate(value);
-    return true;
+  if (/[\r\n]/.test(input)) {
+    throw new ShellParseError("Enter one command at a time.");
   }
-  if (command === "run" && isRecord(value)) {
-    renderRun(value);
-    return true;
+  if (input.trimStart().startsWith("!")) {
+    throw new ShellParseError("Shell escapes are disabled; enter a TT command instead.");
   }
-  if (command === "runs") {
-    if ((subcommand === void 0 || subcommand === "list") && Array.isArray(value)) {
-      renderRunsList(value);
-      return true;
-    }
-    if (subcommand === "events" && Array.isArray(value)) {
-      renderRunEvents(value);
-      return true;
+  const tokens = [];
+  let token = "";
+  let tokenStarted = false;
+  let quote = "none";
+  const finishToken = () => {
+    if (!tokenStarted) return;
+    tokens.push(token);
+    token = "";
+    tokenStarted = false;
+  };
+  for (let index = 0; index < input.length; index += 1) {
+    const character = input[index];
+    if (quote === "single") {
+      if (character === "'") {
+        quote = "none";
+      } else {
+        token += character;
+      }
+      continue;
     }
-    if (subcommand === "get" && isRecord(value)) {
-      renderRunRecord(value);
-      return true;
+    if (quote === "double") {
+      if (character === '"') {
+        quote = "none";
+        continue;
+      }
+      if (character === "\\") {
+        const escaped = input[index + 1];
+        if (escaped === void 0) {
+          throw new ShellParseError("Command ends with an unfinished escape.");
+        }
+        token += escaped;
+        tokenStarted = true;
+        index += 1;
+        continue;
+      }
+      if (character === "`") throw operatorError("`\u2026`");
+      if (character === "$" && input[index + 1] === "(") {
+        throw operatorError("$(\u2026)");
+      }
+      token += character;
+      tokenStarted = true;
+      continue;
     }
-    if (subcommand === "report" && isRecord(value)) {
-      renderRunReport(value);
-      return true;
+    if (/\s/.test(character)) {
+      finishToken();
+      continue;
     }
-    if (subcommand === "compare" && isRecord(value)) {
-      renderRunComparison(value);
-      return true;
+    if (character === "'") {
+      quote = "single";
+      tokenStarted = true;
+      continue;
     }
-  }
-  if (command === "models") {
-    if ((subcommand === void 0 || subcommand === "list") && Array.isArray(value)) {
-      renderModelsList(value);
-      return true;
+    if (character === '"') {
+      quote = "double";
+      tokenStarted = true;
+      continue;
     }
-    if ((subcommand === "get" || subcommand === "verify") && isRecord(value)) {
-      if (subcommand === "verify") printSuccess("Local model artifact is valid");
-      renderModelRecord(value);
-      return true;
+    if (character === "\\") {
+      const escaped = input[index + 1];
+      if (escaped === void 0) {
+        throw new ShellParseError("Command ends with an unfinished escape.");
+      }
+      token += escaped;
+      tokenStarted = true;
+      index += 1;
+      continue;
     }
-    if ((subcommand === "prefetch" || subcommand === "verify-base") && isRecord(value)) {
-      renderModelPrefetch(value);
-      return true;
+    if (character === "`") throw operatorError("`\u2026`");
+    if (character === "$" && input[index + 1] === "(") {
+      throw operatorError("$(\u2026)");
     }
-    if (["active", "activate", "rollback"].includes(subcommand ?? "") && isRecord(value)) {
-      renderActiveModel(value);
-      return true;
+    if (character === "|" || character === ">" || character === "<" || character === ";" || character === "&") {
+      const doubled = input[index + 1] === character && (character === "|" || character === "&");
+      throw operatorError(doubled ? character.repeat(2) : character);
     }
-    if (subcommand === "serve" && isRecord(value)) {
-      renderServePlan(value);
-      return true;
+    token += character;
+    tokenStarted = true;
+  }
+  if (quote !== "none") {
+    throw new ShellParseError(
+      `Command has an unterminated ${quote === "single" ? "single" : "double"} quote.`
+    );
+  }
+  finishToken();
+  return tokens;
+}
+function routeShellCommand(input, activeMode) {
+  let args = tokenizeShellInput(input);
+  if (args.length === 0) return null;
+  if (args[0] === "tt") {
+    args = args.slice(1);
+    if (args.length === 0) {
+      throw new ShellParseError("The TT shell is already open; enter a command such as `runs list`.");
     }
   }
-  if (command === "serve" && isRecord(value)) {
-    renderServePlan(value);
-    return true;
+  if (args[0]?.startsWith("/")) {
+    throw new ShellParseError("Slash commands are session commands and cannot be routed to a workflow.");
   }
-  return false;
+  const override = args[0];
+  if (override === "cloud" || override === "local") {
+    if (args.length === 1) {
+      throw new ShellParseError(`Add a ${override} command, or use \`/mode ${override}\` to switch workflows.`);
+    }
+    return { target: override, args: args.slice(1) };
+  }
+  return { target: activeMode, args };
 }
-function lastNonEmptyLine(value) {
-  return value.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).at(-1);
+function isCatalogCommand(mode, args) {
+  if (args.length === 0) return false;
+  if (args[0] === "status") {
+    return args.length === 1 || args[1]?.startsWith("-") === true;
+  }
+  return COMMAND_CATALOG.some((command) => {
+    if (!command.modes.includes(mode)) return false;
+    const path = command.path.split(" ");
+    return path.every((token, index) => args[index] === token);
+  });
 }
-function adaptLocalCliText(value) {
-  return value.replace(
-    /(?<![.@/\w])tuned-tensor-local(?=$|[\s:`\]])/g,
-    "tt local"
-  ).replace(/(?<![.@/\w])tt-local(?=$|[\s:`\]])/g, "tt local");
+function hasCatalogIntent(input, activeMode) {
+  let args = input.trim().split(/\s+/);
+  if (args[0] === "tt") args = args.slice(1);
+  const override = args[0];
+  const mode = override === "cloud" || override === "local" ? override : activeMode;
+  if (override === "cloud" || override === "local") args = args.slice(1);
+  return isCatalogCommand(mode, args);
 }
-function localCliErrorEnvelope(payload) {
-  const rawMessage = payload.errorMessage ?? (payload.stderr.trim() || void 0) ?? lastNonEmptyLine(payload.stdout) ?? `tt local exited with code ${payload.exitCode}.`;
-  return {
-    error: {
-      status: null,
-      code: "LOCAL_CLI_ERROR",
-      message: adaptLocalCliText(rawMessage),
-      exit_code: payload.exitCode,
-      signal: payload.signal
-    }
-  };
-}
-function localCliTextEnvelope(payload) {
-  const output = adaptLocalCliText(payload.stdout).trim();
-  if (payload.args[0] === "info") {
-    const lines = output.split(/\r?\n/);
-    const heading = lines[0]?.match(/^([^:]+):\s*(.+)$/);
-    const fields = Object.fromEntries(
-      lines.slice(1).flatMap((line) => {
-        const match = line.match(/^([^:]+):\s*(.*)$/);
-        return match ? [[match[1].trim().toLowerCase().replaceAll(" ", "_"), match[2].trim()]] : [];
-      })
-    );
-    if (heading) {
-      return {
-        data: {
-          name: heading[1],
-          description: heading[2],
-          ...fields
-        }
-      };
+var SLASH_NAMES = /* @__PURE__ */ new Set([
+  "help",
+  "status",
+  "context",
+  "mode",
+  "model",
+  "clear",
+  "cd",
+  "exit"
+]);
+var WORKFLOW_ROOT_COMMANDS = new Set(
+  COMMAND_CATALOG.map((command) => command.path.split(" ", 1)[0])
+);
+function editDistance(left, right) {
+  const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+  for (let i = 1; i <= left.length; i += 1) {
+    let diagonal = previous[0];
+    previous[0] = i;
+    for (let j = 1; j <= right.length; j += 1) {
+      const above = previous[j];
+      previous[j] = Math.min(
+        previous[j] + 1,
+        previous[j - 1] + 1,
+        diagonal + (left[i - 1] === right[j - 1] ? 0 : 1)
+      );
+      diagonal = above;
     }
   }
-  return { data: { output } };
+  return previous[right.length];
 }
-function renderLocalOutput(payload, options = {}) {
-  if (payload.streamingStdout && payload.exitCode === 0 && !payload.errorMessage) {
-    return;
-  }
-  const output = options.stdout ?? process.stdout;
-  if (options.jsonMode) {
-    if (payload.hasJson) {
-      output.write(payload.stdout);
-      return;
-    }
-    if (payload.exitCode !== 0 || payload.errorMessage) {
-      output.write(`${JSON.stringify(localCliErrorEnvelope(payload), null, 2)}
-`);
-      return;
-    }
-    output.write(`${JSON.stringify(localCliTextEnvelope(payload), null, 2)}
-`);
-    return;
-  }
-  if (payload.droppedSpecKeys.length > 0) {
-    printWarning(
-      `Ignored project field(s) unsupported by the local runtime: ${payload.droppedSpecKeys.join(", ")}.`
+function suggestSlashCommands(rawName) {
+  const names = [...SLASH_NAMES].sort();
+  const prefixMatches = names.filter((name) => name.startsWith(rawName));
+  if (prefixMatches.length > 0) return prefixMatches;
+  return names.filter((name) => editDistance(name, rawName) <= 2);
+}
+function unknownSlashCommandError(rawName) {
+  if (WORKFLOW_ROOT_COMMANDS.has(rawName)) {
+    return new ShellParseError(
+      `Unknown session command: /${rawName}. Workflow commands need no slash \u2014 try "${rawName} --help".`
     );
   }
-  if (payload.hasJson && renderKnownJson(payload.args, payload.json)) return;
-  if (payload.hasJson) {
-    printJson(payload.json);
-    return;
+  const suggestions = suggestSlashCommands(rawName);
+  const hint = suggestions.length > 0 ? ` Did you mean ${suggestions.map((name) => `/${name}`).join(" or ")}?` : "";
+  return new ShellParseError(
+    `Unknown session command: /${rawName}.${hint} Use /help to see available commands.`
+  );
+}
+function parseSlashCommand(input) {
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+  if (trimmed === "?") return { name: "help", args: [] };
+  if (trimmed.startsWith("? ")) {
+    return {
+      name: "help",
+      args: tokenizeShellInput(trimmed.slice(1))
+    };
   }
-  if (payload.stdout) output.write(adaptLocalCliText(payload.stdout));
-  if (payload.exitCode !== 0 && !payload.stderr && !payload.stdout) {
-    printError(
-      payload.errorMessage ? adaptLocalCliText(payload.errorMessage) : `tt local exited with code ${payload.exitCode}.`
-    );
+  if (!trimmed.startsWith("/")) return null;
+  if (trimmed === "/") return { name: "palette", args: [] };
+  const tokens = tokenizeShellInput(trimmed);
+  const rawName = tokens[0].slice(1).toLowerCase();
+  if (!SLASH_NAMES.has(rawName)) {
+    throw unknownSlashCommandError(rawName);
   }
+  return {
+    name: rawName,
+    args: tokens.slice(1)
+  };
 }
-
-// src/local-runner.ts
-var localRequire = createRequire(import.meta.url);
-var DEFAULT_SPEC_NAME = "tunedtensor.json";
-var VALUE_OPTIONS = /* @__PURE__ */ new Set([
-  "--config",
-  "--name",
-  "--model",
-  "--output",
-  "--profile",
-  "--host",
-  "--port",
-  "--device",
-  "--max-tokens",
-  "--temperature",
-  "--top-p",
-  "--max-concurrent-requests",
-  "--spec",
-  "--api-key-env"
-]);
-function isOptionWithInlineValue(value) {
-  const equals = value.indexOf("=");
-  return equals !== -1 && VALUE_OPTIONS.has(value.slice(0, equals));
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
 }
-function positionalIndices(args, start) {
-  const indices = [];
-  let optionsEnded = false;
-  for (let index = start; index < args.length; index += 1) {
-    const value = args[index];
-    if (!optionsEnded && value === "--") {
-      optionsEnded = true;
-      continue;
-    }
-    if (!optionsEnded && value.startsWith("-")) {
-      if (!isOptionWithInlineValue(value) && VALUE_OPTIONS.has(value)) index += 1;
-      continue;
-    }
-    indices.push(index);
-  }
-  return indices;
+var successMark = () => chalk.green("\u2713");
+var errorMark = () => chalk.red("\u2717");
+var accent = chalk.hex("#8B5CF6");
+var DETAIL_LABEL_WIDTH = 15;
+function styleDetailLines(lines) {
+  return lines.map((line) => {
+    if (line.length <= DETAIL_LABEL_WIDTH) return line;
+    const label = line.slice(0, DETAIL_LABEL_WIDTH);
+    if (!label.trim()) return line;
+    const color = label.startsWith("Warning") ? chalk.yellow : accent.bold;
+    return `${color(label)}${line.slice(DETAIL_LABEL_WIDTH)}`;
+  });
 }
-function optionValueArgument(args, name) {
-  for (let index = 0; index < args.length; index += 1) {
-    const value = args[index];
-    if (value === name) {
-      const path = args[index + 1];
-      if (!path) return null;
-      return {
-        path,
-        replace(projectedPath) {
-          args[index + 1] = projectedPath;
-        }
-      };
-    }
-    if (value.startsWith(`${name}=`)) {
-      const path = value.slice(name.length + 1);
-      if (!path) return null;
-      return {
-        path,
-        replace(projectedPath) {
-          args[index] = `${name}=${projectedPath}`;
-        }
-      };
-    }
+function detailLine(label, value) {
+  return `${label.padEnd(DETAIL_LABEL_WIDTH)}${value}`;
+}
+function assertNoArgs(command, args) {
+  if (args.length > 0) {
+    throw new ShellParseError(`/${command} does not accept arguments.`);
   }
-  return null;
 }
-function positionalSpecArgument(args, start, defaultPath) {
-  const positional = positionalIndices(args, start)[0];
-  if (positional !== void 0) {
-    return {
-      path: args[positional],
-      replace(projectedPath) {
-        args[positional] = projectedPath;
+function expandDirectory(value, cwd, env) {
+  const home = env.HOME ? resolve2(env.HOME) : homedir3();
+  if (value === "~") return home;
+  if (value.startsWith("~/")) return resolve2(home, value.slice(2));
+  return isAbsolute2(value) ? resolve2(value) : resolve2(cwd, value);
+}
+function helpText(mode, query, palette = false) {
+  const groups = groupedCatalog(mode, query);
+  const lines = [];
+  lines.push(accent.bold(palette ? `Commands for ${mode} \u2014 type a command or use cloud/local as a one-shot prefix` : `TT ${mode} commands${query ? ` matching ${JSON.stringify(query)}` : ""}`));
+  if (groups.size === 0) {
+    lines.push(chalk.dim("  No matching commands."));
+  } else {
+    for (const [group, commands] of groups) {
+      lines.push("");
+      lines.push(chalk.bold(group));
+      for (const command of commands) {
+        lines.push(`  ${accent(command.path.padEnd(22))} ${command.description}`);
       }
-    };
-  }
-  return {
-    path: defaultPath,
-    replace(projectedPath) {
-      args.splice(start, 0, projectedPath);
     }
-  };
-}
-function selectedSpecArgument(args, cwd) {
-  const command = args[0];
-  if (["doctor", "validate", "run"].includes(command ?? "")) {
-    return positionalSpecArgument(args, 1, join2(cwd, DEFAULT_SPEC_NAME));
   }
-  if (command === "models" && ["prefetch", "verify-base"].includes(args[1] ?? "")) {
-    return positionalSpecArgument(args, 2, join2(cwd, DEFAULT_SPEC_NAME));
+  if (!query) {
+    lines.push("");
+    lines.push(chalk.bold("Conversation"));
+    lines.push(`  ${accent("plain text".padEnd(22))} Ask the Tuned Tensor agent anything.`);
+    lines.push(`  ${accent("/new".padEnd(22))} Start a new agent conversation.`);
+    lines.push(`  ${accent("/threads".padEnd(22))} List recent conversations.`);
+    lines.push(`  ${accent("/resume <id>".padEnd(22))} Resume a conversation.`);
+    lines.push(`  ${accent("/approve [id]".padEnd(22))} Approve a proposed action.`);
+    lines.push(`  ${accent("/reject [id]".padEnd(22))} Reject a proposed action.`);
+    lines.push("");
+    lines.push(chalk.bold("Session"));
+    for (const command of SLASH_COMMANDS) {
+      lines.push(`  ${accent(command.path.padEnd(22))} ${command.description}`);
+    }
+    lines.push(`  ${accent("?".padEnd(22))} Alias for /help.`);
+    lines.push(chalk.dim(
+      "\nKnown TT commands execute directly; other text goes to the agent. Prefix a command with : to make the intent explicit."
+    ));
   }
-  const serves = command === "serve" || command === "models" && args[1] === "serve";
-  if (!serves) return null;
-  const explicit = optionValueArgument(args, "--spec");
-  if (explicit) return explicit;
-  return null;
+  return `${lines.join("\n")}
+`;
 }
-async function pathIsFile(path) {
-  return (await stat(path).catch(() => null))?.isFile() ?? false;
+function activeModelLabel(snapshot) {
+  return snapshot.mode === "local" ? snapshot.context.local.activeModelId ?? "base" : snapshot.context.spec?.baseModel ?? "\u2014";
 }
-function resolveFromCwd(path, cwd) {
-  if (isAbsolute(path)) return path;
-  return resolve(cwd, path);
+function logoRows() {
+  const muted = chalk.dim("\u2588\u2588");
+  return [
+    `${chalk.hex("#A78BFA")("\u2588\u2588")} ${muted} ${muted}`,
+    `${muted} ${accent("\u2588\u2588")} ${muted}`,
+    `${muted} ${muted} ${chalk.hex("#7C3AED")("\u2588\u2588")}`
+  ];
 }
-async function projectSpecArguments(originalArgs, cwd) {
-  const args = [...originalArgs];
-  if (args.includes("--help") || args.includes("-h")) {
-    return {
-      args,
-      droppedSpecKeys: [],
-      pathReplacements: [],
-      cleanup: async () => {
-      }
-    };
+function renderShellBanner(snapshot) {
+  const spec = snapshot.context.spec?.name ?? snapshot.context.spec?.path ?? "no spec";
+  const heading = snapshot.version ? `${accent.bold("Tuned Tensor")} ${chalk.dim(`v${snapshot.version}`)}` : accent.bold("Tuned Tensor");
+  const textRows = [
+    heading,
+    `${chalk.bold(snapshot.mode)} \xB7 ${snapshot.context.projectName} \xB7 ${spec} \xB7 model ${activeModelLabel(snapshot)}`,
+    chalk.dim("Ask TT anything \xB7 known commands run directly \xB7 /help for more")
+  ];
+  const logo = logoRows();
+  const lines = textRows.map((row, index) => `${logo[index]}  ${row}`);
+  return `${lines.join("\n")}
+
+`;
+}
+function renderShellPrompt(snapshot) {
+  return `${accent("tt")} ${chalk.bold(snapshot.mode)} ${chalk.dim(snapshot.context.projectName)} \u203A `;
+}
+var TunedTensorShellSession = class _TunedTensorShellSession {
+  constructor(runner, io, agent, env, contextProvider, version, initialContext) {
+    this.runner = runner;
+    this.io = io;
+    this.agent = agent;
+    this.env = env;
+    this.contextProvider = contextProvider;
+    this.version = version;
+    this.mode = initialContext.inferredTarget;
+    this.modeSource = initialContext.targetSource;
+    this.cwd = initialContext.cwd;
+    this.context = initialContext;
   }
-  const selected = selectedSpecArgument(args, cwd);
-  if (!selected) {
-    return {
-      args,
-      droppedSpecKeys: [],
-      pathReplacements: [],
-      cleanup: async () => {
-      }
-    };
+  mode;
+  modeSource;
+  cwd;
+  context;
+  static async create(options) {
+    const env = options.env ?? process.env;
+    const cwd = resolve2(options.cwd ?? process.cwd());
+    const contextProvider = options.contextProvider ?? ((input) => discoverShellContext(input));
+    const initialContext = await contextProvider({ cwd, env });
+    return new _TunedTensorShellSession(
+      options.runner,
+      options.io,
+      options.agent,
+      env,
+      contextProvider,
+      options.version,
+      initialContext
+    );
   }
-  const sourcePath = resolveFromCwd(selected.path, cwd);
-  if (!await pathIsFile(sourcePath)) {
+  interruptAgent() {
+    return this.agent?.interrupt() ?? false;
+  }
+  snapshot() {
     return {
-      args,
-      droppedSpecKeys: [],
-      pathReplacements: [],
-      cleanup: async () => {
-      }
+      mode: this.mode,
+      modeSource: this.modeSource,
+      cwd: this.cwd,
+      context: this.context,
+      version: this.version
     };
   }
-  const raw = JSON.parse(await readFile(sourcePath, "utf8"));
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    throw new Error(`${sourcePath} must contain a JSON object.`);
-  }
-  const body = raw;
-  const runRequestKeys = [
-    "run_id",
-    "behavior_spec_id",
-    "run_number",
-    "spec_snapshot"
-  ].filter((key) => key in body);
-  if ("spec_snapshot" in body || runRequestKeys.length >= 2) {
-    return {
-      args,
-      droppedSpecKeys: [],
-      pathReplacements: [],
-      cleanup: async () => {
-      }
-    };
+  prompt() {
+    return renderShellPrompt(this.snapshot());
   }
-  const projected = projectLocalSpec(body);
-  if (projected.droppedKeys.length === 0) {
-    return {
-      args,
-      droppedSpecKeys: [],
-      pathReplacements: [],
-      cleanup: async () => {
+  banner() {
+    return renderShellBanner(this.snapshot());
+  }
+  async refreshContext() {
+    this.context = await this.contextProvider({ cwd: this.cwd, env: this.env });
+    this.cwd = this.context.cwd;
+    if (this.modeSource !== "session" && this.modeSource !== "environment") {
+      this.mode = this.context.inferredTarget;
+      this.modeSource = this.context.targetSource;
+    }
+  }
+  writeLines(lines) {
+    this.io.write(`${lines.join("\n")}
+`);
+  }
+  modelLines() {
+    if (this.mode === "local") {
+      return styleDetailLines([
+        detailLine("Active model", this.context.local.activeModelId ?? "base"),
+        detailLine("Change", "/model <id> to activate a verified local model")
+      ]);
+    }
+    return styleDetailLines([
+      detailLine("Base model", this.context.spec?.baseModel ?? "\u2014"),
+      detailLine("Change", "edit base_model in tunedtensor.json, then run push")
+    ]);
+  }
+  async handleSlash(command) {
+    switch (command.name) {
+      case "palette":
+        this.io.write(helpText(this.mode, void 0, true));
+        return "continue";
+      case "help":
+        this.io.write(helpText(this.mode, command.args.join(" ") || void 0));
+        return "continue";
+      case "status":
+        assertNoArgs("status", command.args);
+        await this.refreshContext();
+        this.writeLines(styleDetailLines(formatShellStatus(this.context, this.mode)));
+        return "continue";
+      case "context":
+        assertNoArgs("context", command.args);
+        await this.refreshContext();
+        this.writeLines(styleDetailLines(
+          formatShellContext(this.context, this.mode, this.modeSource)
+        ));
+        return "continue";
+      case "mode": {
+        if (command.args.length === 0) {
+          this.io.write(`Current workflow: ${this.mode}
+`);
+          return "continue";
+        }
+        if (command.args.length !== 1 || !["cloud", "local"].includes(command.args[0])) {
+          throw new ShellParseError("Usage: /mode cloud|local");
+        }
+        this.mode = command.args[0];
+        this.modeSource = "session";
+        this.io.write(`${successMark()} Workflow switched to ${this.mode}.
+`);
+        return "continue";
       }
-    };
+      case "model": {
+        if (command.args.length === 0) {
+          await this.refreshContext();
+          this.writeLines(this.modelLines());
+          return "continue";
+        }
+        if (command.args.length !== 1) {
+          throw new ShellParseError("Usage: /model [model-id]");
+        }
+        if (this.mode !== "local") {
+          throw new ShellParseError(
+            "Activating models is a local workflow action. Use /mode local first; cloud specs change base_model in tunedtensor.json."
+          );
+        }
+        await this.runner({
+          target: "local",
+          args: ["models", "activate", command.args[0]],
+          cwd: this.cwd
+        });
+        await this.refreshContext();
+        return "continue";
+      }
+      case "clear":
+        assertNoArgs("clear", command.args);
+        this.io.clear();
+        return "continue";
+      case "cd": {
+        if (command.args.length === 0) {
+          this.io.write(`${this.cwd}
+`);
+          return "continue";
+        }
+        if (command.args.length !== 1) {
+          throw new ShellParseError("Usage: /cd <directory>; quote paths containing spaces.");
+        }
+        const nextDirectory = expandDirectory(command.args[0], this.cwd, this.env);
+        const metadata = await stat2(nextDirectory).catch(() => null);
+        if (!metadata?.isDirectory()) {
+          throw new ShellParseError(`Not a directory: ${nextDirectory}`);
+        }
+        this.cwd = nextDirectory;
+        await this.refreshContext();
+        this.io.write(`${successMark()} Directory: ${this.cwd}
+`);
+        return "continue";
+      }
+      case "exit":
+        assertNoArgs("exit", command.args);
+        return "exit";
+    }
   }
-  const temporaryPath = join2(
-    dirname(sourcePath),
-    `.${basename2(sourcePath)}.tt-local-${process.pid}-${randomUUID()}.json`
-  );
-  await writeFile(
-    temporaryPath,
-    `${JSON.stringify(projected.body, null, 2)}
-`,
-    { encoding: "utf8", flag: "wx", mode: 384 }
-  );
-  selected.replace(temporaryPath);
-  return {
-    args,
-    droppedSpecKeys: projected.droppedKeys,
-    pathReplacements: [{
-      sourcePath,
-      projectedPath: temporaryPath
-    }],
-    cleanup: () => rm(temporaryPath, { force: true })
-  };
-}
-function resolveLocalCliEntrypoint() {
-  try {
-    return localRequire.resolve("@tuned-tensor/local");
-  } catch (error) {
-    throw new Error(
-      "TT Local is not installed. Reinstall @tuned-tensor/cli with its local runtime dependency.",
-      { cause: error }
-    );
+  async handleLine(input) {
+    try {
+      if (/^(exit|quit)$/i.test(input.trim())) return "exit";
+      const trimmed = input.trim();
+      if (trimmed.startsWith("/")) {
+        const rawName = trimmed.slice(1).split(/\s+/, 1)[0].toLowerCase();
+        if (AGENT_SLASH_COMMANDS.has(rawName)) {
+          if (!this.agent) {
+            throw new ShellParseError("The conversational agent is unavailable.");
+          }
+          await this.agent.handleLine(trimmed);
+          await this.refreshContext();
+          return "continue";
+        }
+      }
+      const slash = parseSlashCommand(input);
+      if (slash) return await this.handleSlash(slash);
+      const explicitCommand = trimmed.startsWith(":") ? trimmed.slice(1).trimStart() : null;
+      if (explicitCommand !== null && !explicitCommand) {
+        throw new ShellParseError("Add a TT command after :.");
+      }
+      const explicitWorkflowPrefix = /^(?:tt\s+)?(?:cloud|local)(?:\s|$)/.test(trimmed) || /^tt(?:\s|$)/.test(trimmed);
+      if (explicitCommand === null && !explicitWorkflowPrefix && this.agent && !hasCatalogIntent(input, this.mode)) {
+        await this.agent.handleLine(input);
+        await this.refreshContext();
+        return "continue";
+      }
+      const commandInput = explicitCommand ?? input;
+      const routed = routeShellCommand(commandInput, this.mode);
+      if (!routed) return "continue";
+      await this.runner({
+        target: routed.target,
+        args: [...routed.args],
+        cwd: this.cwd
+      });
+      await this.refreshContext();
+      return "continue";
+    } catch (error) {
+      this.io.writeError(`${errorMark()} ${errorMessage(error)}
+`);
+      return "continue";
+    }
   }
+};
+async function createShellSession(options) {
+  return TunedTensorShellSession.create(options);
 }
-function localCommandStreamsStdout(args) {
-  const serves = args[0] === "serve" || args[0] === "models" && args[1] === "serve";
-  return serves && !args.includes("--print-command") && !args.includes("--help") && !args.includes("-h");
+function streamIsTTY(stream) {
+  return Boolean(stream.isTTY);
 }
-function parseJsonOutput(stdout2) {
-  if (!stdout2.trim()) return { hasJson: false, json: void 0 };
+async function withForegroundSignalHandoff(control, run) {
+  const signals = control.signals ?? process;
+  const restoreRawMode = control.input.isRaw === true && typeof control.input.setRawMode === "function";
+  const keepParentAlive = () => {
+  };
+  control.pauseReadline();
+  if (restoreRawMode) control.input.setRawMode(false);
+  signals.on("SIGINT", keepParentAlive);
   try {
-    return { hasJson: true, json: JSON.parse(stdout2) };
-  } catch {
-    return { hasJson: false, json: void 0 };
+    return await run();
+  } finally {
+    signals.off("SIGINT", keepParentAlive);
+    if (restoreRawMode) control.input.setRawMode(true);
+    control.resumeReadline();
   }
 }
-function signalExitCode(signal) {
-  if (!signal) return 1;
-  const signalNumber = osConstants.signals[signal];
-  return typeof signalNumber === "number" ? 128 + signalNumber : 1;
-}
-function writeStream(stream, chunk) {
-  stream.write(chunk);
+function streamIO(output, error) {
+  return {
+    write(text2) {
+      output.write(text2);
+    },
+    writeError(text2) {
+      error.write(text2);
+    },
+    clear() {
+      output.write("\x1B[2J\x1B[H");
+    }
+  };
 }
-function normalizeProjectedPaths(value, replacements) {
-  let normalized = value;
-  for (const replacement of replacements) {
-    const encodedProjectedPath = JSON.stringify(
-      replacement.projectedPath
-    ).slice(1, -1);
-    const encodedSourcePath = JSON.stringify(
-      replacement.sourcePath
-    ).slice(1, -1);
-    normalized = normalized.replaceAll(encodedProjectedPath, encodedSourcePath).replaceAll(replacement.projectedPath, replacement.sourcePath);
+async function startInteractiveShell(options) {
+  const input = options.input ?? process.stdin;
+  const output = options.output ?? process.stdout;
+  const error = options.error ?? process.stderr;
+  if (options.requireTTY !== false && (!streamIsTTY(input) || !streamIsTTY(output))) {
+    throw new Error("The interactive TT shell requires a TTY.");
   }
-  return normalized;
-}
-async function spawnLocalCli(args) {
-  const output = args.stdout ?? process.stdout;
-  const errors = args.stderr ?? process.stderr;
-  const pipeInput = Boolean(args.stdin && args.stdin !== process.stdin);
-  const pipeStreamingOutput = args.streamingStdout && Boolean(args.stdout && args.stdout !== process.stdout);
-  const child = spawn(
-    args.nodeExecutable,
-    [args.entrypoint, ...args.commandArgs],
+  let readline;
+  const terminalInput = input;
+  const foregroundRunner = (request2) => withForegroundSignalHandoff(
     {
-      cwd: args.cwd,
-      env: args.env,
-      stdio: [
-        pipeInput ? "pipe" : "inherit",
-        args.streamingStdout && !pipeStreamingOutput ? "inherit" : "pipe",
-        "pipe"
-      ],
-      detached: process.platform !== "win32"
-    }
+      input: terminalInput,
+      pauseReadline: () => readline?.pause(),
+      resumeReadline: () => readline?.resume()
+    },
+    () => options.runner(request2)
   );
-  if (pipeInput && args.stdin && child.stdin) args.stdin.pipe(child.stdin);
-  let stdout2 = "";
-  let stderr = "";
-  child.stdout?.setEncoding("utf8");
-  child.stderr?.setEncoding("utf8");
-  child.stdout?.on("data", (chunk) => {
-    const normalized = normalizeProjectedPaths(
-      chunk,
-      args.pathReplacements
-    );
-    if (args.streamingStdout) writeStream(output, normalized);
-    else stdout2 += normalized;
+  const session = await createShellSession({
+    runner: foregroundRunner,
+    io: streamIO(output, error),
+    agent: options.agent,
+    cwd: options.cwd,
+    env: options.env,
+    version: options.version
   });
-  child.stderr?.on("data", (chunk) => {
-    const normalized = normalizeProjectedPaths(
-      chunk,
-      args.pathReplacements
-    );
-    stderr += normalized;
-    writeStream(
-      errors,
-      args.jsonMode ? normalized : adaptLocalCliText(normalized)
-    );
+  const completer = createCommandCompleter(() => session.snapshot().mode);
+  readline = createInterface({
+    input,
+    output,
+    terminal: true,
+    historySize: 100,
+    removeHistoryDuplicates: true,
+    completer
   });
-  return new Promise((resolveChild) => {
-    let spawnError;
-    const forwardSignal = (signal) => {
-      const childSignal = signal === "SIGHUP" ? "SIGTERM" : signal;
-      if (child.pid && process.platform !== "win32") {
-        try {
-          process.kill(-child.pid, childSignal);
-          return;
-        } catch {
-        }
+  readline.on("SIGINT", () => {
+    if (session.interruptAgent()) {
+      output.write("\n");
+      return;
+    }
+    output.write("\n");
+    readline?.setPrompt(session.prompt());
+    readline?.write(null, { ctrl: true, name: "u" });
+  });
+  output.write(session.banner());
+  readline.setPrompt(session.prompt());
+  readline.prompt();
+  try {
+    for await (const line of readline) {
+      const action = await session.handleLine(line);
+      if (action === "exit") {
+        readline.close();
+        break;
       }
-      child.kill(childSignal);
-    };
-    const onSigint = () => forwardSignal("SIGINT");
-    const onSigterm = () => forwardSignal("SIGTERM");
-    const onSighup = () => forwardSignal("SIGHUP");
-    const cleanup = () => {
-      process.off("SIGINT", onSigint);
-      process.off("SIGTERM", onSigterm);
-      if (process.platform !== "win32") process.off("SIGHUP", onSighup);
-    };
-    process.on("SIGINT", onSigint);
-    process.on("SIGTERM", onSigterm);
-    if (process.platform !== "win32") process.on("SIGHUP", onSighup);
-    child.once("error", (error) => {
-      spawnError = error;
-    });
-    child.once("close", (code, signal) => {
-      cleanup();
-      resolveChild({
-        exitCode: spawnError ? 1 : code ?? signalExitCode(signal),
-        signal,
-        stdout: stdout2,
-        stderr,
-        ...spawnError ? { errorMessage: spawnError.message } : {}
-      });
-    });
+      readline.setPrompt(session.prompt());
+      readline.prompt();
+    }
+  } finally {
+    readline.close();
+  }
+}
+function ciEnabled(value) {
+  if (!value) return false;
+  return !["0", "false", "no", "off"].includes(value.trim().toLowerCase());
+}
+function shouldStartInteractiveShell(options) {
+  const env = options.env ?? process.env;
+  return options.args.length === 0 && options.stdinIsTTY === true && options.stdoutIsTTY === true && !ciEnabled(env.CI) && env.TERM !== "dumb";
+}
+
+// src/agent.ts
+var accent2 = chalk2.hex("#8B5CF6");
+var successMark2 = () => chalk2.green("\u2713");
+var errorMark2 = () => chalk2.red("\u2717");
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function stringValue2(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function helpText2() {
+  return [
+    accent2.bold("Agent commands"),
+    "",
+    `  ${accent2("/new".padEnd(22))} Start a new conversation.`,
+    `  ${accent2("/threads".padEnd(22))} List recent conversations.`,
+    `  ${accent2("/resume <id>".padEnd(22))} Resume a conversation by ID or prefix.`,
+    `  ${accent2("/approve [id]".padEnd(22))} Approve a proposed action.`,
+    `  ${accent2("/reject [id]".padEnd(22))} Reject a proposed action.`,
+    `  ${accent2("/status".padEnd(22))} Show the active conversation.`,
+    `  ${accent2("/clear".padEnd(22))} Clear the terminal.`,
+    `  ${accent2("/exit".padEnd(22))} Exit the agent.`,
+    "",
+    chalk2.dim(
+      "Everything else is sent to the Tuned Tensor agent; known TT commands still run directly in the shell."
+    ),
+    ""
+  ].join("\n");
+}
+function formatThread(thread, activeId) {
+  const active = thread.id === activeId ? accent2("\u25CF") : chalk2.dim("\u25CB");
+  const time = thread.last_message_at ?? thread.updated_at ?? thread.created_at;
+  const date = new Date(time);
+  const dateLabel = Number.isNaN(date.getTime()) ? "" : date.toLocaleString([], {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
   });
+  return `${active} ${chalk2.dim(thread.id.slice(0, 8))}  ${thread.title}  ${chalk2.dim(dateLabel)}`;
 }
-function setupFailure(originalArgs, error) {
-  const message = error instanceof Error ? error.message : String(error);
+function actionFromPayload(payload) {
+  const value = isRecord(payload.action) ? payload.action : isRecord(payload.approval) ? payload.approval : payload;
+  const id = stringValue2(value.id);
+  const title = stringValue2(value.title);
+  if (!id || !title) return null;
   return {
-    args: [...originalArgs],
-    projectedArgs: [...originalArgs],
-    entrypoint: null,
-    exitCode: 1,
-    signal: null,
-    stdout: "",
-    stderr: "",
-    hasJson: false,
-    json: void 0,
-    streamingStdout: false,
-    droppedSpecKeys: [],
-    errorMessage: message
+    id,
+    title,
+    summary: stringValue2(value.summary) ?? "",
+    risk: stringValue2(value.risk) ?? "unknown",
+    status: stringValue2(value.status) ?? "proposed",
+    operation: stringValue2(value.operation) ?? void 0,
+    thread_id: stringValue2(value.thread_id) ?? void 0,
+    turn_id: stringValue2(value.turn_id) ?? void 0,
+    arguments: value.arguments,
+    preview: value.preview,
+    method: stringValue2(value.method) ?? void 0,
+    path: stringValue2(value.path) ?? void 0
   };
 }
-async function runLocalCommand(args, options = {}) {
-  const cwd = resolve(options.cwd ?? process.cwd());
-  let projected;
+function formatJson(value) {
   try {
-    const entrypoint = options.entrypoint ?? resolveLocalCliEntrypoint();
-    projected = await projectSpecArguments(args, cwd);
-    const streamingStdout = localCommandStreamsStdout(projected.args);
-    const result = await spawnLocalCli({
-      entrypoint,
-      commandArgs: projected.args,
-      cwd,
-      env: options.env ?? process.env,
-      nodeExecutable: options.nodeExecutable ?? process.execPath,
-      streamingStdout,
-      jsonMode: options.jsonMode ?? false,
-      stdin: options.stdin,
-      stdout: options.stdout,
-      stderr: options.stderr,
-      pathReplacements: projected.pathReplacements
-    });
-    const parsed = parseJsonOutput(result.stdout);
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+var TunedTensorAgentSession = class {
+  constructor(options) {
+    this.options = options;
+    this.thread = options.thread ?? null;
+  }
+  thread;
+  pendingActions = /* @__PURE__ */ new Map();
+  activeRequest = null;
+  responseStarted = false;
+  lineOpen = false;
+  get busy() {
+    return this.activeRequest !== null;
+  }
+  snapshot() {
     return {
-      args: [...args],
-      projectedArgs: projected.args,
-      entrypoint,
-      ...result,
-      ...parsed,
-      streamingStdout,
-      droppedSpecKeys: projected.droppedSpecKeys
+      thread: this.thread,
+      pendingActions: [...this.pendingActions.values()]
     };
-  } catch (error) {
-    return setupFailure(args, error);
-  } finally {
-    await projected?.cleanup().catch(() => void 0);
   }
+  interrupt() {
+    if (!this.activeRequest) return false;
+    this.activeRequest.abort("user-stop");
+    return true;
+  }
+  endOpenLine() {
+    if (this.lineOpen) this.options.io.write("\n");
+    this.lineOpen = false;
+  }
+  renderAction(action) {
+    this.endOpenLine();
+    this.options.io.write(
+      `
+${chalk2.yellow.bold("Approval required")}  ${chalk2.dim(action.id.slice(0, 8))}
+`
+    );
+    this.options.io.write(`${chalk2.bold(action.title)}  ${chalk2.yellow(`[${action.risk} risk]`)}
+`);
+    if (action.summary) this.options.io.write(`${action.summary}
+`);
+    const request2 = [action.method, action.path].filter(Boolean).join(" ");
+    const technical = {
+      operation: action.operation,
+      ...request2 ? { request: request2 } : {},
+      arguments: action.arguments ?? null,
+      preview: action.preview ?? null
+    };
+    this.options.io.write(`${chalk2.bold("Proposed action")}
+`);
+    this.options.io.write(`${formatJson(technical)}
+`);
+    this.options.io.write(
+      chalk2.dim("Use /approve or /reject. The action will not run without approval.") + "\n"
+    );
+  }
+  renderEvent(event) {
+    const payload = event.payload;
+    if (event.type === "text_delta") {
+      const delta = stringValue2(payload.delta) ?? stringValue2(payload.text) ?? stringValue2(payload.content);
+      if (!delta) return;
+      if (!this.responseStarted) {
+        this.options.io.write(`${accent2.bold("TT")}  `);
+        this.responseStarted = true;
+        this.lineOpen = true;
+      }
+      this.options.io.write(delta);
+      this.lineOpen = !delta.endsWith("\n");
+      return;
+    }
+    if (event.type === "tool_call") {
+      this.endOpenLine();
+      const name = stringValue2(payload.name) ?? stringValue2(isRecord(payload.tool_call) ? payload.tool_call.name : null) ?? "tool";
+      this.options.io.write(chalk2.dim(`  \u25CB ${name}
+`));
+      return;
+    }
+    if (event.type === "tool_result") {
+      this.endOpenLine();
+      const failed = payload.status === "error" || Boolean(payload.error);
+      this.options.io.write(
+        chalk2.dim(`  ${failed ? chalk2.red("\u2717") : chalk2.green("\u2713")} Tool ${failed ? "failed" : "complete"}
+`)
+      );
+      return;
+    }
+    if (event.type === "approval_required") {
+      const action = actionFromPayload(payload);
+      if (!action) return;
+      this.pendingActions.set(action.id, action);
+      this.renderAction(action);
+      return;
+    }
+    if (event.type === "action_started") {
+      this.endOpenLine();
+      this.options.io.write(chalk2.dim("  \u25CB Running approved action\u2026\n"));
+      return;
+    }
+    if (event.type === "action_result") {
+      this.endOpenLine();
+      const failed = payload.status === "failed" || Boolean(payload.error);
+      this.options.io.write(
+        `${failed ? errorMark2() : successMark2()} Approved action ${failed ? "failed" : "completed"}.
+`
+      );
+      return;
+    }
+    if (event.type === "error") {
+      this.endOpenLine();
+      const message = stringValue2(payload.message) ?? stringValue2(payload.error) ?? "The agent could not complete this request.";
+      this.options.io.writeError(`${errorMark2()} ${message}
+`);
+    }
+  }
+  async ensureThread() {
+    if (!this.thread) this.thread = await this.options.client.createThread();
+    return this.thread;
+  }
+  async runStream(operation) {
+    if (this.activeRequest) {
+      this.options.io.writeError(`${errorMark2()} A response is already running.
+`);
+      return null;
+    }
+    const controller = new AbortController();
+    this.activeRequest = controller;
+    this.responseStarted = false;
+    this.lineOpen = false;
+    try {
+      const result = await operation(controller.signal);
+      this.endOpenLine();
+      for (const action of result.actions) {
+        this.pendingActions.set(action.id, action);
+      }
+      return result;
+    } catch (error) {
+      this.endOpenLine();
+      if (controller.signal.aborted) {
+        this.options.io.write(chalk2.dim("Response stopped.\n"));
+        return null;
+      }
+      throw error;
+    } finally {
+      this.activeRequest = null;
+      this.responseStarted = false;
+      this.lineOpen = false;
+    }
+  }
+  async send(prompt) {
+    const normalized = prompt.trim();
+    if (!normalized) return null;
+    const thread = await this.ensureThread();
+    return await this.runStream(
+      async (signal) => await this.options.client.runTurn(
+        thread.id,
+        normalized,
+        (event) => this.renderEvent(event),
+        signal
+      )
+    );
+  }
+  resolvePendingAction(idOrPrefix) {
+    const candidates = [...this.pendingActions.values()].filter(
+      (action) => idOrPrefix ? action.id.startsWith(idOrPrefix) : true
+    );
+    if (candidates.length === 0) {
+      throw new Error(
+        idOrPrefix ? `No pending action matches ${idOrPrefix}.` : "There is no pending action."
+      );
+    }
+    if (candidates.length > 1) {
+      throw new Error("More than one action is pending; include its ID or prefix.");
+    }
+    return candidates[0];
+  }
+  async approve(idOrPrefix) {
+    const action = this.resolvePendingAction(idOrPrefix);
+    const result = await this.runStream(
+      async (signal) => await this.options.client.approveAction(
+        action.id,
+        (event) => this.renderEvent(event),
+        signal
+      )
+    );
+    if (result) this.pendingActions.delete(action.id);
+  }
+  async reject(idOrPrefix) {
+    const action = this.resolvePendingAction(idOrPrefix);
+    await this.options.client.rejectAction(action.id);
+    this.pendingActions.delete(action.id);
+    this.options.io.write(`${successMark2()} Action rejected.
+`);
+  }
+  async resolveThread(idOrPrefix) {
+    const id = idOrPrefix.trim();
+    if (!id) throw new Error("Usage: /resume <conversation-id>");
+    if (id.length >= 32) return await this.options.client.getThread(id);
+    const matches = (await this.options.client.listThreads()).filter((thread) => thread.id.startsWith(id));
+    if (matches.length === 0) throw new Error(`No conversation matches ${id}.`);
+    if (matches.length > 1) {
+      throw new Error(`Conversation prefix ${id} is ambiguous.`);
+    }
+    return await this.options.client.getThread(matches[0].id);
+  }
+  async handleCommand(input) {
+    const tokens = tokenizeShellInput(input);
+    const command = tokens[0].slice(1).toLowerCase();
+    const args = tokens.slice(1);
+    switch (command) {
+      case "help":
+        this.options.io.write(helpText2());
+        return "continue";
+      case "new":
+        if (args.length > 0) throw new Error("/new does not accept arguments.");
+        this.thread = null;
+        this.pendingActions.clear();
+        this.options.io.write(`${successMark2()} New conversation ready.
+`);
+        return "continue";
+      case "threads": {
+        if (args.length > 0) throw new Error("/threads does not accept arguments.");
+        const threads = await this.options.client.listThreads();
+        if (threads.length === 0) {
+          this.options.io.write(chalk2.dim("No conversations yet.\n"));
+          return "continue";
+        }
+        this.options.io.write(
+          `${threads.slice(0, 20).map((thread) => formatThread(thread, this.thread?.id)).join("\n")}
+`
+        );
+        return "continue";
+      }
+      case "resume":
+        if (args.length !== 1) throw new Error("Usage: /resume <conversation-id>");
+        {
+          const detail = await this.resolveThread(args[0]);
+          this.thread = detail.thread;
+          this.pendingActions.clear();
+          for (const action of detail.actions) {
+            if (action.status === "proposed") {
+              this.pendingActions.set(action.id, action);
+            }
+          }
+        }
+        this.options.io.write(
+          `${successMark2()} Resumed ${this.thread.title} (${this.thread.id.slice(0, 8)}).
+`
+        );
+        return "continue";
+      case "approve":
+        if (args.length > 1) throw new Error("Usage: /approve [action-id]");
+        await this.approve(args[0]);
+        return "continue";
+      case "reject":
+        if (args.length > 1) throw new Error("Usage: /reject [action-id]");
+        await this.reject(args[0]);
+        return "continue";
+      case "status":
+        if (args.length > 0) throw new Error("/status does not accept arguments.");
+        this.options.io.write(
+          this.thread ? `${formatThread(this.thread, this.thread.id)}
+` : chalk2.dim("New conversation; send a message to create it.\n")
+        );
+        this.options.io.write(
+          chalk2.dim(`${this.pendingActions.size} pending approval(s).
+`)
+        );
+        return "continue";
+      case "clear":
+        if (args.length > 0) throw new Error("/clear does not accept arguments.");
+        this.options.io.clear();
+        return "continue";
+      case "exit":
+        if (args.length > 0) throw new Error("/exit does not accept arguments.");
+        return "exit";
+      default:
+        throw new Error(`Unknown agent command: /${command}. Use /help.`);
+    }
+  }
+  async handleLine(input) {
+    try {
+      const normalized = input.trim();
+      if (!normalized) return "continue";
+      if (/^(exit|quit)$/i.test(normalized)) return "exit";
+      if (normalized.startsWith("/")) return await this.handleCommand(normalized);
+      await this.send(normalized);
+      return "continue";
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      this.options.io.writeError(`${errorMark2()} ${message}
+`);
+      return "continue";
+    }
+  }
+};
+
+// src/local-runner.ts
+import { constants as osConstants } from "os";
+import { randomUUID } from "crypto";
+import { createRequire } from "module";
+import { spawn } from "child_process";
+import {
+  readFile as readFile2,
+  rm,
+  stat as stat3,
+  writeFile
+} from "fs/promises";
+import {
+  basename as basename3,
+  dirname as dirname2,
+  isAbsolute as isAbsolute3,
+  join as join3,
+  resolve as resolve3
+} from "path";
+
+// src/base-models.ts
+var SUPPORTED_BASE_MODELS = [
+  "google/gemma-4-E2B-it",
+  "google/gemma-4-E4B-it",
+  "Qwen/Qwen3.5-2B",
+  "Qwen/Qwen3-VL-2B-Instruct",
+  "Qwen/Qwen3.5-4B",
+  "meta-llama/Llama-3.2-3B-Instruct",
+  "microsoft/Phi-4-mini-instruct",
+  "ibm-granite/granite-3.3-2b-instruct",
+  "bigcode/starcoder2-3b"
+];
+var BASE_MODEL_ALIASES = /* @__PURE__ */ new Map();
+for (const model of SUPPORTED_BASE_MODELS) {
+  BASE_MODEL_ALIASES.set(model.toLowerCase(), model);
+}
+for (const [alias, model] of [
+  ["google/gemma-4-E2B", "google/gemma-4-E2B-it"],
+  ["google/gemma-4-e2b", "google/gemma-4-E2B-it"],
+  ["google/gemma-4-e2b-it", "google/gemma-4-E2B-it"],
+  ["google/gemma-4-E4B", "google/gemma-4-E4B-it"],
+  ["google/gemma-4-e4b", "google/gemma-4-E4B-it"],
+  ["google/gemma-4-e4b-it", "google/gemma-4-E4B-it"],
+  ["qwen/qwen3.5-2b", "Qwen/Qwen3.5-2B"],
+  ["Qwen/Qwen3.5-2B-Base", "Qwen/Qwen3.5-2B"],
+  ["qwen/qwen3.5-2b-base", "Qwen/Qwen3.5-2B"],
+  ["qwen/qwen3-vl-2b-instruct", "Qwen/Qwen3-VL-2B-Instruct"],
+  ["Qwen/Qwen3-VL-2B", "Qwen/Qwen3-VL-2B-Instruct"],
+  ["qwen/qwen3-vl-2b", "Qwen/Qwen3-VL-2B-Instruct"],
+  ["qwen/qwen3.5-4b", "Qwen/Qwen3.5-4B"],
+  ["Qwen/Qwen3.5-4B-Base", "Qwen/Qwen3.5-4B"],
+  ["qwen/qwen3.5-4b-base", "Qwen/Qwen3.5-4B"],
+  ["meta-llama/llama-3.2-3b-instruct", "meta-llama/Llama-3.2-3B-Instruct"],
+  ["meta-llama/Llama-3.2-3B", "meta-llama/Llama-3.2-3B-Instruct"],
+  ["meta-llama/llama-3.2-3b", "meta-llama/Llama-3.2-3B-Instruct"],
+  ["microsoft/phi-4-mini-instruct", "microsoft/Phi-4-mini-instruct"],
+  ["phi-4-mini-instruct", "microsoft/Phi-4-mini-instruct"],
+  ["ibm-granite/granite-3.3-2b-instruct", "ibm-granite/granite-3.3-2b-instruct"],
+  ["granite-3.3-2b-instruct", "ibm-granite/granite-3.3-2b-instruct"],
+  ["bigcode/starcoder2-3b", "bigcode/starcoder2-3b"],
+  ["starcoder2-3b", "bigcode/starcoder2-3b"]
+]) {
+  BASE_MODEL_ALIASES.set(alias.toLowerCase(), model);
+}
+var UnsupportedBaseModelError = class extends Error {
+  constructor(model) {
+    const supported = SUPPORTED_BASE_MODELS.join(", ");
+    super(
+      `Unsupported base_model "${String(model)}". Supported base models: ${supported}`
+    );
+    this.name = "UnsupportedBaseModelError";
+  }
+};
+function canonicalizeBaseModel(model) {
+  if (typeof model !== "string" || !model.trim()) {
+    throw new UnsupportedBaseModelError(model);
+  }
+  const canonical = BASE_MODEL_ALIASES.get(model.trim().toLowerCase());
+  if (!canonical) {
+    throw new UnsupportedBaseModelError(model);
+  }
+  return canonical;
 }
-async function executeLocalCommand(args, options = {}) {
-  const result = await runLocalCommand(args, options);
-  renderLocalOutput(result, {
-    jsonMode: options.jsonMode,
-    stdout: options.stdout
-  });
-  if (result.exitCode !== 0) process.exitCode = result.exitCode;
-  return result;
+function canonicalizeSpecBaseModel(body) {
+  if ("base_model" in body && body.base_model !== void 0) {
+    return { ...body, base_model: canonicalizeBaseModel(body.base_model) };
+  }
+  return body;
 }
 
-// src/shell.ts
-import chalk2 from "chalk";
-import { stat as stat3 } from "fs/promises";
-import { homedir as homedir3 } from "os";
-import { isAbsolute as isAbsolute3, resolve as resolve3 } from "path";
-import { createInterface } from "readline";
-
-// src/command-catalog.ts
-var CLOUD = ["cloud"];
-var LOCAL = ["local"];
-var BOTH = ["cloud", "local"];
-var COMMAND_CATALOG = [
-  { path: "init", description: "Create a behaviour-spec project.", group: "Workflow", modes: BOTH },
-  { path: "eval", description: "Validate a managed-service behaviour spec.", group: "Workflow", modes: CLOUD },
-  { path: "push", description: "Create or update the cloud behaviour spec.", group: "Workflow", modes: CLOUD },
-  { path: "validate", description: "Validate a local fine-tuning project.", group: "Workflow", modes: LOCAL },
-  { path: "doctor", description: "Check the local host and run prerequisites.", group: "Workflow", modes: LOCAL },
-  { path: "run", description: "Run the local fine-tuning and evaluation workflow.", group: "Workflow", modes: LOCAL },
-  { path: "runs list", description: "List runs.", group: "Inspect", modes: BOTH },
-  { path: "runs get", description: "Show a run.", group: "Inspect", modes: BOTH },
-  { path: "runs report", description: "Show a run report.", group: "Inspect", modes: BOTH },
-  { path: "runs compare", description: "Compare two local run reports.", group: "Inspect", modes: LOCAL },
-  { path: "runs events", description: "Show local run progress events.", group: "Inspect", modes: LOCAL },
-  { path: "runs estimate", description: "Estimate managed run cost and duration.", group: "Workflow", modes: CLOUD },
-  { path: "runs start", description: "Start a managed fine-tuning run.", group: "Workflow", modes: CLOUD },
-  { path: "runs watch", description: "Watch a managed run.", group: "Inspect", modes: CLOUD },
-  { path: "runs diagnose", description: "Show managed run diagnostics.", group: "Inspect", modes: CLOUD },
-  { path: "runs cancel", description: "Cancel a managed run.", group: "Workflow", modes: CLOUD },
-  { path: "models list", description: "List models.", group: "Inspect", modes: BOTH },
-  { path: "models get", description: "Show a model.", group: "Inspect", modes: BOTH },
-  { path: "models base", description: "List managed-service base models.", group: "Inspect", modes: CLOUD },
-  { path: "models download", description: "Download a managed model artifact.", group: "Serving", modes: CLOUD },
-  { path: "models export", description: "Export a managed model to GGUF or Ollama.", group: "Serving", modes: CLOUD },
-  { path: "models setup-runtime", description: "Install the managed model-serving runtime.", group: "Serving", modes: CLOUD },
-  { path: "models serve", description: "Serve a model through an OpenAI-compatible API.", group: "Serving", modes: BOTH },
-  { path: "models delete", description: "Delete a managed model.", group: "Workflow", modes: CLOUD },
-  { path: "models verify", description: "Verify a local model artifact.", group: "Serving", modes: LOCAL },
-  { path: "models prefetch", description: "Download the local base-model snapshot.", group: "Serving", modes: LOCAL },
-  { path: "models verify-base", description: "Verify the local base-model snapshot.", group: "Serving", modes: LOCAL },
-  { path: "models active", description: "Show the active local model.", group: "Serving", modes: LOCAL },
-  { path: "models activate", description: "Activate a verified local model.", group: "Serving", modes: LOCAL },
-  { path: "models rollback", description: "Roll back the active local model.", group: "Serving", modes: LOCAL },
-  { path: "serve", description: "Serve a local adapter, active model, or base model.", group: "Serving", modes: LOCAL },
-  { path: "specs list", description: "List cloud behaviour specs.", group: "Inspect", modes: CLOUD },
-  { path: "specs get", description: "Show a cloud behaviour spec.", group: "Inspect", modes: CLOUD },
-  { path: "specs create", description: "Create a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
-  { path: "specs update", description: "Update a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
-  { path: "specs delete", description: "Delete a cloud behaviour spec.", group: "Workflow", modes: CLOUD },
-  { path: "datasets list", description: "List cloud datasets.", group: "Data", modes: CLOUD },
-  { path: "datasets get", description: "Show a cloud dataset.", group: "Data", modes: CLOUD },
-  { path: "datasets upload", description: "Upload a cloud dataset.", group: "Data", modes: CLOUD },
-  { path: "datasets delete", description: "Delete a cloud dataset.", group: "Data", modes: CLOUD },
-  { path: "label upload", description: "Start a cloud teacher-labeling job.", group: "Data", modes: CLOUD },
-  { path: "label watch", description: "Watch a cloud labeling job.", group: "Data", modes: CLOUD },
-  { path: "label list", description: "List cloud labeling jobs.", group: "Data", modes: CLOUD },
-  { path: "label status", description: "Show cloud labeling-job status.", group: "Data", modes: CLOUD },
-  { path: "label rows", description: "Review labeled rows.", group: "Data", modes: CLOUD },
-  { path: "label accept", description: "Accept labeled rows.", group: "Data", modes: CLOUD },
-  { path: "label reject", description: "Reject labeled rows.", group: "Data", modes: CLOUD },
-  { path: "label edit", description: "Edit a labeled row.", group: "Data", modes: CLOUD },
-  { path: "label promote", description: "Promote reviewed rows to a dataset.", group: "Data", modes: CLOUD },
-  { path: "label cancel", description: "Cancel a labeling job.", group: "Data", modes: CLOUD },
-  { path: "auth login", description: "Store a cloud API key.", group: "Account", modes: CLOUD },
-  { path: "auth logout", description: "Remove stored cloud credentials.", group: "Account", modes: CLOUD },
-  { path: "auth status", description: "Show cloud authentication status.", group: "Account", modes: CLOUD },
-  { path: "balance", description: "Show cloud credit balance.", group: "Account", modes: CLOUD },
-  { path: "topup", description: "Open a cloud credit checkout.", group: "Account", modes: CLOUD },
-  { path: "info", description: "Show TT Local package information.", group: "Inspect", modes: LOCAL }
+// src/project-spec.ts
+var CLOUD_SPEC_KEYS = [
+  "name",
+  "description",
+  "base_model",
+  "system_prompt",
+  "guidelines",
+  "constraints",
+  "examples",
+  "eval_cases"
 ];
-var SLASH_COMMANDS = [
-  { path: "/help", description: "Show commands; add a word to filter." },
-  { path: "/status", description: "Show lightweight workflow status." },
-  { path: "/context", description: "Show the current project and backend context." },
-  { path: "/mode cloud", description: "Use the managed cloud workflow." },
-  { path: "/mode local", description: "Use the local GPU workflow." },
-  { path: "/cd", description: "Change the shell's working directory." },
-  { path: "/clear", description: "Clear the terminal." },
-  { path: "/exit", description: "Exit the TT shell." }
+var LOCAL_ONLY_SPEC_KEYS = [
+  "hyperparameters",
+  "dataset_prebuilt"
 ];
-function catalogForMode(mode) {
-  return COMMAND_CATALOG.filter((command) => command.modes.includes(mode));
+var LOCAL_SPEC_KEYS = [
+  "id",
+  "name",
+  "description",
+  "system_prompt",
+  "guidelines",
+  "constraints",
+  "base_model",
+  "examples",
+  ...LOCAL_ONLY_SPEC_KEYS
+];
+var CLOUD_SPEC_KEY_SET = new Set(CLOUD_SPEC_KEYS);
+var LOCAL_ONLY_SPEC_KEY_SET = new Set(LOCAL_ONLY_SPEC_KEYS);
+var LOCAL_SPEC_KEY_SET = new Set(LOCAL_SPEC_KEYS);
+var KNOWN_PROJECT_SPEC_KEY_SET = /* @__PURE__ */ new Set([
+  ...CLOUD_SPEC_KEYS,
+  ...LOCAL_SPEC_KEYS
+]);
+function projectSpec(raw, supportedKeys) {
+  const body = {};
+  const droppedKeys = [];
+  for (const [key, value] of Object.entries(raw)) {
+    if (supportedKeys.has(key)) {
+      body[key] = value;
+    } else {
+      droppedKeys.push(key);
+    }
+  }
+  return {
+    body: canonicalizeSpecBaseModel(body),
+    droppedKeys
+  };
 }
-function commandPathsForMode(mode) {
-  return [...new Set(catalogForMode(mode).map((command) => command.path))].sort((left, right) => left.localeCompare(right));
+function projectCloudSpec(raw) {
+  return projectSpec(raw, CLOUD_SPEC_KEY_SET);
 }
-function groupedCatalog(mode, query) {
-  const normalizedQuery = query?.trim().toLowerCase();
-  const matches = catalogForMode(mode).filter((command) => {
-    if (!normalizedQuery) return true;
-    return command.path.toLowerCase().includes(normalizedQuery) || command.description.toLowerCase().includes(normalizedQuery) || command.group.toLowerCase().includes(normalizedQuery);
+function projectLocalSpec(raw) {
+  return projectSpec(raw, LOCAL_SPEC_KEY_SET);
+}
+function hasLocalOnlySpecFields(raw) {
+  return Object.keys(raw).some((key) => LOCAL_ONLY_SPEC_KEY_SET.has(key));
+}
+function unknownProjectSpecKeys(raw) {
+  return Object.keys(raw).filter(
+    (key) => !KNOWN_PROJECT_SPEC_KEY_SET.has(key)
+  );
+}
+
+// src/output.ts
+import chalk3 from "chalk";
+import Table from "cli-table3";
+var jsonMode = false;
+function setJsonMode(enabled) {
+  jsonMode = enabled;
+}
+function isJsonMode() {
+  return jsonMode;
+}
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function printTable(headers, rows2, meta) {
+  const table = new Table({
+    head: headers.map((h) => chalk3.bold.cyan(h)),
+    style: { head: [], border: [] }
   });
-  const groups = /* @__PURE__ */ new Map();
-  for (const command of matches) {
-    const group = groups.get(command.group) ?? [];
-    group.push(command);
-    groups.set(command.group, group);
+  for (const row of rows2) {
+    table.push(row);
+  }
+  console.log(table.toString());
+  if (meta) {
+    const totalPages = Math.ceil(meta.total / meta.per_page);
+    console.log(
+      chalk3.dim(
+        `
+Page ${meta.page}/${totalPages} (${meta.total} total)`
+      )
+    );
   }
-  return groups;
 }
-function completionTarget(line, activeMode) {
-  const leadingWhitespace = line.match(/^\s*/)?.[0] ?? "";
-  const content = line.slice(leadingWhitespace.length);
-  const override = content.match(/^(cloud|local)(?:\s+|$)/);
-  if (!override) {
-    return { prefix: leadingWhitespace, mode: activeMode, fragment: content };
+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(`${chalk3.bold.cyan(paddedLabel)}  ${value ?? chalk3.dim("\u2014")}`);
   }
-  const mode = override[1];
-  const prefix = `${leadingWhitespace}${mode} `;
-  return {
-    prefix,
-    mode,
-    fragment: content.slice(override[0].length)
-  };
 }
-function createCommandCompleter(getMode) {
-  return (line) => {
-    const trimmed = line.trimStart();
-    if (trimmed.startsWith("/")) {
-      const candidates = SLASH_COMMANDS.map((command) => command.path);
-      const matches2 = candidates.filter((candidate) => candidate.startsWith(trimmed));
-      return [matches2.length > 0 ? matches2 : candidates, line];
-    }
-    if (trimmed.startsWith("?")) {
-      return [["?"], line];
-    }
-    const { prefix, mode, fragment } = completionTarget(line, getMode());
-    const paths = commandPathsForMode(mode);
-    const targetCandidates = paths.map((path) => `${prefix}${path}`);
-    if (!prefix.trim()) targetCandidates.unshift("cloud ", "local ");
-    const normalizedLine = line.trimStart().toLowerCase();
-    const normalizedFragment = fragment.toLowerCase();
-    const matches = targetCandidates.filter((candidate) => {
-      if (prefix.trim()) return candidate.toLowerCase().startsWith(`${prefix.toLowerCase()}${normalizedFragment}`);
-      return candidate.toLowerCase().startsWith(normalizedLine);
+function printSuccess(message) {
+  console.log(chalk3.green("\u2713") + " " + message);
+}
+function printWarning(message) {
+  console.log(chalk3.yellow("!") + " " + message);
+}
+function printError(message) {
+  console.error(chalk3.red("\u2717") + " " + message);
+}
+function reportError(err) {
+  const isApi = err instanceof ApiError;
+  const message = err?.message || String(err);
+  if (jsonMode) {
+    printJson({
+      error: {
+        status: isApi ? err.status : null,
+        code: isApi ? err.code : "CLI_ERROR",
+        message
+      }
     });
-    return [matches.length > 0 ? matches : targetCandidates, line];
+  } else if (isApi) {
+    printError(`[${err.status}] ${message}`);
+  } else {
+    printError(message);
+  }
+}
+function formatDate(iso) {
+  if (!iso) return "\u2014";
+  return new Date(iso).toLocaleString();
+}
+function formatStatus(status2) {
+  const map = {
+    completed: chalk3.green,
+    running: chalk3.blue,
+    training: chalk3.blue,
+    evaluating: chalk3.blue,
+    preparing: chalk3.yellow,
+    pending: chalk3.yellow,
+    uploading: chalk3.yellow,
+    failed: chalk3.red,
+    cancelled: chalk3.dim,
+    validated: chalk3.green,
+    invalid: chalk3.red
   };
+  const colorFn = map[status2] || chalk3.white;
+  return colorFn(status2);
+}
+function truncate(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 1) + "\u2026";
+}
+function shortId(id) {
+  return id.slice(0, 8);
 }
 
-// src/shell-context.ts
-import { readFile as readFile2, readdir, stat as stat2 } from "fs/promises";
-import { homedir as homedir2 } from "os";
-import { basename as basename3, dirname as dirname2, isAbsolute as isAbsolute2, join as join3, resolve as resolve2 } from "path";
-async function readJsonObject(path) {
-  try {
-    const parsed = JSON.parse(await readFile2(path, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return { found: true, invalid: true };
-    }
-    return {
-      found: true,
-      value: parsed,
-      invalid: false
-    };
-  } catch (error) {
-    if (error.code === "ENOENT") {
-      return { found: false, invalid: false };
-    }
-    return { found: true, invalid: true };
+// src/local-output.ts
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function text(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
   }
+  return void 0;
 }
-function stringField(value, key) {
-  const field = value?.[key];
-  return typeof field === "string" && field.trim() ? field : void 0;
+function number(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function expandPath(value, baseDirectory, homeDirectory) {
-  if (value === "~") return homeDirectory;
-  if (value.startsWith("~/")) return resolve2(homeDirectory, value.slice(2));
-  return isAbsolute2(value) ? resolve2(value) : resolve2(baseDirectory, value);
+function record2(value) {
+  return isRecord2(value) ? value : void 0;
 }
-function environmentHome(env) {
-  return env.HOME ? resolve2(env.HOME) : homedir2();
+function rows(value) {
+  return Array.isArray(value) ? value.filter(isRecord2) : [];
 }
-function cloudConfigPath(env, homeDirectory) {
-  const configHome = env.XDG_CONFIG_HOME ? resolve2(env.XDG_CONFIG_HOME) : join3(homeDirectory, ".config");
-  return join3(configHome, "tuned-tensor", "config.json");
+function displayId(value) {
+  const id = text(value);
+  return id ? shortId(id) : "\u2014";
 }
-function redactApiKey(key) {
-  if (!key) return void 0;
-  if (key.length <= 4) return "\u2026";
-  const prefixLength = key.length > 8 ? 8 : Math.max(1, Math.floor(key.length / 2));
-  return `${key.slice(0, prefixLength)}\u2026`;
+function displayNumber(value, digits = 4) {
+  const parsed = number(value);
+  if (parsed === void 0) return void 0;
+  return parsed.toFixed(digits).replace(/\.?0+$/, "");
 }
-function targetFromEnvironment(env) {
-  const value = env.TT_TARGET?.trim().toLowerCase();
-  return value === "cloud" || value === "local" ? value : void 0;
+function displayBytes(value) {
+  const bytes = number(value);
+  if (bytes === void 0 || bytes < 0) return void 0;
+  const units = ["B", "KiB", "MiB", "GiB", "TiB"];
+  let amount = bytes;
+  let unit = 0;
+  while (amount >= 1024 && unit < units.length - 1) {
+    amount /= 1024;
+    unit += 1;
+  }
+  const precision = amount >= 10 || unit === 0 ? 0 : 1;
+  return `${amount.toFixed(precision)} ${units[unit]}`;
 }
-async function adjacentFile(path) {
-  try {
-    return (await stat2(path)).isFile();
-  } catch {
-    return false;
+function displayCommand(value) {
+  if (!Array.isArray(value) || !value.every((part) => typeof part === "string")) {
+    return void 0;
   }
+  return value.map(
+    (part) => /[\s"'\\]/.test(part) ? JSON.stringify(part) : part
+  ).join(" ");
 }
-async function readActiveModelId(storeRoot) {
-  const result = await readJsonObject(join3(storeRoot, "active-model.json"));
-  if (!result.found || result.invalid) return void 0;
-  const modelId = result.value?.model_id;
-  if (modelId === null) return "base";
-  return typeof modelId === "string" && modelId ? modelId : void 0;
+function status(value) {
+  const parsed = text(value) ?? "unknown";
+  return formatStatus(parsed);
 }
-async function readLatestRun(storeRoot) {
-  const runsRoot = join3(storeRoot, "runs");
-  let names;
-  try {
-    names = (await readdir(runsRoot, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
-  } catch {
-    return void 0;
+function gateFrom(value) {
+  return record2(record2(value)?.general_regression);
+}
+function renderGate(value) {
+  const gate = gateFrom(value);
+  if (!gate) {
+    printWarning(
+      "General regression was not run; this model cannot be activated yet."
+    );
+    return;
   }
-  const states = await Promise.all(names.map(async (name) => {
-    const result = await readJsonObject(join3(runsRoot, name, "state.json"));
-    if (!result.found || result.invalid || !result.value) return void 0;
-    const id = stringField(result.value, "id") ?? name;
-    const state = {
-      id,
-      status: stringField(result.value, "status"),
-      specName: stringField(result.value, "spec_name"),
-      updatedAt: stringField(result.value, "updated_at")
-    };
-    return state;
-  }));
-  return states.filter((state) => Boolean(state)).sort((left, right) => {
-    const leftUpdated = left.updatedAt ?? "";
-    const rightUpdated = right.updatedAt ?? "";
-    if (leftUpdated !== rightUpdated) {
-      return rightUpdated.localeCompare(leftUpdated);
-    }
-    return right.id.localeCompare(left.id);
-  })[0];
+  if (gate.passed === true) {
+    printSuccess("General regression gate passed");
+    return;
+  }
+  printWarning(
+    "The local run completed, but the general regression gate failed."
+  );
+  const failures = Array.isArray(gate.failures) ? gate.failures.filter(
+    (failure) => typeof failure === "string"
+  ) : [];
+  for (const failure of failures) printWarning(failure);
 }
-async function discoverShellContext(options = {}) {
-  const env = options.env ?? process.env;
-  const cwd = resolve2(options.cwd ?? process.cwd());
-  const homeDirectory = environmentHome(env);
-  const warnings = [];
-  const specPath = join3(cwd, "tunedtensor.json");
-  const specJson = await readJsonObject(specPath);
-  let spec;
-  if (specJson.found) {
-    if (specJson.invalid || !specJson.value) {
-      spec = { path: specPath, parseError: true };
-      warnings.push("tunedtensor.json could not be parsed.");
-    } else {
-      const examples = specJson.value.examples;
-      spec = {
-        path: specPath,
-        id: stringField(specJson.value, "id"),
-        name: stringField(specJson.value, "name"),
-        baseModel: stringField(specJson.value, "base_model"),
-        exampleCount: Array.isArray(examples) ? examples.length : void 0,
-        parseError: false
-      };
-    }
+function renderDoctor(value) {
+  const checks = rows(value.checks);
+  printTable(
+    ["Check", "Status", "Details"],
+    checks.map((check) => [
+      text(check.name) ?? "unknown",
+      check.ok === true ? formatStatus("completed") : formatStatus("failed"),
+      truncate(text(check.message) ?? text(check.detail) ?? "\u2014", 100)
+    ])
+  );
+  if (value.ok === true) {
+    printSuccess("Local environment is ready");
+  } else {
+    printError("Local environment needs attention");
   }
-  const localConfigPath = join3(cwd, "local-runner.json");
-  const hasAdjacentLocalConfig = await adjacentFile(localConfigPath);
-  const localConfigJson = hasAdjacentLocalConfig ? await readJsonObject(localConfigPath) : { found: false, invalid: false };
-  if (localConfigJson.invalid) {
-    warnings.push("local-runner.json could not be parsed.");
+  if (value.config_path) {
+    printDetail([["Config", text(value.config_path)]]);
   }
-  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) : resolve2(cwd, ".tt-local", "artifacts");
-  const storeRoot = configuredStoreRoot ? expandPath(configuredStoreRoot, localConfigDirectory, homeDirectory) : env.TT_LOCAL_HOME ? expandPath(env.TT_LOCAL_HOME, cwd, homeDirectory) : join3(homeDirectory, ".tuned-tensor-local");
-  const cloudPath = cloudConfigPath(env, homeDirectory);
-  const cloudConfigJson = await readJsonObject(cloudPath);
-  if (cloudConfigJson.invalid) {
-    warnings.push("The Tuned Tensor cloud config could not be parsed.");
+}
+function renderInit(value) {
+  printSuccess("Created local Tuned Tensor project");
+  printDetail([
+    ["Path", text(value.path)],
+    ["Name", text(value.name)],
+    ["ID", text(value.id)],
+    ["Base model", text(value.base_model)],
+    ["Config", text(value.config_path)]
+  ]);
+}
+function renderValidate(value) {
+  printSuccess("Local behavior spec is valid");
+  printDetail([
+    ["Input", text(value.input_path)],
+    ["Config", text(value.config_path)],
+    ["Spec", text(value.behavior_spec_id)],
+    ["Base model", text(value.base_model)],
+    ["Dataset", text(value.dataset_format)],
+    ["Artifacts", text(value.artifact_root)],
+    ["Store", text(value.store_root)],
+    ["Dry run", text(value.dry_run)]
+  ]);
+}
+function renderRun(value) {
+  const runStatus = text(value.status) ?? "unknown";
+  if (runStatus === "completed") {
+    printSuccess("Local run completed");
+  } else {
+    printWarning(`Local run finished with status ${runStatus}`);
   }
-  const environmentApiKey = env.TUNED_TENSOR_API_KEY?.trim();
-  const storedApiKey = stringField(cloudConfigJson.value, "api_key");
-  const apiKey = environmentApiKey || storedApiKey;
-  const baseUrl = env.TUNED_TENSOR_URL?.trim() || stringField(cloudConfigJson.value, "base_url") || "https://tunedtensor.com";
-  const environmentTarget = targetFromEnvironment(env);
-  if (env.TT_TARGET && !environmentTarget) {
-    warnings.push(`Ignoring invalid TT_TARGET=${JSON.stringify(env.TT_TARGET)}; use cloud or local.`);
+  const comparison = record2(value.comparison);
+  printDetail([
+    ["Run", text(value.run_id)],
+    ["Status", status(runStatus)],
+    ["Model", text(value.model_id) ?? text(value.fine_tuned_model_id)],
+    ["Report", text(value.report_path)],
+    ["Artifacts", text(value.artifact_dir)],
+    ["Score delta", displayNumber(comparison?.avg_score_delta)],
+    ["Pass-rate delta", displayNumber(comparison?.pass_rate_delta)]
+  ]);
+  renderGate(value);
+}
+function renderRunsList(value) {
+  const runRows = rows(value);
+  if (runRows.length === 0) {
+    printWarning("No local runs found.");
+    return;
+  }
+  printTable(
+    ["Run", "Spec", "Status", "Stage", "Model", "Updated"],
+    runRows.map((run) => [
+      displayId(run.id),
+      truncate(text(run.spec_name) ?? displayId(run.behavior_spec_id), 28),
+      status(run.status),
+      text(run.current_stage) ?? "\u2014",
+      displayId(run.model_id),
+      formatDate(text(run.updated_at))
+    ])
+  );
+}
+function renderRunEvents(value) {
+  const eventRows = rows(value);
+  if (eventRows.length === 0) {
+    printWarning("No local run events found.");
+    return;
   }
-  const inferredTarget = environmentTarget ?? (hasAdjacentLocalConfig ? "local" : "cloud");
-  const targetSource = environmentTarget ? "environment" : hasAdjacentLocalConfig ? "adjacent-config" : "default-cloud";
-  const [activeModelId, latestRun] = await Promise.all([
-    readActiveModelId(storeRoot),
-    readLatestRun(storeRoot)
+  printTable(
+    ["Time", "Stage", "Status", "Message"],
+    eventRows.map((event) => [
+      formatDate(text(event.occurred_at)),
+      text(event.stage) ?? "\u2014",
+      status(event.status),
+      truncate(text(event.message) ?? "\u2014", 80)
+    ])
+  );
+}
+function renderRunRecord(value) {
+  printDetail([
+    ["Run", text(value.id) ?? text(value.run_id)],
+    ["Spec", text(value.spec_name) ?? text(value.behavior_spec_id)],
+    ["Status", status(value.status)],
+    ["Stage", text(value.current_stage)],
+    ["Model", text(value.model_id) ?? text(value.fine_tuned_model_id)],
+    ["Base model", text(value.base_model)],
+    ["Report", text(value.report_path)],
+    ["Artifacts", text(value.artifact_dir)],
+    ["Updated", formatDate(text(value.updated_at) ?? text(value.created_at))]
   ]);
-  return {
-    cwd,
-    projectName: basename3(cwd) || cwd,
-    inferredTarget,
-    targetSource,
-    spec,
-    cloud: {
-      authenticated: Boolean(apiKey),
-      keyPrefix: redactApiKey(apiKey),
-      baseUrl,
-      configPath: cloudPath,
-      configFound: cloudConfigJson.found
-    },
-    local: {
-      configPath: hasAdjacentLocalConfig ? localConfigPath : void 0,
-      artifactRoot,
-      storeRoot,
-      activeModelId,
-      latestRun
-    },
-    warnings
-  };
 }
-function valueOrDash(value) {
-  return value === void 0 || value === "" ? "\u2014" : String(value);
+function renderRunReport(value) {
+  const baseline = record2(value.baseline);
+  const candidate = record2(value.candidate);
+  const comparison = record2(value.comparison);
+  const metadata = record2(value.run_metadata);
+  printDetail([
+    ["Run", text(value.run_id)],
+    ["Status", status(value.status)],
+    ["Base model", text(value.base_model)],
+    ["Tuned model", text(value.fine_tuned_model_id)],
+    ["Training examples", text(metadata?.training_example_count)],
+    ["Evaluation examples", text(metadata?.eval_examples_used)],
+    ["Baseline score", displayNumber(baseline?.avg_score)],
+    ["Candidate score", displayNumber(candidate?.avg_score)],
+    ["Score delta", displayNumber(comparison?.avg_score_delta)],
+    ["Pass-rate delta", displayNumber(comparison?.pass_rate_delta)],
+    ["Regressions", text(comparison?.regressions)],
+    ["Improvements", text(comparison?.improvements)]
+  ]);
+  renderGate(value);
 }
-function targetSourceLabel(source) {
-  switch (source) {
-    case "environment":
-      return "TT_TARGET";
-    case "adjacent-config":
-      return "adjacent local-runner.json";
-    default:
-      return "default";
+function renderRunComparison(value) {
+  const runA = record2(value.run_a);
+  const runB = record2(value.run_b);
+  const shared = record2(value.shared);
+  const sharedA = record2(shared?.run_a);
+  const sharedB = record2(shared?.run_b);
+  printTable(
+    ["Run", "Candidate score", "Token F1", "Examples"],
+    [
+      [
+        displayId(runA?.run_id),
+        displayNumber(sharedA?.candidate_avg_score) ?? "\u2014",
+        displayNumber(sharedA?.candidate_avg_token_f1) ?? "\u2014",
+        text(shared?.examples) ?? "0"
+      ],
+      [
+        displayId(runB?.run_id),
+        displayNumber(sharedB?.candidate_avg_score) ?? "\u2014",
+        displayNumber(sharedB?.candidate_avg_token_f1) ?? "\u2014",
+        text(shared?.examples) ?? "0"
+      ]
+    ]
+  );
+  const notes = Array.isArray(value.notes) ? value.notes.filter((note) => typeof note === "string") : [];
+  for (const note of notes) printWarning(note);
+}
+function renderModelsList(value) {
+  const modelRows = rows(value);
+  if (modelRows.length === 0) {
+    printWarning("No local models found.");
+    return;
   }
+  printTable(
+    ["Model", "Base model", "Run", "Provider", "Created"],
+    modelRows.map((model) => [
+      displayId(model.id),
+      truncate(text(model.base_model) ?? "\u2014", 32),
+      displayId(model.run_id),
+      text(model.provider) ?? "\u2014",
+      formatDate(text(model.created_at))
+    ])
+  );
 }
-function formatShellContext(context, selectedTarget, targetSource) {
-  const specLabel = context.spec ? context.spec.parseError ? `${context.spec.path} (invalid JSON)` : context.spec.path : "not found";
-  const sourceLabel = targetSource === "session" ? "session" : targetSource === "command-option" ? "--target" : targetSourceLabel(targetSource);
-  const lines = [
-    `Target         ${selectedTarget} (${sourceLabel})`,
-    `Project        ${context.projectName}`,
-    `Directory      ${context.cwd}`,
-    `Spec           ${specLabel}`,
-    `Spec ID        ${valueOrDash(context.spec?.id)}`,
-    `Base model     ${valueOrDash(context.spec?.baseModel)}`,
-    `Examples       ${valueOrDash(context.spec?.exampleCount)}`,
-    `Cloud endpoint ${context.cloud.baseUrl}`,
-    `Cloud auth     ${context.cloud.authenticated ? `yes (${context.cloud.keyPrefix})` : "no"}`,
-    `Local config   ${context.local.configPath ?? "not found"}`,
-    `Artifact root  ${context.local.artifactRoot}`,
-    `Store root     ${context.local.storeRoot}`
-  ];
-  for (const warning of context.warnings) lines.push(`Warning        ${warning}`);
-  return lines;
+function renderModelRecord(value) {
+  const model = record2(value.model) ?? value;
+  const artifact = record2(value.artifact);
+  const integrity = record2(value.integrity);
+  printDetail([
+    ["Model", text(model.id) ?? text(value.active)],
+    ["Base model", text(model.base_model)],
+    ["Run", text(model.run_id)],
+    ["Provider", text(model.provider)],
+    ["Artifact", text(model.artifact_uri) ?? text(artifact?.path)],
+    ["Manifest", text(value.manifest_path)],
+    ["Verified files", text(integrity?.checked)],
+    ["Created", formatDate(text(model.created_at))]
+  ]);
 }
-function formatShellStatus(context, selectedTarget) {
-  const lines = [
-    `Workflow       ${selectedTarget}`,
-    `Spec           ${context.spec?.name ?? (context.spec ? "unnamed" : "not found")}`
-  ];
-  if (selectedTarget === "cloud") {
-    lines.push(
-      `Authentication ${context.cloud.authenticated ? `ready (${context.cloud.keyPrefix})` : "not configured"}`,
-      `Endpoint       ${context.cloud.baseUrl}`,
-      "Remote status  not queried"
-    );
-  } else {
-    lines.push(
-      `Local config   ${context.local.configPath ?? "not found"}`,
-      `Active model   ${context.local.activeModelId ?? "base"}`,
-      `Latest run     ${context.local.latestRun ? `${context.local.latestRun.id} (${context.local.latestRun.status ?? "unknown"})` : "none"}`,
-      "Host checks    not run (use doctor)"
-    );
-  }
-  return lines;
+function renderModelPrefetch(value) {
+  printSuccess(
+    value.local_files_only === true ? "Verified the local base-model snapshot" : "Base model is ready locally"
+  );
+  printDetail([
+    ["Base model", text(value.base_model)],
+    ["Revision", text(value.snapshot_revision)],
+    ["Snapshot", text(value.snapshot_path)],
+    ["Files", text(value.file_count)],
+    ["Size", displayBytes(value.size_bytes)],
+    ["Cache", text(value.model_cache) ?? text(value.hf_home)]
+  ]);
 }
-
-// src/shell.ts
-var ShellParseError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ShellParseError";
+function renderActiveModel(value) {
+  const active = text(value.active) ?? "base";
+  const pointer = record2(value.pointer);
+  if (pointer?.action === "activate") {
+    printSuccess(`Activated local model ${active}`);
+  } else if (pointer?.action === "rollback") {
+    printSuccess(`Rolled back to ${active}`);
   }
-};
-function operatorError(operator) {
-  return new ShellParseError(
-    `Shell operator ${JSON.stringify(operator)} is not supported. Run TT commands directly; pipes, redirects, and command substitution are disabled.`
-  );
+  printDetail([
+    ["Active", active],
+    ["Run", text(pointer?.run_id)],
+    ["Previous", text(pointer?.previous_model_id) ?? "base"],
+    ["Changed", formatDate(text(pointer?.activated_at))],
+    ["Manifest", text(value.manifest_path)]
+  ]);
 }
-function tokenizeShellInput(input) {
-  if (input.includes("\0")) {
-    throw new ShellParseError("Command input must not contain NUL bytes.");
+function renderServePlan(value) {
+  printSuccess("Local serving plan is valid");
+  printDetail([
+    ["Model", text(value.model_id) ?? text(value.base_model)],
+    ["URL", text(value.url)],
+    ["Artifact", text(value.artifact_path)],
+    ["Manifest", text(value.manifest_path)],
+    ["Command", displayCommand(value.command)]
+  ]);
+}
+function renderKnownJson(args, value) {
+  const command = args[0];
+  const subcommand = args[1];
+  if (command === "doctor" && isRecord2(value)) {
+    renderDoctor(value);
+    return true;
   }
-  if (/[\r\n]/.test(input)) {
-    throw new ShellParseError("Enter one command at a time.");
+  if (command === "init" && isRecord2(value)) {
+    renderInit(value);
+    return true;
   }
-  if (input.trimStart().startsWith("!")) {
-    throw new ShellParseError("Shell escapes are disabled; enter a TT command instead.");
+  if (command === "validate" && isRecord2(value)) {
+    renderValidate(value);
+    return true;
   }
-  const tokens = [];
-  let token = "";
-  let tokenStarted = false;
-  let quote = "none";
-  const finishToken = () => {
-    if (!tokenStarted) return;
-    tokens.push(token);
-    token = "";
-    tokenStarted = false;
-  };
-  for (let index = 0; index < input.length; index += 1) {
-    const character = input[index];
-    if (quote === "single") {
-      if (character === "'") {
-        quote = "none";
-      } else {
-        token += character;
-      }
-      continue;
+  if (command === "run" && isRecord2(value)) {
+    renderRun(value);
+    return true;
+  }
+  if (command === "runs") {
+    if ((subcommand === void 0 || subcommand === "list") && Array.isArray(value)) {
+      renderRunsList(value);
+      return true;
+    }
+    if (subcommand === "events" && Array.isArray(value)) {
+      renderRunEvents(value);
+      return true;
     }
-    if (quote === "double") {
-      if (character === '"') {
-        quote = "none";
-        continue;
-      }
-      if (character === "\\") {
-        const escaped = input[index + 1];
-        if (escaped === void 0) {
-          throw new ShellParseError("Command ends with an unfinished escape.");
-        }
-        token += escaped;
-        tokenStarted = true;
-        index += 1;
-        continue;
-      }
-      if (character === "`") throw operatorError("`\u2026`");
-      if (character === "$" && input[index + 1] === "(") {
-        throw operatorError("$(\u2026)");
-      }
-      token += character;
-      tokenStarted = true;
-      continue;
+    if (subcommand === "get" && isRecord2(value)) {
+      renderRunRecord(value);
+      return true;
     }
-    if (/\s/.test(character)) {
-      finishToken();
-      continue;
+    if (subcommand === "report" && isRecord2(value)) {
+      renderRunReport(value);
+      return true;
     }
-    if (character === "'") {
-      quote = "single";
-      tokenStarted = true;
-      continue;
+    if (subcommand === "compare" && isRecord2(value)) {
+      renderRunComparison(value);
+      return true;
     }
-    if (character === '"') {
-      quote = "double";
-      tokenStarted = true;
-      continue;
+  }
+  if (command === "models") {
+    if ((subcommand === void 0 || subcommand === "list") && Array.isArray(value)) {
+      renderModelsList(value);
+      return true;
     }
-    if (character === "\\") {
-      const escaped = input[index + 1];
-      if (escaped === void 0) {
-        throw new ShellParseError("Command ends with an unfinished escape.");
-      }
-      token += escaped;
-      tokenStarted = true;
-      index += 1;
-      continue;
+    if ((subcommand === "get" || subcommand === "verify") && isRecord2(value)) {
+      if (subcommand === "verify") printSuccess("Local model artifact is valid");
+      renderModelRecord(value);
+      return true;
     }
-    if (character === "`") throw operatorError("`\u2026`");
-    if (character === "$" && input[index + 1] === "(") {
-      throw operatorError("$(\u2026)");
+    if ((subcommand === "prefetch" || subcommand === "verify-base") && isRecord2(value)) {
+      renderModelPrefetch(value);
+      return true;
     }
-    if (character === "|" || character === ">" || character === "<" || character === ";" || character === "&") {
-      const doubled = input[index + 1] === character && (character === "|" || character === "&");
-      throw operatorError(doubled ? character.repeat(2) : character);
+    if (["active", "activate", "rollback"].includes(subcommand ?? "") && isRecord2(value)) {
+      renderActiveModel(value);
+      return true;
+    }
+    if (subcommand === "serve" && isRecord2(value)) {
+      renderServePlan(value);
+      return true;
     }
-    token += character;
-    tokenStarted = true;
   }
-  if (quote !== "none") {
-    throw new ShellParseError(
-      `Command has an unterminated ${quote === "single" ? "single" : "double"} quote.`
-    );
+  if (command === "serve" && isRecord2(value)) {
+    renderServePlan(value);
+    return true;
   }
-  finishToken();
-  return tokens;
+  return false;
 }
-function routeShellCommand(input, activeMode) {
-  let args = tokenizeShellInput(input);
-  if (args.length === 0) return null;
-  if (args[0] === "tt") {
-    args = args.slice(1);
-    if (args.length === 0) {
-      throw new ShellParseError("The TT shell is already open; enter a command such as `runs list`.");
+function lastNonEmptyLine(value) {
+  return value.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).at(-1);
+}
+function adaptLocalCliText(value) {
+  return value.replace(
+    /(?<![.@/\w])tuned-tensor-local(?=$|[\s:`\]])/g,
+    "tt local"
+  ).replace(/(?<![.@/\w])tt-local(?=$|[\s:`\]])/g, "tt local");
+}
+function localCliErrorEnvelope(payload) {
+  const rawMessage = payload.errorMessage ?? (payload.stderr.trim() || void 0) ?? lastNonEmptyLine(payload.stdout) ?? `tt local exited with code ${payload.exitCode}.`;
+  return {
+    error: {
+      status: null,
+      code: "LOCAL_CLI_ERROR",
+      message: adaptLocalCliText(rawMessage),
+      exit_code: payload.exitCode,
+      signal: payload.signal
+    }
+  };
+}
+function localCliTextEnvelope(payload) {
+  const output = adaptLocalCliText(payload.stdout).trim();
+  if (payload.args[0] === "info") {
+    const lines = output.split(/\r?\n/);
+    const heading = lines[0]?.match(/^([^:]+):\s*(.+)$/);
+    const fields = Object.fromEntries(
+      lines.slice(1).flatMap((line) => {
+        const match = line.match(/^([^:]+):\s*(.*)$/);
+        return match ? [[match[1].trim().toLowerCase().replaceAll(" ", "_"), match[2].trim()]] : [];
+      })
+    );
+    if (heading) {
+      return {
+        data: {
+          name: heading[1],
+          description: heading[2],
+          ...fields
+        }
+      };
     }
   }
-  if (args[0]?.startsWith("/")) {
-    throw new ShellParseError("Slash commands are session commands and cannot be routed to a workflow.");
+  return { data: { output } };
+}
+function renderLocalOutput(payload, options = {}) {
+  if (payload.streamingStdout && payload.exitCode === 0 && !payload.errorMessage) {
+    return;
   }
-  const override = args[0];
-  if (override === "cloud" || override === "local") {
-    if (args.length === 1) {
-      throw new ShellParseError(`Add a ${override} command, or use \`/mode ${override}\` to switch workflows.`);
+  const output = options.stdout ?? process.stdout;
+  if (options.jsonMode) {
+    if (payload.hasJson) {
+      output.write(payload.stdout);
+      return;
     }
-    return { target: override, args: args.slice(1) };
+    if (payload.exitCode !== 0 || payload.errorMessage) {
+      output.write(`${JSON.stringify(localCliErrorEnvelope(payload), null, 2)}
+`);
+      return;
+    }
+    output.write(`${JSON.stringify(localCliTextEnvelope(payload), null, 2)}
+`);
+    return;
+  }
+  if (payload.droppedSpecKeys.length > 0) {
+    printWarning(
+      `Ignored project field(s) unsupported by the local runtime: ${payload.droppedSpecKeys.join(", ")}.`
+    );
+  }
+  if (payload.hasJson && renderKnownJson(payload.args, payload.json)) return;
+  if (payload.hasJson) {
+    printJson(payload.json);
+    return;
+  }
+  if (payload.stdout) output.write(adaptLocalCliText(payload.stdout));
+  if (payload.exitCode !== 0 && !payload.stderr && !payload.stdout) {
+    printError(
+      payload.errorMessage ? adaptLocalCliText(payload.errorMessage) : `tt local exited with code ${payload.exitCode}.`
+    );
   }
-  return { target: activeMode, args };
 }
-var SLASH_NAMES = /* @__PURE__ */ new Set([
-  "help",
-  "status",
-  "context",
-  "mode",
-  "clear",
-  "cd",
-  "exit"
+
+// src/local-runner.ts
+var localRequire = createRequire(import.meta.url);
+var DEFAULT_SPEC_NAME = "tunedtensor.json";
+var VALUE_OPTIONS = /* @__PURE__ */ new Set([
+  "--config",
+  "--name",
+  "--model",
+  "--output",
+  "--profile",
+  "--host",
+  "--port",
+  "--device",
+  "--max-tokens",
+  "--temperature",
+  "--top-p",
+  "--max-concurrent-requests",
+  "--spec",
+  "--api-key-env"
 ]);
-function parseSlashCommand(input) {
-  const trimmed = input.trim();
-  if (!trimmed) return null;
-  if (trimmed === "?") return { name: "help", args: [] };
-  if (trimmed.startsWith("? ")) {
+function isOptionWithInlineValue(value) {
+  const equals = value.indexOf("=");
+  return equals !== -1 && VALUE_OPTIONS.has(value.slice(0, equals));
+}
+function positionalIndices(args, start) {
+  const indices = [];
+  let optionsEnded = false;
+  for (let index = start; index < args.length; index += 1) {
+    const value = args[index];
+    if (!optionsEnded && value === "--") {
+      optionsEnded = true;
+      continue;
+    }
+    if (!optionsEnded && value.startsWith("-")) {
+      if (!isOptionWithInlineValue(value) && VALUE_OPTIONS.has(value)) index += 1;
+      continue;
+    }
+    indices.push(index);
+  }
+  return indices;
+}
+function optionValueArgument(args, name) {
+  for (let index = 0; index < args.length; index += 1) {
+    const value = args[index];
+    if (value === name) {
+      const path = args[index + 1];
+      if (!path) return null;
+      return {
+        path,
+        replace(projectedPath) {
+          args[index + 1] = projectedPath;
+        }
+      };
+    }
+    if (value.startsWith(`${name}=`)) {
+      const path = value.slice(name.length + 1);
+      if (!path) return null;
+      return {
+        path,
+        replace(projectedPath) {
+          args[index] = `${name}=${projectedPath}`;
+        }
+      };
+    }
+  }
+  return null;
+}
+function positionalSpecArgument(args, start, defaultPath) {
+  const positional = positionalIndices(args, start)[0];
+  if (positional !== void 0) {
     return {
-      name: "help",
-      args: tokenizeShellInput(trimmed.slice(1))
+      path: args[positional],
+      replace(projectedPath) {
+        args[positional] = projectedPath;
+      }
     };
   }
-  if (!trimmed.startsWith("/")) return null;
-  if (trimmed === "/") return { name: "palette", args: [] };
-  const tokens = tokenizeShellInput(trimmed);
-  const rawName = tokens[0].slice(1).toLowerCase();
-  if (!SLASH_NAMES.has(rawName)) {
-    throw new ShellParseError(`Unknown session command: /${rawName}. Use /help to see available commands.`);
-  }
   return {
-    name: rawName,
-    args: tokens.slice(1)
+    path: defaultPath,
+    replace(projectedPath) {
+      args.splice(start, 0, projectedPath);
+    }
   };
 }
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function assertNoArgs(command, args) {
-  if (args.length > 0) {
-    throw new ShellParseError(`/${command} does not accept arguments.`);
-  }
-}
-function expandDirectory(value, cwd, env) {
-  const home = env.HOME ? resolve3(env.HOME) : homedir3();
-  if (value === "~") return home;
-  if (value.startsWith("~/")) return resolve3(home, value.slice(2));
-  return isAbsolute3(value) ? resolve3(value) : resolve3(cwd, value);
-}
-function helpText(mode, query, palette = false) {
-  const groups = groupedCatalog(mode, query);
-  const lines = [];
-  lines.push(palette ? `Commands for ${mode} \u2014 type a command or use cloud/local as a one-shot prefix` : `TT ${mode} commands${query ? ` matching ${JSON.stringify(query)}` : ""}`);
-  if (groups.size === 0) {
-    lines.push("  No matching commands.");
-  } else {
-    for (const [group, commands] of groups) {
-      lines.push(`
-${group}`);
-      for (const command of commands) {
-        lines.push(`  ${command.path.padEnd(22)} ${command.description}`);
-      }
-    }
+function selectedSpecArgument(args, cwd) {
+  const command = args[0];
+  if (["doctor", "validate", "run"].includes(command ?? "")) {
+    return positionalSpecArgument(args, 1, join3(cwd, DEFAULT_SPEC_NAME));
   }
-  if (!query) {
-    lines.push("\nSession");
-    for (const command of SLASH_COMMANDS) {
-      lines.push(`  ${command.path.padEnd(22)} ${command.description}`);
-    }
-    lines.push("  ?                      Alias for /help.");
-    lines.push("\nUse Tab to complete commands. Shell operators and shell escapes are disabled.");
+  if (command === "models" && ["prefetch", "verify-base"].includes(args[1] ?? "")) {
+    return positionalSpecArgument(args, 2, join3(cwd, DEFAULT_SPEC_NAME));
   }
-  return `${lines.join("\n")}
-`;
+  const serves = command === "serve" || command === "models" && args[1] === "serve";
+  if (!serves) return null;
+  const explicit = optionValueArgument(args, "--spec");
+  if (explicit) return explicit;
+  return null;
 }
-function renderShellBanner(snapshot) {
-  const spec = snapshot.context.spec?.name ?? snapshot.context.spec?.path ?? "no spec";
-  return [
-    chalk2.bold.cyan("Tuned Tensor"),
-    `  ${chalk2.bold(snapshot.mode)} \xB7 ${snapshot.context.projectName} \xB7 ${spec}`,
-    chalk2.dim("  /help for commands \xB7 /mode cloud|local to switch workflows"),
-    ""
-  ].join("\n");
+async function pathIsFile(path) {
+  return (await stat3(path).catch(() => null))?.isFile() ?? false;
 }
-function renderShellPrompt(snapshot) {
-  return `${chalk2.cyan("tt")} ${chalk2.bold(snapshot.mode)} ${chalk2.dim(snapshot.context.projectName)} \u203A `;
+function resolveFromCwd(path, cwd) {
+  if (isAbsolute3(path)) return path;
+  return resolve3(cwd, path);
 }
-var TunedTensorShellSession = class _TunedTensorShellSession {
-  constructor(runner, io, env, contextProvider, initialContext) {
-    this.runner = runner;
-    this.io = io;
-    this.env = env;
-    this.contextProvider = contextProvider;
-    this.mode = initialContext.inferredTarget;
-    this.modeSource = initialContext.targetSource;
-    this.cwd = initialContext.cwd;
-    this.context = initialContext;
-  }
-  mode;
-  modeSource;
-  cwd;
-  context;
-  static async create(options) {
-    const env = options.env ?? process.env;
-    const cwd = resolve3(options.cwd ?? process.cwd());
-    const contextProvider = options.contextProvider ?? ((input) => discoverShellContext(input));
-    const initialContext = await contextProvider({ cwd, env });
-    return new _TunedTensorShellSession(
-      options.runner,
-      options.io,
-      env,
-      contextProvider,
-      initialContext
-    );
-  }
-  snapshot() {
+async function projectSpecArguments(originalArgs, cwd) {
+  const args = [...originalArgs];
+  if (args.includes("--help") || args.includes("-h")) {
     return {
-      mode: this.mode,
-      modeSource: this.modeSource,
-      cwd: this.cwd,
-      context: this.context
+      args,
+      droppedSpecKeys: [],
+      pathReplacements: [],
+      cleanup: async () => {
+      }
     };
   }
-  prompt() {
-    return renderShellPrompt(this.snapshot());
-  }
-  banner() {
-    return renderShellBanner(this.snapshot());
+  const selected = selectedSpecArgument(args, cwd);
+  if (!selected) {
+    return {
+      args,
+      droppedSpecKeys: [],
+      pathReplacements: [],
+      cleanup: async () => {
+      }
+    };
   }
-  async refreshContext() {
-    this.context = await this.contextProvider({ cwd: this.cwd, env: this.env });
-    this.cwd = this.context.cwd;
-    if (this.modeSource !== "session" && this.modeSource !== "environment") {
-      this.mode = this.context.inferredTarget;
-      this.modeSource = this.context.targetSource;
-    }
+  const sourcePath = resolveFromCwd(selected.path, cwd);
+  if (!await pathIsFile(sourcePath)) {
+    return {
+      args,
+      droppedSpecKeys: [],
+      pathReplacements: [],
+      cleanup: async () => {
+      }
+    };
   }
-  writeLines(lines) {
-    this.io.write(`${lines.join("\n")}
-`);
+  const raw = JSON.parse(await readFile2(sourcePath, "utf8"));
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error(`${sourcePath} must contain a JSON object.`);
   }
-  async handleSlash(command) {
-    switch (command.name) {
-      case "palette":
-        this.io.write(helpText(this.mode, void 0, true));
-        return "continue";
-      case "help":
-        this.io.write(helpText(this.mode, command.args.join(" ") || void 0));
-        return "continue";
-      case "status":
-        assertNoArgs("status", command.args);
-        await this.refreshContext();
-        this.writeLines(formatShellStatus(this.context, this.mode));
-        return "continue";
-      case "context":
-        assertNoArgs("context", command.args);
-        await this.refreshContext();
-        this.writeLines(formatShellContext(this.context, this.mode, this.modeSource));
-        return "continue";
-      case "mode": {
-        if (command.args.length === 0) {
-          this.io.write(`Current workflow: ${this.mode}
-`);
-          return "continue";
-        }
-        if (command.args.length !== 1 || !["cloud", "local"].includes(command.args[0])) {
-          throw new ShellParseError("Usage: /mode cloud|local");
-        }
-        this.mode = command.args[0];
-        this.modeSource = "session";
-        this.io.write(`Workflow switched to ${this.mode}.
-`);
-        return "continue";
-      }
-      case "clear":
-        assertNoArgs("clear", command.args);
-        this.io.clear();
-        return "continue";
-      case "cd": {
-        if (command.args.length === 0) {
-          this.io.write(`${this.cwd}
-`);
-          return "continue";
-        }
-        if (command.args.length !== 1) {
-          throw new ShellParseError("Usage: /cd <directory>; quote paths containing spaces.");
-        }
-        const nextDirectory = expandDirectory(command.args[0], this.cwd, this.env);
-        const metadata = await stat3(nextDirectory).catch(() => null);
-        if (!metadata?.isDirectory()) {
-          throw new ShellParseError(`Not a directory: ${nextDirectory}`);
-        }
-        this.cwd = nextDirectory;
-        await this.refreshContext();
-        this.io.write(`Directory: ${this.cwd}
-`);
-        return "continue";
+  const body = raw;
+  const runRequestKeys = [
+    "run_id",
+    "behavior_spec_id",
+    "run_number",
+    "spec_snapshot"
+  ].filter((key) => key in body);
+  if ("spec_snapshot" in body || runRequestKeys.length >= 2) {
+    return {
+      args,
+      droppedSpecKeys: [],
+      pathReplacements: [],
+      cleanup: async () => {
       }
-      case "exit":
-        assertNoArgs("exit", command.args);
-        return "exit";
-    }
+    };
   }
-  async handleLine(input) {
-    try {
-      const slash = parseSlashCommand(input);
-      if (slash) return await this.handleSlash(slash);
-      const routed = routeShellCommand(input, this.mode);
-      if (!routed) return "continue";
-      await this.runner({
-        target: routed.target,
-        args: [...routed.args],
-        cwd: this.cwd
-      });
-      await this.refreshContext();
-      return "continue";
-    } catch (error) {
-      this.io.writeError(`${chalk2.red("Error:")} ${errorMessage(error)}
-`);
-      return "continue";
-    }
+  const projected = projectLocalSpec(body);
+  if (projected.droppedKeys.length === 0) {
+    return {
+      args,
+      droppedSpecKeys: [],
+      pathReplacements: [],
+      cleanup: async () => {
+      }
+    };
   }
-};
-async function createShellSession(options) {
-  return TunedTensorShellSession.create(options);
+  const temporaryPath = join3(
+    dirname2(sourcePath),
+    `.${basename3(sourcePath)}.tt-local-${process.pid}-${randomUUID()}.json`
+  );
+  await writeFile(
+    temporaryPath,
+    `${JSON.stringify(projected.body, null, 2)}
+`,
+    { encoding: "utf8", flag: "wx", mode: 384 }
+  );
+  selected.replace(temporaryPath);
+  return {
+    args,
+    droppedSpecKeys: projected.droppedKeys,
+    pathReplacements: [{
+      sourcePath,
+      projectedPath: temporaryPath
+    }],
+    cleanup: () => rm(temporaryPath, { force: true })
+  };
 }
-function streamIsTTY(stream) {
-  return Boolean(stream.isTTY);
+function resolveLocalCliEntrypoint() {
+  try {
+    return localRequire.resolve("@tuned-tensor/local");
+  } catch (error) {
+    throw new Error(
+      "TT Local is not installed. Reinstall @tuned-tensor/cli with its local runtime dependency.",
+      { cause: error }
+    );
+  }
 }
-async function withForegroundSignalHandoff(control, run) {
-  const signals = control.signals ?? process;
-  const restoreRawMode = control.input.isRaw === true && typeof control.input.setRawMode === "function";
-  const keepParentAlive = () => {
-  };
-  control.pauseReadline();
-  if (restoreRawMode) control.input.setRawMode(false);
-  signals.on("SIGINT", keepParentAlive);
+function localCommandStreamsStdout(args) {
+  const serves = args[0] === "serve" || args[0] === "models" && args[1] === "serve";
+  return serves && !args.includes("--print-command") && !args.includes("--help") && !args.includes("-h");
+}
+function parseJsonOutput(stdout2) {
+  if (!stdout2.trim()) return { hasJson: false, json: void 0 };
   try {
-    return await run();
-  } finally {
-    signals.off("SIGINT", keepParentAlive);
-    if (restoreRawMode) control.input.setRawMode(true);
-    control.resumeReadline();
+    return { hasJson: true, json: JSON.parse(stdout2) };
+  } catch {
+    return { hasJson: false, json: void 0 };
   }
 }
-function streamIO(output, error) {
-  return {
-    write(text2) {
-      output.write(text2);
-    },
-    writeError(text2) {
-      error.write(text2);
-    },
-    clear() {
-      output.write("\x1B[2J\x1B[H");
-    }
-  };
+function signalExitCode(signal) {
+  if (!signal) return 1;
+  const signalNumber = osConstants.signals[signal];
+  return typeof signalNumber === "number" ? 128 + signalNumber : 1;
 }
-async function startInteractiveShell(options) {
-  const input = options.input ?? process.stdin;
-  const output = options.output ?? process.stdout;
-  const error = options.error ?? process.stderr;
-  if (options.requireTTY !== false && (!streamIsTTY(input) || !streamIsTTY(output))) {
-    throw new Error("The interactive TT shell requires a TTY.");
+function writeStream(stream, chunk) {
+  stream.write(chunk);
+}
+function normalizeProjectedPaths(value, replacements) {
+  let normalized = value;
+  for (const replacement of replacements) {
+    const encodedProjectedPath = JSON.stringify(
+      replacement.projectedPath
+    ).slice(1, -1);
+    const encodedSourcePath = JSON.stringify(
+      replacement.sourcePath
+    ).slice(1, -1);
+    normalized = normalized.replaceAll(encodedProjectedPath, encodedSourcePath).replaceAll(replacement.projectedPath, replacement.sourcePath);
   }
-  let readline;
-  const terminalInput = input;
-  const foregroundRunner = (request2) => withForegroundSignalHandoff(
+  return normalized;
+}
+async function spawnLocalCli(args) {
+  const output = args.stdout ?? process.stdout;
+  const errors = args.stderr ?? process.stderr;
+  const pipeInput = Boolean(args.stdin && args.stdin !== process.stdin);
+  const pipeStreamingOutput = args.streamingStdout && Boolean(args.stdout && args.stdout !== process.stdout);
+  const child = spawn(
+    args.nodeExecutable,
+    [args.entrypoint, ...args.commandArgs],
     {
-      input: terminalInput,
-      pauseReadline: () => readline?.pause(),
-      resumeReadline: () => readline?.resume()
-    },
-    () => options.runner(request2)
+      cwd: args.cwd,
+      env: args.env,
+      stdio: [
+        pipeInput ? "pipe" : "inherit",
+        args.streamingStdout && !pipeStreamingOutput ? "inherit" : "pipe",
+        "pipe"
+      ],
+      detached: process.platform !== "win32"
+    }
   );
-  const session = await createShellSession({
-    runner: foregroundRunner,
-    io: streamIO(output, error),
-    cwd: options.cwd,
-    env: options.env
+  if (pipeInput && args.stdin && child.stdin) args.stdin.pipe(child.stdin);
+  let stdout2 = "";
+  let stderr = "";
+  child.stdout?.setEncoding("utf8");
+  child.stderr?.setEncoding("utf8");
+  child.stdout?.on("data", (chunk) => {
+    const normalized = normalizeProjectedPaths(
+      chunk,
+      args.pathReplacements
+    );
+    if (args.streamingStdout) writeStream(output, normalized);
+    else stdout2 += normalized;
   });
-  const completer = createCommandCompleter(() => session.snapshot().mode);
-  readline = createInterface({
-    input,
-    output,
-    terminal: true,
-    historySize: 100,
-    removeHistoryDuplicates: true,
-    completer
+  child.stderr?.on("data", (chunk) => {
+    const normalized = normalizeProjectedPaths(
+      chunk,
+      args.pathReplacements
+    );
+    stderr += normalized;
+    writeStream(
+      errors,
+      args.jsonMode ? normalized : adaptLocalCliText(normalized)
+    );
   });
-  readline.on("SIGINT", () => {
-    output.write("\n");
-    readline?.setPrompt(session.prompt());
-    readline?.write(null, { ctrl: true, name: "u" });
+  return new Promise((resolveChild) => {
+    let spawnError;
+    const forwardSignal = (signal) => {
+      const childSignal = signal === "SIGHUP" ? "SIGTERM" : signal;
+      if (child.pid && process.platform !== "win32") {
+        try {
+          process.kill(-child.pid, childSignal);
+          return;
+        } catch {
+        }
+      }
+      child.kill(childSignal);
+    };
+    const onSigint = () => forwardSignal("SIGINT");
+    const onSigterm = () => forwardSignal("SIGTERM");
+    const onSighup = () => forwardSignal("SIGHUP");
+    const cleanup = () => {
+      process.off("SIGINT", onSigint);
+      process.off("SIGTERM", onSigterm);
+      if (process.platform !== "win32") process.off("SIGHUP", onSighup);
+    };
+    process.on("SIGINT", onSigint);
+    process.on("SIGTERM", onSigterm);
+    if (process.platform !== "win32") process.on("SIGHUP", onSighup);
+    child.once("error", (error) => {
+      spawnError = error;
+    });
+    child.once("close", (code, signal) => {
+      cleanup();
+      resolveChild({
+        exitCode: spawnError ? 1 : code ?? signalExitCode(signal),
+        signal,
+        stdout: stdout2,
+        stderr,
+        ...spawnError ? { errorMessage: spawnError.message } : {}
+      });
+    });
   });
-  output.write(session.banner());
-  readline.setPrompt(session.prompt());
-  readline.prompt();
+}
+function setupFailure(originalArgs, error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return {
+    args: [...originalArgs],
+    projectedArgs: [...originalArgs],
+    entrypoint: null,
+    exitCode: 1,
+    signal: null,
+    stdout: "",
+    stderr: "",
+    hasJson: false,
+    json: void 0,
+    streamingStdout: false,
+    droppedSpecKeys: [],
+    errorMessage: message
+  };
+}
+async function runLocalCommand(args, options = {}) {
+  const cwd = resolve3(options.cwd ?? process.cwd());
+  let projected;
   try {
-    for await (const line of readline) {
-      const action = await session.handleLine(line);
-      if (action === "exit") {
-        readline.close();
-        break;
-      }
-      readline.setPrompt(session.prompt());
-      readline.prompt();
-    }
+    const entrypoint = options.entrypoint ?? resolveLocalCliEntrypoint();
+    projected = await projectSpecArguments(args, cwd);
+    const streamingStdout = localCommandStreamsStdout(projected.args);
+    const result = await spawnLocalCli({
+      entrypoint,
+      commandArgs: projected.args,
+      cwd,
+      env: options.env ?? process.env,
+      nodeExecutable: options.nodeExecutable ?? process.execPath,
+      streamingStdout,
+      jsonMode: options.jsonMode ?? false,
+      stdin: options.stdin,
+      stdout: options.stdout,
+      stderr: options.stderr,
+      pathReplacements: projected.pathReplacements
+    });
+    const parsed = parseJsonOutput(result.stdout);
+    return {
+      args: [...args],
+      projectedArgs: projected.args,
+      entrypoint,
+      ...result,
+      ...parsed,
+      streamingStdout,
+      droppedSpecKeys: projected.droppedSpecKeys
+    };
+  } catch (error) {
+    return setupFailure(args, error);
   } finally {
-    readline.close();
+    await projected?.cleanup().catch(() => void 0);
   }
 }
-function ciEnabled(value) {
-  if (!value) return false;
-  return !["0", "false", "no", "off"].includes(value.trim().toLowerCase());
-}
-function shouldStartInteractiveShell(options) {
-  const env = options.env ?? process.env;
-  return options.args.length === 0 && options.stdinIsTTY === true && options.stdoutIsTTY === true && !ciEnabled(env.CI) && env.TERM !== "dumb";
+async function executeLocalCommand(args, options = {}) {
+  const result = await runLocalCommand(args, options);
+  renderLocalOutput(result, {
+    jsonMode: options.jsonMode,
+    stdout: options.stdout
+  });
+  if (result.exitCode !== 0) process.exitCode = result.exitCode;
+  return result;
 }
 
 // src/commands/auth.ts
 import { createInterface as createInterface2 } from "readline/promises";
 import { stdin, stdout } from "process";
 import { Writable } from "stream";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 async function promptForApiKey(input = stdin, output = stdout) {
   if (input.isTTY !== true || output.isTTY !== true) {
     throw new Error(
@@ -2069,9 +2827,9 @@ function registerAuthCommands(parent) {
       const settingsUrl = `${DEFAULT_BASE_URL}/dashboard/settings`;
       console.log();
       console.log(
-        `  To get your API key, go to ${chalk3.bold("Settings \u2192 API Keys")} in the Tuned Tensor dashboard:`
+        `  To get your API key, go to ${chalk4.bold("Settings \u2192 API Keys")} in the Tuned Tensor dashboard:`
       );
-      console.log(`  ${chalk3.cyan.underline(settingsUrl)}`);
+      console.log(`  ${chalk4.cyan.underline(settingsUrl)}`);
       console.log();
       apiKey = await promptForApiKey();
     }
@@ -2958,18 +3716,18 @@ function findControlChar(value) {
 function formatCodepoint(code) {
   return `U+${code.toString(16).toUpperCase().padStart(4, "0")}`;
 }
-function detectRowFormat(record2) {
-  const input = record2.input;
-  if (input && typeof input === "object" && typeof input.prompt === "string" && Array.isArray(input.assets) && input.assets.length > 0 && typeof record2.output === "string") {
+function detectRowFormat(record3) {
+  const input = record3.input;
+  if (input && typeof input === "object" && typeof input.prompt === "string" && Array.isArray(input.assets) && input.assets.length > 0 && typeof record3.output === "string") {
     return "document_ocr_jsonl";
   }
-  if (typeof record2.input === "string" || typeof record2.output === "string" || !("input" in record2) || !("output" in record2)) {
+  if (typeof record3.input === "string" || typeof record3.output === "string" || !("input" in record3) || !("output" in record3)) {
     return "jsonl";
   }
   return null;
 }
-function validateDocumentOcrRow(record2, rowNumber, errors) {
-  const input = record2.input;
+function validateDocumentOcrRow(record3, rowNumber, errors) {
+  const input = record3.input;
   const assets = input.assets;
   if (typeof input.prompt !== "string" || input.prompt.trim().length === 0) {
     errors.push(`Row ${rowNumber}: OCR input.prompt must be a non-empty string`);
@@ -2981,10 +3739,10 @@ function validateDocumentOcrRow(record2, rowNumber, errors) {
       );
     }
   }
-  if (typeof record2.output !== "string" || record2.output.trim().length === 0) {
+  if (typeof record3.output !== "string" || record3.output.trim().length === 0) {
     errors.push(`Row ${rowNumber}: OCR output must be a non-empty string`);
   } else {
-    const hit = findControlChar(record2.output);
+    const hit = findControlChar(record3.output);
     if (hit) {
       errors.push(
         `Row ${rowNumber}: OCR output contains invisible control character ${formatCodepoint(hit.codepoint)} (${hit.name}) at offset ${hit.offset} \u2014 strip or escape before uploading; some training paths split on it`
@@ -3053,14 +3811,14 @@ function validateDatasetFile(file, requestedFormat) {
       errors.push(`Row ${rowNumber}: expected an object with "input" and "output" fields`);
       continue;
     }
-    const record2 = row;
-    if ("messages" in record2 && !("input" in record2) && !("output" in record2)) {
+    const record3 = row;
+    if ("messages" in record3 && !("input" in record3) && !("output" in record3)) {
       errors.push(
         `Row ${rowNumber}: found OpenAI SFT-style "messages"; Tuned Tensor datasets require flat "input" and "output" strings`
       );
       continue;
     }
-    const rowFormat = detectRowFormat(record2);
+    const rowFormat = detectRowFormat(record3);
     if (!rowFormat) {
       errors.push(
         `Row ${rowNumber}: expected text {"input": string, "output": string} or OCR {"input":{"prompt": string, "assets": [...]}, "output": string}`
@@ -3077,17 +3835,17 @@ function validateDatasetFile(file, requestedFormat) {
       continue;
     }
     if (rowFormat === "document_ocr_jsonl") {
-      validateDocumentOcrRow(record2, rowNumber, errors);
+      validateDocumentOcrRow(record3, rowNumber, errors);
       continue;
     }
-    if (typeof record2.input !== "string") {
+    if (typeof record3.input !== "string") {
       errors.push(`Row ${rowNumber}: missing string "input" field`);
     }
-    if (typeof record2.output !== "string") {
+    if (typeof record3.output !== "string") {
       errors.push(`Row ${rowNumber}: missing string "output" field`);
     }
     for (const field of ["input", "output"]) {
-      const value = record2[field];
+      const value = record3[field];
       if (typeof value !== "string") continue;
       const hit = findControlChar(value);
       if (hit) {
@@ -4090,12 +4848,12 @@ var ManagedModelServer = class {
     clearTimeout(this.idleTimer);
     this.idleTimer = null;
   }
-  writeLog(record2) {
+  writeLog(record3) {
     if (this.logRecordOverride) {
-      this.logRecordOverride(record2);
+      this.logRecordOverride(record3);
       return;
     }
-    const line = `${JSON.stringify(record2)}
+    const line = `${JSON.stringify(record3)}
 `;
     if (this.options.logFile) {
       mkdirSync2(dirname3(this.options.logFile), { recursive: true });
@@ -5535,7 +6293,7 @@ function registerModelsCommands(parent) {
 }
 
 // src/commands/balance.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 var KIND_LABELS = {
   signup_bonus: "Signup bonus",
   topup: "Top-up",
@@ -5550,8 +6308,8 @@ function formatCents3(cents) {
   return `${sign}$${(abs / 100).toFixed(2)}`;
 }
 function formatSigned(cents) {
-  if (cents > 0) return chalk4.green(`+${formatCents3(cents)}`);
-  if (cents < 0) return chalk4.red(formatCents3(cents));
+  if (cents > 0) return chalk5.green(`+${formatCents3(cents)}`);
+  if (cents < 0) return chalk5.red(formatCents3(cents));
   return formatCents3(cents);
 }
 function registerBalanceCommands(parent) {
@@ -5566,7 +6324,7 @@ function registerBalanceCommands(parent) {
       return printJson({ balance, transactions });
     }
     const lowBalance = balance.balance_cents < 100;
-    const balanceLine = lowBalance ? chalk4.red(formatCents3(balance.balance_cents)) + chalk4.dim(" (low)") : chalk4.bold.green(formatCents3(balance.balance_cents));
+    const balanceLine = lowBalance ? chalk5.red(formatCents3(balance.balance_cents)) + chalk5.dim(" (low)") : chalk5.bold.green(formatCents3(balance.balance_cents));
     printDetail([
       ["Credits", balanceLine],
       [
@@ -5581,7 +6339,7 @@ function registerBalanceCommands(parent) {
     ]);
     if (transactions && transactions.length > 0) {
       console.log(`
-${chalk4.bold("Recent transactions")}`);
+${chalk5.bold("Recent transactions")}`);
       printTable(
         ["Date", "Type", "Amount", "Balance", "Reference"],
         transactions.map((row) => [
@@ -5589,19 +6347,19 @@ ${chalk4.bold("Recent transactions")}`);
           KIND_LABELS[row.kind] ?? row.kind,
           formatSigned(row.amount_cents),
           formatCents3(row.balance_after_cents),
-          row.reference_id ? shortId(row.reference_id) : chalk4.dim("\u2014")
+          row.reference_id ? shortId(row.reference_id) : chalk5.dim("\u2014")
         ])
       );
     } else {
       console.log(
         `
-${chalk4.dim("No transactions yet \u2014 run `tt topup` to add credits.")}`
+${chalk5.dim("No transactions yet \u2014 run `tt topup` to add credits.")}`
       );
     }
     if (lowBalance) {
       console.log(
         `
-${formatStatus("preparing")} ${chalk4.yellow(
+${formatStatus("preparing")} ${chalk5.yellow(
           "Run `tt topup` to add more credits before starting a run."
         )}`
       );
@@ -5610,7 +6368,7 @@ ${formatStatus("preparing")} ${chalk4.yellow(
 }
 
 // src/commands/topup.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import open from "open";
 var PRESETS_USD = [10, 25, 50, 100];
 var MIN_USD = 5;
@@ -5649,9 +6407,9 @@ function registerTopupCommands(parent) {
           "amount is required in --json mode (use --amount <usd>)"
         );
       }
-      console.log(chalk5.bold("Add credits via Stripe Checkout"));
+      console.log(chalk6.bold("Add credits via Stripe Checkout"));
       console.log(
-        chalk5.dim(
+        chalk6.dim(
           `Quick picks: ${PRESETS_USD.map((n) => `$${n}`).join(", ")}`
         )
       );
@@ -5678,8 +6436,8 @@ function registerTopupCommands(parent) {
     }
     const url = data.checkout_url;
     console.log(
-      `${chalk5.bold("Checkout URL:")} ${chalk5.cyan(url)}
-` + chalk5.dim("Complete the payment to credit your account.")
+      `${chalk6.bold("Checkout URL:")} ${chalk6.cyan(url)}
+` + chalk6.dim("Complete the payment to credit your account.")
     );
     if (options.open !== false) {
       try {
@@ -5687,7 +6445,7 @@ function registerTopupCommands(parent) {
         printSuccess("Opened Stripe Checkout in your browser.");
       } catch {
         console.log(
-          chalk5.yellow(
+          chalk6.yellow(
             "Could not open browser automatically \u2014 copy the URL above."
           )
         );
@@ -5697,7 +6455,7 @@ function registerTopupCommands(parent) {
 }
 
 // src/commands/eval.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // src/eval/rules.ts
 function validateSpec(spec) {
@@ -5862,7 +6620,7 @@ function registerEvalCommand(parent) {
     const spec = loadSpec(cmdOpts.file);
     const validation = validateSpec(spec);
     if (!isJsonMode()) {
-      console.log(chalk6.dim(`
+      console.log(chalk7.dim(`
 Spec: ${cmdOpts.file}
 `));
     }
@@ -5877,10 +6635,10 @@ Spec: ${cmdOpts.file}
   });
 }
 function printValidation(checks) {
-  console.log(chalk6.bold("Spec Validation"));
+  console.log(chalk7.bold("Spec Validation"));
   for (const check of checks) {
-    const icon = check.passed ? chalk6.green("\u2713") : chalk6.red("\u2717");
-    const msg = check.message ? chalk6.dim(` \u2014 ${check.message}`) : "";
+    const icon = check.passed ? chalk7.green("\u2713") : chalk7.red("\u2717");
+    const msg = check.message ? chalk7.dim(` \u2014 ${check.message}`) : "";
     console.log(`  ${icon} ${check.name}${msg}`);
   }
 }
@@ -6036,16 +6794,28 @@ function createProgram(version, runtime = {}) {
   const openShell = async () => {
     const root = program.opts();
     const shellEnvironment = childEnvironment(root, env);
+    const output = runtime.stdout ?? process.stdout;
+    const error = runtime.stderr ?? process.stderr;
+    const agent = createShellAgent({
+      client: runtime.agentClient ?? createAgentClient({
+        apiKey: root.apiKey ?? shellEnvironment.TUNED_TENSOR_API_KEY,
+        baseUrl: root.baseUrl ?? shellEnvironment.TUNED_TENSOR_URL
+      }),
+      output,
+      error
+    });
     await launchShell({
       runner: shellRunner,
+      agent,
       input: runtime.stdin ?? process.stdin,
-      output: runtime.stdout ?? process.stdout,
-      error: runtime.stderr ?? process.stderr,
+      output,
+      error,
       cwd,
-      env: shellEnvironment
+      env: shellEnvironment,
+      version
     });
   };
-  program.name("tt").description("Tuned Tensor \u2014 one terminal for cloud and local fine-tuning").version(version).option("-k, --api-key <key>", "API key (overrides stored key)").option(
+  program.name("tt").description("Tuned Tensor \u2014 converse, train, and inspect from one terminal").version(version).option("-k, --api-key <key>", "API key (overrides stored key)").option(
     "-u, --base-url <url>",
     "API base URL (default: https://tunedtensor.com)"
   ).option("--json", "Output raw JSON").option("--no-color", "Disable colors").showSuggestionAfterError().hook("preAction", () => {
@@ -6053,7 +6823,7 @@ function createProgram(version, runtime = {}) {
     if (root.json) setJsonMode(true);
     if (root.color === false) {
       process.env.FORCE_COLOR = "0";
-      chalk7.level = 0;
+      chalk8.level = 0;
     }
   });
   registerAuthCommands(program);
@@ -6086,12 +6856,12 @@ function createProgram(version, runtime = {}) {
 `);
       return;
     }
-    output.write(`${chalk7.bold.cyan("Tuned Tensor status")}
+    output.write(`${chalk8.bold.cyan("Tuned Tensor status")}
 `);
     output.write(`${formatShellStatus(context, target).join("\n")}
 
 `);
-    output.write(`${chalk7.bold("Context")}
+    output.write(`${chalk8.bold("Context")}
 `);
     output.write(
       `${formatShellContext(
@@ -6105,7 +6875,7 @@ function createProgram(version, runtime = {}) {
   program.command("local").description("Run the local CUDA training and model workflow").helpOption(false).allowUnknownOption().argument("[args...]", "TT Local command and arguments").action(async (args) => {
     const root = program.opts();
     const passthrough = extractPassthroughOptions(args, root);
-    if (!passthrough.color) chalk7.level = 0;
+    if (!passthrough.color) chalk8.level = 0;
     const result = await invokeLocal(
       passthrough.args.length > 0 ? passthrough.args : ["--help"],
       {
@@ -6145,7 +6915,7 @@ function createProgram(version, runtime = {}) {
     "after",
     `
 Workflows:
-  tt                     Open the interactive terminal (TTY only)
+  tt                     Open the conversational terminal (TTY only)
   tt status              Inspect cloud/local project context
   tt cloud <command>     Run a hosted command explicitly
   tt local <command>     Run a local GPU command
@@ -6158,6 +6928,22 @@ Examples:
   );
   return program;
 }
+function createShellAgent(options) {
+  return new TunedTensorAgentSession({
+    client: options.client,
+    io: {
+      write(text2) {
+        options.output.write(text2);
+      },
+      writeError(text2) {
+        options.error.write(text2);
+      },
+      clear() {
+        options.output.write("\x1B[2J\x1B[H");
+      }
+    }
+  });
+}
 async function runCli(version, runtime = {}) {
   const argv = runtime.argv ?? process.argv;
   const env = runtime.env ?? process.env;
@@ -6169,6 +6955,16 @@ async function runCli(version, runtime = {}) {
     env
   })) {
     const invokeSelf = runtime.runSelfCommand ?? runSelfCommand;
+    const output = runtime.stdout ?? process.stdout;
+    const error = runtime.stderr ?? process.stderr;
+    const agent = createShellAgent({
+      client: runtime.agentClient ?? createAgentClient({
+        apiKey: env.TUNED_TENSOR_API_KEY,
+        baseUrl: env.TUNED_TENSOR_URL
+      }),
+      output,
+      error
+    });
     await (runtime.startShell ?? startInteractiveShell)({
       runner: async (request2) => await invokeSelf(
         request2.target === "local" ? ["local", ...request2.args] : request2.args,
@@ -6178,11 +6974,13 @@ async function runCli(version, runtime = {}) {
           entrypoint: argv[1]
         }
       ),
+      agent,
       input: runtime.stdin ?? process.stdin,
-      output: runtime.stdout ?? process.stdout,
-      error: runtime.stderr ?? process.stderr,
+      output,
+      error,
       cwd: runtime.cwd ?? process.cwd(),
-      env
+      env,
+      version
     });
     return;
   }
@@ -6191,7 +6989,7 @@ async function runCli(version, runtime = {}) {
 }
 
 // src/index.ts
-runCli("0.5.0").catch((err) => {
+runCli("0.7.0").catch((err) => {
   reportError(err);
   process.exit(1);
 });