@aexhq/sdk 0.40.16 → 0.41.0

package/dist/cli.mjs

@@ -167,7 +167,7 @@ var MODEL_PROVIDER_IDS = {
     "doubao-cn": "doubao-seed-1-6-flash-250828"
   }
 };
-var RUN_MODELS = Object.keys(MODEL_PROVIDER_IDS);
+var SUPPORTED_MODELS = Object.keys(MODEL_PROVIDER_IDS);
 var Models = {
   /** Claude Haiku 4.5 — Anthropic. */
   CLAUDE_HAIKU_4_5: "claude-haiku-4-5",
@@ -215,7 +215,7 @@ var PROVIDERS_BY_MODEL = (() => {
   }
   return map;
 })();
-var RUN_MODELS_BY_PROVIDER = (() => {
+var SUPPORTED_MODELS_BY_PROVIDER = (() => {
   const map = {};
   for (const [model, providers] of Object.entries(MODEL_PROVIDER_IDS)) {
     for (const provider of Object.keys(providers)) {
@@ -240,17 +240,17 @@ function resolveModelProvider(model, provider) {
   }
   const inferred = providers[0];
   if (inferred === void 0) {
-    const hint = suggest(model, RUN_MODELS);
+    const hint = suggest(model, SUPPORTED_MODELS);
     throw new Error(`${JSON.stringify(model)} is not a known model id` + (hint ? ` (did you mean ${JSON.stringify(hint)}?)` : "") + "; pass provider explicitly to run it");
   }
   return inferred;
 }
-function isRunModel(input) {
-  return typeof input === "string" && RUN_MODELS.includes(input);
+function isModelName(input) {
+  return typeof input === "string" && SUPPORTED_MODELS.includes(input);
 }
-function parseRunModel(input, field = "submission.model") {
-  if (!isRunModel(input)) {
-    throw new Error(`${field} must be one of: ${RUN_MODELS.join(", ")}`);
+function parseModelName(input, field = "submission.model") {
+  if (!isModelName(input)) {
+    throw new Error(`${field} must be one of: ${SUPPORTED_MODELS.join(", ")}`);
   }
   return input;
 }
@@ -283,7 +283,7 @@ var SESSION_TERMINAL_STATUSES = /* @__PURE__ */ new Set([
   "deleted",
   "expired"
 ]);
-var TERMINAL_RUN_STATUSES = [
+var TERMINAL_SESSION_CONTROL_STATUSES = [
   "succeeded",
   "failed",
   "timed_out",
@@ -292,7 +292,7 @@ var TERMINAL_RUN_STATUSES = [
   "expired",
   "cleanup_failed"
 ];
-var terminalRunStatuses = new Set(TERMINAL_RUN_STATUSES);
+var terminalSessionControlStatuses = new Set(TERMINAL_SESSION_CONTROL_STATUSES);
 var CLEANUP_STATUSES = [
   "not_started",
   "pending",
@@ -303,7 +303,7 @@ var CLEANUP_STATUSES = [
   "skipped"
 ];
 
-// ../contracts/dist/run-config.js
+// ../contracts/dist/session-config.js
 var SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,127}$/;
 var TOOL_NAME_PATTERN = SKILL_NAME_PATTERN;
 var SKILL_RESERVED_NAMES = /* @__PURE__ */ new Set(["skills", "skill"]);
@@ -514,7 +514,7 @@ function parseRemoteMcpTransport(input, field) {
   }
   return input;
 }
-function parseRunConfigMcpServerRef(input, path) {
+function parseSessionConfigMcpServerRef(input, path) {
   if (input === null || typeof input !== "object" || Array.isArray(input)) {
     throw new Error(`${path} must be an object`);
   }
@@ -522,7 +522,7 @@ function parseRunConfigMcpServerRef(input, path) {
   rejectStdioMcpShape(record);
   for (const key of Object.keys(record)) {
     if (key !== "name" && key !== "url" && key !== "headers" && key !== "transport") {
-      throw new Error(`${path}.${key} is not an allowed field for RunConfigMcpServer; permitted: name, url, transport, headers`);
+      throw new Error(`${path}.${key} is not an allowed field for SessionConfigMcpServer; permitted: name, url, transport, headers`);
     }
   }
   const stripped = { name: record.name, url: record.url };
@@ -545,9 +545,9 @@ function parseRunConfigMcpServerRef(input, path) {
   }
   return { ...ref, headers };
 }
-function parseRunRequestConfig(input) {
+function parseSessionRequestConfig(input) {
   if (input === null || typeof input !== "object" || Array.isArray(input)) {
-    throw new Error("run request config must be an object");
+    throw new Error("session request config must be an object");
   }
   const record = input;
   const allowed = /* @__PURE__ */ new Set([
@@ -562,23 +562,23 @@ function parseRunRequestConfig(input) {
   ]);
   for (const key of Object.keys(record)) {
     if (!allowed.has(key)) {
-      throw new Error(`run request config contains unexpected field: ${key}`);
+      throw new Error(`session request config contains unexpected field: ${key}`);
     }
   }
-  const model = parseRunModel(record.model, "run request config model");
+  const model = parseModelName(record.model, "session request config model");
   const system = record.system;
   if (system !== void 0 && typeof system !== "string") {
-    throw new Error("run request config system, when provided, must be a string");
+    throw new Error("session request config system, when provided, must be a string");
   }
-  const prompt = parseRunRequestConfigPrompt(record.prompt);
-  const mcpServers = parseRunRequestConfigMcpServers(record.mcpServers);
+  const prompt = parseSessionRequestConfigPrompt(record.prompt);
+  const mcpServers = parseSessionRequestConfigMcpServers(record.mcpServers);
   return {
     model,
     ...system !== void 0 ? { system } : {},
     prompt,
     ...mcpServers !== void 0 ? { mcpServers } : {},
     // environment / metadata: passed through as-is — the BFF revalidates
-    // them via `parseRunSubmissionRequest`,
+    // them via `parseSessionSubmissionRequest`,
     // so duplicating the heavyweight parsers here would mean two sources
     // of truth. The CLI surfaces structural errors at submission time.
     ...record.environment !== void 0 ? { environment: record.environment } : {},
@@ -587,10 +587,10 @@ function parseRunRequestConfig(input) {
     ...record.metadata !== void 0 ? { metadata: record.metadata } : {}
   };
 }
-function parseRunRequestConfigPrompt(value) {
+function parseSessionRequestConfigPrompt(value) {
   if (typeof value === "string") {
     if (value.length === 0) {
-      throw new Error("run request config prompt must be a non-empty string");
+      throw new Error("session request config prompt must be a non-empty string");
     }
     return value;
   }
@@ -599,29 +599,29 @@ function parseRunRequestConfigPrompt(value) {
     for (let i2 = 0; i2 < value.length; i2++) {
       const item = value[i2];
       if (typeof item !== "string" || item.length === 0) {
-        throw new Error(`run request config prompt[${i2}] must be a non-empty string`);
+        throw new Error(`session request config prompt[${i2}] must be a non-empty string`);
       }
       arr.push(item);
     }
     if (arr.length === 0) {
-      throw new Error("run request config prompt must be a non-empty string or array of strings");
+      throw new Error("session request config prompt must be a non-empty string or array of strings");
     }
     return arr;
   }
-  throw new Error("run request config prompt must be a string or array of strings");
+  throw new Error("session request config prompt must be a string or array of strings");
 }
-function parseRunRequestConfigMcpServers(value) {
+function parseSessionRequestConfigMcpServers(value) {
   if (value === void 0) {
     return void 0;
   }
   if (!Array.isArray(value)) {
-    throw new Error("run request config mcpServers must be an array");
+    throw new Error("session request config mcpServers must be an array");
   }
   const seen = /* @__PURE__ */ new Set();
   return value.map((item, index) => {
-    const entry = parseRunConfigMcpServerRef(item, `run request config mcpServers[${index}]`);
+    const entry = parseSessionConfigMcpServerRef(item, `session request config mcpServers[${index}]`);
     if (seen.has(entry.name)) {
-      throw new Error(`run request config mcpServers duplicate name: ${entry.name}`);
+      throw new Error(`session request config mcpServers duplicate name: ${entry.name}`);
     }
     seen.add(entry.name);
     return entry;
@@ -639,9 +639,9 @@ var RUNTIME_SIZE_PRESETS = {
 };
 var RUNTIME_SIZES = Object.keys(RUNTIME_SIZE_PRESETS);
 var DEFAULT_RUNTIME_SIZE = "shared-0.25x-1gb";
-var DEFAULT_RUN_TIMEOUT_MS = 8 * 60 * 60 * 1e3;
-var MAX_RUN_TIMEOUT_MS = 8 * 60 * 60 * 1e3;
-var MIN_RUN_TIMEOUT_MS = 60 * 1e3;
+var DEFAULT_SESSION_TIMEOUT_MS = 8 * 60 * 60 * 1e3;
+var MAX_SESSION_TIMEOUT_MS = 8 * 60 * 60 * 1e3;
+var MIN_SESSION_TIMEOUT_MS = 60 * 1e3;
 var DURATION_PATTERN = /^(\d+(?:\.\d+)?)(ms|s|m|h)?$/;
 function parseDurationToMs(input) {
   const match = DURATION_PATTERN.exec(input.trim());
@@ -656,7 +656,7 @@ function parseDurationToMs(input) {
   const factor = unit === "h" ? 36e5 : unit === "m" ? 6e4 : unit === "s" ? 1e3 : 1;
   return Math.round(value * factor);
 }
-function parseRunTimeout(input) {
+function parseSessionTimeout(input) {
   if (input === void 0) {
     return void 0;
   }
@@ -664,16 +664,16 @@ function parseRunTimeout(input) {
     throw new Error(`timeout must be a duration string (e.g. "1h", "30m"); got ${JSON.stringify(input)}`);
   }
   const ms = parseDurationToMs(input);
-  if (ms < MIN_RUN_TIMEOUT_MS) {
-    throw new Error(`timeout must be at least ${MIN_RUN_TIMEOUT_MS}ms (1m); got ${ms}ms`);
+  if (ms < MIN_SESSION_TIMEOUT_MS) {
+    throw new Error(`timeout must be at least ${MIN_SESSION_TIMEOUT_MS}ms (1m); got ${ms}ms`);
   }
-  if (ms > MAX_RUN_TIMEOUT_MS) {
-    throw new Error(`timeout must be at most ${MAX_RUN_TIMEOUT_MS}ms (8h); got ${ms}ms`);
+  if (ms > MAX_SESSION_TIMEOUT_MS) {
+    throw new Error(`timeout must be at most ${MAX_SESSION_TIMEOUT_MS}ms (8h); got ${ms}ms`);
   }
   return ms;
 }
-var RUN_PROCESS_KILL_GRACE_MS = 60 * 1e3;
-var RUN_TERMINAL_GRACE_MS = 90 * 1e3;
+var SESSION_PROCESS_KILL_GRACE_MS = 60 * 1e3;
+var SESSION_TERMINAL_GRACE_MS = 90 * 1e3;
 
 // ../contracts/dist/runtime-security-profile.js
 var RUNTIME_SECURITY_PROFILE_CONFIG = Object.freeze({
@@ -705,7 +705,7 @@ var RUNTIME_SECURITY_PROFILE_CONFIG = Object.freeze({
 
 // ../contracts/dist/submission.js
 var PLATFORM_PACKAGE_ECOSYSTEMS = ["apt", "npm", "pip"];
-var RUN_PROVIDERS = [
+var PROVIDERS = [
   "anthropic",
   "deepseek",
   "openai",
@@ -748,7 +748,7 @@ function optionalPositiveNumber(input, field) {
   }
   return input;
 }
-function parseRunWebhook(input) {
+function parseSessionWebhook(input) {
   if (input === void 0) {
     return void 0;
   }
@@ -774,26 +774,26 @@ function parseRunWebhook(input) {
   }
   return { url };
 }
-function parseRunLimits(input) {
+function parseSessionLimits(input) {
   if (input === void 0) {
     return void 0;
   }
   const value = requireRecord(input, "limits");
-  const allowed = /* @__PURE__ */ new Set(["maxConcurrentChildRuns", "maxSubagentDepth", "maxSpendUsd", "maxTurns"]);
+  const allowed = /* @__PURE__ */ new Set(["maxConcurrentChildSessions", "maxSubagentDepth", "maxSpendUsd", "maxTurns"]);
   for (const key of Object.keys(value)) {
     if (!allowed.has(key)) {
       throw new Error(`limits.${key} is not an allowed field; permitted: ${[...allowed].join(", ")}`);
     }
   }
-  const maxConcurrentChildRuns = optionalPositiveInt(value.maxConcurrentChildRuns, "limits.maxConcurrentChildRuns");
+  const maxConcurrentChildSessions = optionalPositiveInt(value.maxConcurrentChildSessions, "limits.maxConcurrentChildSessions");
   const maxSubagentDepth = optionalPositiveInt(value.maxSubagentDepth, "limits.maxSubagentDepth");
   const maxSpendUsd = optionalPositiveNumber(value.maxSpendUsd, "limits.maxSpendUsd");
   const maxTurns = optionalPositiveInt(value.maxTurns, "limits.maxTurns");
-  if (maxConcurrentChildRuns === void 0 && maxSubagentDepth === void 0 && maxSpendUsd === void 0 && maxTurns === void 0) {
+  if (maxConcurrentChildSessions === void 0 && maxSubagentDepth === void 0 && maxSpendUsd === void 0 && maxTurns === void 0) {
     return void 0;
   }
   return {
-    ...maxConcurrentChildRuns !== void 0 ? { maxConcurrentChildRuns } : {},
+    ...maxConcurrentChildSessions !== void 0 ? { maxConcurrentChildSessions } : {},
     ...maxSubagentDepth !== void 0 ? { maxSubagentDepth } : {},
     ...maxSpendUsd !== void 0 ? { maxSpendUsd } : {},
     ...maxTurns !== void 0 ? { maxTurns } : {}
@@ -823,22 +823,22 @@ var BUILTIN_TOOL_NAMES = [
   "wc"
 ];
 var DEFAULT_BUILTIN_TOOLS = BUILTIN_TOOL_NAMES;
-var MAX_OUTPUT_CAPTURE_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
+var MAX_FILE_CAPTURE_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
 var SKILLS_MAX = 64;
 
 // ../contracts/dist/event-envelope.js
 var AEX_EVENT_SOURCES = ["agent", "api", "runtime", "mcp", "aex", "workflow", "host"];
 var AEX_EVENT_TYPES = [
-  "RUN_STARTED",
-  "RUN_FINISHED",
-  "RUN_ERROR",
+  "TURN_STARTED",
+  "TURN_FINISHED",
+  "TURN_ERROR",
   "TEXT_MESSAGE_CONTENT",
   "TOOL_CALL_START",
   "TOOL_CALL_RESULT",
   "CUSTOM",
   // The carrier type for a `channel: "log"` record. Kept out of the AG-UI
-  // typed-event vocabulary on purpose: a `LOG` is never a run-lifecycle signal,
-  // so terminal detection (RUN_FINISHED/RUN_ERROR) is unaffected and an
+  // typed-event vocabulary on purpose: a `LOG` is never a session-lifecycle signal,
+  // so terminal detection (TURN_FINISHED/TURN_ERROR) is unaffected and an
   // off-the-shelf AG-UI client filters logs out by `channel`.
   "LOG"
 ];
@@ -857,9 +857,9 @@ function isSessionParked(e) {
 function customName(e) {
   return e.type === "CUSTOM" ? str(e.data.name) || null : null;
 }
-var AEX_RUN_SETTLED_NAME = "aex.run.settled";
-function isRunSettled(e) {
-  return customName(e) === AEX_RUN_SETTLED_NAME || isSessionParked(e);
+var AEX_SESSION_SETTLED_NAME = "aex.session.settled";
+function isSessionSettled(e) {
+  return customName(e) === AEX_SESSION_SETTLED_NAME || isSessionParked(e);
 }
 function channelOf(e) {
   return e.channel ?? "event";
@@ -868,16 +868,16 @@ function toAGUI(e) {
   const timestamp = Date.parse(e.time);
   const d = e.data;
   switch (e.type) {
-    case "RUN_STARTED":
-      return { type: "RUN_STARTED", timestamp, threadId: e.subject, runId: e.subject };
-    case "RUN_FINISHED":
-      return { type: "RUN_FINISHED", timestamp, threadId: e.subject, runId: e.subject };
-    case "RUN_ERROR": {
+    case "TURN_STARTED":
+      return { type: "TURN_STARTED", timestamp, threadId: e.subject, sessionId: e.subject };
+    case "TURN_FINISHED":
+      return { type: "TURN_FINISHED", timestamp, threadId: e.subject, sessionId: e.subject };
+    case "TURN_ERROR": {
       const code = str(d.failureClass);
       return {
-        type: "RUN_ERROR",
+        type: "TURN_ERROR",
         timestamp,
-        message: str(d.failureMessage) || e.message || "run error",
+        message: str(d.failureMessage) || e.message || "turn error",
         ...code ? { code } : {}
       };
     }
@@ -917,7 +917,7 @@ function str(v) {
 var encoder = new TextEncoder();
 
 // ../contracts/dist/event-stream-client.js
-var isTerminalType = (e) => e.type === "RUN_FINISHED" || e.type === "RUN_ERROR" || isSessionParked(e);
+var isTerminalType = (e) => e.type === "TURN_FINISHED" || e.type === "TURN_ERROR" || isSessionParked(e);
 var COORDINATOR_PING = "aex:ping";
 var COORDINATOR_REPLAY = JSON.stringify({ action: "replay" });
 var DEFAULT_IDLE_TIMEOUT_MS = 45e3;
@@ -1153,8 +1153,8 @@ function sleep(ms, signal) {
   });
 }
 
-// ../contracts/dist/run-unit.js
-function parseRunUnitSubmission(input, fallbackModel) {
+// ../contracts/dist/session-unit.js
+function parseSessionUnitSubmission(input, fallbackModel) {
   if (!input || typeof input !== "object" || Array.isArray(input)) {
     return fallbackFlat(fallbackModel);
   }
@@ -1166,15 +1166,15 @@ function parseRunUnitSubmission(input, fallbackModel) {
 }
 function parseFlatProjection(value, fallbackModel) {
   const submissionRaw = isRecord2(value.submission) ? value.submission : {};
-  const outputsRaw = isRecord2(submissionRaw.outputs) ? submissionRaw.outputs : {};
-  const allowedDirs = toOptionalStringArray(outputsRaw.allowedDirs);
-  const deniedDirs = toOptionalStringArray(outputsRaw.deniedDirs);
-  const captureTimeoutMs = toOptionalPositiveInteger(outputsRaw.captureTimeoutMs);
-  const maxFileBytes = toOptionalPositiveInteger(outputsRaw.maxFileBytes);
-  const maxTotalBytes = toOptionalPositiveInteger(outputsRaw.maxTotalBytes);
-  const maxFiles = toOptionalPositiveInteger(outputsRaw.maxFiles);
+  const fileCaptureRaw = isRecord2(submissionRaw.fileCapture) ? submissionRaw.fileCapture : {};
+  const allowedDirs = toOptionalStringArray(fileCaptureRaw.allowedDirs);
+  const deniedDirs = toOptionalStringArray(fileCaptureRaw.deniedDirs);
+  const captureTimeoutMs = toOptionalPositiveInteger(fileCaptureRaw.captureTimeoutMs);
+  const maxFileBytes = toOptionalPositiveInteger(fileCaptureRaw.maxFileBytes);
+  const maxTotalBytes = toOptionalPositiveInteger(fileCaptureRaw.maxTotalBytes);
+  const maxFiles = toOptionalPositiveInteger(fileCaptureRaw.maxFiles);
   const submission = {
-    model: coerceRunUnitModel(submissionRaw.model ?? fallbackModel),
+    model: coerceSessionUnitModel(submissionRaw.model ?? fallbackModel),
     ...typeof submissionRaw.system === "string" ? { system: submissionRaw.system } : {},
     prompt: toStringArray(submissionRaw.prompt),
     agentsMd: [],
@@ -1185,7 +1185,7 @@ function parseFlatProjection(value, fallbackModel) {
     ...parseSecurityProfile(submissionRaw.securityProfile) ? { securityProfile: parseSecurityProfile(submissionRaw.securityProfile) } : {},
     ...isJsonRecord(submissionRaw.metadata) ? { metadata: submissionRaw.metadata } : {},
     ...allowedDirs || deniedDirs || captureTimeoutMs !== void 0 || maxFileBytes !== void 0 || maxTotalBytes !== void 0 || maxFiles !== void 0 ? {
-      outputs: {
+      fileCapture: {
         ...allowedDirs ? { allowedDirs } : {},
         ...deniedDirs ? { deniedDirs } : {},
         ...captureTimeoutMs !== void 0 ? { captureTimeoutMs } : {},
@@ -1210,7 +1210,7 @@ function fallbackFlat(fallbackModel) {
   return {
     kind: "submission",
     submission: {
-      model: coerceRunUnitModel(fallbackModel),
+      model: coerceSessionUnitModel(fallbackModel),
       prompt: [],
       agentsMd: [],
       files: [],
@@ -1222,7 +1222,7 @@ function fallbackFlat(fallbackModel) {
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function normalizeRunUnit(raw) {
+function normalizeSessionUnit(raw) {
   const r = isRecord2(raw) ? raw : {};
   const eventsRaw = isRecord2(r.events) ? r.events : {};
   const str3 = (v) => typeof v === "string" ? v : void 0;
@@ -1240,9 +1240,9 @@ function normalizeRunUnit(raw) {
     ...str3(r.deletedAt) ? { deletedAt: r.deletedAt } : {},
     attemptCount: typeof r.attemptCount === "number" ? r.attemptCount : Array.isArray(r.attempts) ? r.attempts.length : 0,
     // Plane responses that project a flat record (no `submission` snapshot)
-    // still carry the run's `model` at the top level — prefer it over the
-    // static fallback so `unit()` never claims a model the run did not use.
-    submission: parseRunUnitSubmission(r.submission, r.model),
+    // still carry the session's `model` at the top level — prefer it over the
+    // static fallback so `unit()` never claims a model the session did not use.
+    submission: parseSessionUnitSubmission(r.submission, r.model),
     ...isRecord2(r.capsSnapshot) ? { capsSnapshot: r.capsSnapshot } : {},
     attempts: arr(r.attempts),
     events: {
@@ -1252,17 +1252,17 @@ function normalizeRunUnit(raw) {
       ...str3(eventsRaw.nextCursor) ? { nextCursor: eventsRaw.nextCursor } : {}
     },
     rawEventPages: arr(r.rawEventPages),
-    outputs: arr(r.outputs),
-    outputCaptureFailures: arr(r.outputCaptureFailures),
+    sessionFiles: arr(r.sessionFiles),
+    fileCaptureFailures: arr(r.fileCaptureFailures),
     ...isRecord2(r.costTelemetry) ? { costTelemetry: r.costTelemetry } : {},
     ...isRecord2(r.runtimeManifest) ? { runtimeManifest: r.runtimeManifest } : {}
   };
 }
-function coerceRunUnitModel(value) {
+function coerceSessionUnitModel(value) {
   if (typeof value !== "string")
     return Models.CLAUDE_HAIKU_4_5;
   try {
-    return parseRunModel(value, "run unit submission.model");
+    return parseModelName(value, "session unit submission.model");
   } catch {
     return Models.CLAUDE_HAIKU_4_5;
   }
@@ -1353,7 +1353,7 @@ var RUNTIME_PATHS = Object.freeze({
   runtimeEnv: "/mnt/session/uploads/aex/RUNTIME.env"
 });
 
-// ../contracts/dist/run-custody.js
+// ../contracts/dist/session-custody.js
 function scanCustodyPayloadForSensitiveValues(input) {
   const findings = [];
   visitCustodyValue(input, "$", findings);
@@ -1418,44 +1418,44 @@ var forbiddenStringPatterns = Object.freeze([
     regex: /\b(?:sk-[A-Za-z0-9_-]{16,}|xox[baprs]-[A-Za-z0-9-]{8,}|AIza[A-Za-z0-9_-]{8,})/i
   },
   { reason: "signed_url", regex: /[?&](?:X-Amz-Signature|X-Amz-Credential|X-Amz-Algorithm|AWSAccessKeyId)=/i },
-  { reason: "object_store_key", regex: /(^|[\s"'`])(?:runs|assets)\/[^?<#\s"'`]+/i },
+  { reason: "object_store_key", regex: /(^|[\s"'`])(?:sessions|assets)\/[^?<#\s"'`]+/i },
   { reason: "vault_id", regex: /\b(?:vault|vlt|secret)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i },
   {
     reason: "private_resource_handle",
-    // `<keyword><sep><id>` opaque handles (`session_a1B2c3D4e5`, `file_9f8e7d…`).
+    // `<keyword><sep><id>` opaque handles (`machine_a1B2c3D4e5`, `resource_9f8e7d...`).
     // The keyword set overlaps ordinary prose, so require the id segment to
     // carry a digit. That keeps genuine minted handles flagged while avoiding
     // dictionary-word chains such as `agent_decision_failure`.
-    regex: /\b(?:machine|session|agent|file|skill|env|resource|handle|token_hash|bearer_hash)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i,
+    regex: /\b(?:machine|agent|resource|handle|token_hash|bearer_hash)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i,
     accept: isMintedResourceHandle
   },
   {
     reason: "high_entropy_token",
-    // Catch-all for an unrecognised opaque secret blob. The candidate run
+    // Catch-all for an unrecognised opaque secret blob. The candidate sequence
     // EXCLUDES `_` (so `SCREAMING_SNAKE` env names and `slug_with_words` URL
-    // segments split instead of fusing into a phantom 40-char run — the live
+    // segments split instead of fusing into a phantom 40-char sequence — the live
     // false positive was `ted_season_2_peacock_official_discussion_thread` in
     // web-search result text and a fetched URL), and the `accept` predicate
     // vetoes content-addressed hashes (md5/sha1/sha256 digests — the platform's
-    // OWN asset filenames) and low-entropy / single-class runs so only genuine
+    // OWN asset filenames) and low-entropy / single-class sessions so only genuine
     // opaque secrets remain. Slash-bearing secrets (signed URLs, connection
     // strings, `Bearer …`) are covered by the named patterns above.
     regex: /\b[A-Za-z0-9-]{40,}\b/,
-    accept: isHighEntropySecretRun
+    accept: isHighEntropySecretSequence
   }
 ]);
-var CONTENT_HASH_RUN = /^(?:[0-9a-f]{32}|[0-9a-f]{40}|[0-9a-f]{64})$/i;
-function isHighEntropySecretRun(run) {
-  if (CONTENT_HASH_RUN.test(run)) {
+var CONTENT_HASH_SEQUENCE = /^(?:[0-9a-f]{32}|[0-9a-f]{40}|[0-9a-f]{64})$/i;
+function isHighEntropySecretSequence(sequence) {
+  if (CONTENT_HASH_SEQUENCE.test(sequence)) {
     return false;
   }
-  if (!/[A-Za-z]/.test(run) || !/\d/.test(run)) {
+  if (!/[A-Za-z]/.test(sequence) || !/\d/.test(sequence)) {
     return false;
   }
-  if (highEntropyCharClassCount(run) < 2) {
+  if (highEntropyCharClassCount(sequence) < 2) {
     return false;
   }
-  return highEntropyShannonBits(run) >= 3;
+  return highEntropyShannonBits(sequence) >= 3;
 }
 function isMintedResourceHandle(match) {
   const separatorIndex = match.search(/[_:-]/);
@@ -1491,32 +1491,32 @@ function isForbiddenCustodyFieldName(key) {
   return /^(apiKey|apiKeys|secretValue|bearerHash|signedUrl|objectStoreKey|objectKey|vaultId|providerResponseBody|responseBody|privateResourceHandle|resourceHandle|rawBody)$/i.test(key);
 }
 
-// ../contracts/dist/run-record.js
-var RUN_RECORD_SCHEMA_VERSION = "aex.run-record.v1";
-var RUN_RECORD_MANIFEST_SCHEMA_VERSION = "aex.run-record.manifest.v1";
-var RunRecordArchiveRedactionError = class extends Error {
-  code = "run_record_archive_not_public_safe";
+// ../contracts/dist/session-record.js
+var SESSION_RECORD_SCHEMA_VERSION = "aex.session-record.v1";
+var SESSION_RECORD_MANIFEST_SCHEMA_VERSION = "aex.session-record.manifest.v1";
+var SessionRecordArchiveRedactionError = class extends Error {
+  code = "session_record_archive_not_public_safe";
   findings;
   constructor(findings) {
-    super(`run record archive contains non-public data at ${formatArchiveFindingPaths(findings)}`);
-    this.name = "RunRecordArchiveRedactionError";
+    super(`session record archive contains non-public data at ${formatArchiveFindingPaths(findings)}`);
+    this.name = "SessionRecordArchiveRedactionError";
     this.findings = Object.freeze([...findings]);
   }
 };
-function buildRunRecordDownloadManifestV1(input) {
-  const outputs = input.outputs.map((file2) => normalizeArtifactSummary(file2));
+function buildSessionRecordDownloadManifestV1(input) {
+  const sessionFiles = input.sessionFiles.map((file2) => normalizeArtifactSummary(file2));
   const errors = (input.errors ?? []).map((error) => Object.freeze({ ...error }));
   return Object.freeze({
-    schemaVersion: RUN_RECORD_MANIFEST_SCHEMA_VERSION,
-    runRecordSchemaVersion: RUN_RECORD_SCHEMA_VERSION,
-    runId: input.runId,
+    schemaVersion: SESSION_RECORD_MANIFEST_SCHEMA_VERSION,
+    sessionRecordSchemaVersion: SESSION_RECORD_SCHEMA_VERSION,
+    sessionId: input.sessionId,
     namespaces: Object.freeze([
-      namespace("metadata", "Run metadata, submission snapshot, custody, and cost files."),
+      namespace("metadata", "SessionRecord metadata, submission snapshot, custody, and cost files."),
       namespace("events", "Typed event-channel exports."),
-      namespace("outputs", "Captured deliverables produced by the run.")
+      namespace("files", "Captured files produced by the session.")
     ]),
     files: Object.freeze([
-      file("metadata", "metadata/run.json", "run_metadata", "present"),
+      file("metadata", "metadata/session.json", "session_metadata", "present"),
       file("metadata", "metadata/submission.json", "submission_snapshot", input.submission?.status ?? "unavailable"),
       file("metadata", "metadata/cost.json", "cost", input.cost?.status ?? "pending"),
       file("metadata", "metadata/custody.json", "custody", input.custody?.status ?? "pending"),
@@ -1524,9 +1524,9 @@ function buildRunRecordDownloadManifestV1(input) {
         recordCount: input.typedEventCount ?? 0
       }),
       file("events", "events/manifest.json", "coordinator_events_manifest", input.coordinatorEventsManifest?.status ?? "unavailable"),
-      ...outputs.map((output) => artifactFile("outputs", "output", "outputs/", output))
+      ...sessionFiles.map((fileSummary) => artifactFile("files", "file", "files/", fileSummary))
     ]),
-    outputs: Object.freeze(outputs),
+    sessionFiles: Object.freeze(sessionFiles),
     errors: Object.freeze(errors)
   });
 }
@@ -1567,7 +1567,7 @@ function normalizeArtifactSummary(input) {
     ...input.contentType !== void 0 ? { contentType: input.contentType } : {}
   });
 }
-function scanRunRecordArchiveEntriesV1(entries) {
+function scanSessionRecordArchiveEntriesV1(entries) {
   const findings = [];
   for (const entry of entries) {
     if (entry.customerContent || !shouldScanArchiveEntry(entry)) {
@@ -1579,14 +1579,14 @@ function scanRunRecordArchiveEntriesV1(entries) {
   }
   return Object.freeze(findings);
 }
-function assertRunRecordArchivePublicSafeV1(entries) {
-  const findings = scanRunRecordArchiveEntriesV1(entries);
+function assertSessionRecordArchivePublicSafeV1(entries) {
+  const findings = scanSessionRecordArchiveEntriesV1(entries);
   if (findings.length > 0) {
-    throw new RunRecordArchiveRedactionError(findings);
+    throw new SessionRecordArchiveRedactionError(findings);
   }
 }
 function shouldScanArchiveEntry(entry) {
-  if (entry.path.startsWith("outputs/")) {
+  if (entry.path.startsWith("files/")) {
     return false;
   }
   const contentType = entry.contentType?.toLowerCase() ?? "";
@@ -1613,7 +1613,7 @@ function isAllowedArchiveHighEntropyField(entryPath, finding) {
   if (finding.reason !== "high_entropy_token" || !entryPath.endsWith("manifest.json")) {
     return false;
   }
-  return /^\$(?:\.files\[\d+\]|\.outputs\[\d+\])\.id$/.test(finding.path);
+  return /^\$(?:\.files\[\d+\]|\.sessionFiles\[\d+\])\.id$/.test(finding.path);
 }
 function parseArchiveTextValues(path, text) {
   if (/\.json$/i.test(path)) {
@@ -1649,14 +1649,14 @@ function formatArchiveFindingPaths(findings) {
   return findings.map((finding) => `${finding.entryPath}${finding.path} (${finding.reason})`).join(", ");
 }
 
-// ../contracts/dist/run-retention.js
+// ../contracts/dist/session-retention.js
 var forbiddenStringPatterns2 = Object.freeze([
   { reason: "signed_url", regex: /[?&](?:X-Amz-Signature|X-Amz-Credential|X-Amz-Algorithm|AWSAccessKeyId)=/i },
-  { reason: "object_store_key", regex: /(^|[\s"'`])(?:runs|assets)\/[^?<#\s"'`]+/i },
+  { reason: "object_store_key", regex: /(^|[\s"'`])(?:sessions|assets)\/[^?<#\s"'`]+/i },
   { reason: "vault_id", regex: /\b(?:vault|vlt|secret)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i },
   {
     reason: "private_resource_handle",
-    regex: /\b(?:machine|session|resource|handle|provider|asset)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i
+    regex: /\b(?:machine|resource|handle|provider|asset)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i
   },
   { reason: "hash_like_value", regex: /\b(?:sha256|hash)[:_-][A-Fa-f0-9]{16,}\b/ }
 ]);
@@ -1669,11 +1669,11 @@ var forbiddenStringPatterns3 = Object.freeze([
     regex: /\b(?:sk-(?:ant|proj|live|test|deepseek|openai)|xox[baprs]-|AIza)[A-Za-z0-9_-]{8,}/i
   },
   { reason: "signed_url", regex: /[?&](?:X-Amz-Signature|X-Amz-Credential|X-Amz-Algorithm|AWSAccessKeyId)=/i },
-  { reason: "object_store_key", regex: /(^|[\s"'`])(?:runs|assets)\/[^?<#\s"'`]+/i },
+  { reason: "object_store_key", regex: /(^|[\s"'`])(?:sessions|assets)\/[^?<#\s"'`]+/i },
   { reason: "vault_id", regex: /\b(?:vault|vlt|secret)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i },
   {
     reason: "private_resource_handle",
-    regex: /\b(?:machine|session|agent|file|skill|env|resource|handle|token_hash|bearer_hash)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i
+    regex: /\b(?:machine|agent|resource|handle|token_hash|bearer_hash)[_:-][A-Za-z0-9][A-Za-z0-9_-]{7,}\b/i
   },
   { reason: "raw_url", regex: /\bhttps?:\/\/\S+/i },
   { reason: "raw_path", regex: /(^|[\s"'`])\/[A-Za-z0-9._~!$&'()*+,;=:@%-]+(?:[/?#][^\s"'`]*)?/ },
@@ -1713,10 +1713,10 @@ var HIGH_ENTROPY_CANDIDATE = /[A-Za-z0-9+/=-]{24,}/g;
 var ENTROPY_BITS_PER_CHAR = 3;
 var MIN_CHAR_CLASSES = 2;
 var HIGH_ENTROPY_NO_DIGIT_MIN_LEN = 40;
-function isCanonicalRunIdHex(input, matchStart, match) {
+function isCanonicalSessionIdHex(input, matchStart, match) {
   if (!/^[0-9a-f]{32}$/.test(match))
     return false;
-  return input.slice(Math.max(0, matchStart - 4), matchStart) === "run_";
+  return input.slice(Math.max(0, matchStart - 4), matchStart) === "ses_";
 }
 function redactSecrets(value) {
   if (typeof value === "string") {
@@ -1750,7 +1750,7 @@ function redactString(input, known = []) {
     // prefix; the rest replace the whole match.
     typeof captured === "string" ? `${captured} ${REDACTED}` : REDACTED
   )), out);
-  return out.replace(HIGH_ENTROPY_CANDIDATE, (match, offset, whole) => !isCanonicalRunIdHex(whole, offset, match) && looksHighEntropySecret(match) ? REDACTED : match);
+  return out.replace(HIGH_ENTROPY_CANDIDATE, (match, offset, whole) => !isCanonicalSessionIdHex(whole, offset, match) && looksHighEntropySecret(match) ? REDACTED : match);
 }
 function isSecretKey(key) {
   return /(?:api[_-]?key|authorization|token|secret|password|credential)/i.test(key);
@@ -1803,7 +1803,7 @@ var AEX_API_ERROR_CODES = [
   "not_found",
   "idempotency_conflict",
   "session_busy",
-  "run_not_terminal",
+  "session_not_terminal",
   "unknown_workspace",
   "workspace_concurrency_exceeded",
   "workspace_submit_rate_exceeded",
@@ -1824,12 +1824,12 @@ var AEX_API_ERROR_MESSAGES = {
   not_found: "The requested resource was not found.",
   idempotency_conflict: "This idempotency key was already used with a different request body.",
   session_busy: "The session is busy handling another turn.",
-  run_not_terminal: "The run has not reached a terminal state yet.",
+  session_not_terminal: "The session has not reached a terminal state yet.",
   unknown_workspace: "The workspace could not be resolved from the API key.",
   workspace_concurrency_exceeded: "The workspace has reached its concurrent-run limit.",
   workspace_submit_rate_exceeded: "The workspace submit-rate limit was exceeded.",
   workspace_spend_cap_exceeded: "The workspace monthly spend cap was reached.",
-  insufficient_balance: "The workspace prepaid balance is insufficient to submit this run.",
+  insufficient_balance: "The workspace prepaid balance is insufficient to submit this session.",
   rate_limited: "Too many requests \u2014 retry after a short backoff.",
   upstream_error: "An upstream provider returned an error.",
   internal_error: "The aex API encountered an internal error."
@@ -1850,12 +1850,12 @@ var AexError = class extends Error {
     this.details = details === void 0 ? void 0 : redactSecrets(details);
   }
 };
-var RunConfigValidationError = class extends AexError {
+var SessionConfigValidationError = class extends AexError {
   constructor(message, details) {
-    super("RUN_CONFIG_INVALID", message, details);
+    super("SESSION_CONFIG_INVALID", message, details);
   }
 };
-var RunStateError = class extends AexError {
+var SessionStateError = class extends AexError {
   /**
    * HTTP status from a wrapped API rejection, when this state error is a
    * bounded client-side interpretation of that rejection.
@@ -1868,7 +1868,7 @@ var RunStateError = class extends AexError {
   constructor(message, details, options) {
     const detailRecord = details && typeof details === "object" && !Array.isArray(details) ? details : void 0;
     const cause = options?.cause ?? detailRecord?.cause;
-    super("RUN_STATE_ERROR", message, details, cause === void 0 ? void 0 : { cause });
+    super("SESSION_STATE_ERROR", message, details, cause === void 0 ? void 0 : { cause });
     const status = detailRecord?.httpStatus ?? detailRecord?.status;
     const apiCode = detailRecord?.apiCode;
     this.status = typeof status === "number" ? status : void 0;
@@ -2043,7 +2043,7 @@ function apiErrorKindForCode(code) {
     case "workspace_submit_rate_exceeded":
       return "rate_limit";
     case "session_busy":
-    case "run_not_terminal":
+    case "session_not_terminal":
     case "unknown_workspace":
     case "workspace_spend_cap_exceeded":
     case "insufficient_balance":
@@ -2397,25 +2397,28 @@ function extractErrorMessage(body) {
   return "aex API request failed";
 }
 
+// ../contracts/dist/session-artifacts.js
+var SESSION_INTERNAL_PREFIX = "internal";
+var SESSION_INTERNAL_LOGS_PREFIX = `${SESSION_INTERNAL_PREFIX}/logs`;
+var SESSION_INTERNAL_USAGE_PREFIX = `${SESSION_INTERNAL_PREFIX}/usage`;
+
 // ../contracts/dist/operations.js
 var operations_exports = {};
 __export(operations_exports, {
-  OUTPUT_FILE_TRANSFER_ATTEMPTS: () => OUTPUT_FILE_TRANSFER_ATTEMPTS,
-  OUTPUT_FILE_TRANSFER_DEFAULT_TIMEOUT_MS: () => OUTPUT_FILE_TRANSFER_DEFAULT_TIMEOUT_MS,
-  READ_OUTPUT_TEXT_DEFAULT_BYTES: () => READ_OUTPUT_TEXT_DEFAULT_BYTES,
-  READ_OUTPUT_TEXT_MAX_BYTES: () => READ_OUTPUT_TEXT_MAX_BYTES,
+  READ_SESSION_FILE_TEXT_DEFAULT_BYTES: () => READ_SESSION_FILE_TEXT_DEFAULT_BYTES,
+  READ_SESSION_FILE_TEXT_MAX_BYTES: () => READ_SESSION_FILE_TEXT_MAX_BYTES,
+  SESSION_FILE_TRANSFER_ATTEMPTS: () => SESSION_FILE_TRANSFER_ATTEMPTS,
+  SESSION_FILE_TRANSFER_DEFAULT_TIMEOUT_MS: () => SESSION_FILE_TRANSFER_DEFAULT_TIMEOUT_MS,
   approveSession: () => approveSession,
-  cancelRun: () => cancelRun,
   cancelSession: () => cancelSession,
-  classifyOutput: () => classifyOutput,
+  classifySessionFile: () => classifySessionFile,
   createBillingCheckout: () => createBillingCheckout,
   createBillingPortal: () => createBillingPortal,
-  createOutputLink: () => createOutputLink,
   createSecret: () => createSecret,
   createSession: () => createSession,
+  createSessionFileLink: () => createSessionFileLink,
   deleteAgentsMd: () => deleteAgentsMd,
   deleteFile: () => deleteFile,
-  deleteRun: () => deleteRun,
   deleteSecret: () => deleteSecret,
   deleteSession: () => deleteSession,
   deleteSkill: () => deleteSkill,
@@ -2424,50 +2427,49 @@ __export(operations_exports, {
   download: () => download,
   downloadEvents: () => downloadEvents,
   downloadMetadata: () => downloadMetadata,
-  downloadOutput: () => downloadOutput,
-  downloadOutputs: () => downloadOutputs,
+  downloadSessionFile: () => downloadSessionFile,
+  downloadSessionFiles: () => downloadSessionFiles,
   eventArchiveLink: () => eventArchiveLink,
-  filterOutputs: () => filterOutputs,
-  findOutput: () => findOutput,
-  findOutputs: () => findOutputs,
+  filterSessionFiles: () => filterSessionFiles,
+  findSessionFile: () => findSessionFile,
+  findSessionFiles: () => findSessionFiles,
   getAgentsMd: () => getAgentsMd,
   getBilling: () => getBilling,
   getBillingLedger: () => getBillingLedger,
   getCoordinatorTicket: () => getCoordinatorTicket,
   getFile: () => getFile,
-  getRun: () => getRun,
-  getRunUnit: () => getRunUnit,
-  getRunWebhookDeliveries: () => getRunWebhookDeliveries,
   getSecret: () => getSecret,
   getSecretValue: () => getSecretValue,
   getSession: () => getSession,
   getSessionCoordinatorTicket: () => getSessionCoordinatorTicket,
+  getSessionRecord: () => getSessionRecord,
+  getSessionUnit: () => getSessionUnit,
+  getSessionWebhookDeliveries: () => getSessionWebhookDeliveries,
   getSkill: () => getSkill,
   getWebhookSigningSecret: () => getWebhookSigningSecret,
   listAgentsMd: () => listAgentsMd,
   listFiles: () => listFiles,
-  listOutputs: () => listOutputs,
-  listRunChildren: () => listRunChildren,
-  listRunEvents: () => listRunEvents,
-  listRuns: () => listRuns,
   listSecrets: () => listSecrets,
+  listSessionChildren: () => listSessionChildren,
   listSessionEvents: () => listSessionEvents,
+  listSessionFiles: () => listSessionFiles,
   listSessionMessages: () => listSessionMessages,
-  listSessionOutputs: () => listSessionOutputs,
+  listSessionRecordEvents: () => listSessionRecordEvents,
+  listSessionRecords: () => listSessionRecords,
   listSessions: () => listSessions,
   listSkills: () => listSkills,
-  normalizeOutputLinkExpiresIn: () => normalizeOutputLinkExpiresIn,
-  outputLink: () => outputLink,
-  readOutputText: () => readOutputText,
-  redeliverRunWebhook: () => redeliverRunWebhook,
+  normalizeSessionFileLinkExpiresIn: () => normalizeSessionFileLinkExpiresIn,
+  readSessionFileText: () => readSessionFileText,
+  redeliverSessionWebhook: () => redeliverSessionWebhook,
   requestApproval: () => requestApproval,
   resolveIdempotencyKey: () => resolveIdempotencyKey,
-  resolveOutputFileSelector: () => resolveOutputFileSelector,
+  resolveSessionFileSelector: () => resolveSessionFileSelector,
   resumeSession: () => resumeSession,
   rotateSecret: () => rotateSecret,
   sendSessionMessage: () => sendSessionMessage,
+  sessionFileLink: () => sessionFileLink,
+  startSessionRecord: () => startSessionRecord,
   submit: () => submit,
-  submitRun: () => submitRun,
   suspendSession: () => suspendSession,
   toFilenameMatcher: () => toFilenameMatcher,
   uploadWorkspaceAsset: () => uploadWorkspaceAsset,
@@ -3193,14 +3195,14 @@ function zipSync(data, opts) {
 
 // ../contracts/dist/operations.js
 import { randomUUID } from "node:crypto";
-async function getRun(http, runId) {
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}`);
-  return hasRun(result) ? result.run : result;
+async function getSessionRecord(http, sessionId) {
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}`);
+  return hasSessionRecord(result) ? result.session : result;
 }
-async function getRunUnit(http, runId) {
-  return normalizeRunUnit(await http.request(`/api/runs/${encodeURIComponent(runId)}`));
+async function getSessionUnit(http, sessionId) {
+  return normalizeSessionUnit(await http.request(`/api/sessions/${encodeURIComponent(sessionId)}`));
 }
-async function listRuns(http, query) {
+async function listSessionRecords(http, query) {
   const params = {};
   if (query?.status !== void 0)
     params.status = query.status;
@@ -3210,30 +3212,30 @@ async function listRuns(http, query) {
     params.limit = String(query.limit);
   if (query?.cursor !== void 0)
     params.cursor = query.cursor;
-  const page = await http.request("/api/runs", {}, params);
+  const page = await http.request("/api/sessions", {}, params);
   let changed = false;
-  const runs = [];
-  for (const run of page.runs) {
-    if (typeof run.id !== "string" || typeof run.status !== "string" || typeof run.createdAt !== "string" || typeof run.updatedAt !== "string") {
+  const sessions = [];
+  for (const session of page.sessions) {
+    if (typeof session.id !== "string" || typeof session.status !== "string" || typeof session.createdAt !== "string" || typeof session.updatedAt !== "string") {
       changed = true;
       continue;
     }
-    if (typeof run.costUsd !== "number" && run.costUsd !== void 0) {
-      const { costUsd: _dropped, ...rest } = run;
-      runs.push(rest);
+    if (typeof session.costUsd !== "number" && session.costUsd !== void 0) {
+      const { costUsd: _dropped, ...rest } = session;
+      sessions.push(rest);
       changed = true;
       continue;
     }
-    runs.push(run);
+    sessions.push(session);
   }
-  return changed ? { ...page, runs } : page;
+  return changed ? { ...page, sessions } : page;
 }
 function resolveIdempotencyKey(key) {
   if (key === void 0) {
     return `aex-idem-${randomUUID()}`;
   }
   if (typeof key !== "string" || key.trim().length === 0) {
-    throw new RunConfigValidationError("idempotencyKey must be a non-empty, non-whitespace string", {
+    throw new SessionConfigValidationError("idempotencyKey must be a non-empty, non-whitespace string", {
       field: "idempotencyKey",
       value: key
     });
@@ -3244,7 +3246,7 @@ function idempotencyHeaders(options) {
   if (options?.idempotencyKey === void 0)
     return void 0;
   if (typeof options.idempotencyKey !== "string" || options.idempotencyKey.trim().length === 0) {
-    throw new RunConfigValidationError("idempotencyKey must be a non-empty, non-whitespace string", {
+    throw new SessionConfigValidationError("idempotencyKey must be a non-empty, non-whitespace string", {
       field: "idempotencyKey",
       value: options.idempotencyKey
     });
@@ -3269,12 +3271,12 @@ async function submit(http, request, options) {
   const sessionId = created.sessionId ?? created.id;
   const accepted = await sendSessionMessage(http, sessionId, { input }, { idempotencyKey: messageKey });
   const session = accepted.session;
-  return { runId: session.sessionId ?? session.id, session };
+  return { sessionId: session.sessionId ?? session.id, session };
 }
 function assertSubmitInput(input) {
   const ok = typeof input === "string" && input.length > 0 || Array.isArray(input) && input.length > 0 && input.every((segment) => typeof segment === "string" && segment.length > 0);
   if (!ok) {
-    throw new RunConfigValidationError("submit: request.input must be a non-empty string or string array", {
+    throw new SessionConfigValidationError("submit: request.input must be a non-empty string or string array", {
       field: "input",
       value: input
     });
@@ -3356,16 +3358,16 @@ async function listSessionEvents(http, sessionId) {
   }
   return all;
 }
-async function listSessionOutputs(http, sessionId, query) {
-  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/outputs`);
-  return query === void 0 ? result.outputs : filterOutputs(result.outputs, query);
+async function listSessionFiles(http, sessionId, query) {
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/files`);
+  return query === void 0 ? result.files : filterSessionFiles(result.files, query);
 }
 async function getSessionCoordinatorTicket(http, sessionId) {
   return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/events/ticket`, { method: "POST" });
 }
 var LIST_EVENTS_PAGE_BUDGET = 1e3;
-async function listRunEvents(http, runId) {
-  const path = `/api/runs/${encodeURIComponent(runId)}/events`;
+async function listSessionRecordEvents(http, sessionId) {
+  const path = `/api/sessions/${encodeURIComponent(sessionId)}/events`;
   const all = [];
   let cursor;
   for (let page = 0; page < LIST_EVENTS_PAGE_BUDGET; page++) {
@@ -3378,31 +3380,27 @@ async function listRunEvents(http, runId) {
   }
   return all;
 }
-async function getCoordinatorTicket(http, runId) {
-  return http.request(`/api/runs/${encodeURIComponent(runId)}/events/ticket`, { method: "POST" });
-}
-async function listOutputs(http, runId, query) {
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}/outputs`);
-  return query === void 0 ? result.outputs : filterOutputs(result.outputs, query);
+async function getCoordinatorTicket(http, sessionId) {
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/events/ticket`, { method: "POST" });
 }
-async function findOutputs(http, runId, query) {
-  return listOutputs(http, runId, query);
+async function findSessionFiles(http, sessionId, query) {
+  return listSessionFiles(http, sessionId, query);
 }
-async function findOutput(http, runId, query) {
-  const matches = await findOutputs(http, runId, query);
+async function findSessionFile(http, sessionId, query) {
+  const matches = await findSessionFiles(http, sessionId, query);
   if (matches.length === 0)
     return null;
   if (matches.length === 1)
     return matches[0];
-  throw new RunStateError("outputs.findOne: output query matched multiple files", {
-    runId,
-    matches: matches.map((output) => output.filename ?? output.id)
+  throw new SessionStateError("files.findOne: file query matched multiple files", {
+    sessionId,
+    matches: matches.map((file2) => file2.filename ?? file2.id)
   });
 }
-async function outputLink(http, runId, selectorOrQuery, options) {
-  const output = await resolveOutputLinkTarget(http, runId, selectorOrQuery);
-  const expiresInSeconds = normalizeOutputLinkExpiresIn(options?.expiresIn);
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}/outputs/${encodeURIComponent(output.id)}/link`, {
+async function sessionFileLink(http, sessionId, selectorOrQuery, options) {
+  const file2 = await resolveSessionFileLinkTarget(http, sessionId, selectorOrQuery);
+  const expiresInSeconds = normalizeSessionFileLinkExpiresIn(options?.expiresIn);
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/files/${encodeURIComponent(file2.id)}/link`, {
     method: "POST",
     body: JSON.stringify({ expiresInSeconds })
   });
@@ -3411,18 +3409,18 @@ async function outputLink(http, runId, selectorOrQuery, options) {
     ...result,
     expiresInSeconds: effectiveExpiresIn,
     expiresAt: result.expiresAt ?? syntheticExpiresAt(effectiveExpiresIn),
-    output: result.output ?? output
+    file: result.file ?? file2
   };
 }
 function syntheticExpiresAt(expiresInSeconds) {
   return new Date(Date.now() + expiresInSeconds * 1e3).toISOString();
 }
-async function createOutputLink(http, runId, selectorOrQuery, options) {
-  return outputLink(http, runId, selectorOrQuery, options);
+async function createSessionFileLink(http, sessionId, selectorOrQuery, options) {
+  return sessionFileLink(http, sessionId, selectorOrQuery, options);
 }
-async function eventArchiveLink(http, runId, options) {
-  const expiresInSeconds = normalizeOutputLinkExpiresIn(options?.expiresIn);
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}/events/link`, {
+async function eventArchiveLink(http, sessionId, options) {
+  const expiresInSeconds = normalizeSessionFileLinkExpiresIn(options?.expiresIn);
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/events/link`, {
     method: "POST",
     body: JSON.stringify({ expiresInSeconds })
   });
@@ -3433,16 +3431,16 @@ async function eventArchiveLink(http, runId, options) {
     expiresAt: result.expiresAt ?? syntheticExpiresAt(effectiveExpiresIn)
   };
 }
-function resolveOutputFileSelector(outputs, selector, runId) {
+function resolveSessionFileSelector(files, selector, sessionId) {
   if (isPathSelector(selector)) {
-    const target = normalizeOutputLookupPath(selector.path);
+    const target = normalizeSessionFileLookupPath(selector.path);
     if (!target) {
-      throw new RunStateError("outputs.download: output path must be non-empty", { runId, path: selector.path });
+      throw new SessionStateError("files.download: file path must be non-empty", { sessionId, path: selector.path });
     }
-    const matches = outputs.filter((output) => {
-      if (typeof output.filename !== "string")
+    const matches = files.filter((file2) => {
+      if (typeof file2.filename !== "string")
         return false;
-      const filename = normalizeOutputLookupPath(output.filename);
+      const filename = normalizeSessionFileLookupPath(file2.filename);
       if (selector.match === "suffix") {
         return filename === target || filename.endsWith(`/${target}`);
       }
@@ -3451,62 +3449,62 @@ function resolveOutputFileSelector(outputs, selector, runId) {
     if (matches.length === 1)
       return matches[0];
     if (matches.length > 1) {
-      throw new RunStateError(`outputs.download: output path "${selector.path}" matched multiple files`, { runId, path: selector.path, matches: matches.map((output) => output.filename ?? output.id) });
+      throw new SessionStateError(`files.download: file path "${selector.path}" matched multiple files`, { sessionId, path: selector.path, matches: matches.map((file2) => file2.filename ?? file2.id) });
     }
-    throw new RunStateError(`outputs.download: output path "${selector.path}" was not found`, {
-      runId,
+    throw new SessionStateError(`files.download: file path "${selector.path}" was not found`, {
+      sessionId,
       path: selector.path
     });
   }
   if (typeof selector?.id !== "string" || selector.id.length === 0) {
-    throw new RunStateError("outputs.download: selector must include an output id or path", { runId });
+    throw new SessionStateError("files.download: selector must include a file id or path", { sessionId });
   }
   return { ...selector, id: selector.id };
 }
-async function downloadOutput(http, runId, selector, options) {
-  const output = isPathSelector(selector) ? resolveOutputFileSelector(await listOutputs(http, runId), selector, runId) : resolveOutputFileSelector([], selector, runId);
-  const timeoutMs = normalizeOutputTransferTimeoutMs(options?.timeoutMs);
-  const path = `/api/runs/${encodeURIComponent(runId)}/outputs/${encodeURIComponent(output.id)}/download`;
-  return { output, bytes: await downloadOutputBytesWithRetry(http, path, timeoutMs) };
-}
-var READ_OUTPUT_TEXT_MAX_BYTES = 1e7;
-var READ_OUTPUT_TEXT_DEFAULT_BYTES = 5e4;
-var OUTPUT_FILE_TRANSFER_DEFAULT_TIMEOUT_MS = 3e4;
-var OUTPUT_FILE_TRANSFER_ATTEMPTS = 2;
-async function readOutputText(http, runId, selector, options) {
-  const maxBytes = Math.max(1, Math.min(options?.maxBytes ?? READ_OUTPUT_TEXT_DEFAULT_BYTES, READ_OUTPUT_TEXT_MAX_BYTES));
-  const output = isPathSelector(selector) ? resolveOutputFileSelector(await listOutputs(http, runId), selector, runId) : resolveOutputFileSelector([], selector, runId);
-  const timeoutMs = normalizeOutputTransferTimeoutMs(options?.timeoutMs);
-  const path = `/api/runs/${encodeURIComponent(runId)}/outputs/${encodeURIComponent(output.id)}/download`;
-  const capped = await readOutputTextWithRetry(http, path, maxBytes, timeoutMs);
+async function downloadSessionFile(http, sessionId, selector, options) {
+  const file2 = isPathSelector(selector) ? resolveSessionFileSelector(await listSessionFiles(http, sessionId), selector, sessionId) : resolveSessionFileSelector([], selector, sessionId);
+  const timeoutMs = normalizeSessionFileTransferTimeoutMs(options?.timeoutMs);
+  const path = `/api/sessions/${encodeURIComponent(sessionId)}/files/${encodeURIComponent(file2.id)}/download`;
+  return { file: file2, bytes: await downloadSessionFileBytesWithRetry(http, path, timeoutMs) };
+}
+var READ_SESSION_FILE_TEXT_MAX_BYTES = 1e7;
+var READ_SESSION_FILE_TEXT_DEFAULT_BYTES = 5e4;
+var SESSION_FILE_TRANSFER_DEFAULT_TIMEOUT_MS = 3e4;
+var SESSION_FILE_TRANSFER_ATTEMPTS = 2;
+async function readSessionFileText(http, sessionId, selector, options) {
+  const maxBytes = Math.max(1, Math.min(options?.maxBytes ?? READ_SESSION_FILE_TEXT_DEFAULT_BYTES, READ_SESSION_FILE_TEXT_MAX_BYTES));
+  const file2 = isPathSelector(selector) ? resolveSessionFileSelector(await listSessionFiles(http, sessionId), selector, sessionId) : resolveSessionFileSelector([], selector, sessionId);
+  const timeoutMs = normalizeSessionFileTransferTimeoutMs(options?.timeoutMs);
+  const path = `/api/sessions/${encodeURIComponent(sessionId)}/files/${encodeURIComponent(file2.id)}/download`;
+  const capped = await readSessionFileTextWithRetry(http, path, maxBytes, timeoutMs);
   const text = options?.grep === void 0 ? capped.text : grepLines(capped.text, options.grep);
-  return { output, text, truncated: capped.truncated, totalBytes: capped.totalBytes };
+  return { file: file2, text, truncated: capped.truncated, totalBytes: capped.totalBytes };
 }
-async function downloadOutputBytesWithRetry(http, path, timeoutMs) {
-  return outputTransferWithRetry(path, timeoutMs, async () => {
-    const response = await downloadOutputResponse(http, path, timeoutMs);
+async function downloadSessionFileBytesWithRetry(http, path, timeoutMs) {
+  return sessionFileTransferWithRetry(path, timeoutMs, async () => {
+    const response = await downloadSessionFileResponse(http, path, timeoutMs);
     return readResponseBytes(response, timeoutMs);
   });
 }
-async function readOutputTextWithRetry(http, path, maxBytes, timeoutMs) {
-  return outputTransferWithRetry(path, timeoutMs, async () => {
-    const response = await downloadOutputResponse(http, path, timeoutMs);
+async function readSessionFileTextWithRetry(http, path, maxBytes, timeoutMs) {
+  return sessionFileTransferWithRetry(path, timeoutMs, async () => {
+    const response = await downloadSessionFileResponse(http, path, timeoutMs);
     return readCappedText(response, maxBytes, timeoutMs);
   });
 }
-async function downloadOutputResponse(http, path, timeoutMs) {
+async function downloadSessionFileResponse(http, path, timeoutMs) {
   const controller = new AbortController();
-  const { response } = await withOutputTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "download-open");
+  const { response } = await withSessionFileTransferTimeout(http.download(path, { signal: controller.signal }), timeoutMs, () => controller.abort(), "download-open");
   return response;
 }
-async function outputTransferWithRetry(path, timeoutMs, action) {
+async function sessionFileTransferWithRetry(path, timeoutMs, action) {
   const startedMs = Date.now();
   let lastTimeout;
-  for (let attempt = 1; attempt <= OUTPUT_FILE_TRANSFER_ATTEMPTS; attempt += 1) {
+  for (let attempt = 1; attempt <= SESSION_FILE_TRANSFER_ATTEMPTS; attempt += 1) {
     try {
       return await action();
     } catch (err2) {
-      if (!(err2 instanceof OutputTransferTimeoutError))
+      if (!(err2 instanceof SessionFileTransferTimeoutError))
         throw err2;
       lastTimeout = err2;
     }
@@ -3515,37 +3513,37 @@ async function outputTransferWithRetry(path, timeoutMs, action) {
     method: "GET",
     host: "",
     path,
-    cause: lastTimeout ?? new OutputTransferTimeoutError("unknown", timeoutMs),
-    attempts: OUTPUT_FILE_TRANSFER_ATTEMPTS,
+    cause: lastTimeout ?? new SessionFileTransferTimeoutError("unknown", timeoutMs),
+    attempts: SESSION_FILE_TRANSFER_ATTEMPTS,
     elapsedMs: Date.now() - startedMs
   });
 }
-function normalizeOutputTransferTimeoutMs(value) {
+function normalizeSessionFileTransferTimeoutMs(value) {
   if (value === void 0)
-    return OUTPUT_FILE_TRANSFER_DEFAULT_TIMEOUT_MS;
+    return SESSION_FILE_TRANSFER_DEFAULT_TIMEOUT_MS;
   if (!Number.isFinite(value) || value <= 0) {
-    throw new RunConfigValidationError("outputs.download: timeoutMs must be a positive finite number", {
+    throw new SessionConfigValidationError("files.download: timeoutMs must be a positive finite number", {
       timeoutMs: value
     });
   }
   return Math.max(1, Math.floor(value));
 }
-var OutputTransferTimeoutError = class extends Error {
+var SessionFileTransferTimeoutError = class extends Error {
   code = "ETIMEDOUT";
   phase;
   constructor(phase, timeoutMs) {
-    super(`output transfer phase=${phase} timed out after ${timeoutMs}ms`);
-    this.name = "OutputTransferTimeoutError";
+    super(`file transfer phase=${phase} timed out after ${timeoutMs}ms`);
+    this.name = "SessionFileTransferTimeoutError";
     this.phase = phase;
   }
 };
-async function withOutputTransferTimeout(promise, timeoutMs, abort, phase) {
+async function withSessionFileTransferTimeout(promise, timeoutMs, abort, phase) {
   let timedOut = false;
   let timeout;
   const timeoutPromise = new Promise((_, reject) => {
     timeout = setTimeout(() => {
       timedOut = true;
-      reject(new OutputTransferTimeoutError(phase, timeoutMs));
+      reject(new SessionFileTransferTimeoutError(phase, timeoutMs));
       queueMicrotask(() => {
         try {
           abort();
@@ -3558,7 +3556,7 @@ async function withOutputTransferTimeout(promise, timeoutMs, abort, phase) {
     return await Promise.race([promise, timeoutPromise]);
   } catch (err2) {
     if (timedOut && isAbortLikeError(err2))
-      throw new OutputTransferTimeoutError(phase, timeoutMs);
+      throw new SessionFileTransferTimeoutError(phase, timeoutMs);
     throw err2;
   } finally {
     if (timeout !== void 0)
@@ -3572,7 +3570,7 @@ function isAbortLikeError(err2) {
 async function readResponseBytes(response, timeoutMs) {
   const body = response.body;
   if (!body) {
-    const buffer = await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
+    const buffer = await withSessionFileTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
     }, "body-read");
     return new Uint8Array(buffer);
   }
@@ -3580,7 +3578,7 @@ async function readResponseBytes(response, timeoutMs) {
   const chunks = [];
   try {
     while (true) {
-      const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
+      const { done, value } = await withSessionFileTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
       }, "body-read");
@@ -3601,7 +3599,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
   const decoder = new TextDecoder("utf-8");
   const body = response.body;
   if (!body) {
-    const buf = new Uint8Array(await withOutputTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
+    const buf = new Uint8Array(await withSessionFileTransferTimeout(response.arrayBuffer(), timeoutMs, () => {
     }, "body-read"));
     const total = declared ?? buf.byteLength;
     return {
@@ -3616,7 +3614,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
   let sawMore = false;
   try {
     while (read < maxBytes) {
-      const { done, value } = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
+      const { done, value } = await withSessionFileTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
       }, "body-read");
@@ -3628,7 +3626,7 @@ async function readCappedText(response, maxBytes, timeoutMs) {
       }
     }
     if (read >= maxBytes) {
-      const next = await withOutputTransferTimeout(reader.read(), timeoutMs, () => {
+      const next = await withSessionFileTransferTimeout(reader.read(), timeoutMs, () => {
         void reader.cancel().catch(() => {
         });
       }, "body-read");
@@ -3660,22 +3658,16 @@ function grepLines(text, pattern) {
   const test = typeof pattern === "string" ? (line) => line.toLowerCase().includes(pattern.toLowerCase()) : (line) => pattern.test(line);
   return text.split("\n").filter((line) => test(line)).join("\n");
 }
-async function listRunChildren(http, runId) {
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}/children`);
+async function listSessionChildren(http, sessionId) {
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/children`);
   return Array.isArray(result) ? result : result.children;
 }
-async function cancelRun(http, runId) {
-  await http.request(`/api/runs/${encodeURIComponent(runId)}/cancel`, { method: "POST" });
-}
-async function deleteRun(http, runId) {
-  await http.request(`/api/runs/${encodeURIComponent(runId)}`, { method: "DELETE" });
-}
-async function getRunWebhookDeliveries(http, runId) {
-  const result = await http.request(`/api/runs/${encodeURIComponent(runId)}/webhook-deliveries`);
+async function getSessionWebhookDeliveries(http, sessionId) {
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/webhook-deliveries`);
   return Array.isArray(result) ? result : result.deliveries;
 }
-async function redeliverRunWebhook(http, runId, deliveryId) {
-  await http.request(`/api/runs/${encodeURIComponent(runId)}/webhook-deliveries/${encodeURIComponent(deliveryId)}/redeliver`, { method: "POST" });
+async function redeliverSessionWebhook(http, sessionId, deliveryId) {
+  await http.request(`/api/sessions/${encodeURIComponent(sessionId)}/webhook-deliveries/${encodeURIComponent(deliveryId)}/redeliver`, { method: "POST" });
 }
 async function deleteWorkspaceAsset(http, hash) {
   const assetId = hash.startsWith("asset_") ? hash : `asset_${hash.startsWith("sha256:") ? hash.slice("sha256:".length) : hash}`;
@@ -3708,17 +3700,17 @@ async function getBillingLedger(http, query) {
 async function getWebhookSigningSecret(http) {
   return http.request("/api/webhook/signing-secret", { method: "POST" });
 }
-async function collectArtifactBytes(http, runId, items, zipPrefix, namespace2, timeoutMs = OUTPUT_FILE_TRANSFER_DEFAULT_TIMEOUT_MS) {
+async function collectArtifactBytes(http, sessionId, items, zipPrefix, namespace2, timeoutMs = SESSION_FILE_TRANSFER_DEFAULT_TIMEOUT_MS) {
   const entries = [];
   const captured = [];
   const errors = [];
   for (const item of items) {
     const rel = item.filename ?? item.id;
     try {
-      const path = `/api/runs/${encodeURIComponent(runId)}/${namespace2}/${encodeURIComponent(item.id)}/download`;
+      const path = `/api/sessions/${encodeURIComponent(sessionId)}/${namespace2}/${encodeURIComponent(item.id)}/download`;
       entries.push({
         path: `${zipPrefix}${rel}`,
-        bytes: await downloadOutputBytesWithRetry(http, path, timeoutMs),
+        bytes: await downloadSessionFileBytesWithRetry(http, path, timeoutMs),
         ...item.contentType !== void 0 ? { contentType: item.contentType } : {},
         customerContent: true
       });
@@ -3740,11 +3732,11 @@ function eventsJsonl(events) {
 function isPathSelector(selector) {
   return Boolean(selector && typeof selector === "object" && "path" in selector);
 }
-function normalizeOutputLookupPath(path) {
+function normalizeSessionFileLookupPath(path) {
   return path.replace(/\\/g, "/").replace(/^\/+/, "");
 }
-function filterOutputs(outputs, query) {
-  return outputs.filter((output) => outputMatchesQuery(output, query));
+function filterSessionFiles(files, query) {
+  return files.filter((file2) => sessionFileMatchesQuery(file2, query));
 }
 function toFilenameMatcher(filename) {
   if (typeof filename === "string") {
@@ -3756,8 +3748,8 @@ function toFilenameMatcher(filename) {
     return filename.test(name);
   };
 }
-function classifyOutput(output) {
-  const contentType = normalizeContentType(output.contentType);
+function classifySessionFile(file2) {
+  const contentType = normalizeContentType(file2.contentType);
   if (contentType) {
     if (contentType === "application/json" || contentType.endsWith("+json") || contentType.includes("json")) {
       return "json";
@@ -3779,7 +3771,7 @@ function classifyOutput(output) {
       return "binary";
     return "unknown";
   }
-  const extension = extensionOf(output.filename);
+  const extension = extensionOf(file2.filename);
   if (!extension)
     return "unknown";
   if (["json", "jsonl", "ndjson"].includes(extension))
@@ -3802,10 +3794,10 @@ function classifyOutput(output) {
     return "binary";
   return "unknown";
 }
-function normalizeOutputLinkExpiresIn(input = "1h") {
+function normalizeSessionFileLinkExpiresIn(input = "1h") {
   if (typeof input === "number") {
     if (!Number.isFinite(input) || input <= 0) {
-      throw new RunStateError("outputLink: expiresIn must be a positive number of seconds", {
+      throw new SessionStateError("sessionFileLink: expiresIn must be a positive number of seconds", {
         expiresIn: input
       });
     }
@@ -3817,34 +3809,34 @@ function normalizeOutputLinkExpiresIn(input = "1h") {
     return 60 * 60;
   if (input === "1d")
     return 24 * 60 * 60;
-  throw new RunStateError('outputLink: expiresIn must be seconds, "15m", "1h", or "1d"', {
+  throw new SessionStateError('sessionFileLink: expiresIn must be seconds, "15m", "1h", or "1d"', {
     expiresIn: input
   });
 }
-async function resolveOutputLinkTarget(http, runId, selectorOrQuery) {
+async function resolveSessionFileLinkTarget(http, sessionId, selectorOrQuery) {
   if (typeof selectorOrQuery === "string") {
     if (selectorOrQuery.length === 0) {
-      throw new RunStateError("outputLink: selector must include an output id or query", { runId });
+      throw new SessionStateError("sessionFileLink: selector must include a file id or query", { sessionId });
     }
     return { id: selectorOrQuery };
   }
-  if (hasOutputId(selectorOrQuery)) {
+  if (hasSessionFileId(selectorOrQuery)) {
     if (selectorOrQuery.id.length === 0) {
-      throw new RunStateError("outputLink: selector must include an output id or query", { runId });
+      throw new SessionStateError("sessionFileLink: selector must include a file id or query", { sessionId });
     }
     return selectorOrQuery;
   }
   if (isPathSelector(selectorOrQuery) && selectorOrQuery.match === "suffix") {
-    return resolveOutputFileSelector(await listOutputs(http, runId), selectorOrQuery, runId);
+    return resolveSessionFileSelector(await listSessionFiles(http, sessionId), selectorOrQuery, sessionId);
   }
-  const match = await findOutput(http, runId, selectorOrQuery);
+  const match = await findSessionFile(http, sessionId, selectorOrQuery);
   if (match)
     return match;
-  throw new RunStateError("outputLink: output query matched no files", { runId });
+  throw new SessionStateError("sessionFileLink: file query matched no files", { sessionId });
 }
-function outputMatchesQuery(output, query) {
-  const normalizedPath = typeof output.filename === "string" ? normalizeOutputQueryPath(output.filename) : "";
-  if (query.path !== void 0 && normalizedPath !== normalizeOutputQueryPath(query.path)) {
+function sessionFileMatchesQuery(file2, query) {
+  const normalizedPath = typeof file2.filename === "string" ? normalizeSessionFileQueryPath(file2.filename) : "";
+  if (query.path !== void 0 && normalizedPath !== normalizeSessionFileQueryPath(query.path)) {
     return false;
   }
   if (query.filename !== void 0) {
@@ -3864,21 +3856,21 @@ function outputMatchesQuery(output, query) {
   if (query.extension !== void 0 && extensionOf(normalizedPath) !== normalizeExtension(query.extension)) {
     return false;
   }
-  if (query.contentType !== void 0 && !contentTypeMatches(output.contentType, query.contentType)) {
+  if (query.contentType !== void 0 && !contentTypeMatches(file2.contentType, query.contentType)) {
     return false;
   }
-  if (query.type !== void 0 && classifyOutput(output) !== query.type) {
+  if (query.type !== void 0 && classifySessionFile(file2) !== query.type) {
     return false;
   }
   return true;
 }
-function hasOutputId(value) {
+function hasSessionFileId(value) {
   return Boolean(value && typeof value === "object" && "id" in value && typeof value.id === "string");
 }
-function normalizeOutputQueryPath(path) {
+function normalizeSessionFileQueryPath(path) {
   let normalized = path.replace(/\\/g, "/").replace(/^\/+/, "");
-  while (normalized === "outputs" || normalized.startsWith("outputs/")) {
-    normalized = normalized === "outputs" ? "" : normalized.slice("outputs/".length);
+  while (normalized === "files" || normalized.startsWith("files/")) {
+    normalized = normalized === "files" ? "" : normalized.slice("files/".length);
   }
   return normalized.replace(/\/+$/, "");
 }
@@ -3886,7 +3878,7 @@ function basenameOf(path) {
   return path.split("/").filter(Boolean).pop() ?? "";
 }
 function directoryMatches(path, dir, recursive) {
-  const normalizedDir = normalizeOutputQueryPath(dir);
+  const normalizedDir = normalizeSessionFileQueryPath(dir);
   if (normalizedDir.length === 0)
     return true;
   const prefix = `${normalizedDir}/`;
@@ -3901,7 +3893,7 @@ function normalizeExtension(extension) {
 function extensionOf(path) {
   if (!path)
     return "";
-  const basename = basenameOf(normalizeOutputQueryPath(path));
+  const basename = basenameOf(normalizeSessionFileQueryPath(path));
   const index = basename.lastIndexOf(".");
   return index > 0 && index < basename.length - 1 ? basename.slice(index + 1).toLowerCase() : "";
 }
@@ -3918,67 +3910,67 @@ function contentTypeMatches(actual, expected) {
   }
   return normalizedActual === normalizedExpected;
 }
-async function download(http, runId) {
-  const [run, events, outputs] = await Promise.all([
-    getRun(http, runId),
-    listRunEvents(http, runId),
-    listOutputs(http, runId)
+async function download(http, sessionId) {
+  const [sessionRecord, events, files] = await Promise.all([
+    getSessionRecord(http, sessionId),
+    listSessionRecordEvents(http, sessionId),
+    listSessionFiles(http, sessionId)
   ]);
-  const out = await collectArtifactBytes(http, runId, outputs, "outputs/", "outputs");
-  const submissionSnapshot = extractSubmissionSnapshot(run);
-  const costTelemetry = extractCostTelemetry(run);
-  const manifest = buildRunRecordDownloadManifestV1({
-    runId,
-    outputs: out.captured,
-    errors: out.errors,
+  const collectedFiles = await collectArtifactBytes(http, sessionId, files, "files/", "files");
+  const submissionSnapshot = extractSubmissionSnapshot(sessionRecord);
+  const costTelemetry = extractCostTelemetry(sessionRecord);
+  const manifest = buildSessionRecordDownloadManifestV1({
+    sessionId,
+    sessionFiles: collectedFiles.captured,
+    errors: collectedFiles.errors,
     typedEventCount: events.length,
     ...submissionSnapshot ? { submission: { status: "present" } } : {},
     ...costTelemetry ? { cost: { status: "present" } } : {}
   });
   return zipEntries([
-    jsonEntry("metadata/run.json", run),
+    jsonEntry("metadata/session.json", sessionRecord),
     ...submissionSnapshot ? [jsonEntry("metadata/submission.json", submissionSnapshot)] : [],
     ...costTelemetry ? [jsonEntry("metadata/cost.json", costTelemetry)] : [],
     jsonlEntry("events/events.jsonl", events),
-    ...out.entries,
+    ...collectedFiles.entries,
     jsonEntry("manifest.json", manifest)
   ]);
 }
-async function downloadOutputs(http, runId, options) {
-  const outputs = await listOutputs(http, runId);
-  const timeoutMs = normalizeOutputTransferTimeoutMs(options?.timeoutMs);
-  const { entries, captured, errors } = await collectArtifactBytes(http, runId, outputs, "", "outputs", timeoutMs);
+async function downloadSessionFiles(http, sessionId, options) {
+  const files = await listSessionFiles(http, sessionId);
+  const timeoutMs = normalizeSessionFileTransferTimeoutMs(options?.timeoutMs);
+  const { entries, captured, errors } = await collectArtifactBytes(http, sessionId, files, "", "files", timeoutMs);
   return zipEntries([
     ...entries,
-    jsonEntry("manifest.json", { runId, namespace: "outputs", outputs: captured, errors })
+    jsonEntry("manifest.json", { sessionId, namespace: "files", files: captured, errors })
   ]);
 }
-async function downloadEvents(http, runId) {
-  const events = await listRunEvents(http, runId);
+async function downloadEvents(http, sessionId) {
+  const events = await listSessionRecordEvents(http, sessionId);
   return zipEntries([
     jsonlEntry("events.jsonl", events),
     jsonEntry("manifest.json", {
-      runId,
+      sessionId,
       namespace: "events",
       files: [{ path: "events.jsonl", role: "typed_events", status: "present", recordCount: events.length }],
       errors: []
     })
   ]);
 }
-async function downloadMetadata(http, runId) {
-  const run = await getRun(http, runId);
+async function downloadMetadata(http, sessionId) {
+  const sessionRecord = await getSessionRecord(http, sessionId);
   return zipEntries([
-    jsonEntry("run.json", run),
+    jsonEntry("session.json", sessionRecord),
     jsonEntry("manifest.json", {
-      runId,
+      sessionId,
       namespace: "metadata",
-      files: [{ path: "run.json", role: "run_metadata", status: "present" }],
+      files: [{ path: "session.json", role: "session_metadata", status: "present" }],
       errors: []
     })
   ]);
 }
 function zipEntries(entries) {
-  assertRunRecordArchivePublicSafeV1(entries);
+  assertSessionRecordArchivePublicSafeV1(entries);
   const files = {};
   for (const entry of entries) {
     files[entry.path] = entry.bytes;
@@ -3999,8 +3991,8 @@ function jsonlEntry(path, events) {
     contentType: "application/jsonl; charset=utf-8"
   };
 }
-function extractSubmissionSnapshot(run) {
-  const raw = run.submission;
+function extractSubmissionSnapshot(sessionRecord) {
+  const raw = sessionRecord.submission;
   if (!isRecord3(raw) || raw.kind !== "submission" || !isRecord3(raw.submission)) {
     return void 0;
   }
@@ -4008,15 +4000,15 @@ function extractSubmissionSnapshot(run) {
     submission: raw.submission
   };
 }
-function extractCostTelemetry(run) {
-  const raw = run.costTelemetry;
+function extractCostTelemetry(sessionRecord) {
+  const raw = sessionRecord.costTelemetry;
   return isRecord3(raw) ? raw : void 0;
 }
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-async function submitRun(http, request) {
-  return http.request("/api/runs", {
+async function startSessionRecord(http, request) {
+  return http.request("/api/sessions", {
     method: "POST",
     body: JSON.stringify(request)
   });
@@ -4140,8 +4132,8 @@ function unwrapSkill(result) {
   }
   return result;
 }
-function hasRun(value) {
-  return Boolean(value && typeof value === "object" && "run" in value);
+function hasSessionRecord(value) {
+  return Boolean(value && typeof value === "object" && "session" in value);
 }
 function unwrapSession(result) {
   if (result && typeof result === "object" && "session" in result) {
@@ -4179,7 +4171,7 @@ var SUCCESS = { code: 0 };
 var USAGE_ERR = { code: 2 };
 var RUNTIME_ERR = { code: 1 };
 var TIMEOUT_ERR = { code: 3 };
-var TERMINAL_STATUSES = new Set(TERMINAL_RUN_STATUSES);
+var TERMINAL_STATUSES = new Set(TERMINAL_SESSION_CONTROL_STATUSES);
 function isSessionParked2(status) {
   return status === "idle" || status === "suspended" || status === "error" || TERMINAL_STATUSES.has(status);
 }
@@ -4314,7 +4306,7 @@ function remedyForStatus(status) {
   if (status === 429)
     return "rate limited \u2014 retry with backoff";
   if (status >= 500)
-    return "server error \u2014 retry; re-run with --debug to capture the request trace";
+    return "server error \u2014 retry; re-session with --debug to capture the request trace";
   return void 0;
 }
 function remedyForNetworkCode(code) {
@@ -4348,10 +4340,10 @@ function makeHttpClient(io2, flags) {
 `) } : {}
   });
 }
-async function refuseInsideManagedRun(io2, verb) {
+async function refuseInsideManagedSession(io2, verb) {
   try {
     await io2.readFile(AEX_INDEX_PATH);
-    io2.stderr(`\`aex ${verb}\` is a host command and cannot run inside a managed run container.
+    io2.stderr(`\`aex ${verb}\` is a host command and cannot execute inside a managed session container.
 Make HTTP calls from your code and pass credentials through secrets.
 `);
     return true;
@@ -4360,7 +4352,7 @@ Make HTTP calls from your code and pass credentials through secrets.
     if (code === "ENOENT" || code === "ENOTDIR") {
       return false;
     }
-    io2.stderr(`\`aex ${verb}\` could not determine whether it is running inside a managed run container (error reading ${AEX_INDEX_PATH}: ${err2.message ?? "unknown"}). Refusing to proceed.
+    io2.stderr(`\`aex ${verb}\` could not determine whether it is running inside a managed session container (error reading ${AEX_INDEX_PATH}: ${err2.message ?? "unknown"}). Refusing to proceed.
 `);
     return true;
   }
@@ -4491,27 +4483,27 @@ function takeOptionFlag(rest, flag) {
   return { value, remaining };
 }
 
-// dist/outputs-sync.js
-async function runOutputsSyncCmd(io2, dirs) {
+// dist/files-sync.js
+async function executeFilesSyncCmd(io2, dirs) {
   if (dirs.length === 0) {
-    io2.stderr("usage: aex outputs sync <dir> [<dir> ...]\n");
+    io2.stderr("usage: aex files sync <dir> [<dir> ...]\n");
     return USAGE_ERR;
   }
   try {
     await io2.readFile(AEX_INDEX_PATH);
   } catch {
-    io2.stderr("`aex outputs sync` is an in-container internal command and cannot run on the host.\n");
+    io2.stderr("`aex files sync` is an in-container internal command and cannot run on the host.\n");
     return USAGE_ERR;
   }
   if (!io2.walkDirectory) {
-    io2.stderr("aex outputs sync: walkDirectory IO is not available\n");
+    io2.stderr("aex files sync: walkDirectory IO is not available\n");
     return RUNTIME_ERR;
   }
   let scanned = 0;
   let missing = 0;
   for (const dir of dirs) {
     if (!dir.startsWith("/")) {
-      io2.stderr(JSON.stringify({ dir, error: "non_absolute_path", message: "skipping non-absolute output dir" }) + "\n");
+      io2.stderr(JSON.stringify({ dir, error: "non_absolute_path", message: "skipping non-absolute file dir" }) + "\n");
       missing++;
       continue;
     }
@@ -4539,7 +4531,7 @@ async function runOutputsSyncCmd(io2, dirs) {
 
 // dist/host/registry.js
 var COMMON_HOST_FLAGS = ["--api-key", "--aex-url", "--json", "--debug"];
-var RUN_FLAGS = [
+var START_FLAGS = [
   "--provider",
   "--model",
   "--system",
@@ -4553,20 +4545,20 @@ var RUN_FLAGS = [
   "--mcp-auth",
   "--metadata",
   "--runtime-size",
-  "--run-timeout",
+  "--session-timeout",
   "--idempotency-key",
   "--webhook",
   "--follow",
   "--timeout"
 ];
-var OUTPUTS_SUBVERBS = ["read", "download", "link", "find", "search"];
+var FILES_SUBVERBS = ["read", "download", "link", "find", "search"];
 var CLI_VERBS = [
   {
-    name: "run",
+    name: "start",
     summary: "One-shot: open a session, send the prompt as the first turn (delegates to the SDK).",
     usage: [
-      "aex run --model M --prompt P [--system S] [--provider name] --<provider>-api-key K",
-      "aex run --config <run.json> --<provider>-api-key K",
+      "aex start --model M --prompt P [--system S] [--provider name] --<provider>-api-key K",
+      "aex start --config <session.json> --<provider>-api-key K",
       "  --skill @file        Attach a workspace skill bundle (repeatable)",
       "  --tool @file.js      Attach a custom tool module (repeatable)",
       "  --agents-md @file    Attach an AGENTS.md brief (repeatable)",
@@ -4574,20 +4566,20 @@ var CLI_VERBS = [
       "  --mcp name=url       MCP server (repeatable); --mcp-auth name=Hdr:Val for headers",
       "  --metadata key=value Submission metadata (repeatable)",
       "  --runtime-size <s>   Managed runtime preset",
-      "  --run-timeout <dur>  Server-side run deadline (validated client-side by the SDK)",
-      "  --webhook <url>      Per-run terminal callback (https)",
+      "  --session-timeout <dur>  Server-side session deadline (validated client-side by the SDK)",
+      "  --webhook <url>      Per-session terminal callback (https)",
       "  --follow             Stream the turn's events until the session parks"
     ],
-    flags: RUN_FLAGS
+    flags: START_FLAGS
   },
   {
     name: "status",
-    summary: "Print a session/run record (GET /api/sessions/:id).",
+    summary: "Print a session/session record (GET /api/sessions/:id).",
     usage: ["aex status <session-id>"]
   },
   {
     name: "deliveries",
-    summary: "List a run's webhook delivery attempts.",
+    summary: "List a session's webhook delivery attempts.",
     usage: ["aex deliveries <session-id>"]
   },
   {
@@ -4615,28 +4607,28 @@ var CLI_VERBS = [
     flags: ["--filter", "--logs", "--timeout"]
   },
   {
-    name: "outputs",
-    summary: "List a session's captured outputs, or read/download/link/find/search one file.",
+    name: "files",
+    summary: "List a session's captured files, or read/download/link/find/search one file.",
     usage: [
-      "aex outputs <session-id>                         List captured outputs (NDJSON)",
-      "aex outputs read <session-id> <path>             Read one file as capped text",
-      "aex outputs download <session-id> <path> [--out] Download one file's raw bytes",
-      "aex outputs link <session-id> <path>             Mint a temporary download URL",
-      "aex outputs find <session-id> [--name S] [--ext E] [--type T]",
-      "aex outputs search [--query S] [--name S] [--ext E] [--run-id ID]   Cross-run"
+      "aex files <session-id>                         List captured files (NDJSON)",
+      "aex files read <session-id> <path>             Read one file as capped text",
+      "aex files download <session-id> <path> [--out] Download one file's raw bytes",
+      "aex files link <session-id> <path>             Mint a temporary download URL",
+      "aex files find <session-id> [--name S] [--ext E] [--type T]",
+      "aex files search [--query S] [--name S] [--ext E] [--session-id ID]   Cross-session"
     ],
-    flags: ["--out", "--name", "--ext", "--type", "--content-type", "--query", "--run-id", "--limit", "--max-bytes"],
-    subverbs: OUTPUTS_SUBVERBS
+    flags: ["--out", "--name", "--ext", "--type", "--content-type", "--query", "--session-id", "--limit", "--max-bytes"],
+    subverbs: FILES_SUBVERBS
   },
   {
     name: "download",
     summary: "Download a session's content as a zip (whole or one namespace).",
-    usage: ["aex download <session-id> [--only outputs|events|metadata] [--out path]"],
+    usage: ["aex download <session-id> [--only files|events|metadata] [--out path]"],
     flags: ["--only", "--out"]
   },
   {
     name: "cancel",
-    summary: "Cancel a running session.",
+    summary: "Cancel a sessionning session.",
     usage: ["aex cancel <session-id>"]
   },
   {
@@ -4650,9 +4642,9 @@ var CLI_VERBS = [
     usage: ["aex delete-asset <assetId|hash>"]
   },
   {
-    name: "runs",
-    summary: "List the workspace's runs (newest first).",
-    usage: ["aex runs [--limit N] [--since ISO]"],
+    name: "sessions",
+    summary: "List the workspace's sessions (newest first).",
+    usage: ["aex sessions [--limit N] [--since ISO]"],
     flags: ["--limit", "--since"]
   },
   {
@@ -4717,7 +4709,7 @@ var CLI_VERBS = [
   {
     name: "runtime-sizes",
     summary: "List managed runtime presets (no token needed).",
-    usage: ["aex runtime-sizes list [--json]"]
+    usage: ["aex starttime-sizes list [--json]"]
   }
 ];
 var VERB_BY_NAME = new Map(CLI_VERBS.map((v) => [v.name, v]));
@@ -4736,7 +4728,7 @@ function renderVerbHelp(spec) {
   return lines.join("\n") + "\n";
 }
 
-// dist/host/run-cmd.js
+// dist/host/start-cmd.js
 import { resolve as resolvePath } from "node:path";
 
 // ../contracts/dist/retry-core.js
@@ -4972,7 +4964,7 @@ function bufferToHex(buffer) {
   return out;
 }
 
-// dist/host/run-submit.js
+// dist/host/start-submit.js
 var TEXT = new TextEncoder();
 var ZIP_EPOCH = new Date(Date.UTC(1980, 0, 1));
 var UPLOAD_CONCURRENCY = 5;
@@ -5059,9 +5051,9 @@ async function buildSessionCreateRequest(http, fetchImpl, options) {
   const provider = resolveModelProvider(options.model, options.provider);
   validateApiKeys(options.apiKeys, provider);
   try {
-    parseRunTimeout(options.overrides?.timeout);
+    parseSessionTimeout(options.overrides?.timeout);
     if (options.webhook !== void 0)
-      parseRunWebhook(options.webhook);
+      parseSessionWebhook(options.webhook);
   } catch (err2) {
     throw new Error(err2 instanceof Error ? err2.message : String(err2));
   }
@@ -5070,7 +5062,7 @@ async function buildSessionCreateRequest(http, fetchImpl, options) {
     limitsInput.maxSpendUsd = options.overrides.maxSpendUsd;
   if (options.overrides?.maxTurns !== void 0)
     limitsInput.maxTurns = options.overrides.maxTurns;
-  const limits = parseRunLimits(Object.keys(limitsInput).length > 0 ? limitsInput : void 0);
+  const limits = parseSessionLimits(Object.keys(limitsInput).length > 0 ? limitsInput : void 0);
   const [preparedTools, preparedSkills, preparedAgentsMd, preparedFiles] = await Promise.all([
     prepareTools(http, fetchImpl, options.tools ?? []),
     prepareSkills(http, fetchImpl, options.skills ?? []),
@@ -5432,7 +5424,7 @@ async function* openEnvelopeStream(io2, http, sessionId, options = {}) {
     from: options.from ?? 0,
     fetchTicket: async () => (await operations_exports.getSessionCoordinatorTicket(http, sessionId)).ticket,
     ...io2.webSocketFactory ? { webSocketFactory: io2.webSocketFactory } : {},
-    ...options.settleConsistent ? { isTerminal: isRunSettled } : {},
+    ...options.settleConsistent ? { isTerminal: isSessionSettled } : {},
     ...options.signal ? { signal: options.signal } : {}
   });
 }
@@ -5455,8 +5447,8 @@ function renderEnvelope(e, options = {}) {
   if (channelOf(e) === "log" && !options.logs)
     return null;
   switch (e.type) {
-    case "RUN_STARTED":
-      return "\u25B6 run started";
+    case "TURN_STARTED":
+      return "\u25B6 turn started";
     case "TEXT_MESSAGE_CONTENT": {
       const delta = toAGUI(e).type === "TEXT_MESSAGE_CONTENT" ? toAGUI(e).delta : "";
       return delta ? delta : null;
@@ -5487,12 +5479,12 @@ function renderEnvelope(e, options = {}) {
       const level = e.level ?? "info";
       return `[${level}] ${e.message ?? str2(e.data.message)}`;
     }
-    case "RUN_FINISHED":
-      return "\u2713 run finished";
-    case "RUN_ERROR": {
+    case "TURN_FINISHED":
+      return "\u2713 session finished";
+    case "TURN_ERROR": {
       const agui = toAGUI(e);
-      const message = agui.type === "RUN_ERROR" ? agui.message : e.message ?? "run error";
-      return `\u2717 run error: ${message}`;
+      const message = agui.type === "TURN_ERROR" ? agui.message : e.message ?? "turn error";
+      return `\u2717 turn error: ${message}`;
     }
     default:
       return null;
@@ -5520,12 +5512,12 @@ function parseFilters(tokens) {
   return { predicate };
 }
 
-// dist/host/run-cmd.js
+// dist/host/start-cmd.js
 var DEFAULT_SESSION_IDLE_TTL = "3m";
 var FOLLOW_SETTLE_POLL_DEADLINE_MS = 6e4;
 var FOLLOW_SETTLE_POLL_INTERVAL_MS = 750;
-async function runRunCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "run"))
+async function executeStartCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "start"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -5543,16 +5535,16 @@ async function runRunCmd(io2, argv) {
   rest = providerFlag.remaining;
   let explicitProvider;
   if (providerFlag.value !== null) {
-    if (!RUN_PROVIDERS.includes(providerFlag.value)) {
-      const hint = suggest(providerFlag.value, RUN_PROVIDERS);
-      io2.stderr(`--provider must be one of: ${RUN_PROVIDERS.join(", ")} (got: ${providerFlag.value})${hint ? `; did you mean "${hint}"?` : ""}
+    if (!PROVIDERS.includes(providerFlag.value)) {
+      const hint = suggest(providerFlag.value, PROVIDERS);
+      io2.stderr(`--provider must be one of: ${PROVIDERS.join(", ")} (got: ${providerFlag.value})${hint ? `; did you mean "${hint}"?` : ""}
 `);
       return USAGE_ERR;
     }
     explicitProvider = providerFlag.value;
   }
   const providerKeyValues = {};
-  for (const p of RUN_PROVIDERS) {
+  for (const p of PROVIDERS) {
     const flag = takeFlagValue(rest, `--${p}-api-key`);
     if (flag.error) {
       io2.stderr(`${flag.error}
@@ -5590,18 +5582,18 @@ async function runRunCmd(io2, argv) {
 `);
     return USAGE_ERR;
   }
-  const runTimeoutFlag = takeFlagValue(rest, "--run-timeout");
-  if (runTimeoutFlag.error) {
-    io2.stderr(`${runTimeoutFlag.error}
+  const sessionTimeoutFlag = takeFlagValue(rest, "--session-timeout");
+  if (sessionTimeoutFlag.error) {
+    io2.stderr(`${sessionTimeoutFlag.error}
 `);
     return USAGE_ERR;
   }
-  rest = runTimeoutFlag.remaining;
-  if (runTimeoutFlag.value) {
+  rest = sessionTimeoutFlag.remaining;
+  if (sessionTimeoutFlag.value) {
     try {
-      parseRunTimeout(runTimeoutFlag.value);
+      parseSessionTimeout(sessionTimeoutFlag.value);
     } catch (err2) {
-      io2.stderr(`--run-timeout: ${err2.message}
+      io2.stderr(`--session-timeout: ${err2.message}
 `);
       return USAGE_ERR;
     }
@@ -5723,7 +5715,7 @@ async function runRunCmd(io2, argv) {
     return USAGE_ERR;
   }
   if (positional.length > 0) {
-    io2.stderr(`aex run takes no positional arguments (got: ${positional.join(" ")})
+    io2.stderr(`aex start takes no positional arguments (got: ${positional.join(" ")})
 `);
     return USAGE_ERR;
   }
@@ -5741,7 +5733,7 @@ async function runRunCmd(io2, argv) {
       io2.stderr("--config cannot be combined with --model/--system/--prompt/--mcp/--metadata\n");
       return USAGE_ERR;
     }
-    let runConfig;
+    let sessionConfig;
     try {
       const absPath = resolvePath(io2.cwd(), config.value);
       const text = await io2.readFile(absPath);
@@ -5749,20 +5741,20 @@ async function runRunCmd(io2, argv) {
       const { mcpHeaders, normalised } = stripMcpHeadersForParsing(raw);
       for (const [name, headers] of mcpHeaders)
         mcpHeaderBag.set(name, headers);
-      runConfig = parseRunRequestConfig(normalised);
+      sessionConfig = parseSessionRequestConfig(normalised);
     } catch (err2) {
       io2.stderr(`failed to load --config: ${err2.message}
 `);
       return USAGE_ERR;
     }
-    model = runConfig.model;
-    system = runConfig.system;
-    promptArray = Array.isArray(runConfig.prompt) ? [...runConfig.prompt] : [runConfig.prompt];
-    configMcpServers = runConfig.mcpServers ?? [];
-    configEnvironment = runConfig.environment;
-    configRuntimeSize = runConfig.runtimeSize;
-    configTimeout = runConfig.timeout;
-    metadata = runConfig.metadata ? { ...runConfig.metadata } : void 0;
+    model = sessionConfig.model;
+    system = sessionConfig.system;
+    promptArray = Array.isArray(sessionConfig.prompt) ? [...sessionConfig.prompt] : [sessionConfig.prompt];
+    configMcpServers = sessionConfig.mcpServers ?? [];
+    configEnvironment = sessionConfig.environment;
+    configRuntimeSize = sessionConfig.runtimeSize;
+    configTimeout = sessionConfig.timeout;
+    metadata = sessionConfig.metadata ? { ...sessionConfig.metadata } : void 0;
   } else {
     if (!modelFlag.value) {
       io2.stderr("--model is required when --config is not provided\n");
@@ -5860,7 +5852,7 @@ async function runRunCmd(io2, argv) {
   }
   const environment = toCliSessionEnvironment(configEnvironment);
   const runtimeSize = runtimeSizeFlag.value ?? configRuntimeSize;
-  const timeout = runTimeoutFlag.value ?? configTimeout;
+  const timeout = sessionTimeoutFlag.value ?? configTimeout;
   const options = {
     message: promptArray,
     provider,
@@ -5886,7 +5878,7 @@ async function runRunCmd(io2, argv) {
   if (follow.present && !io2.webSocketFactory) {
     io2.stderr(JSON.stringify({
       error: "websocket_unavailable",
-      message: "`aex run --follow` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or run with bun."
+      message: "`aex start --follow` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or session with bun."
     }) + "\n");
     return USAGE_ERR;
   }
@@ -5895,7 +5887,7 @@ async function runRunCmd(io2, argv) {
     session = await submitCliRun(http, io2.fetchImpl, options);
   } catch (err2) {
     const d = describeApiError(err2);
-    return emitJsonError(io2, "run_failed", d.message, {
+    return emitJsonError(io2, "session_failed", d.message, {
       ...d.status !== void 0 ? { status: d.status } : {},
       ...d.remedy ? { remedy: d.remedy } : {}
     });
@@ -5929,7 +5921,7 @@ async function runRunCmd(io2, argv) {
     if (timer)
       clearTimeout(timer);
     if (timedOut) {
-      emitJsonError(io2, "run_follow_timeout", `timed out after ${followTimeoutMs}ms following session`, {
+      emitJsonError(io2, "session_follow_timeout", `timed out after ${followTimeoutMs}ms following session`, {
         sessionId: session.id,
         lastSeq,
         ...followTimeoutContext(session),
@@ -5948,7 +5940,7 @@ async function runRunCmd(io2, argv) {
   if (timer)
     clearTimeout(timer);
   if (timedOut) {
-    emitJsonError(io2, "run_follow_timeout", `timed out after ${followTimeoutMs}ms following session`, {
+    emitJsonError(io2, "session_follow_timeout", `timed out after ${followTimeoutMs}ms following session`, {
       sessionId: session.id,
       lastSeq,
       ...followTimeoutContext(session),
@@ -6110,8 +6102,8 @@ async function readMaybeFile(io2, value) {
 }
 
 // dist/host/status.js
-async function runStatusCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "status"))
+async function executeStatusCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "status"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6146,8 +6138,8 @@ async function runStatusCmd(io2, argv) {
 }
 
 // dist/host/deliveries.js
-async function runDeliveriesCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "deliveries"))
+async function executeDeliveriesCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "deliveries"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6168,7 +6160,7 @@ async function runDeliveriesCmd(io2, argv) {
   const sessionId = positional[0];
   const http = makeHttpClient(io2, common.flags);
   try {
-    const deliveries = await operations_exports.getRunWebhookDeliveries(http, sessionId);
+    const deliveries = await operations_exports.getSessionWebhookDeliveries(http, sessionId);
     io2.stdout(JSON.stringify(deliveries) + "\n");
     return SUCCESS;
   } catch (err2) {
@@ -6183,8 +6175,8 @@ async function runDeliveriesCmd(io2, argv) {
 
 // dist/host/wait.js
 var DEFAULT_INTERVAL_MS = 2e3;
-async function runWaitCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "wait"))
+async function executeWaitCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "wait"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6257,8 +6249,8 @@ function sleep3(ms) {
 }
 
 // dist/host/events.js
-async function runEventsCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "events"))
+async function executeEventsCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "events"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6348,10 +6340,10 @@ function sleep4(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-// dist/host/outputs.js
+// dist/host/files.js
 import { resolve as resolvePath2 } from "node:path";
-async function runOutputsCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "outputs"))
+async function executeSessionFilesCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "files"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6364,21 +6356,21 @@ async function runOutputsCmd(io2, argv) {
   const http = makeHttpClient(io2, common.flags);
   switch (sub) {
     case "read":
-      return outputsRead(io2, http, args.slice(1));
+      return filesRead(io2, http, args.slice(1));
     case "download":
-      return outputsDownload(io2, http, args.slice(1), common.flags);
+      return filesDownload(io2, http, args.slice(1), common.flags);
     case "link":
-      return outputsLink(io2, http, args.slice(1));
+      return filesLink(io2, http, args.slice(1));
     case "find":
-      return outputsFind(io2, http, args.slice(1));
+      return filesFind(io2, http, args.slice(1));
     case "search":
-      return outputsSearch(io2, http, args.slice(1));
+      return filesSearch(io2, http, args.slice(1));
     default:
-      return outputsList(io2, http, args);
+      return filesList(io2, http, args);
   }
 }
-async function outputsList(io2, http, args) {
-  const usage = "usage: aex outputs <session-id> [common flags]";
+async function filesList(io2, http, args) {
+  const usage = "usage: aex files <session-id> [common flags]";
   const unknown = rejectUnknownFlags(io2, args, usage);
   if (unknown)
     return unknown;
@@ -6390,16 +6382,16 @@ async function outputsList(io2, http, args) {
   }
   const sessionId = positional[0];
   try {
-    const outputs = await operations_exports.listSessionOutputs(http, sessionId);
-    for (const out of outputs)
-      io2.stdout(JSON.stringify(out) + "\n");
+    const files = await operations_exports.listSessionFiles(http, sessionId);
+    for (const file2 of files)
+      io2.stdout(JSON.stringify(file2) + "\n");
     return SUCCESS;
   } catch (err2) {
-    return outputsError(io2, "outputs_failed", err2, { sessionId });
+    return filesError(io2, "files_failed", err2, { sessionId });
   }
 }
-async function outputsRead(io2, http, args) {
-  const usage = "usage: aex outputs read <session-id> <path> [common flags]";
+async function filesRead(io2, http, args) {
+  const usage = "usage: aex files read <session-id> <path> [common flags]";
   const unknown = rejectUnknownFlags(io2, args, usage);
   if (unknown)
     return unknown;
@@ -6411,14 +6403,14 @@ async function outputsRead(io2, http, args) {
   }
   const [sessionId, selector] = positional;
   try {
-    const text = await operations_exports.readOutputText(http, sessionId, { path: selector });
+    const text = await operations_exports.readSessionFileText(http, sessionId, { path: selector });
     io2.stdout(JSON.stringify(text) + "\n");
     return SUCCESS;
   } catch (err2) {
-    return outputsError(io2, "outputs_read_failed", err2, { sessionId, path: selector });
+    return filesError(io2, "files_read_failed", err2, { sessionId, path: selector });
   }
 }
-async function outputsDownload(io2, http, args, flags) {
+async function filesDownload(io2, http, args, flags) {
   const outFlag = takeFlagValue(args, "--out");
   if (outFlag.error) {
     io2.stderr(`${outFlag.error}
@@ -6426,7 +6418,7 @@ async function outputsDownload(io2, http, args, flags) {
     return USAGE_ERR;
   }
   void flags;
-  const usage = "usage: aex outputs download <session-id> <path> [--out file] [common flags]";
+  const usage = "usage: aex files download <session-id> <path> [--out file] [common flags]";
   const unknown = rejectUnknownFlags(io2, outFlag.remaining, usage);
   if (unknown)
     return unknown;
@@ -6439,9 +6431,9 @@ async function outputsDownload(io2, http, args, flags) {
   const [sessionId, selector] = positional;
   let bytes;
   try {
-    bytes = (await operations_exports.downloadOutput(http, sessionId, { path: selector })).bytes;
+    bytes = (await operations_exports.downloadSessionFile(http, sessionId, { path: selector })).bytes;
   } catch (err2) {
-    return outputsError(io2, "outputs_download_failed", err2, { sessionId, path: selector });
+    return filesError(io2, "files_download_failed", err2, { sessionId, path: selector });
   }
   const destination = resolvePath2(io2.cwd(), outFlag.value ?? baseName2(selector));
   try {
@@ -6452,8 +6444,8 @@ async function outputsDownload(io2, http, args, flags) {
   io2.stdout(JSON.stringify({ sessionId, path: selector, out: destination, bytes: bytes.byteLength }) + "\n");
   return SUCCESS;
 }
-async function outputsLink(io2, http, args) {
-  const usage = "usage: aex outputs link <session-id> <path> [common flags]";
+async function filesLink(io2, http, args) {
+  const usage = "usage: aex files link <session-id> <path> [common flags]";
   const unknown = rejectUnknownFlags(io2, args, usage);
   if (unknown)
     return unknown;
@@ -6465,14 +6457,14 @@ async function outputsLink(io2, http, args) {
   }
   const [sessionId, selector] = positional;
   try {
-    const link = await operations_exports.outputLink(http, sessionId, { path: selector });
+    const link = await operations_exports.sessionFileLink(http, sessionId, { path: selector });
     io2.stdout(JSON.stringify(link) + "\n");
     return SUCCESS;
   } catch (err2) {
-    return outputsError(io2, "outputs_link_failed", err2, { sessionId, path: selector });
+    return filesError(io2, "files_link_failed", err2, { sessionId, path: selector });
   }
 }
-async function outputsFind(io2, http, args) {
+async function filesFind(io2, http, args) {
   const name = takeFlagValue(args, "--name");
   const ext = takeFlagValue(name.remaining, "--ext");
   const type = takeFlagValue(ext.remaining, "--type");
@@ -6483,7 +6475,7 @@ async function outputsFind(io2, http, args) {
 `);
     return USAGE_ERR;
   }
-  const usage = "usage: aex outputs find <session-id> [--name S] [--ext E] [--type T] [--content-type CT] [common flags]";
+  const usage = "usage: aex files find <session-id> [--name S] [--ext E] [--type T] [--content-type CT] [common flags]";
   const unknown = rejectUnknownFlags(io2, contentType.remaining, usage);
   if (unknown)
     return unknown;
@@ -6501,33 +6493,33 @@ async function outputsFind(io2, http, args) {
     ...contentType.value !== null ? { contentType: contentType.value } : {}
   };
   try {
-    const hits = await searchSessionOutputs(http, sessionId, query);
+    const hits = await searchSessionFiles(http, sessionId, query);
     for (const hit of hits)
       io2.stdout(JSON.stringify(hit) + "\n");
     return SUCCESS;
   } catch (err22) {
-    return outputsError(io2, "outputs_find_failed", err22, { sessionId });
+    return filesError(io2, "files_find_failed", err22, { sessionId });
   }
 }
-async function outputsSearch(io2, http, args) {
+async function filesSearch(io2, http, args) {
   const query = takeFlagValue(args, "--query");
   const name = takeFlagValue(query.remaining, "--name");
   const ext = takeFlagValue(name.remaining, "--ext");
   const contentType = takeFlagValue(ext.remaining, "--content-type");
   const limit = takeFlagValue(contentType.remaining, "--limit");
-  const runIds = collectRepeated(limit.remaining, "--run-id");
-  const err2 = query.error ?? name.error ?? ext.error ?? contentType.error ?? limit.error ?? runIds.error;
+  const sessionIds = collectRepeated(limit.remaining, "--session-id");
+  const err2 = query.error ?? name.error ?? ext.error ?? contentType.error ?? limit.error ?? sessionIds.error;
   if (err2) {
     io2.stderr(`${err2}
 `);
     return USAGE_ERR;
   }
-  const usage = "usage: aex outputs search [--query S] [--name S] [--ext E] [--content-type CT] [--run-id ID] [--limit N] [common flags]";
-  const unknown = rejectUnknownFlags(io2, runIds.remaining, usage);
+  const usage = "usage: aex files search [--query S] [--name S] [--ext E] [--content-type CT] [--session-id ID] [--limit N] [common flags]";
+  const unknown = rejectUnknownFlags(io2, sessionIds.remaining, usage);
   if (unknown)
     return unknown;
-  if (runIds.remaining.length > 0) {
-    io2.stderr(`unexpected arguments: ${runIds.remaining.join(" ")}
+  if (sessionIds.remaining.length > 0) {
+    io2.stderr(`unexpected arguments: ${sessionIds.remaining.join(" ")}
 `);
     io2.stderr(`${usage}
 `);
@@ -6548,18 +6540,18 @@ async function outputsSearch(io2, http, args) {
     ...filename !== null ? { filename } : {},
     ...ext.value !== null ? { extension: ext.value } : {},
     ...contentType.value !== null ? { contentType: contentType.value } : {},
-    ...runIds.values.length > 0 ? { runIds: [...runIds.values] } : {},
+    ...sessionIds.values.length > 0 ? { sessionIds: [...sessionIds.values] } : {},
     ...limitValue !== void 0 ? { limit: limitValue } : {}
   };
   try {
-    const page = await searchWorkspaceOutputs(http, search);
+    const page = await searchWorkspaceFiles(http, search);
     io2.stdout(JSON.stringify(page) + "\n");
     return SUCCESS;
   } catch (err22) {
-    return outputsError(io2, "outputs_search_failed", err22, {});
+    return filesError(io2, "files_search_failed", err22, {});
   }
 }
-function outputsError(io2, code, err2, extra) {
+function filesError(io2, code, err2, extra) {
   const d = describeApiError(err2);
   return emitJsonError(io2, code, d.message, {
     ...extra,
@@ -6567,23 +6559,23 @@ function outputsError(io2, code, err2, extra) {
     ...d.remedy ? { remedy: d.remedy } : {}
   });
 }
-async function searchWorkspaceOutputs(http, query) {
-  assertMetadataOnlyOutputSearch(query, "aex outputs search");
-  const runIds = query.runIds && query.runIds.length > 0 ? [...query.runIds] : void 0;
+async function searchWorkspaceFiles(http, query) {
+  assertMetadataOnlySessionFileSearch(query, "aex files search");
+  const sessionIds = query.sessionIds && query.sessionIds.length > 0 ? [...query.sessionIds] : void 0;
   const limit = query.limit ?? 100;
   const hits = [];
-  const candidates = runIds ?? await listRecentRunIds(http, limit);
-  for (const runId of candidates) {
-    const outputs = await searchSessionOutputs(http, runId, query);
-    for (const output of outputs) {
-      hits.push(outputHit(runId, output));
+  const candidates = sessionIds ?? await listRecentSessionIds(http, limit);
+  for (const sessionId of candidates) {
+    const files = await searchSessionFiles(http, sessionId, query);
+    for (const file2 of files) {
+      hits.push(fileHit(sessionId, file2));
       if (hits.length >= limit)
         return { hits };
     }
   }
   return { hits };
 }
-async function listRecentRunIds(http, limit) {
+async function listRecentSessionIds(http, limit) {
   const out = [];
   let cursor;
   while (out.length < limit) {
@@ -6595,30 +6587,30 @@ async function listRecentRunIds(http, limit) {
   }
   return out;
 }
-async function searchSessionOutputs(http, sessionId, query) {
+async function searchSessionFiles(http, sessionId, query) {
   const listQuery = {
     ...query.extension !== void 0 ? { extension: query.extension } : {},
     ...query.contentType !== void 0 ? { contentType: query.contentType } : {}
   };
-  const outputs = await operations_exports.listSessionOutputs(http, sessionId, Object.keys(listQuery).length > 0 ? listQuery : void 0);
+  const files = await operations_exports.listSessionFiles(http, sessionId, Object.keys(listQuery).length > 0 ? listQuery : void 0);
   if (query.filename === void 0)
-    return outputs;
+    return files;
   const match = operations_exports.toFilenameMatcher(query.filename);
-  return outputs.filter((output) => typeof output.filename === "string" && match(output.filename));
+  return files.filter((file2) => typeof file2.filename === "string" && match(file2.filename));
 }
-function outputHit(runId, output) {
+function fileHit(sessionId, file2) {
   return {
-    runId,
-    outputId: output.id,
-    ...output.filename !== void 0 ? { filename: output.filename } : {},
-    ...output.sizeBytes !== void 0 ? { sizeBytes: output.sizeBytes } : {},
-    ...output.contentType !== void 0 ? { contentType: output.contentType } : {}
+    sessionId,
+    fileId: file2.id,
+    ...file2.filename !== void 0 ? { filename: file2.filename } : {},
+    ...file2.sizeBytes !== void 0 ? { sizeBytes: file2.sizeBytes } : {},
+    ...file2.contentType !== void 0 ? { contentType: file2.contentType } : {}
   };
 }
-function assertMetadataOnlyOutputSearch(query, surface) {
+function assertMetadataOnlySessionFileSearch(query, surface) {
   for (const key of ["content", "text", "query", "grep", "body"]) {
     if (Object.prototype.hasOwnProperty.call(query, key)) {
-      throw new Error(`${surface}: ${key} is not supported; output search is metadata-only`);
+      throw new Error(`${surface}: ${key} is not supported; file search is metadata-only`);
     }
   }
 }
@@ -6631,12 +6623,12 @@ function baseName2(p) {
 // dist/host/download.js
 import { resolve as resolvePath3 } from "node:path";
 var NAMESPACE_DOWNLOADERS = {
-  outputs: operations_exports.downloadOutputs,
+  files: operations_exports.downloadSessionFiles,
   events: operations_exports.downloadEvents,
   metadata: operations_exports.downloadMetadata
 };
-async function runDownloadCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "download"))
+async function executeDownloadCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "download"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6662,7 +6654,7 @@ async function runDownloadCmd(io2, argv) {
     return USAGE_ERR;
   }
   const namespace2 = onlyFlag.value;
-  const usage = "usage: aex download <session-id> [--only outputs|events|metadata] [--out path] [common flags]";
+  const usage = "usage: aex download <session-id> [--only files|events|metadata] [--out path] [common flags]";
   const unknown = rejectUnknownFlags(io2, onlyFlag.remaining, usage);
   if (unknown)
     return unknown;
@@ -6704,8 +6696,8 @@ function resolveDestination(io2, out, sessionId, namespace2) {
 }
 
 // dist/host/cancel.js
-async function runCancelCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "cancel"))
+async function executeCancelCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "cancel"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6740,8 +6732,8 @@ async function runCancelCmd(io2, argv) {
 }
 
 // dist/host/delete.js
-async function runDeleteCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "delete"))
+async function executeDeleteCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "delete"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6776,8 +6768,8 @@ async function runDeleteCmd(io2, argv) {
 }
 
 // dist/host/delete-asset.js
-async function runDeleteAssetCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "delete-asset"))
+async function executeDeleteAssetCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "delete-asset"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6812,8 +6804,8 @@ async function runDeleteAssetCmd(io2, argv) {
 }
 
 // dist/host/whoami.js
-async function runWhoamiCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "whoami"))
+async function executeWhoamiCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "whoami"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6858,8 +6850,8 @@ function parseLimit(io2, raw) {
   }
   return { ok: true, limit };
 }
-async function runBillingCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "billing"))
+async function executeBillingCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "billing"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -6987,8 +6979,8 @@ async function runBillingLedger(io2, argv, flags) {
 }
 
 // dist/host/webhooks-cmd.js
-async function runWebhooksCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "webhooks"))
+async function sessionWebhooksCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "webhooks"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -7003,7 +6995,7 @@ async function runWebhooksCmd(io2, argv) {
   }
   const { present: rotate, remaining } = takeBooleanFlag(rest, "--rotate");
   if (rotate) {
-    io2.stderr("--rotate is not supported: the hosted API reveals (or creates on first use) the workspace webhook signing secret but does not rotate it. Run `aex webhooks secret` to reveal the current value.\n");
+    io2.stderr("--rotate is not supported: the hosted API reveals (or creates on first use) the workspace webhook signing secret but does not rotate it. SessionRecord `aex webhooks secret` to reveal the current value.\n");
     return USAGE_ERR;
   }
   if (remaining.length > 0) {
@@ -7039,8 +7031,8 @@ function parseLimit2(io2, raw) {
   }
   return { ok: true, limit };
 }
-async function runRunsCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "runs"))
+async function executeSessionsCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "sessions"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -7053,7 +7045,7 @@ async function runRunsCmd(io2, argv) {
   if (remaining.length > 0) {
     io2.stderr(`unexpected arguments: ${remaining.join(" ")}
 `);
-    io2.stderr("usage: aex runs [--limit N] [--since ISO-8601] [common flags]\n");
+    io2.stderr("usage: aex sessions [--limit N] [--since ISO-8601] [common flags]\n");
     return USAGE_ERR;
   }
   const parsed = parseLimit2(io2, rawLimit);
@@ -7067,47 +7059,15 @@ async function runRunsCmd(io2, argv) {
   }
   const http = makeHttpClient(io2, common.flags);
   try {
-    const page = await operations_exports.listRuns(http, {
+    const page = await operations_exports.listSessionRecords(http, {
       ...parsed.limit !== void 0 ? { limit: parsed.limit } : {},
       ...since !== void 0 ? { since } : {}
     });
-    const runs = sinceMs === void 0 ? page.runs : page.runs.filter((run) => {
-      const created = Date.parse(run.createdAt);
+    const sessions = sinceMs === void 0 ? page.sessions : page.sessions.filter((session) => {
+      const created = Date.parse(session.createdAt);
       return !Number.isNaN(created) && created >= sinceMs;
     });
-    io2.stdout(JSON.stringify({ ...page, runs }) + "\n");
-    return SUCCESS;
-  } catch (err2) {
-    const d = describeApiError(err2);
-    return emitJsonError(io2, "runs_failed", d.message, {
-      ...d.status !== void 0 ? { status: d.status } : {},
-      ...d.remedy ? { remedy: d.remedy } : {}
-    });
-  }
-}
-async function runSessionsCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "sessions"))
-    return USAGE_ERR;
-  const common = await resolveCommonHostFlags(io2, argv);
-  if (!common.ok) {
-    io2.stderr(`${common.reason}
-`);
-    return USAGE_ERR;
-  }
-  const { value: rawLimit, remaining } = takeOptionFlag(common.rest, "--limit");
-  if (remaining.length > 0) {
-    io2.stderr(`unexpected arguments: ${remaining.join(" ")}
-`);
-    io2.stderr("usage: aex sessions [--limit N] [common flags]\n");
-    return USAGE_ERR;
-  }
-  const parsed = parseLimit2(io2, rawLimit);
-  if (!parsed.ok)
-    return USAGE_ERR;
-  const http = makeHttpClient(io2, common.flags);
-  try {
-    const page = await operations_exports.listSessions(http, parsed.limit !== void 0 ? { limit: parsed.limit } : void 0);
-    io2.stdout(JSON.stringify(page) + "\n");
+    io2.stdout(JSON.stringify({ ...page, sessions }) + "\n");
     return SUCCESS;
   } catch (err2) {
     const d = describeApiError(err2);
@@ -7119,8 +7079,8 @@ async function runSessionsCmd(io2, argv) {
 }
 
 // dist/host/auth-cmd.js
-async function runLoginCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "login"))
+async function executeLoginCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "login"))
     return USAGE_ERR;
   if (!io2.configStore) {
     return emitJsonError(io2, "config_store_unavailable", "config store unavailable in this environment");
@@ -7177,8 +7137,8 @@ async function runLoginCmd(io2, argv) {
   }) + "\n");
   return SUCCESS;
 }
-async function runLogoutCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "logout"))
+async function executeLogoutCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "logout"))
     return USAGE_ERR;
   if (!io2.configStore) {
     return emitJsonError(io2, "config_store_unavailable", "config store unavailable in this environment");
@@ -7204,8 +7164,8 @@ async function runLogoutCmd(io2, argv) {
   io2.stdout(JSON.stringify({ ok: true, cleared: true, configPath: io2.configStore.location() }) + "\n");
   return SUCCESS;
 }
-async function runAuthStatusCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "auth"))
+async function executeAuthStatusCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "auth"))
     return USAGE_ERR;
   if (!io2.configStore) {
     return emitJsonError(io2, "config_store_unavailable", "config store unavailable in this environment");
@@ -7253,11 +7213,11 @@ function wantsJson(argv) {
   const { present, remaining } = takeBooleanFlag(argv, "--json");
   return { json: present, rest: remaining };
 }
-function runModelsCmd(io2, argv) {
+function modelNamesCmd(io2, argv) {
   const { json, rest } = wantsJson(stripListSubcommand(argv));
   if (hasUnknown(io2, rest, "models"))
     return USAGE_ERR;
-  const entries = RUN_MODELS.map((model) => ({
+  const entries = SUPPORTED_MODELS.map((model) => ({
     model,
     defaultProvider: providerForModel(model) ?? null,
     providers: providersForModel(model)
@@ -7269,14 +7229,14 @@ function runModelsCmd(io2, argv) {
   }
   return SUCCESS;
 }
-function runProvidersCmd(io2, argv) {
+function providerNamesCmd(io2, argv) {
   const { json, rest } = wantsJson(stripListSubcommand(argv));
   if (hasUnknown(io2, rest, "providers"))
     return USAGE_ERR;
-  const entries = RUN_PROVIDERS.map((provider) => ({
+  const entries = PROVIDERS.map((provider) => ({
     provider,
     displayName: PROVIDER_PUBLIC_SUPPORT[provider].displayName,
-    models: RUN_MODELS_BY_PROVIDER[provider] ?? []
+    models: SUPPORTED_MODELS_BY_PROVIDER[provider] ?? []
   }));
   if (json) {
     io2.stdout(JSON.stringify(entries) + "\n");
@@ -7285,7 +7245,7 @@ function runProvidersCmd(io2, argv) {
   }
   return SUCCESS;
 }
-function runToolsCmd(io2, argv) {
+function executeToolsCmd(io2, argv) {
   const { json, rest } = wantsJson(stripListSubcommand(argv));
   if (hasUnknown(io2, rest, "tools"))
     return USAGE_ERR;
@@ -7300,7 +7260,7 @@ function runToolsCmd(io2, argv) {
   }
   return SUCCESS;
 }
-function runRuntimeSizesCmd(io2, argv) {
+function executeRuntimeSizesCmd(io2, argv) {
   const { json, rest } = wantsJson(stripListSubcommand(argv));
   if (hasUnknown(io2, rest, "runtime-sizes"))
     return USAGE_ERR;
@@ -7336,8 +7296,8 @@ function hasUnknown(io2, rest, verb) {
 }
 
 // dist/host/tail.js
-async function runTailCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "tail"))
+async function executeTailCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "tail"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -7390,7 +7350,7 @@ async function runTailCmd(io2, argv) {
   if (!io2.webSocketFactory) {
     io2.stderr(JSON.stringify({
       error: "websocket_unavailable",
-      message: "`aex tail` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or run with bun.",
+      message: "`aex tail` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or session with bun.",
       sessionId
     }) + "\n");
     return USAGE_ERR;
@@ -7443,7 +7403,7 @@ async function runTailCmd(io2, argv) {
           eventCount++;
         }
       }
-      if (e.type === "RUN_ERROR")
+      if (e.type === "TURN_ERROR")
         runErrorLine = renderEnvelope(e, { logs: true });
     }
   } catch (err2) {
@@ -7495,8 +7455,8 @@ async function runTailCmd(io2, argv) {
 }
 
 // dist/host/inspect.js
-async function runInspectCmd(io2, argv) {
-  if (await refuseInsideManagedRun(io2, "inspect"))
+async function executeInspectCmd(io2, argv) {
+  if (await refuseInsideManagedSession(io2, "inspect"))
     return USAGE_ERR;
   const common = await resolveCommonHostFlags(io2, argv);
   if (!common.ok) {
@@ -7537,7 +7497,7 @@ async function runInspectCmd(io2, argv) {
   if (!io2.webSocketFactory) {
     io2.stderr(JSON.stringify({
       error: "websocket_unavailable",
-      message: "`aex inspect` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or run with bun.",
+      message: "`aex inspect` needs a global WebSocket (Bun or Node >= 22). Upgrade Node or session with bun.",
       sessionId
     }) + "\n");
     return USAGE_ERR;
@@ -7584,7 +7544,7 @@ async function runInspectCmd(io2, argv) {
       ...debug2 ? { debug: debug2 } : {}
     });
     for await (const e of stream) {
-      if (e.type === "RUN_ERROR")
+      if (e.type === "TURN_ERROR")
         runErrorEvent = e;
       if (filters.predicate && !filters.predicate(e))
         continue;
@@ -7623,7 +7583,7 @@ async function runInspectCmd(io2, argv) {
   } else {
     if (runErrorEvent) {
       const d = runErrorEvent.data;
-      const failureMessage = typeof d.failureMessage === "string" ? d.failureMessage : runErrorEvent.message ?? "run error";
+      const failureMessage = typeof d.failureMessage === "string" ? d.failureMessage : runErrorEvent.message ?? "turn error";
       const failureClass = typeof d.failureClass === "string" ? ` [${d.failureClass}]` : "";
       io2.stdout(`
 \u2717 ${failureMessage}${failureClass}
@@ -7651,8 +7611,8 @@ async function runInspectCmd(io2, argv) {
   return RUNTIME_ERR;
 }
 
-// dist/run.js
-async function runCli(io2) {
+// dist/main.js
+async function executeCli(io2) {
   const args = io2.argv.slice(2);
   try {
     const exit = await dispatch(io2, args);
@@ -7670,87 +7630,84 @@ async function dispatch(io2, args) {
   const sub = args[0];
   const rest = args.slice(1);
   const spec = sub === void 0 ? void 0 : findVerbSpec(sub);
-  if (spec && wantsVerbHelp(rest) && !(sub === "outputs" && rest[0] === "sync")) {
+  if (spec && wantsVerbHelp(rest) && !(sub === "files" && rest[0] === "sync")) {
     io2.stdout(renderVerbHelp(spec));
     return SUCCESS;
   }
   switch (sub) {
-    case "run":
-      return runRunCmd(io2, rest);
+    case "start":
+      return executeStartCmd(io2, rest);
     case "status":
-      return runStatusCmd(io2, rest);
+      return executeStatusCmd(io2, rest);
     case "deliveries":
-      return runDeliveriesCmd(io2, rest);
+      return executeDeliveriesCmd(io2, rest);
     case "wait":
-      return runWaitCmd(io2, rest);
+      return executeWaitCmd(io2, rest);
     case "events":
-      return runEventsCmd(io2, rest);
+      return executeEventsCmd(io2, rest);
     case "tail":
-      return runTailCmd(io2, rest);
+      return executeTailCmd(io2, rest);
     case "inspect":
-      return runInspectCmd(io2, rest);
-    case "outputs":
+      return executeInspectCmd(io2, rest);
+    case "files":
       if (rest[0] === "sync") {
-        return runOutputsSyncCmd(io2, rest.slice(1));
+        return executeFilesSyncCmd(io2, rest.slice(1));
       }
-      return runOutputsCmd(io2, rest);
+      return executeSessionFilesCmd(io2, rest);
     case "download":
-      return runDownloadCmd(io2, rest);
+      return executeDownloadCmd(io2, rest);
     case "cancel":
-      return runCancelCmd(io2, rest);
+      return executeCancelCmd(io2, rest);
     case "delete":
-      return runDeleteCmd(io2, rest);
+      return executeDeleteCmd(io2, rest);
     case "delete-asset":
-      return runDeleteAssetCmd(io2, rest);
-    case "runs":
-      return runRunsCmd(io2, rest);
+      return executeDeleteAssetCmd(io2, rest);
     case "sessions":
-      return runSessionsCmd(io2, rest);
+      return executeSessionsCmd(io2, rest);
     case "whoami":
-      return runWhoamiCmd(io2, rest);
+      return executeWhoamiCmd(io2, rest);
     case "billing":
-      return runBillingCmd(io2, rest);
+      return executeBillingCmd(io2, rest);
     case "webhooks":
-      return runWebhooksCmd(io2, rest);
+      return sessionWebhooksCmd(io2, rest);
     case "login":
-      return runLoginCmd(io2, rest);
+      return executeLoginCmd(io2, rest);
     case "logout":
-      return runLogoutCmd(io2, rest);
+      return executeLogoutCmd(io2, rest);
     case "auth":
-      return runAuthStatusCmd(io2, rest[0] === "status" ? rest.slice(1) : rest);
+      return executeAuthStatusCmd(io2, rest[0] === "status" ? rest.slice(1) : rest);
     case "models":
-      return runModelsCmd(io2, rest);
+      return modelNamesCmd(io2, rest);
     case "providers":
-      return runProvidersCmd(io2, rest);
+      return providerNamesCmd(io2, rest);
     case "tools":
-      return runToolsCmd(io2, rest);
+      return executeToolsCmd(io2, rest);
     case "runtime-sizes":
-      return runRuntimeSizesCmd(io2, rest);
+      return executeRuntimeSizesCmd(io2, rest);
     default:
       io2.stderr(`unknown subcommand: ${sub}
 `);
-      io2.stderr("run `aex --help` for usage\n");
+      io2.stderr("use `aex --help` for usage\n");
       return USAGE_ERR;
   }
 }
 async function printGlobalHelp(io2) {
   io2.stdout("aex \u2014 unified CLI for the aex platform (a thin pass-through over the SDK)\n\n");
   io2.stdout("Usage:\n");
-  io2.stdout("  aex run --config <run.json> --<provider>-api-key K --api-key T [flags]\n");
-  io2.stdout("  aex run --model M --prompt P [--system S] [--mcp name=url ...] --<provider>-api-key K --api-key T [flags]\n");
+  io2.stdout("  aex start --config <session.json> --<provider>-api-key K --api-key T [flags]\n");
+  io2.stdout("  aex start --model M --prompt P [--system S] [--mcp name=url ...] --<provider>-api-key K --api-key T [flags]\n");
   io2.stdout("  aex status <session-id> --api-key T\n");
   io2.stdout("  aex deliveries <session-id> --api-key T\n");
   io2.stdout("  aex wait <session-id> [--timeout 8m] [--interval 2s] --api-key T\n");
   io2.stdout("  aex events <session-id> [--follow] [--timeout 8m] --api-key T\n");
   io2.stdout("  aex tail <session-id> [--json] [--filter <type|source>] [--logs] [--settle] [--timeout 8m] --api-key T\n");
   io2.stdout("  aex inspect <session-id> [--json] [--filter <type|source>] [--logs] [--timeout 8m] --api-key T\n");
-  io2.stdout("  aex outputs <session-id> --api-key T\n");
-  io2.stdout("  aex download <session-id> [--only outputs|events|metadata] [--out path] --api-key T\n");
+  io2.stdout("  aex files <session-id> --api-key T\n");
+  io2.stdout("  aex download <session-id> [--only files|events|metadata] [--out path] --api-key T\n");
   io2.stdout("  aex cancel <session-id> --api-key T\n");
   io2.stdout("  aex delete <session-id> --api-key T\n");
   io2.stdout("  aex delete-asset <assetId|hash> --api-key T\n");
-  io2.stdout("  aex runs [--limit N] [--since ISO] --api-key T      List the workspace's runs (newest first, JSON)\n");
-  io2.stdout("  aex sessions [--limit N] --api-key T      List the workspace's sessions (newest first, JSON)\n");
+  io2.stdout("  aex sessions [--limit N] [--since ISO] --api-key T      List the workspace's sessions (newest first, JSON)\n");
   io2.stdout("  aex whoami --api-key T\n");
   io2.stdout("  aex billing [--json] --api-key T          Show prepaid balance, month spend, and spend cap\n");
   io2.stdout("  aex billing ledger [--limit N] --api-key T   Recent credit-ledger entries (newest first, JSON)\n");
@@ -7763,20 +7720,20 @@ async function printGlobalHelp(io2) {
   io2.stdout("  aex models list [--json]                   List models + default provider (no token needed)\n");
   io2.stdout("  aex providers list [--json]                List providers + their models (no token needed)\n");
   io2.stdout("  aex tools list [--json]                    List builtin tools (all default; no token needed)\n");
-  io2.stdout("  aex runtime-sizes list [--json]            List managed runtime presets (no token needed)\n");
+  io2.stdout("  aex starttime-sizes list [--json]            List managed runtime presets (no token needed)\n");
   io2.stdout("  aex --help\n\n");
   io2.stdout("Common flags on every host subcommand:\n");
   io2.stdout("  --api-key <token>         REQUIRED \u2014 aex SDK API key (workspace is derived from it)\n");
   io2.stdout("  --aex-url <url>         Optional; defaults to https://api.aex.dev (local/staging/hosted plane)\n");
   io2.stdout("  --debug                     Optional; print a redacted per-request trace to stderr (uploads nothing)\n\n");
-  io2.stdout("aex run flags:\n");
-  io2.stdout(`  --provider <name>           Optional; one of: ${RUN_PROVIDERS.join(", ")} (default anthropic)
+  io2.stdout("aex start flags:\n");
+  io2.stdout(`  --provider <name>           Optional; one of: ${PROVIDERS.join(", ")} (default anthropic)
 `);
-  for (const provider of RUN_PROVIDERS) {
+  for (const provider of PROVIDERS) {
     io2.stdout(`  --${provider}-api-key <key>${" ".repeat(Math.max(1, 13 - provider.length))}REQUIRED when --provider ${provider}; never stored
 `);
   }
-  io2.stdout("  --config <path>             Run-request JSON (mutually exclusive with the flat --model/--prompt flags)\n");
+  io2.stdout("  --config <path>             Session request JSON (mutually exclusive with the flat --model/--prompt flags)\n");
   io2.stdout("  --model <model-id>          Provider model id (required in flat mode)\n");
   io2.stdout("  --system @file | <text>     System message; @-prefix reads from file\n");
   io2.stdout("  --prompt @file | <text>     User message; @-prefix reads from file (repeatable)\n");
@@ -7784,10 +7741,10 @@ async function printGlobalHelp(io2) {
   io2.stdout("  --mcp-auth name=Hdr:Val     Auth header on the matching --mcp; routed into vaulted secrets (repeatable)\n");
   io2.stdout("  --metadata key=value        Submission metadata entry (repeatable)\n");
   io2.stdout("  --runtime-size <size>       managed runtime preset\n");
-  io2.stdout("  --run-timeout <dur>         Server-side run deadline (e.g. 1h, max 8h); distinct from --timeout\n");
+  io2.stdout("  --session-timeout <dur>     Server-side session deadline (e.g. 1h, max 8h); distinct from --timeout\n");
   io2.stdout("  --idempotency-key <key>     Optional; defaults to a fresh UUID\n");
-  io2.stdout("  --webhook <url>             Optional per-run callback URL (https); receives the terminal run.finished event\n");
-  io2.stdout("  --follow                    Poll events to stdout until the run terminates\n");
+  io2.stdout("  --webhook <url>             Optional per-session callback URL (https); receives the terminal session.finished event\n");
+  io2.stdout("  --follow                    Poll events to stdout until the session reaches a terminal state\n");
   io2.stdout("  --timeout <dur>             With --follow: give up after this long (e.g. 8m, 30s, 500ms); exit code 3\n");
   return SUCCESS;
 }
@@ -7884,4 +7841,4 @@ var io = {
     process.on(signal, handler);
   }
 };
-await runCli(io);
+await executeCli(io);