@aexhq/sdk 0.40.16 → 0.41.0

package/examples/feature-tour.ts

@@ -1,10 +1,10 @@
 /**
  * SDK feature tour: one managed session that uses typed model/runtime constants,
  * inline AGENTS.md guidance, uploaded files, a custom tool bundle, selected
- * built-in tools, runtime env vars/secrets, streamed events, output reads, and
+ * built-in tools, runtime env vars/secrets, streamed events, file reads, and
  * a follow-up session turn.
  *
- * Run from the repository root after building the workspace package:
+ * SessionRecord from the repository root after building the workspace package:
  *
  *   AEX_API_KEY=... DEEPSEEK_API_KEY=... bun packages/sdk/examples/feature-tour.ts
  *
@@ -107,7 +107,7 @@ const runRules = await AgentsMd.fromContent(
     "# Feature tour rules",
     "- Use `/workspace/input/quarterly-metrics.csv` as the source table.",
     "- Call `metric_lookup` for atlas, beacon, and cinder before writing conclusions.",
-    "- Write final artifacts under `/workspace/outputs`.",
+    "- Write final artifacts under `/workspace/files`.",
     "- Never print runtime secret values or provider keys."
   ].join("\n"),
   { name: "feature-tour-rules" }
@@ -156,12 +156,12 @@ const session = await aex.openSession({
     networking: { mode: "open" },
     variables: {
       FEATURE_TOUR: "true",
-      REPORT_DIR: "/workspace/outputs"
+      REPORT_DIR: "/workspace/files"
     },
     ...(environmentSecrets ? { secrets: environmentSecrets } : {})
   },
-  outputs: {
-    allowedDirs: ["/workspace/outputs"],
+  fileCapture: {
+    allowedDirs: ["/workspace/files"],
     deniedDirs: ["*.tmp"],
     maxFiles: 10,
     maxFileBytes: 1_000_000
@@ -185,8 +185,8 @@ console.log(`session: ${session.id}`);
 const prompt = [
   "Analyze the attached quarterly metrics.",
   "Call metric_lookup for atlas, beacon, and cinder.",
-  "Create /workspace/outputs/feature-tour-report.md with a short table, a ranking by q2_revenue_usd, and two risks.",
-  "Create /workspace/outputs/summary.json with keys topProduct, totalQ2RevenueUsd, highestActivationProduct, and riskCount."
+  "Create /workspace/files/feature-tour-report.md with a short table, a ranking by q2_revenue_usd, and two risks.",
+  "Create /workspace/files/summary.json with keys topProduct, totalQ2RevenueUsd, highestActivationProduct, and riskCount."
 ].join(" ");
 
 const firstTurn = session.send(prompt);
@@ -230,24 +230,24 @@ console.log(`assistant messages: ${messages.length}`);
 const events = await session.events().list();
 console.log(`captured events: ${events.length}`);
 
-const outputs = await session.outputs().list();
-console.log("outputs:");
-for (const output of outputs) {
-  console.log(`- ${output.filename ?? output.id} (${output.contentType ?? "unknown"})`);
+const files = await session.files().list();
+console.log("files:");
+for (const file of files) {
+  console.log(`- ${file.filename ?? file.id} (${file.contentType ?? "unknown"})`);
 }
 
-const summary = await session.outputs().read(
+const summary = await session.files().read(
   { path: "summary.json", match: "suffix" },
   { maxBytes: 20_000 }
 );
 console.log("summary.json:");
 console.log(summary.text);
 
-const report = await session.outputs().findOne({
+const report = await session.files().findOne({
   filename: "feature-tour-report.md"
 });
 if (report) {
-  const reportPreview = await session.outputs().read(report, {
+  const reportPreview = await session.files().read(report, {
     maxBytes: 4_000,
     grep: "risk"
   });
@@ -255,8 +255,8 @@ if (report) {
   console.log(reportPreview.text || "(no risk lines found)");
 }
 
-const reopenedOutputs = await aex.sessions.outputs(session.id).list();
-console.log(`outputs via aex.sessions.outputs(...): ${reopenedOutputs.length}`);
+const reopenedFiles = await aex.sessions.files(session.id).list();
+console.log(`files via aex.sessions.files(...): ${reopenedFiles.length}`);
 
 if (downloadPath) {
   const bytes = await session.download({ to: downloadPath });

package/examples/spike-settle-latency.ts

@@ -1,7 +1,7 @@
 /**
  * SPIKE (throwaway): measure the real park-event -> record-idle gap for interactive
  * session turns. This is the extra wall-clock Option B (settle-consistent turn stream)
- * would force onto EVERY turn: the turn stream currently ends on the RUN_FINISHED park
+ * would force onto EVERY turn: the turn stream currently ends on the TURN_FINISHED park
  * event, but the session RECORD flips running->idle later, in the async settle lambda.
  *
  *   AEX_API_KEY=... DEEPSEEK_API_KEY=... AEX_API_URL=... bun packages/sdk/examples/spike-settle-latency.ts
@@ -9,7 +9,7 @@
  * Optional: SPIKE_TURNS=8 (samples), SPIKE_POLL_MS=120 (record poll interval).
  *
  * Method per turn:
- *   1) send a tiny prompt, stream events, capture t_runFinished at the RUN_FINISHED event
+ *   1) send a tiny prompt, stream events, capture t_runFinished at the TURN_FINISHED event
  *      (this is where the default turn stream ends), then stop consuming.
  *   2) tight-poll session.refresh() until status === "idle"; capture t_idle.
  *   3) settleGapMs = t_idle - t_runFinished  <-- the Option B tax.
@@ -48,21 +48,21 @@ const samples: Sample[] = [];
 for (let i = 0; i < turns; i++) {
   const stream = session.send(`Say hello #${i + 1} in one short sentence.`);
   const tStart = performance.now();
-  let tRunFinished = 0;
+  let tTurnFinished = 0;
   let errored = false;
   for await (const event of stream) {
-    if (event.isRunError()) {
+    if (event.isTurnError()) {
       errored = true;
-      tRunFinished = performance.now();
+      tTurnFinished = performance.now();
       break;
     }
-    if (event.isRunFinished()) {
-      tRunFinished = performance.now();
+    if (event.isTurnFinished()) {
+      tTurnFinished = performance.now();
       break; // default turn stream would end HERE
     }
   }
-  if (tRunFinished === 0) tRunFinished = performance.now();
-  const turnMs = tRunFinished - tStart;
+  if (tTurnFinished === 0) tTurnFinished = performance.now();
+  const turnMs = tTurnFinished - tStart;
 
   // Tight-poll the authoritative record until it leaves running.
   let polls = 0;
@@ -84,11 +84,11 @@ for (let i = 0; i < turns; i++) {
     }
     await sleep(pollMs);
   }
-  const settleGapMs = tIdle - tRunFinished;
+  const settleGapMs = tIdle - tTurnFinished;
   samples.push({ turn: i + 1, turnMs, settleGapMs, polls, timedOut });
   console.log(
     `turn ${String(i + 1).padStart(2)}  turn=${fmt(turnMs)}  settleGap=${fmt(settleGapMs)}  polls=${polls}` +
-      (errored ? "  (RUN_ERROR)" : "") +
+      (errored ? "  (TURN_ERROR)" : "") +
       (timedOut ? "  (TIMEOUT>90s)" : "")
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.40.16",
+  "version": "0.41.0",
   "description": "TypeScript SDK for running autonomous agent sessions across providers (Anthropic, OpenAI, DeepSeek, Gemini, Mistral) behind one interface.",
   "license": "Apache-2.0",
   "repository": {

package/dist/_contracts/run-artifacts.d.ts

@@ -1,49 +0,0 @@
-/**
- * Single source of truth for a run's artifact namespaces.
- *
- * Every run stores public outputs and internal diagnostics under separate
- * prefixes:
- *
- *   runs/<runId>/outputs/<rel>              — the run's real deliverables.
- *   runs/<runId>/internal/logs/<rel>        — platform diagnostics
- *                                             (`runtime/`, `host/`,
- *                                             `provider-proxy/`,
- *                                             `control-plane/`).
- *
- * The runner uploads every file with a workspace-relative path and the
- * server decides the namespace from that path's prefix, so the split is
- * owned here — the runner does not need to know about it. Diagnostics
- * reach the upload route as workspace dotdirs (`.runtime-logs/...`,
- * `.host-logs/...`, etc.) or runtime-managed home-directory state; the stored
- * path uses canonical log namespaces.
- */
-export declare const RUN_OUTPUTS_PREFIX = "outputs";
-export declare const RUN_INTERNAL_LOGS_PREFIX = "internal/logs";
-/**
- * Relative-path prefixes that mark a stored artifact as a platform diagnostic
- * rather than a run deliverable. Dotted forms are upload-time paths; legacy
- * forms are accepted so old records normalize to the canonical namespace.
- */
-export declare const RUN_LOG_REL_PREFIXES: readonly [".runtime-logs/", ".host-logs/", ".provider-proxy/", ".control-plane/", ".anthropic-debug/", ".goose-logs/", ".fly-logs/", "runtime/", "host/", "provider-proxy/", "control-plane/", "anthropic-debug/", "goose-logs/", "fly-logs/"];
-/** True when a workspace-relative artifact path belongs to the internal logs namespace. */
-export declare function isRunLogRelPath(rel: string): boolean;
-/**
- * The artifact's path relative to its namespace prefix as stored. Diagnostics
- * are canonicalized (`.runtime-logs/x` -> `runtime/x`,
- * legacy `.goose-logs/x` -> `runtime/x`, legacy `.fly-logs/x` -> `host/x`).
- */
-export declare function runArtifactRel(rel: string): string;
-/**
- * Storage key for a run artifact uploaded with relative path `rel`, routing
- * diagnostics into `internal/logs/` and everything else into `outputs/`.
- */
-export declare function runArtifactKey(runId: string, rel: string): string;
-/** The `assets` namespace under a run's prefix. */
-export declare const RUN_ASSETS_PREFIX = "assets";
-/**
- * Storage key for a run's snapshotted asset, addressed by its content hash.
- * At submit, each referenced shared-store asset is copied here so the run owns
- * its bytes. Accepts a `sha256:<hex>` hash or a bare 64-hex digest; the stored
- * suffix is the hex.
- */
-export declare function runAssetKey(runId: string, hash: string): string;

