@aexhq/sdk 0.40.15 → 0.41.0

package/dist/_contracts/{run-cost.js → session-cost.js}

@@ -1,13 +1,13 @@
-export const RUN_COST_TELEMETRY_SCHEMA_VERSION = 1;
-export const RUN_USAGE_SAMPLE_SCHEMA_VERSION = 1;
-export const RUN_COST_SUMMARY_STATUSES = [
+export const SESSION_COST_TELEMETRY_SCHEMA_VERSION = 1;
+export const SESSION_USAGE_SAMPLE_SCHEMA_VERSION = 1;
+export const SESSION_COST_SUMMARY_STATUSES = [
     "pending",
     "partial",
     "complete",
     "unavailable",
     "not_applicable"
 ];
-export const RUN_USAGE_SAMPLE_UNITS = [
+export const SESSION_USAGE_SAMPLE_UNITS = [
     "token",
     "millisecond",
     "byte",
@@ -16,18 +16,18 @@ export const RUN_USAGE_SAMPLE_UNITS = [
     "file",
     "credit_unit"
 ];
-export const RUN_USAGE_SAMPLE_SOURCE_TYPES = [
+export const SESSION_USAGE_SAMPLE_SOURCE_TYPES = [
     "coordinator-event",
-    "run-event",
+    "session-event",
     "usage-ledger",
-    "output-object",
+    "file-object",
     "proxy-call",
     "runtime-job",
     "provider-session",
     "storage-accrual",
     "manual-adjustment"
 ];
-export const RUN_USAGE_SAMPLE_METRICS = [
+export const SESSION_USAGE_SAMPLE_METRICS = [
     "provider.input_tokens",
     "provider.output_tokens",
     "provider.cache_read_input_tokens",
@@ -35,17 +35,17 @@ export const RUN_USAGE_SAMPLE_METRICS = [
     "provider.total_tokens",
     "runtime.queued_ms",
     "runtime.active_ms",
-    "runtime.output_capture_ms",
+    "runtime.file_capture_ms",
     "runtime.cleanup_ms",
-    "run.total_ms",
-    "output.discovered_files",
-    "output.captured_files",
-    "output.failed_files",
-    "output.captured_bytes",
+    "session.total_ms",
+    "file.discovered_files",
+    "file.captured_files",
+    "file.failed_files",
+    "file.captured_bytes",
     "retry.runtime_attempts",
     "retry.provider_poll",
-    "retry.output_capture",
-    "retry.output_upload",
+    "retry.file_capture",
+    "retry.file_upload",
     "capture.uploaded_files",
     "capture.failed_files",
     "capture.total_bytes",
@@ -57,7 +57,7 @@ export const RUN_USAGE_SAMPLE_METRICS = [
     "proxy.response_bytes",
     "proxy.duration_ms"
 ];
-const RUN_USAGE_SAMPLE_METRIC_UNITS = {
+const SESSION_USAGE_SAMPLE_METRIC_UNITS = {
     "provider.input_tokens": "token",
     "provider.output_tokens": "token",
     "provider.cache_read_input_tokens": "token",
@@ -65,17 +65,17 @@ const RUN_USAGE_SAMPLE_METRIC_UNITS = {
     "provider.total_tokens": "token",
     "runtime.queued_ms": "millisecond",
     "runtime.active_ms": "millisecond",
-    "runtime.output_capture_ms": "millisecond",
+    "runtime.file_capture_ms": "millisecond",
     "runtime.cleanup_ms": "millisecond",
-    "run.total_ms": "millisecond",
-    "output.discovered_files": "file",
-    "output.captured_files": "file",
-    "output.failed_files": "file",
-    "output.captured_bytes": "byte",
+    "session.total_ms": "millisecond",
+    "file.discovered_files": "file",
+    "file.captured_files": "file",
+    "file.failed_files": "file",
+    "file.captured_bytes": "byte",
     "retry.runtime_attempts": "count",
     "retry.provider_poll": "count",
-    "retry.output_capture": "count",
-    "retry.output_upload": "count",
+    "retry.file_capture": "count",
+    "retry.file_upload": "count",
     "capture.uploaded_files": "file",
     "capture.failed_files": "file",
     "capture.total_bytes": "byte",
@@ -88,26 +88,26 @@ const RUN_USAGE_SAMPLE_METRIC_UNITS = {
     "proxy.duration_ms": "millisecond"
 };
 /**
- * The basis for a {@link RunCostTelemetry.billedCostUsd}: an honest marker of
+ * The basis for a {@link SessionCostTelemetry.billedCostUsd}: an honest marker of
  * whether the figure is a settle-time ESTIMATE or has been RECONCILED against
  * authoritative actuals. Deliberately carries NO rate-card version or unit
  * rates — the platform's public-safe convention treats `rateCard`/`margin` as
- * private tokens (run-cost.test.ts privateCostFieldPattern), so the version the
+ * private tokens (session-cost.test.ts privateCostFieldPattern), so the version the
  * figure was derived under stays internal (recorded only in the platform's
  * internal raw-usage export).
  */
-export const RUN_COST_BASIS_STATUSES = ["estimated", "reconciled"];
-export function buildRunUsageSample(input) {
+export const SESSION_COST_BASIS_STATUSES = ["estimated", "reconciled"];
+export function buildSessionUsageSample(input) {
     const metric = normalizeUsageSampleMetric(input.metric);
-    const expectedUnit = RUN_USAGE_SAMPLE_METRIC_UNITS[metric];
+    const expectedUnit = SESSION_USAGE_SAMPLE_METRIC_UNITS[metric];
     const unit = input.unit ? normalizeUsageSampleUnit(input.unit) : expectedUnit;
     if (unit !== expectedUnit) {
-        throw new Error(`run usage sample ${metric} must use ${expectedUnit} units`);
+        throw new Error(`session usage sample ${metric} must use ${expectedUnit} units`);
     }
     return Object.freeze({
-        schemaVersion: RUN_USAGE_SAMPLE_SCHEMA_VERSION,
+        schemaVersion: SESSION_USAGE_SAMPLE_SCHEMA_VERSION,
         ...(input.sampleId ? { sampleId: nonEmptyString(input.sampleId, "sampleId") } : {}),
-        ...(input.runId ? { runId: input.runId } : {}),
+        ...(input.sessionId ? { sessionId: input.sessionId } : {}),
         metric,
         unit,
         quantity: nonNegativeFinite(input.quantity, "quantity"),
@@ -117,16 +117,16 @@ export function buildRunUsageSample(input) {
         ...(input.recordedAt ? { recordedAt: input.recordedAt } : {})
     });
 }
-export function buildRunCostTelemetry(input) {
+export function buildSessionCostTelemetry(input) {
     return freezeTelemetry({
-        schemaVersion: RUN_COST_TELEMETRY_SCHEMA_VERSION,
-        ...(input.runId ? { runId: input.runId } : {}),
+        schemaVersion: SESSION_COST_TELEMETRY_SCHEMA_VERSION,
+        ...(input.sessionId ? { sessionId: input.sessionId } : {}),
         ...(input.provider ? { provider: input.provider } : {}),
         ...(input.recordedAt ? { recordedAt: input.recordedAt } : {}),
         ...(input.status ? { status: normalizeSummaryStatus(input.status) } : {}),
         ...(input.sourceSummary ? { sourceSummary: normalizeSourceSummary(input.sourceSummary) } : {}),
         ...(input.durations ? { durations: normalizeDurations(input.durations) } : {}),
-        ...(input.outputs ? { outputs: normalizeOutputs(input.outputs) } : {}),
+        ...(input.files ? { files: normalizeFiles(input.files) } : {}),
         ...(input.retries ? { retries: normalizeRetries(input.retries) } : {}),
         ...(input.capture ? { capture: normalizeCapture(input.capture) } : {}),
         ...(input.providerUsage ? { providerUsage: input.providerUsage.map(normalizeProviderUsage) } : {}),
@@ -136,13 +136,13 @@ export function buildRunCostTelemetry(input) {
         ...(input.costBasis ? { costBasis: normalizeCostBasis(input.costBasis) } : {})
     });
 }
-export function buildRunCostTelemetryFromUsageSamples(input) {
-    const samples = input.samples.map(buildRunUsageSample);
+export function buildSessionCostTelemetryFromUsageSamples(input) {
+    const samples = input.samples.map(buildSessionUsageSample);
     const telemetry = {
         sourceSummary: summarizeUsageSamples(samples)
     };
-    if (input.runId)
-        telemetry.runId = input.runId;
+    if (input.sessionId)
+        telemetry.sessionId = input.sessionId;
     if (input.provider)
         telemetry.provider = input.provider;
     if (input.recordedAt)
@@ -150,7 +150,7 @@ export function buildRunCostTelemetryFromUsageSamples(input) {
     if (input.status)
         telemetry.status = input.status;
     const durations = {};
-    const outputs = {};
+    const files = {};
     const retries = {};
     const capture = {};
     const storage = {};
@@ -180,26 +180,26 @@ export function buildRunCostTelemetryFromUsageSamples(input) {
             case "runtime.active_ms":
                 addDraftNumber(durations, "runtimeMs", sample.quantity);
                 break;
-            case "runtime.output_capture_ms":
-                addDraftNumber(durations, "outputCaptureMs", sample.quantity);
+            case "runtime.file_capture_ms":
+                addDraftNumber(durations, "fileCaptureMs", sample.quantity);
                 break;
             case "runtime.cleanup_ms":
                 addDraftNumber(durations, "cleanupMs", sample.quantity);
                 break;
-            case "run.total_ms":
+            case "session.total_ms":
                 addDraftNumber(durations, "totalMs", sample.quantity);
                 break;
-            case "output.discovered_files":
-                addDraftNumber(outputs, "discoveredFiles", sample.quantity);
+            case "file.discovered_files":
+                addDraftNumber(files, "discoveredFiles", sample.quantity);
                 break;
-            case "output.captured_files":
-                addDraftNumber(outputs, "capturedFiles", sample.quantity);
+            case "file.captured_files":
+                addDraftNumber(files, "capturedFiles", sample.quantity);
                 break;
-            case "output.failed_files":
-                addDraftNumber(outputs, "failedFiles", sample.quantity);
+            case "file.failed_files":
+                addDraftNumber(files, "failedFiles", sample.quantity);
                 break;
-            case "output.captured_bytes":
-                addDraftNumber(outputs, "capturedBytes", sample.quantity);
+            case "file.captured_bytes":
+                addDraftNumber(files, "capturedBytes", sample.quantity);
                 break;
             case "retry.runtime_attempts":
                 addDraftNumber(retries, "runtimeAttempts", sample.quantity);
@@ -207,11 +207,11 @@ export function buildRunCostTelemetryFromUsageSamples(input) {
             case "retry.provider_poll":
                 addDraftNumber(retries, "providerPollRetries", sample.quantity);
                 break;
-            case "retry.output_capture":
-                addDraftNumber(retries, "outputCaptureRetries", sample.quantity);
+            case "retry.file_capture":
+                addDraftNumber(retries, "fileCaptureRetries", sample.quantity);
                 break;
-            case "retry.output_upload":
-                addDraftNumber(retries, "outputUploadRetries", sample.quantity);
+            case "retry.file_upload":
+                addDraftNumber(retries, "fileUploadRetries", sample.quantity);
                 break;
             case "capture.uploaded_files":
                 captureAttempted = true;
@@ -250,8 +250,8 @@ export function buildRunCostTelemetryFromUsageSamples(input) {
     }
     if (Object.keys(durations).length > 0)
         telemetry.durations = durations;
-    if (Object.keys(outputs).length > 0)
-        telemetry.outputs = outputs;
+    if (Object.keys(files).length > 0)
+        telemetry.files = files;
     if (Object.keys(retries).length > 0)
         telemetry.retries = retries;
     if (captureAttempted || Object.keys(capture).length > 0) {
@@ -264,10 +264,10 @@ export function buildRunCostTelemetryFromUsageSamples(input) {
         telemetry.storage = storage;
     if (Object.keys(proxy).length > 0)
         telemetry.proxy = proxy;
-    return buildRunCostTelemetry(telemetry);
+    return buildSessionCostTelemetry(telemetry);
 }
 export function summarizeUsageSamples(samples) {
-    const normalized = samples.map(buildRunUsageSample);
+    const normalized = samples.map(buildSessionUsageSample);
     const metrics = unique(normalized.map((sample) => sample.metric));
     const sourceTypes = unique(normalized.map((sample) => sample.source.type));
     const sourceSampleIds = unique(normalized.flatMap((sample) => (sample.sampleId ? [sample.sampleId] : [])));
@@ -278,16 +278,16 @@ export function summarizeUsageSamples(samples) {
         ...(sourceSampleIds.length > 0 ? { sourceSampleIds } : {})
     });
 }
-export function mergeRunCostTelemetry(base, next) {
-    const patch = buildRunCostTelemetry(next);
+export function mergeSessionCostTelemetry(base, next) {
+    const patch = buildSessionCostTelemetry(next);
     const merged = {};
-    const runId = patch.runId ?? base.runId;
+    const sessionId = patch.sessionId ?? base.sessionId;
     const provider = patch.provider ?? base.provider;
     const recordedAt = patch.recordedAt ?? base.recordedAt;
     const status = patch.status ?? base.status;
     const sourceSummary = mergeSourceSummary(base.sourceSummary, patch.sourceSummary);
     const durations = sumDurations(base.durations, patch.durations);
-    const outputs = sumOutputs(base.outputs, patch.outputs);
+    const files = sumFiles(base.files, patch.files);
     const retries = sumRetries(base.retries, patch.retries);
     const capture = mergeCapture(base.capture, patch.capture);
     const providerUsage = [...(base.providerUsage ?? []), ...(patch.providerUsage ?? [])];
@@ -298,8 +298,8 @@ export function mergeRunCostTelemetry(base, next) {
     // not additive metrics.
     const billedCostUsd = patch.billedCostUsd ?? base.billedCostUsd;
     const costBasis = patch.costBasis ?? base.costBasis;
-    if (runId)
-        merged.runId = runId;
+    if (sessionId)
+        merged.sessionId = sessionId;
     if (provider)
         merged.provider = provider;
     if (recordedAt)
@@ -310,8 +310,8 @@ export function mergeRunCostTelemetry(base, next) {
         merged.sourceSummary = sourceSummary;
     if (durations)
         merged.durations = durations;
-    if (outputs)
-        merged.outputs = outputs;
+    if (files)
+        merged.files = files;
     if (retries)
         merged.retries = retries;
     if (capture)
@@ -326,18 +326,18 @@ export function mergeRunCostTelemetry(base, next) {
         merged.billedCostUsd = billedCostUsd;
     if (costBasis)
         merged.costBasis = costBasis;
-    return buildRunCostTelemetry(merged);
+    return buildSessionCostTelemetry(merged);
 }
 function normalizeDurations(input) {
     return freezeOptionalNumbers({
         queuedMs: input.queuedMs,
         runtimeMs: input.runtimeMs,
-        outputCaptureMs: input.outputCaptureMs,
+        fileCaptureMs: input.fileCaptureMs,
         cleanupMs: input.cleanupMs,
         totalMs: input.totalMs
     });
 }
-function normalizeOutputs(input) {
+function normalizeFiles(input) {
     return freezeOptionalNumbers({
         discoveredFiles: input.discoveredFiles,
         capturedFiles: input.capturedFiles,
@@ -349,8 +349,8 @@ function normalizeRetries(input) {
     return freezeOptionalNumbers({
         runtimeAttempts: input.runtimeAttempts,
         providerPollRetries: input.providerPollRetries,
-        outputCaptureRetries: input.outputCaptureRetries,
-        outputUploadRetries: input.outputUploadRetries
+        fileCaptureRetries: input.fileCaptureRetries,
+        fileUploadRetries: input.fileUploadRetries
     });
 }
 function normalizeCapture(input) {
@@ -408,7 +408,7 @@ function normalizeSourceSummary(input) {
 }
 function normalizeUsageSampleSource(input) {
     if (!input || typeof input !== "object") {
-        throw new Error("run usage sample source must be an object");
+        throw new Error("session usage sample source must be an object");
     }
     return Object.freeze({
         type: normalizeUsageSampleSourceType(input.type),
@@ -417,45 +417,45 @@ function normalizeUsageSampleSource(input) {
     });
 }
 function normalizeUsageSampleMetric(input) {
-    if (!isStringIn(input, RUN_USAGE_SAMPLE_METRICS)) {
-        throw new Error(`run usage sample metric ${String(input)} is not supported`);
+    if (!isStringIn(input, SESSION_USAGE_SAMPLE_METRICS)) {
+        throw new Error(`session usage sample metric ${String(input)} is not supported`);
     }
     return input;
 }
 function normalizeUsageSampleUnit(input) {
-    if (!isStringIn(input, RUN_USAGE_SAMPLE_UNITS)) {
-        throw new Error(`run usage sample unit ${String(input)} is not supported`);
+    if (!isStringIn(input, SESSION_USAGE_SAMPLE_UNITS)) {
+        throw new Error(`session usage sample unit ${String(input)} is not supported`);
     }
     return input;
 }
 function normalizeUsageSampleSourceType(input) {
-    if (!isStringIn(input, RUN_USAGE_SAMPLE_SOURCE_TYPES)) {
-        throw new Error(`run usage sample source type ${String(input)} is not supported`);
+    if (!isStringIn(input, SESSION_USAGE_SAMPLE_SOURCE_TYPES)) {
+        throw new Error(`session usage sample source type ${String(input)} is not supported`);
     }
     return input;
 }
 function normalizeSummaryStatus(input) {
-    if (!isStringIn(input, RUN_COST_SUMMARY_STATUSES)) {
-        throw new Error(`run cost telemetry status ${String(input)} is not supported`);
+    if (!isStringIn(input, SESSION_COST_SUMMARY_STATUSES)) {
+        throw new Error(`session cost telemetry status ${String(input)} is not supported`);
     }
     return input;
 }
 function normalizeCostBasis(input) {
     if (!input || typeof input !== "object") {
-        throw new Error("run cost basis must be an object");
+        throw new Error("session cost basis must be an object");
     }
     if (input.currency !== "USD") {
-        throw new Error(`run cost basis currency ${String(input.currency)} is not supported`);
+        throw new Error(`session cost basis currency ${String(input.currency)} is not supported`);
     }
-    if (!isStringIn(input.status, RUN_COST_BASIS_STATUSES)) {
-        throw new Error(`run cost basis status ${String(input.status)} is not supported`);
+    if (!isStringIn(input.status, SESSION_COST_BASIS_STATUSES)) {
+        throw new Error(`session cost basis status ${String(input.status)} is not supported`);
     }
     return Object.freeze({ currency: "USD", status: input.status });
 }
 function addProviderUsage(usageByKey, input, sample, field) {
     const provider = sample.provider ?? input.provider;
     if (!provider) {
-        throw new Error(`run usage sample ${sample.metric} requires a provider`);
+        throw new Error(`session usage sample ${sample.metric} requires a provider`);
     }
     const key = `${provider}\u0000${sample.model ?? ""}`;
     const existing = usageByKey.get(key);
@@ -465,7 +465,7 @@ function addProviderUsage(usageByKey, input, sample, field) {
         sourceSampleIds: []
     };
     usage[field] = (usage[field] ?? 0) + sample.quantity;
-    if (!usage.sourceEventId && (sample.source.type === "coordinator-event" || sample.source.type === "run-event")) {
+    if (!usage.sourceEventId && (sample.source.type === "coordinator-event" || sample.source.type === "session-event")) {
         usage.sourceEventId = sample.source.id;
     }
     if (sample.sampleId) {
@@ -503,13 +503,13 @@ function freezeOptionalNumbers(input) {
     return Object.freeze(out);
 }
 function sumDurations(base, next) {
-    return sumNumberFields(["queuedMs", "runtimeMs", "outputCaptureMs", "cleanupMs", "totalMs"], base, next);
+    return sumNumberFields(["queuedMs", "runtimeMs", "fileCaptureMs", "cleanupMs", "totalMs"], base, next);
 }
-function sumOutputs(base, next) {
+function sumFiles(base, next) {
     return sumNumberFields(["discoveredFiles", "capturedFiles", "failedFiles", "capturedBytes"], base, next);
 }
 function sumRetries(base, next) {
-    return sumNumberFields(["runtimeAttempts", "providerPollRetries", "outputCaptureRetries", "outputUploadRetries"], base, next);
+    return sumNumberFields(["runtimeAttempts", "providerPollRetries", "fileCaptureRetries", "fileUploadRetries"], base, next);
 }
 function sumStorage(base, next) {
     return sumNumberFields(["storedBytes", "byteMilliseconds"], base, next);
@@ -570,13 +570,13 @@ function unique(input) {
 }
 function nonEmptyString(value, field) {
     if (typeof value !== "string" || value.trim().length === 0) {
-        throw new Error(`run cost telemetry ${field} must be a non-empty string`);
+        throw new Error(`session cost telemetry ${field} must be a non-empty string`);
     }
     return value;
 }
 function nonNegativeFinite(value, field) {
     if (!Number.isFinite(value) || value < 0) {
-        throw new Error(`run cost telemetry ${field} must be a non-negative finite number`);
+        throw new Error(`session cost telemetry ${field} must be a non-negative finite number`);
     }
     return value;
 }

package/dist/_contracts/{run-custody.d.ts → session-custody.d.ts}

@@ -1,15 +1,15 @@
-import type { RunStatus } from "./status.js";
-import type { RunProvider } from "./submission.js";
+import type { SessionControlStatus } from "./status.js";
+import type { ProviderName } from "./submission.js";
 export declare const CUSTODY_MANIFEST_SCHEMA_VERSION = 1;
 export declare const CUSTODY_REDACTION_SCANNER_VERSION = 1;
 export declare const CUSTODY_MANIFEST_KIND = "aex.custody_manifest.v1";
 export declare const CUSTODY_MANIFEST_CONTENT_TYPE = "application/json; charset=utf-8";
-export declare const CUSTODY_MANIFEST_RUN_REL_PATH = "metadata/custody.json";
+export declare const CUSTODY_MANIFEST_SESSION_REL_PATH = "metadata/custody.json";
 export declare const CUSTODY_SECRET_CLASSES: readonly ["provider_api_key", "mcp_credential", "proxy_endpoint_auth", "runner_bearer", "managed_system_credential"];
 export type CustodySecretClass = (typeof CUSTODY_SECRET_CLASSES)[number];
-export declare const CUSTODY_RESOURCE_CLASSES: readonly ["runtime_machine", "proxy_token", "execution_secret", "event_archive", "run_output", "run_log", "run_asset"];
+export declare const CUSTODY_RESOURCE_CLASSES: readonly ["runtime_machine", "proxy_token", "execution_secret", "event_archive", "session_file", "session_log", "session_asset"];
 export type CustodyResourceClass = (typeof CUSTODY_RESOURCE_CLASSES)[number];
-export declare const CUSTODY_EXPOSURE_SURFACES: readonly ["aex_vault", "aex_kv", "host_env", "host_file", "dashboard_proxy", "api_provider_proxy", "api_mcp_proxy", "run_artifact_store", "coordinator_event_archive"];
+export declare const CUSTODY_EXPOSURE_SURFACES: readonly ["aex_vault", "aex_kv", "host_env", "host_file", "dashboard_proxy", "api_provider_proxy", "api_mcp_proxy", "session_artifact_store", "coordinator_event_archive"];
 export type CustodyExposureSurface = (typeof CUSTODY_EXPOSURE_SURFACES)[number];
 export declare const CUSTODY_EXPOSURE_ACCESS_KINDS: readonly ["stored", "injected", "proxied", "replicated", "observed", "unknown"];
 export type CustodyExposureAccessKind = (typeof CUSTODY_EXPOSURE_ACCESS_KINDS)[number];
@@ -19,15 +19,15 @@ export declare const CUSTODY_DISPOSITION_STATUSES: readonly ["destroyed", "revok
 export type CustodyDispositionStatus = (typeof CUSTODY_DISPOSITION_STATUSES)[number];
 export declare const CUSTODY_CLEANUP_STATUSES: readonly ["succeeded", "partial", "failed", "retained", "pending"];
 export type CustodyCleanupStatus = (typeof CUSTODY_CLEANUP_STATUSES)[number];
-export declare const CUSTODY_EVIDENCE_SOURCES: readonly ["run_row", "runtime_manifest", "terminal_event", "cleanup_step", "output_capture", "proxy_audit", "provider_cleanup_summary"];
+export declare const CUSTODY_EVIDENCE_SOURCES: readonly ["session_row", "runtime_manifest", "terminal_event", "cleanup_step", "file_capture", "proxy_audit", "provider_cleanup_summary"];
 export type CustodyEvidenceSource = (typeof CUSTODY_EVIDENCE_SOURCES)[number];
 export declare const CUSTODY_MANIFEST_EXCLUDED_VALUE_CLASSES: readonly ["raw_secret_values", "bearer_hashes", "provider_response_bodies", "signed_urls", "object_store_keys", "vault_ids", "private_resource_handles"];
 export type CustodyManifestExcludedValueClass = (typeof CUSTODY_MANIFEST_EXCLUDED_VALUE_CLASSES)[number];
-export interface CustodyManifestRunV1 {
-    readonly runId: string;
+export interface CustodyManifestSessionV1 {
+    readonly sessionId: string;
     readonly workspaceId: string;
-    readonly provider: RunProvider | string;
-    readonly terminalStatus: RunStatus | string;
+    readonly provider: ProviderName | string;
+    readonly terminalStatus: SessionControlStatus | string;
     readonly createdAt?: string;
     readonly terminalAt?: string;
 }
@@ -100,14 +100,14 @@ export interface CustodyManifestV1 {
     readonly kind: typeof CUSTODY_MANIFEST_KIND;
     readonly generatedAt: string;
     readonly finalizedAt?: string;
-    readonly run: CustodyManifestRunV1;
+    readonly session: CustodyManifestSessionV1;
     readonly secrets: readonly CustodyManifestSecretClassV1[];
     readonly resources: readonly CustodyManifestResourceClassV1[];
     readonly cleanup: CustodyManifestCleanupV1;
     readonly summary: CustodyManifestSummaryV1;
     readonly redaction: CustodyManifestRedactionV1;
 }
-export type CustodyManifestRunInput = CustodyManifestRunV1;
+export type CustodyManifestSessionInput = CustodyManifestSessionV1;
 export type CustodyManifestExposureInput = CustodyManifestExposureV1;
 export type CustodyManifestDispositionInput = CustodyManifestDispositionV1;
 export type CustodyManifestEvidenceSummaryInput = CustodyManifestEvidenceSummaryV1;
@@ -123,7 +123,7 @@ export interface CustodyManifestResourceClassInput extends Omit<CustodyManifestR
 export interface CustodyManifestInput {
     readonly generatedAt: string;
     readonly finalizedAt?: string;
-    readonly run: CustodyManifestRunInput;
+    readonly session: CustodyManifestSessionInput;
     readonly secrets?: readonly CustodyManifestSecretClassInput[];
     readonly resources?: readonly CustodyManifestResourceClassInput[];
     readonly cleanup?: CustodyManifestCleanupInput;
@@ -139,7 +139,7 @@ export interface CustodyManifestObjectStore {
 export interface CustodyManifestWriteResult {
     readonly status: "written";
     readonly schemaVersion: typeof CUSTODY_MANIFEST_SCHEMA_VERSION;
-    readonly runId: string;
+    readonly sessionId: string;
     readonly workspaceId: string;
     readonly key: string;
     readonly writtenAt: string;
@@ -161,11 +161,11 @@ export declare class CustodyManifestRedactionError extends Error {
 export declare class FakeCustodyManifestObjectStore implements CustodyManifestObjectStore {
     #private;
     putCustodyManifestObject(object: CustodyManifestWriteObject): Promise<void>;
-    getByRunId(runId: string): CustodyManifestV1 | undefined;
+    getBySessionId(sessionId: string): CustodyManifestV1 | undefined;
     get(key: string): CustodyManifestV1 | undefined;
     listKeys(): readonly string[];
 }
-export declare function custodyManifestObjectKey(runId: string): string;
+export declare function custodyManifestObjectKey(sessionId: string): string;
 export declare function createCustodyManifestWriter(store: CustodyManifestObjectStore): CustodyManifestWriter;
 export declare function writeCustodyManifest(store: CustodyManifestObjectStore, input: CustodyManifestInput): Promise<CustodyManifestWriteResult>;
 export declare function buildCustodyManifest(input: CustodyManifestInput): CustodyManifestV1;