@aexhq/sdk 0.40.16 → 0.41.0

package/dist/_contracts/provider-support.d.ts

@@ -1,4 +1,4 @@
-import type { RunProvider } from "./submission.js";
+import type { ProviderName } from "./submission.js";
 export interface SupportPointer {
     readonly label: string;
     /** Markdown href, relative to `packages/sdk/docs/provider-runtime-capabilities.md`. */
@@ -224,4 +224,4 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
         }];
     };
 };
-export declare function providerPublicSupport(provider: RunProvider): ProviderPublicSupport;
+export declare function providerPublicSupport(provider: ProviderName): ProviderPublicSupport;

package/dist/_contracts/runner-event.d.ts

@@ -2,8 +2,8 @@
  * Unified runner event schema. The managed runtime feeds one shape into
  * the hosted aex event pipeline:
  *
- *   - The per-run managed runtime POSTs batches of NDJSON events to
- *     `/runs/{id}/runner/events`; the runtime adapter translates each
+ *   - The per-session managed runtime POSTs batches of NDJSON events to
+ *     `/sessions/{id}/runner/events`; the runtime adapter translates each
  *     event into one or more `RunnerEvent`s.
  *
  * The downstream subscribers (dashboard, SDK `streamEvents`, observable
@@ -37,9 +37,9 @@ export declare const RUNNER_EVENT_VERSION: 1;
  *   - `notification`     — runtime/extension notification; catch-all
  *                          for diagnostic data.
  *   - `stream_error`     — stream-level error (non-fatal). Subscribers
- *                          may surface this as a UI warning; the run
+ *                          may surface this as a UI warning; the session
  *                          continues unless `runtime_terminal` follows.
- *   - `runtime_terminal` — the run reached a terminal state. The
+ *   - `runtime_terminal` — the session reached a terminal state. The
  *                          adapter MUST emit exactly one of these per
  *                          run; subscribers gate on it for end-of-stream.
  */
@@ -48,7 +48,7 @@ export type RunnerEventKind = (typeof RUNNER_EVENT_KINDS)[number];
 /**
  * One event in the unified stream. `seq` is monotonically increasing
  * within a single run (the adapter is responsible for assigning seqs
- * — no two events with the same `seq` for the same `runId`); `tMs` is
+ * — no two events with the same `seq` for the same `sessionId`); `tMs` is
  * a millisecond-resolution timestamp that is also monotonically
  * non-decreasing within a single run (an event's `tMs` is never less
  * than the previous event's `tMs`). `data` carries the runtime- and
@@ -69,7 +69,7 @@ export interface RunnerEvent {
  */
 export interface RunnerEventBatch {
     readonly v: typeof RUNNER_EVENT_VERSION;
-    readonly runId: string;
+    readonly sessionId: string;
     readonly events: readonly RunnerEvent[];
 }
 /**
@@ -93,7 +93,7 @@ export type RunnerEventBatchValidation = {
     readonly code: RunnerEventBatchValidationCode;
     readonly message: string;
 };
-export declare const RUNNER_EVENT_BATCH_VALIDATION_CODES: readonly ["invalid_envelope", "version_mismatch", "missing_run_id", "empty_batch", "batch_too_large", "invalid_event", "seq_not_monotonic", "t_ms_not_monotonic"];
+export declare const RUNNER_EVENT_BATCH_VALIDATION_CODES: readonly ["invalid_envelope", "version_mismatch", "missing_session_id", "empty_batch", "batch_too_large", "invalid_event", "seq_not_monotonic", "t_ms_not_monotonic"];
 export type RunnerEventBatchValidationCode = (typeof RUNNER_EVENT_BATCH_VALIDATION_CODES)[number];
 /**
  * Parse + validate an inbound runner event batch (untrusted input).
@@ -103,7 +103,7 @@ export type RunnerEventBatchValidationCode = (typeof RUNNER_EVENT_BATCH_VALIDATI
  * Successful validation guarantees:
  *   - top-level envelope matches {@link RunnerEventBatch}
  *   - `v === RUNNER_EVENT_VERSION`
- *   - `runId` is a non-empty string
+ *   - `sessionId` is a non-empty string
  *   - `events` is a non-empty array of at most
  *     {@link RUNNER_EVENT_BATCH_MAX_EVENTS} entries
  *   - each event is a {@link RunnerEvent} with a known `kind`

package/dist/_contracts/runner-event.js

@@ -2,8 +2,8 @@
  * Unified runner event schema. The managed runtime feeds one shape into
  * the hosted aex event pipeline:
  *
- *   - The per-run managed runtime POSTs batches of NDJSON events to
- *     `/runs/{id}/runner/events`; the runtime adapter translates each
+ *   - The per-session managed runtime POSTs batches of NDJSON events to
+ *     `/sessions/{id}/runner/events`; the runtime adapter translates each
  *     event into one or more `RunnerEvent`s.
  *
  * The downstream subscribers (dashboard, SDK `streamEvents`, observable
@@ -36,9 +36,9 @@ export const RUNNER_EVENT_VERSION = 1;
  *   - `notification`     — runtime/extension notification; catch-all
  *                          for diagnostic data.
  *   - `stream_error`     — stream-level error (non-fatal). Subscribers
- *                          may surface this as a UI warning; the run
+ *                          may surface this as a UI warning; the session
  *                          continues unless `runtime_terminal` follows.
- *   - `runtime_terminal` — the run reached a terminal state. The
+ *   - `runtime_terminal` — the session reached a terminal state. The
  *                          adapter MUST emit exactly one of these per
  *                          run; subscribers gate on it for end-of-stream.
  */
@@ -63,7 +63,7 @@ export const RUNNER_EVENT_BATCH_MAX_EVENTS = 256;
 export const RUNNER_EVENT_BATCH_VALIDATION_CODES = [
     "invalid_envelope",
     "version_mismatch",
-    "missing_run_id",
+    "missing_session_id",
     "empty_batch",
     "batch_too_large",
     "invalid_event",
@@ -78,7 +78,7 @@ export const RUNNER_EVENT_BATCH_VALIDATION_CODES = [
  * Successful validation guarantees:
  *   - top-level envelope matches {@link RunnerEventBatch}
  *   - `v === RUNNER_EVENT_VERSION`
- *   - `runId` is a non-empty string
+ *   - `sessionId` is a non-empty string
  *   - `events` is a non-empty array of at most
  *     {@link RUNNER_EVENT_BATCH_MAX_EVENTS} entries
  *   - each event is a {@link RunnerEvent} with a known `kind`
@@ -92,8 +92,8 @@ export function validateRunnerEventBatch(input) {
     if (input.v !== RUNNER_EVENT_VERSION) {
         return invalid("version_mismatch", `batch.v must equal ${RUNNER_EVENT_VERSION} (got ${JSON.stringify(input.v)})`);
     }
-    if (typeof input.runId !== "string" || input.runId.length === 0) {
-        return invalid("missing_run_id", "batch.runId must be a non-empty string");
+    if (typeof input.sessionId !== "string" || input.sessionId.length === 0) {
+        return invalid("missing_session_id", "batch.sessionId must be a non-empty string");
     }
     if (!Array.isArray(input.events) || input.events.length === 0) {
         return invalid("empty_batch", "batch.events must be a non-empty array");
@@ -148,7 +148,7 @@ export function validateRunnerEventBatch(input) {
     }
     return {
         ok: true,
-        batch: { v: RUNNER_EVENT_VERSION, runId: input.runId, events: Object.freeze(events) }
+        batch: { v: RUNNER_EVENT_VERSION, sessionId: input.sessionId, events: Object.freeze(events) }
     };
 }
 function invalid(code, message) {

package/dist/_contracts/runtime-manifest.d.ts

@@ -1,13 +1,13 @@
-import type { RunProvider } from "./submission.js";
+import type { ProviderName } from "./submission.js";
 /**
- * Runtime manifest: the per-run description of where
+ * Runtime manifest: the per-session description of where
  * aex places things inside the agent container, plus the merged
  * env-var bag delivered via `RUNTIME.env` / `RUNTIME.json`.
  *
- * The hosted API computes a manifest at submitRun-response time
+ * The hosted API computes a manifest at startSessionRecord-response time
  * from the validated submission via {@link buildRuntimeManifest} and
  * echoes it on the wire as
- * `Run.runtimeManifest`, so caller code (anyone rendering catalog markdown
+ * `SessionRecord.runtimeManifest`, so caller code (anyone rendering catalog markdown
  * pre-submission, or resolving aex's in-container path strings) doesn't
  * have to guess.
  * The managed runtime materialises the actual `RUNTIME.env` / `RUNTIME.json`
@@ -16,7 +16,7 @@ import type { RunProvider } from "./submission.js";
  *
  * Manifest values are derived, never persisted separately — the source
  * of truth for the customer half remains `submission.environment.envVars`
- * on the run row; the aex half is constant for a given SDK version.
+ * on the session row; the aex half is constant for a given SDK version.
  */
 /**
  * The in-container paths the agent and skill code reference at
@@ -30,18 +30,18 @@ import type { RunProvider } from "./submission.js";
  * under `/mnt/session/uploads/`.
  */
 export interface RuntimeManifest {
-    readonly provider: RunProvider | string;
+    readonly provider: ProviderName | string;
     /** Where skill bundles auto-discover in the managed runner. */
     readonly skillsRoot: string;
     /** Parent dir of File mounts: `<filesRoot>/<f_id>/<rel-path>`. */
     readonly filesRoot: string;
     /** Parent dir of non-SKILL.md asset mounts: `<assetsRoot>/<skl_id>/<rel-path>`. */
     readonly assetsRoot: string;
-    /** Absolute path of the in-container aex runtime bridge (invoke via `bun`). */
+    /** Absolute path of the in-container aex starttime bridge (invoke via `bun`). */
     readonly aexCli: string;
-    /** Absolute path of the in-container aex runtime index. */
+    /** Absolute path of the in-container aex starttime index. */
     readonly indexJson: string;
-    /** Absolute path of the always-mounted aex runtime contract README. */
+    /** Absolute path of the always-mounted aex starttime contract README. */
     readonly readme: string;
     /** Absolute path of the machine-readable manifest mirror. */
     readonly runtimeJson: string;
@@ -60,11 +60,11 @@ export interface RuntimeManifest {
      * caller can learn where a handed file landed. `mountPath` is the validated
      * directory the archive unzipped into (the SDK default is `/workspace`); a
      * single file lands at `<mountPath>/<realFilename>`, a folder lands its entries
-     * under `<mountPath>/`. Empty when the run carried no files.
+     * under `<mountPath>/`. Empty when the session carried no files.
      */
     readonly mountedFiles: readonly MountedFileManifest[];
 }
-/** One submitted `File`'s resolved mount directory (surfaced on the Run record). */
+/** One submitted `File`'s resolved mount directory (surfaced on the Session record). */
 export interface MountedFileManifest {
     /** The file's storage slug (`FileRef.name`). */
     readonly name: string;
@@ -89,7 +89,7 @@ declare const RUNTIME_PATHS: Readonly<{
 }>;
 export declare function runtimePaths(): typeof RUNTIME_PATHS;
 export interface BuildRuntimeManifestInput {
-    readonly provider: RunProvider | string;
+    readonly provider: ProviderName | string;
     /**
      * Customer-supplied `environment.envVars` from the validated
      * submission. Keys with the reserved `AEX_` prefix are

package/dist/_contracts/runtime-manifest.js

@@ -26,7 +26,7 @@ export function runtimePaths() {
 const AEX_PREFIX = "AEX_";
 /**
  * Default mount DIRECTORY for a `File` with no explicit `mountPath`. Mirrors
- * `DEFAULT_FILE_MOUNT_PATH` in `run-config.ts`; duplicated here so this module
+ * `DEFAULT_FILE_MOUNT_PATH` in `session-config.ts`; duplicated here so this module
  * stays self-contained (tree-shakeable) — the same reason {@link AEX_PREFIX}
  * is inlined rather than imported from the submission parser.
  */

package/dist/_contracts/runtime-sizes.d.ts

@@ -12,7 +12,7 @@ export interface RuntimeResources {
 /**
  * The single source of truth: every offered preset, keyed by its wire token.
  * Tokens intentionally remain stable product presets. The smallest
- * (`shared-0.06x-256mb`) tier is for light / IO-bound runs only.
+ * (`shared-0.06x-256mb`) tier is for light / IO-bound sessions only.
  */
 export declare const RUNTIME_SIZE_PRESETS: {
     readonly "shared-0.06x-256mb": {
@@ -65,12 +65,12 @@ export declare function runtimeResources(size: RuntimeSize): RuntimeResources;
  * consumers apply {@link DEFAULT_RUNTIME_SIZE}.
  */
 export declare function parseRuntimeSize(input: unknown): RuntimeSize | undefined;
-/** Default run deadline when `timeout` is omitted (8 hours). */
-export declare const DEFAULT_RUN_TIMEOUT_MS: number;
-/** Hard ceiling on a run deadline (8 hours). */
-export declare const MAX_RUN_TIMEOUT_MS: number;
-/** Floor on a run deadline (1 minute). */
-export declare const MIN_RUN_TIMEOUT_MS: number;
+/** Default session deadline when `timeout` is omitted (8 hours). */
+export declare const DEFAULT_SESSION_TIMEOUT_MS: number;
+/** Hard ceiling on a session deadline (8 hours). */
+export declare const MAX_SESSION_TIMEOUT_MS: number;
+/** Floor on a session deadline (1 minute). */
+export declare const MIN_SESSION_TIMEOUT_MS: number;
 /**
  * Parse a human duration string (`"1h"`, `"90m"`, `"3600s"`, `"500ms"`, or a
  * bare-ms integer) into milliseconds. Throws on malformed input.
@@ -79,17 +79,17 @@ export declare function parseDurationToMs(input: string): number;
 /**
  * Validate the wire `timeout` field (a duration string) into a bounded ms
  * value. `undefined` (omitted) returns `undefined`; the consumer applies
- * {@link DEFAULT_RUN_TIMEOUT_MS}.
+ * {@link DEFAULT_SESSION_TIMEOUT_MS}.
  */
-export declare function parseRunTimeout(input: unknown): number | undefined;
+export declare function parseSessionTimeout(input: unknown): number | undefined;
 /** Apply the default when a parsed `timeoutMs` is absent. */
-export declare function resolveRunTimeoutMs(timeoutMs: number | undefined): number;
+export declare function resolveSessionTimeoutMs(timeoutMs: number | undefined): number;
 /** Format a millisecond deadline as a second-granularity duration string. */
 export declare function orchestrationTimeoutString(ms: number): string;
 /** Runtime process: time to wait after graceful interrupt before hard kill. */
-export declare const RUN_PROCESS_KILL_GRACE_MS: number;
+export declare const SESSION_PROCESS_KILL_GRACE_MS: number;
 /**
  * Orchestrator: extra window past `timeoutMs` to wait for terminal callback
  * before host-level cleanup.
  */
-export declare const RUN_TERMINAL_GRACE_MS: number;
+export declare const SESSION_TERMINAL_GRACE_MS: number;

package/dist/_contracts/runtime-sizes.js

@@ -8,7 +8,7 @@
 /**
  * The single source of truth: every offered preset, keyed by its wire token.
  * Tokens intentionally remain stable product presets. The smallest
- * (`shared-0.06x-256mb`) tier is for light / IO-bound runs only.
+ * (`shared-0.06x-256mb`) tier is for light / IO-bound sessions only.
  */
 export const RUNTIME_SIZE_PRESETS = {
     "shared-0.06x-256mb": { cpus: 0.0625, memoryMb: 256 },
@@ -52,14 +52,14 @@ export function parseRuntimeSize(input) {
     return input;
 }
 // ===========================================================================
-// Run timeout
+// SessionRecord timeout
 // ===========================================================================
-/** Default run deadline when `timeout` is omitted (8 hours). */
-export const DEFAULT_RUN_TIMEOUT_MS = 8 * 60 * 60 * 1000;
-/** Hard ceiling on a run deadline (8 hours). */
-export const MAX_RUN_TIMEOUT_MS = 8 * 60 * 60 * 1000;
-/** Floor on a run deadline (1 minute). */
-export const MIN_RUN_TIMEOUT_MS = 60 * 1000;
+/** Default session deadline when `timeout` is omitted (8 hours). */
+export const DEFAULT_SESSION_TIMEOUT_MS = 8 * 60 * 60 * 1000;
+/** Hard ceiling on a session deadline (8 hours). */
+export const MAX_SESSION_TIMEOUT_MS = 8 * 60 * 60 * 1000;
+/** Floor on a session deadline (1 minute). */
+export const MIN_SESSION_TIMEOUT_MS = 60 * 1000;
 const DURATION_PATTERN = /^(\d+(?:\.\d+)?)(ms|s|m|h)?$/;
 /**
  * Parse a human duration string (`"1h"`, `"90m"`, `"3600s"`, `"500ms"`, or a
@@ -81,9 +81,9 @@ export function parseDurationToMs(input) {
 /**
  * Validate the wire `timeout` field (a duration string) into a bounded ms
  * value. `undefined` (omitted) returns `undefined`; the consumer applies
- * {@link DEFAULT_RUN_TIMEOUT_MS}.
+ * {@link DEFAULT_SESSION_TIMEOUT_MS}.
  */
-export function parseRunTimeout(input) {
+export function parseSessionTimeout(input) {
     if (input === undefined) {
         return undefined;
     }
@@ -91,26 +91,26 @@ export 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;
 }
 /** Apply the default when a parsed `timeoutMs` is absent. */
-export function resolveRunTimeoutMs(timeoutMs) {
-    return timeoutMs ?? DEFAULT_RUN_TIMEOUT_MS;
+export function resolveSessionTimeoutMs(timeoutMs) {
+    return timeoutMs ?? DEFAULT_SESSION_TIMEOUT_MS;
 }
 /** Format a millisecond deadline as a second-granularity duration string. */
 export function orchestrationTimeoutString(ms) {
     return `${Math.max(1, Math.ceil(ms / 1000))}s`;
 }
 /** Runtime process: time to wait after graceful interrupt before hard kill. */
-export const RUN_PROCESS_KILL_GRACE_MS = 60 * 1000;
+export const SESSION_PROCESS_KILL_GRACE_MS = 60 * 1000;
 /**
  * Orchestrator: extra window past `timeoutMs` to wait for terminal callback
  * before host-level cleanup.
  */
-export const RUN_TERMINAL_GRACE_MS = 90 * 1000;
+export const SESSION_TERMINAL_GRACE_MS = 90 * 1000;