package/dist/_contracts/run-artifacts.js

@@ -1,102 +0,0 @@
-/**
- * Single source of truth for a run's artifact namespaces.
- *
- * Every run stores public outputs and internal diagnostics under separate
- * prefixes:
- *
- *   runs/<runId>/outputs/<rel>              — the run's real deliverables.
- *   runs/<runId>/internal/logs/<rel>        — platform diagnostics
- *                                             (`runtime/`, `host/`,
- *                                             `provider-proxy/`,
- *                                             `control-plane/`).
- *
- * The runner uploads every file with a workspace-relative path and the
- * server decides the namespace from that path's prefix, so the split is
- * owned here — the runner does not need to know about it. Diagnostics
- * reach the upload route as workspace dotdirs (`.runtime-logs/...`,
- * `.host-logs/...`, etc.) or runtime-managed home-directory state; the stored
- * path uses canonical log namespaces.
- */
-export const RUN_OUTPUTS_PREFIX = "outputs";
-export const RUN_INTERNAL_LOGS_PREFIX = "internal/logs";
-/**
- * Relative-path prefixes that mark a stored artifact as a platform diagnostic
- * rather than a run deliverable. Dotted forms are upload-time paths; legacy
- * forms are accepted so old records normalize to the canonical namespace.
- */
-export const RUN_LOG_REL_PREFIXES = [
-    ".runtime-logs/",
-    ".host-logs/",
-    ".provider-proxy/",
-    ".control-plane/",
-    ".anthropic-debug/",
-    ".goose-logs/",
-    ".fly-logs/",
-    "runtime/",
-    "host/",
-    "provider-proxy/",
-    "control-plane/",
-    "anthropic-debug/",
-    "goose-logs/",
-    "fly-logs/"
-];
-/** True when a workspace-relative artifact path belongs to the internal logs namespace. */
-export function isRunLogRelPath(rel) {
-    return RUN_LOG_REL_PREFIXES.some((prefix) => rel.startsWith(prefix));
-}
-/**
- * The artifact's path relative to its namespace prefix as stored. Diagnostics
- * are canonicalized (`.runtime-logs/x` -> `runtime/x`,
- * legacy `.goose-logs/x` -> `runtime/x`, legacy `.fly-logs/x` -> `host/x`).
- */
-export function runArtifactRel(rel) {
-    if (rel.startsWith(".runtime-logs/"))
-        return `runtime/${rel.slice(".runtime-logs/".length)}`;
-    if (rel.startsWith("runtime/"))
-        return rel;
-    if (rel.startsWith(".host-logs/"))
-        return `host/${rel.slice(".host-logs/".length)}`;
-    if (rel.startsWith("host/"))
-        return rel;
-    if (rel.startsWith(".provider-proxy/"))
-        return `provider-proxy/${rel.slice(".provider-proxy/".length)}`;
-    if (rel.startsWith("provider-proxy/"))
-        return rel;
-    if (rel.startsWith(".control-plane/"))
-        return `control-plane/${rel.slice(".control-plane/".length)}`;
-    if (rel.startsWith("control-plane/"))
-        return rel;
-    if (rel.startsWith(".goose-logs/"))
-        return `runtime/${rel.slice(".goose-logs/".length)}`;
-    if (rel.startsWith("goose-logs/"))
-        return `runtime/${rel.slice("goose-logs/".length)}`;
-    if (rel.startsWith(".fly-logs/"))
-        return `host/${rel.slice(".fly-logs/".length)}`;
-    if (rel.startsWith("fly-logs/"))
-        return `host/${rel.slice("fly-logs/".length)}`;
-    if (rel.startsWith(".anthropic-debug/"))
-        return `provider-proxy/${rel.slice(".anthropic-debug/".length)}`;
-    if (rel.startsWith("anthropic-debug/"))
-        return `provider-proxy/${rel.slice("anthropic-debug/".length)}`;
-    return rel;
-}
-/**
- * Storage key for a run artifact uploaded with relative path `rel`, routing
- * diagnostics into `internal/logs/` and everything else into `outputs/`.
- */
-export function runArtifactKey(runId, rel) {
-    const namespace = isRunLogRelPath(rel) ? RUN_INTERNAL_LOGS_PREFIX : RUN_OUTPUTS_PREFIX;
-    return `runs/${runId}/${namespace}/${runArtifactRel(rel)}`;
-}
-/** The `assets` namespace under a run's prefix. */
-export const RUN_ASSETS_PREFIX = "assets";
-/**
- * Storage key for a run's snapshotted asset, addressed by its content hash.
- * At submit, each referenced shared-store asset is copied here so the run owns
- * its bytes. Accepts a `sha256:<hex>` hash or a bare 64-hex digest; the stored
- * suffix is the hex.
- */
-export function runAssetKey(runId, hash) {
-    const hex = hash.startsWith("sha256:") ? hash.slice("sha256:".length) : hash;
-    return `runs/${runId}/${RUN_ASSETS_PREFIX}/${hex}`;
-}

package/dist/_contracts/run-cost.d.ts

@@ -1,140 +0,0 @@
-import type { RunProvider } from "./submission.js";
-export declare const RUN_COST_TELEMETRY_SCHEMA_VERSION = 1;
-export declare const RUN_USAGE_SAMPLE_SCHEMA_VERSION = 1;
-export declare const RUN_COST_SUMMARY_STATUSES: readonly ["pending", "partial", "complete", "unavailable", "not_applicable"];
-export type RunCostSummaryStatus = (typeof RUN_COST_SUMMARY_STATUSES)[number];
-export declare const RUN_USAGE_SAMPLE_UNITS: readonly ["token", "millisecond", "byte", "byte_millisecond", "count", "file", "credit_unit"];
-export type RunUsageSampleUnit = (typeof RUN_USAGE_SAMPLE_UNITS)[number];
-export declare const RUN_USAGE_SAMPLE_SOURCE_TYPES: readonly ["coordinator-event", "run-event", "usage-ledger", "output-object", "proxy-call", "runtime-job", "provider-session", "storage-accrual", "manual-adjustment"];
-export type RunUsageSampleSourceType = (typeof RUN_USAGE_SAMPLE_SOURCE_TYPES)[number];
-export declare const RUN_USAGE_SAMPLE_METRICS: readonly ["provider.input_tokens", "provider.output_tokens", "provider.cache_read_input_tokens", "provider.cache_creation_input_tokens", "provider.total_tokens", "runtime.queued_ms", "runtime.active_ms", "runtime.output_capture_ms", "runtime.cleanup_ms", "run.total_ms", "output.discovered_files", "output.captured_files", "output.failed_files", "output.captured_bytes", "retry.runtime_attempts", "retry.provider_poll", "retry.output_capture", "retry.output_upload", "capture.uploaded_files", "capture.failed_files", "capture.total_bytes", "storage.current_bytes", "storage.byte_milliseconds", "proxy.call_count", "proxy.failed_call_count", "proxy.request_bytes", "proxy.response_bytes", "proxy.duration_ms"];
-export type RunUsageSampleMetric = (typeof RUN_USAGE_SAMPLE_METRICS)[number];
-export interface RunUsageSampleSource {
-    readonly type: RunUsageSampleSourceType;
-    readonly id: string;
-    readonly observedAt?: string;
-}
-export interface RunUsageSample {
-    readonly schemaVersion: typeof RUN_USAGE_SAMPLE_SCHEMA_VERSION;
-    readonly sampleId?: string;
-    readonly runId?: string;
-    readonly metric: RunUsageSampleMetric;
-    readonly unit: RunUsageSampleUnit;
-    readonly quantity: number;
-    readonly source: RunUsageSampleSource;
-    readonly provider?: RunProvider | string;
-    readonly model?: string;
-    readonly recordedAt?: string;
-}
-export type RunUsageSampleInput = Omit<RunUsageSample, "schemaVersion" | "unit"> & {
-    readonly unit?: RunUsageSampleUnit;
-};
-export interface RunCostSourceSummary {
-    readonly sampleCount: number;
-    readonly metrics?: readonly RunUsageSampleMetric[];
-    readonly sourceTypes?: readonly RunUsageSampleSourceType[];
-    readonly sourceSampleIds?: readonly string[];
-}
-export interface RunCostDurations {
-    readonly queuedMs?: number;
-    readonly runtimeMs?: number;
-    readonly outputCaptureMs?: number;
-    readonly cleanupMs?: number;
-    readonly totalMs?: number;
-}
-export interface RunCostOutputTelemetry {
-    readonly discoveredFiles?: number;
-    readonly capturedFiles?: number;
-    readonly failedFiles?: number;
-    readonly capturedBytes?: number;
-}
-export interface RunCostRetryTelemetry {
-    readonly runtimeAttempts?: number;
-    readonly providerPollRetries?: number;
-    readonly outputCaptureRetries?: number;
-    readonly outputUploadRetries?: number;
-}
-export interface RunCostCaptureTelemetry {
-    readonly attempted: boolean;
-    readonly uploadedFiles?: number;
-    readonly failedFiles?: number;
-    readonly totalBytes?: number;
-    readonly failureReasons?: readonly string[];
-}
-export interface RunCostProviderUsage {
-    readonly provider: RunProvider | string;
-    readonly model?: string;
-    readonly inputTokens?: number;
-    readonly outputTokens?: number;
-    readonly cacheReadInputTokens?: number;
-    readonly cacheCreationInputTokens?: number;
-    readonly totalTokens?: number;
-    readonly sourceEventId?: string;
-    readonly sourceSampleIds?: readonly string[];
-}
-export interface RunCostStorageTelemetry {
-    readonly storedBytes?: number;
-    readonly byteMilliseconds?: number;
-}
-export interface RunCostProxyTelemetry {
-    readonly calls?: number;
-    readonly failedCalls?: number;
-    readonly requestBytes?: number;
-    readonly responseBytes?: number;
-    readonly durationMs?: number;
-}
-/**
- * The basis for a {@link RunCostTelemetry.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
- * figure was derived under stays internal (recorded only in the platform's
- * internal raw-usage export).
- */
-export declare const RUN_COST_BASIS_STATUSES: readonly ["estimated", "reconciled"];
-export type RunCostBasisStatus = (typeof RUN_COST_BASIS_STATUSES)[number];
-export interface RunCostBasis {
-    readonly currency: "USD";
-    readonly status: RunCostBasisStatus;
-}
-export interface RunCostTelemetry {
-    readonly schemaVersion: typeof RUN_COST_TELEMETRY_SCHEMA_VERSION;
-    readonly runId?: string;
-    readonly provider?: RunProvider | string;
-    readonly recordedAt?: string;
-    readonly status?: RunCostSummaryStatus;
-    readonly sourceSummary?: RunCostSourceSummary;
-    readonly durations?: RunCostDurations;
-    readonly outputs?: RunCostOutputTelemetry;
-    readonly retries?: RunCostRetryTelemetry;
-    readonly capture?: RunCostCaptureTelemetry;
-    readonly providerUsage?: readonly RunCostProviderUsage[];
-    readonly storage?: RunCostStorageTelemetry;
-    readonly proxy?: RunCostProxyTelemetry;
-    /**
-     * Customer-facing AEX cost of serving this run, USD — a REPORTED ESTIMATE,
-     * not a charge (telemetry/showback only; no invoicing or credit deduction).
-     * = rawCostUsd × marginMultiplier (margin currently a global 1.0). EXCLUDES
-     * the customer's BYOK provider spend. The raw (pre-margin) figure is kept
-     * internal and never appears on this public-safe shape. A plain number, so it
-     * passes the run-record public-safe archive scan. Absent when the run incurred
-     * no priced AEX usage.
-     */
-    readonly billedCostUsd?: number;
-    /** Currency + estimate/reconciled basis for {@link billedCostUsd}. */
-    readonly costBasis?: RunCostBasis;
-}
-export type RunCostTelemetryInput = Omit<RunCostTelemetry, "schemaVersion">;
-export interface RunCostTelemetryFromUsageSamplesInput {
-    readonly runId?: string;
-    readonly provider?: RunProvider | string;
-    readonly recordedAt?: string;
-    readonly status?: RunCostSummaryStatus;
-    readonly samples: readonly RunUsageSampleInput[];
-}
-export declare function buildRunUsageSample(input: RunUsageSampleInput): RunUsageSample;
-export declare function buildRunCostTelemetry(input: RunCostTelemetryInput): RunCostTelemetry;
-export declare function buildRunCostTelemetryFromUsageSamples(input: RunCostTelemetryFromUsageSamplesInput): RunCostTelemetry;
-export declare function summarizeUsageSamples(samples: readonly RunUsageSampleInput[]): RunCostSourceSummary;
-export declare function mergeRunCostTelemetry(base: RunCostTelemetry, next: RunCostTelemetryInput): RunCostTelemetry;

package/dist/_contracts/run-record.d.ts

@@ -1,116 +0,0 @@
-import type { RunCostTelemetry } from "./run-cost.js";
-import { type CustodyManifestV1, type CustodyRedactionFinding } from "./run-custody.js";
-import type { AexEvent } from "./event-envelope.js";
-import type { Run, Output } from "./runtime-types.js";
-import type { PlatformSubmission } from "./submission.js";
-export declare const RUN_RECORD_SCHEMA_VERSION: "aex.run-record.v1";
-export declare const RUN_RECORD_MANIFEST_SCHEMA_VERSION: "aex.run-record.manifest.v1";
-export type RunRecordArchiveNamespaceV1 = "metadata" | "events" | "outputs";
-export type RunRecordFileStatusV1 = "present" | "absent" | "pending" | "unavailable" | "not_applicable" | "error";
-export type RunRecordArchiveFileRoleV1 = "run_metadata" | "submission_snapshot" | "cost" | "custody" | "typed_events" | "coordinator_events_manifest" | "output";
-export interface RunRecordSubmissionSnapshotV1 {
-    readonly submission: PlatformSubmission;
-}
-export interface RunRecordCostV1 {
-    readonly status: RunRecordFileStatusV1;
-    readonly telemetry?: RunCostTelemetry;
-}
-export interface RunRecordMetadataV1 {
-    readonly run: Run;
-    readonly submission?: RunRecordSubmissionSnapshotV1;
-    readonly cost?: RunRecordCostV1;
-    readonly custody?: CustodyManifestV1;
-}
-export interface RunRecordEventsV1 {
-    /** Typed `channel: "event"` records in the SDK `events/events.jsonl` export. */
-    readonly typed: readonly AexEvent[];
-}
-export interface RunRecordV1 {
-    readonly schemaVersion: typeof RUN_RECORD_SCHEMA_VERSION;
-    readonly runId: string;
-    readonly metadata: RunRecordMetadataV1;
-    readonly events: RunRecordEventsV1;
-    readonly outputs: readonly Output[];
-    readonly manifest: RunRecordManifestV1;
-}
-export interface RunRecordNamespaceV1 {
-    readonly name: RunRecordArchiveNamespaceV1;
-    readonly prefix: `${RunRecordArchiveNamespaceV1}/`;
-    readonly status: RunRecordFileStatusV1;
-    readonly description: string;
-}
-export interface RunRecordArchiveFileV1 {
-    readonly namespace: RunRecordArchiveNamespaceV1;
-    readonly path: string;
-    readonly role: RunRecordArchiveFileRoleV1;
-    readonly status: RunRecordFileStatusV1;
-    readonly id?: string;
-    readonly filename?: string | null;
-    readonly sizeBytes?: number;
-    readonly contentType?: string;
-    readonly recordCount?: number;
-}
-export interface RunRecordArtifactSummaryV1 {
-    readonly id: string;
-    readonly filename: string | null;
-    readonly sizeBytes?: number;
-    readonly contentType?: string;
-}
-export interface RunRecordDownloadErrorV1 {
-    readonly namespace: "outputs";
-    readonly id: string;
-    readonly filename: string | null;
-    readonly message: string;
-}
-export interface RunRecordManifestV1 {
-    readonly schemaVersion: typeof RUN_RECORD_MANIFEST_SCHEMA_VERSION;
-    readonly runRecordSchemaVersion: typeof RUN_RECORD_SCHEMA_VERSION;
-    readonly runId: string;
-    readonly namespaces: readonly RunRecordNamespaceV1[];
-    readonly files: readonly RunRecordArchiveFileV1[];
-    /**
-     * Compatibility aliases for existing consumers of `manifest.json`.
-     * Prefer `files[]` for new code because it carries namespace, role, and
-     * presence state for optional run-record members.
-     */
-    readonly outputs: readonly RunRecordArtifactSummaryV1[];
-    readonly errors: readonly RunRecordDownloadErrorV1[];
-}
-export interface BuildRunRecordDownloadManifestV1Input {
-    readonly runId: string;
-    readonly outputs: readonly RunRecordArtifactSummaryV1[];
-    readonly errors?: readonly RunRecordDownloadErrorV1[];
-    readonly typedEventCount?: number;
-    readonly submission?: RunRecordFileManifestInputV1;
-    readonly cost?: RunRecordFileManifestInputV1;
-    readonly custody?: RunRecordFileManifestInputV1;
-    readonly coordinatorEventsManifest?: RunRecordFileManifestInputV1;
-}
-export interface RunRecordFileManifestInputV1 {
-    readonly status: RunRecordFileStatusV1;
-    readonly recordCount?: number;
-}
-export interface RunRecordArchiveEntryForRedactionV1 {
-    readonly path: string;
-    readonly bytes: Uint8Array;
-    readonly contentType?: string;
-    /**
-     * Customer-authored output bytes are intentionally outside the public-record
-     * redaction guarantee. Metadata, event exports, and manifests remain scanned.
-     */
-    readonly customerContent?: boolean;
-}
-export interface RunRecordArchiveRedactionFindingV1 {
-    readonly entryPath: string;
-    readonly path: string;
-    readonly reason: CustodyRedactionFinding["reason"];
-    readonly valueLength?: number;
-}
-export declare class RunRecordArchiveRedactionError extends Error {
-    readonly code = "run_record_archive_not_public_safe";
-    readonly findings: readonly RunRecordArchiveRedactionFindingV1[];
-    constructor(findings: readonly RunRecordArchiveRedactionFindingV1[]);
-}
-export declare function buildRunRecordDownloadManifestV1(input: BuildRunRecordDownloadManifestV1Input): RunRecordManifestV1;
-export declare function scanRunRecordArchiveEntriesV1(entries: readonly RunRecordArchiveEntryForRedactionV1[]): readonly RunRecordArchiveRedactionFindingV1[];
-export declare function assertRunRecordArchivePublicSafeV1(entries: readonly RunRecordArchiveEntryForRedactionV1[]): void;