@aexhq/sdk 0.32.0 → 0.33.1

package/dist/cli.mjs

@@ -11700,14 +11700,14 @@ var init_client = __esm({
         return { req, url, timeout: options.timeout };
       }
       async buildHeaders({ options, method, bodyHeaders, retryCount }) {
-        let idempotencyHeaders = {};
+        let idempotencyHeaders2 = {};
         if (this.idempotencyHeader && method !== "get") {
           if (!options.idempotencyKey)
             options.idempotencyKey = this.defaultIdempotencyKey();
-          idempotencyHeaders[this.idempotencyHeader] = options.idempotencyKey;
+          idempotencyHeaders2[this.idempotencyHeader] = options.idempotencyKey;
         }
         const headers = buildHeaders([
-          idempotencyHeaders,
+          idempotencyHeaders2,
           {
             Accept: "application/json",
             "User-Agent": this.getUserAgent(),
@@ -12013,96 +12013,6 @@ var TERMINAL_RUN_STATUSES = [
 ];
 var terminalRunStatuses = new Set(TERMINAL_RUN_STATUSES);
 
-// ../contracts/dist/runtime-sizes.js
-var RUNTIME_SIZE_PRESETS = {
-  "shared-0.06x-256mb": { cpus: 0.0625, memoryMb: 256 },
-  "shared-0.25x-1gb": { cpus: 0.25, memoryMb: 1024 },
-  "shared-0.5x-4gb": { cpus: 0.5, memoryMb: 4096 },
-  "shared-1x-6gb": { cpus: 1, memoryMb: 6144 },
-  "shared-2x-8gb": { cpus: 2, memoryMb: 8192 },
-  "shared-4x-12gb": { cpus: 4, memoryMb: 12288 }
-};
-var RUNTIME_SIZES = Object.keys(RUNTIME_SIZE_PRESETS);
-var DEFAULT_RUNTIME_SIZE = "shared-0.25x-1gb";
-var DEFAULT_RUN_TIMEOUT_MS = 60 * 60 * 1e3;
-var MAX_RUN_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
-var MIN_RUN_TIMEOUT_MS = 60 * 1e3;
-var DURATION_PATTERN = /^(\d+(?:\.\d+)?)(ms|s|m|h)?$/;
-function parseDurationToMs(input) {
-  const match = DURATION_PATTERN.exec(input.trim());
-  if (!match) {
-    throw new Error(`invalid duration ${JSON.stringify(input)} (expected e.g. "1h", "90m", "30s", "500ms", or a bare ms integer)`);
-  }
-  const value = Number(match[1]);
-  if (!Number.isFinite(value) || value < 0) {
-    throw new Error(`invalid duration ${JSON.stringify(input)} (must be a non-negative number)`);
-  }
-  const unit = match[2] ?? "ms";
-  const factor = unit === "h" ? 36e5 : unit === "m" ? 6e4 : unit === "s" ? 1e3 : 1;
-  return Math.round(value * factor);
-}
-var RUN_PROCESS_KILL_GRACE_MS = 60 * 1e3;
-var RUN_TERMINAL_GRACE_MS = 90 * 1e3;
-
-// ../contracts/dist/post-hook.js
-var DEFAULT_POST_HOOK_TIMEOUT_MS = 5 * 60 * 1e3;
-var DEFAULT_POST_HOOK_MAX_TURNS = 10;
-function parsePostHook(input, path5 = "postHook") {
-  if (input === void 0 || input === null) {
-    return void 0;
-  }
-  const value = requirePostHookRecord(input, path5);
-  const allowed = /* @__PURE__ */ new Set(["command", "timeout", "maxTurns", "maxChars"]);
-  for (const key of Object.keys(value)) {
-    if (!allowed.has(key)) {
-      throw new Error(`${path5}.${key} is not an allowed field; permitted: command, timeout, maxTurns, maxChars`);
-    }
-  }
-  if (typeof value.command !== "string") {
-    throw new Error(`${path5}.command must be a string`);
-  }
-  if (value.command.trim().length === 0) {
-    return void 0;
-  }
-  const timeoutMs = parsePostHookTimeout(value.timeout, `${path5}.timeout`);
-  const maxTurns = parseNonNegativeInteger(value.maxTurns, `${path5}.maxTurns`, DEFAULT_POST_HOOK_MAX_TURNS);
-  const maxChars = value.maxChars === null ? null : parseNonNegativeInteger(value.maxChars, `${path5}.maxChars`, null);
-  return {
-    command: value.command,
-    timeoutMs,
-    maxTurns,
-    maxChars
-  };
-}
-function parsePostHookTimeout(input, path5) {
-  if (input === void 0) {
-    return DEFAULT_POST_HOOK_TIMEOUT_MS;
-  }
-  if (typeof input !== "string") {
-    throw new Error(`${path5} must be a duration string (e.g. "5m", "30s"); got ${JSON.stringify(input)}`);
-  }
-  const ms = parseDurationToMs(input);
-  if (ms <= 0) {
-    throw new Error(`${path5} must be greater than 0ms; got ${ms}ms`);
-  }
-  return ms;
-}
-function parseNonNegativeInteger(input, path5, defaultValue) {
-  if (input === void 0) {
-    return defaultValue;
-  }
-  if (typeof input !== "number" || !Number.isSafeInteger(input) || input < 0) {
-    throw new Error(`${path5} must be a non-negative integer`);
-  }
-  return input;
-}
-function requirePostHookRecord(input, path5) {
-  if (input === null || typeof input !== "object" || Array.isArray(input)) {
-    throw new Error(`${path5} must be an object`);
-  }
-  return input;
-}
-
 // ../contracts/dist/run-config.js
 var SKILL_BUNDLE_LIMITS = {
   /** Compressed (.zip) ceiling. */
@@ -12414,7 +12324,6 @@ function parseRunRequestConfig(input) {
     "environment",
     "runtimeSize",
     "timeout",
-    "postHook",
     "proxyEndpoints",
     "metadata"
   ]);
@@ -12431,7 +12340,6 @@ function parseRunRequestConfig(input) {
   const prompt = parseRunRequestConfigPrompt(record.prompt);
   const skills = parseRunRequestConfigSkills(record.skills);
   const mcpServers = parseRunRequestConfigMcpServers(record.mcpServers);
-  const postHook = parsePostHook(record.postHook, "run request config postHook");
   return {
     model,
     ...system !== void 0 ? { system } : {},
@@ -12445,7 +12353,6 @@ function parseRunRequestConfig(input) {
     ...record.environment !== void 0 ? { environment: record.environment } : {},
     ...record.runtimeSize !== void 0 ? { runtimeSize: record.runtimeSize } : {},
     ...record.timeout !== void 0 ? { timeout: record.timeout } : {},
-    ...postHook !== void 0 ? { postHook: record.postHook } : {},
     ...record.proxyEndpoints !== void 0 ? { proxyEndpoints: record.proxyEndpoints } : {},
     ...record.metadata !== void 0 ? { metadata: record.metadata } : {}
   };
@@ -12500,6 +12407,23 @@ function parseRunRequestConfigMcpServers(value) {
   });
 }
 
+// ../contracts/dist/runtime-sizes.js
+var RUNTIME_SIZE_PRESETS = {
+  "shared-0.06x-256mb": { cpus: 0.0625, memoryMb: 256 },
+  "shared-0.25x-1gb": { cpus: 0.25, memoryMb: 1024 },
+  "shared-0.5x-4gb": { cpus: 0.5, memoryMb: 4096 },
+  "shared-1x-6gb": { cpus: 1, memoryMb: 6144 },
+  "shared-2x-8gb": { cpus: 2, memoryMb: 8192 },
+  "shared-4x-12gb": { cpus: 4, memoryMb: 12288 }
+};
+var RUNTIME_SIZES = Object.keys(RUNTIME_SIZE_PRESETS);
+var DEFAULT_RUNTIME_SIZE = "shared-0.25x-1gb";
+var DEFAULT_RUN_TIMEOUT_MS = 60 * 60 * 1e3;
+var MAX_RUN_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
+var MIN_RUN_TIMEOUT_MS = 60 * 1e3;
+var RUN_PROCESS_KILL_GRACE_MS = 60 * 1e3;
+var RUN_TERMINAL_GRACE_MS = 90 * 1e3;
+
 // ../contracts/dist/runtime-security-profile.js
 var RUNTIME_SECURITY_PROFILE_CONFIG = Object.freeze({
   strict: Object.freeze({
@@ -13383,14 +13307,17 @@ __export(operations_exports, {
   READ_OUTPUT_TEXT_DEFAULT_BYTES: () => READ_OUTPUT_TEXT_DEFAULT_BYTES,
   READ_OUTPUT_TEXT_MAX_BYTES: () => READ_OUTPUT_TEXT_MAX_BYTES,
   cancelRun: () => cancelRun,
+  cancelSession: () => cancelSession,
   classifyOutput: () => classifyOutput,
   createOutputLink: () => createOutputLink,
   createSecret: () => createSecret,
+  createSession: () => createSession,
   createSkillBundleDirect: () => createSkillBundleDirect,
   deleteAgentsMd: () => deleteAgentsMd,
   deleteFile: () => deleteFile,
   deleteRun: () => deleteRun,
   deleteSecret: () => deleteSecret,
+  deleteSession: () => deleteSession,
   deleteSkill: () => deleteSkill,
   deleteWorkspaceAsset: () => deleteWorkspaceAsset,
   download: () => download,
@@ -13412,6 +13339,8 @@ __export(operations_exports, {
   getRunWebhookDeliveries: () => getRunWebhookDeliveries,
   getSecret: () => getSecret,
   getSecretValue: () => getSecretValue,
+  getSession: () => getSession,
+  getSessionCoordinatorTicket: () => getSessionCoordinatorTicket,
   getSkill: () => getSkill,
   listAgentsMd: () => listAgentsMd,
   listFiles: () => listFiles,
@@ -13419,14 +13348,20 @@ __export(operations_exports, {
   listRunEvents: () => listRunEvents,
   listRuns: () => listRuns,
   listSecrets: () => listSecrets,
+  listSessionEvents: () => listSessionEvents,
+  listSessionOutputs: () => listSessionOutputs,
+  listSessions: () => listSessions,
   listSkills: () => listSkills,
   normalizeOutputLinkExpiresIn: () => normalizeOutputLinkExpiresIn,
   outputLink: () => outputLink,
   readOutputText: () => readOutputText,
   redeliverRunWebhook: () => redeliverRunWebhook,
   resolveOutputFileSelector: () => resolveOutputFileSelector,
+  resumeSession: () => resumeSession,
   rotateSecret: () => rotateSecret,
+  sendSessionMessage: () => sendSessionMessage,
   submitRun: () => submitRun,
+  suspendSession: () => suspendSession,
   uploadWorkspaceAsset: () => uploadWorkspaceAsset,
   whoami: () => whoami
 });
@@ -14167,6 +14102,79 @@ async function listRuns(http, query) {
     params.cursor = query.cursor;
   return http.request("/api/runs", {}, params);
 }
+function idempotencyHeaders(options) {
+  return options?.idempotencyKey ? { "Idempotency-Key": options.idempotencyKey } : void 0;
+}
+async function createSession(http, request, options) {
+  const headers = idempotencyHeaders(options);
+  const result = await http.request("/api/sessions", {
+    method: "POST",
+    ...headers ? { headers } : {},
+    body: JSON.stringify(request)
+  });
+  return unwrapSession(result);
+}
+async function getSession(http, sessionId) {
+  const result = await http.request(`/api/sessions/${encodeURIComponent(sessionId)}`);
+  return unwrapSession(result);
+}
+async function listSessions(http, query) {
+  const params = {};
+  if (query?.status !== void 0)
+    params.status = query.status;
+  if (query?.since !== void 0)
+    params.since = query.since;
+  if (query?.limit !== void 0)
+    params.limit = String(query.limit);
+  if (query?.cursor !== void 0)
+    params.cursor = query.cursor;
+  return http.request("/api/sessions", {}, params);
+}
+async function sendSessionMessage(http, sessionId, request, options) {
+  const headers = idempotencyHeaders(options);
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/messages`, {
+    method: "POST",
+    ...headers ? { headers } : {},
+    body: JSON.stringify(request)
+  });
+}
+async function suspendSession(http, sessionId, options) {
+  const headers = idempotencyHeaders(options);
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/suspend`, { method: "POST", ...headers ? { headers } : {} });
+}
+async function cancelSession(http, sessionId, options) {
+  const headers = idempotencyHeaders(options);
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/cancel`, { method: "POST", ...headers ? { headers } : {} });
+}
+async function resumeSession(http, sessionId, options) {
+  const headers = idempotencyHeaders(options);
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}/resume`, { method: "POST", ...headers ? { headers } : {} });
+}
+async function deleteSession(http, sessionId, options) {
+  const headers = idempotencyHeaders(options);
+  return http.request(`/api/sessions/${encodeURIComponent(sessionId)}`, { method: "DELETE", ...headers ? { headers } : {} });
+}
+async function listSessionEvents(http, sessionId) {
+  const path5 = `/api/sessions/${encodeURIComponent(sessionId)}/events`;
+  const all = [];
+  let cursor;
+  for (let page = 0; page < LIST_EVENTS_PAGE_BUDGET; page++) {
+    const query = cursor !== void 0 ? { cursor: String(cursor) } : {};
+    const result = await http.request(path5, {}, query);
+    all.push(...result.events);
+    if (typeof result.nextCursor !== "number")
+      break;
+    cursor = result.nextCursor;
+  }
+  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 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 path5 = `/api/runs/${encodeURIComponent(runId)}/events`;
@@ -14780,6 +14788,12 @@ function unwrapSkill(result) {
 function hasRun(value) {
   return Boolean(value && typeof value === "object" && "run" in value);
 }
+function unwrapSession(result) {
+  if (result && typeof result === "object" && "session" in result) {
+    return result.session;
+  }
+  return result;
+}
 async function uploadWorkspaceAsset(http, input) {
   return http.request("/assets", {
     method: "POST",
@@ -15772,7 +15786,6 @@ async function runRunCmd(io2, argv) {
     secrets,
     ...runtimeSizeFlag.value ? { runtimeSize: runtimeSizeFlag.value } : runConfig.runtimeSize ? { runtimeSize: runConfig.runtimeSize } : {},
     ...runTimeoutFlag.value ? { timeout: runTimeoutFlag.value } : runConfig.timeout ? { timeout: runConfig.timeout } : {},
-    ...runConfig.postHook ? { postHook: runConfig.postHook } : {},
     ...webhookFlag.value ? { webhook: { url: webhookFlag.value } } : {},
     ...proxyEndpoints.length > 0 ? { proxyEndpoints } : {}
   };

package/dist/cli.mjs.sha256

@@ -1 +1 @@
-91bc1e9fe17896658e7fea3117b8a16b601da0a747b121ee3628e6a95a00ddc1  cli.mjs
+ad37c1366dc0104bf96adc80f5b48d9a2b8b7cf73bc6cba0d014a3d458441855  cli.mjs

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { HttpClient, SecretString, type AexEvent, type AgentsMdRecord, type DebugSink, type FetchLike, type FileRecord, type Output, type OutputFileType, type OutputLink, type OutputLinkOptions, type OutputQuery, type OutputText, type OutputMode, type ReadOutputTextOptions, type RunListPage, type RunListQuery, type OutputSearchQuery, type OutputSearchPage, type PlatformEnvironmentInput, type PlatformSubmission, type PlatformInlineSecrets, type PlatformProxyEndpoint, type PlatformProxyEndpointAuth, type PlatformPostHookInput, type Run, type RunModel, type RunEvent, type RunTrace, type UsageSummary, type RunLimits, type RunWebhookDelivery, type RunProvider, type SecretRecord, type SecretReveal, type RunUnit, type BuiltinToolName, type RuntimeSize, type Skill as SkillRecord, type WhoAmI } from "./_contracts/index.js";
+import { HttpClient, SecretString, type AexEvent, type AgentsMdRecord, type DebugSink, type FetchLike, type FileRecord, type Output, type OutputFileType, type OutputLink, type OutputLinkOptions, type OutputQuery, type OutputText, type OutputMode, type ReadOutputTextOptions, type RunListPage, type RunListQuery, type OutputSearchQuery, type OutputSearchPage, type Session, type SessionCreateRequest, type SessionEvent, type SessionListPage, type SessionListQuery, type SessionStateChangeAccepted, type SessionTurn, type PlatformEnvironmentInput, type PlatformSubmission, type PlatformInlineSecrets, type PlatformProxyEndpoint, type PlatformProxyEndpointAuth, type Run, type RunModel, type RunEvent, type RunTrace, type UsageSummary, type RunLimits, type RunWebhookDelivery, type RunProvider, type SecretRecord, type SecretReveal, type RunUnit, type BuiltinToolName, type RuntimeSize, type Skill as SkillRecord, type WebSocketFactory, type WhoAmI } from "./_contracts/index.js";
 import { AgentsMd } from "./agents-md.js";
 import { type UploadedAsset } from "./asset-upload.js";
 import { File } from "./file.js";
@@ -110,12 +110,6 @@ export interface SubmitOptions {
      * [1m, 6h]; omit for the 1h default. Applies to both runtimes.
      */
     readonly timeout?: string;
-    /**
-     * Command to run after the agent process exits successfully. A non-zero exit
-     * or timeout is sent back to the model as a repair prompt until `maxTurns`
-     * is exhausted. Empty commands are treated as omitted.
-     */
-    readonly postHook?: PlatformPostHookInput;
     readonly proxyEndpoints?: readonly ProxyEndpoint[];
     /**
      * Output capture policy for the run's output files.
@@ -186,24 +180,29 @@ export interface SubmitOptions {
      * shape + positivity are validated client-side.
      */
     readonly limits?: RunLimits;
-    readonly signal?: AbortSignal;
 }
 /**
  * The settle-consistent result of {@link AgentExecutor.run} / `runAndCollect`:
- * the terminal run record plus its settle-bracketed events, decoded trace,
- * assistant text, and captured outputs — everything a "do it and give me the
- * result" caller needs without hand-rolling a poll loop.
+ * the one-shot session record plus its events, decoded trace, assistant text,
+ * and captured outputs — everything a "do it and give me the result" caller
+ * needs without hand-rolling a session/message/stream loop.
  */
 export interface RunResult {
     readonly runId: string;
-    /** The full terminal run record (status, costTelemetry, timings). */
+    /** The session id used as the run-compatible handle. */
+    readonly sessionId?: string;
+    /** Run-compatible view of the underlying session record. */
     readonly run: Run;
+    /** The underlying resumable session record. */
+    readonly session?: Session;
+    /** The turn accepted for this one-shot run. */
+    readonly turn?: SessionTurn;
     readonly status: string;
-    /** `true` when `status === "succeeded"`. */
+    /** `true` when the one-shot turn parked the session cleanly (`idle` or `suspended`). */
     readonly ok: boolean;
-    /** The assistant's final text (decoded over the settled events). */
+    /** The assistant's final text. */
     readonly text: string;
-    /** The settle-bracketed event stream (RUN_STARTED … terminal). */
+    /** The session turn event stream. */
     readonly events: readonly RunEvent[];
     /** Decoded view of the events: tool calls + usage + assistant text. */
     readonly trace: RunTrace;
@@ -218,12 +217,96 @@ export interface RunResult {
 }
 /** Options for {@link AgentExecutor.run} / `runAndCollect`. */
 export interface RunCollectOptions {
-    /** Overall wait budget (ms) for the run to reach a terminal record. */
+    /** Overall wait budget (ms) for the one-shot session turn to park. */
     readonly timeoutMs?: number;
-    readonly signal?: AbortSignal;
+    readonly webSocketFactory?: WebSocketFactory;
+    readonly idleTimeoutMs?: number;
+    readonly pingIntervalMs?: number;
     /** Throw a {@link RunStateError} when the run does not succeed. Default false. */
     readonly throwOnFailure?: boolean;
 }
+export type SessionInput = string | readonly string[];
+export type ChatInput = SessionInput;
+export interface SessionEnvironmentOptions extends Omit<PlatformEnvironmentInput, "envVars"> {
+    readonly variables?: Readonly<Record<string, string>>;
+    readonly secrets?: Readonly<Record<string, Secret>>;
+}
+export interface SessionOverrides {
+    readonly idleTtl?: string;
+    readonly timeout?: string;
+    readonly maxSpendUsd?: number;
+}
+export interface SessionCreateOptions extends Omit<SubmitOptions, "prompt" | "webhook" | "environment" | "secretEnv" | "secrets" | "runtimeSize" | "parentRunId" | "limits" | "timeout"> {
+    readonly apiKeys?: Partial<Record<RunProvider, string>>;
+    readonly environment?: SessionEnvironmentOptions;
+    readonly runtime?: RuntimeSize;
+    readonly overrides?: SessionOverrides;
+}
+export type ChatCreateOptions = SessionCreateOptions;
+export interface SessionSendOptions {
+    readonly idempotencyKey?: string;
+    readonly from?: number;
+    readonly webSocketFactory?: WebSocketFactory;
+    readonly idleTimeoutMs?: number;
+    readonly pingIntervalMs?: number;
+}
+export type ChatSendOptions = SessionSendOptions;
+export interface SessionRunOptions extends SessionCreateOptions {
+    readonly message: SessionInput;
+    readonly deleteAfter?: boolean;
+    readonly messageIdempotencyKey?: string;
+    readonly stream?: Omit<SessionSendOptions, "idempotencyKey">;
+}
+export type ChatRunOptions = SessionRunOptions;
+export interface SessionTurnResult {
+    readonly sessionId: string;
+    readonly session: Session;
+    readonly turn: SessionTurn;
+    readonly status: string;
+    readonly text: string;
+    readonly events: readonly SessionEvent[];
+    readonly outputs: readonly Output[];
+}
+export interface ChatTurnResult extends SessionTurnResult {
+}
+export interface SessionRunResult extends SessionTurnResult {
+}
+export interface ChatRunResult extends SessionRunResult {
+}
+export declare class SessionTurnStream implements AsyncIterable<SessionEvent> {
+    #private;
+    constructor(run: () => AsyncGenerator<SessionEvent, SessionTurnResult, void>);
+    [Symbol.asyncIterator](): AsyncIterator<SessionEvent>;
+    done(): Promise<SessionTurnResult>;
+}
+export declare const ChatTurnStream: typeof SessionTurnStream;
+export type ChatTurnStream = SessionTurnStream;
+export declare class SessionHandle {
+    #private;
+    constructor(http: HttpClient, session: Session);
+    get id(): string;
+    get record(): Session;
+    send(input: SessionInput, options?: SessionSendOptions): SessionTurnStream;
+    suspend(options?: Pick<SessionSendOptions, "idempotencyKey">): Promise<SessionStateChangeAccepted>;
+    cancel(options?: Pick<SessionSendOptions, "idempotencyKey">): Promise<SessionStateChangeAccepted>;
+    resume(options?: Pick<SessionSendOptions, "idempotencyKey">): Promise<SessionStateChangeAccepted>;
+    delete(options?: Pick<SessionSendOptions, "idempotencyKey">): Promise<void>;
+    listEvents(): Promise<readonly SessionEvent[]>;
+    listOutputs(query?: OutputQuery): Promise<readonly Output[]>;
+}
+export declare const ChatSession: typeof SessionHandle;
+export type ChatSession = SessionHandle;
+export declare class SessionClient {
+    #private;
+    constructor(http: HttpClient, buildCreateRequest: (options: SessionCreateOptions) => Promise<SessionCreateRequest>);
+    create(options: SessionCreateOptions): Promise<SessionHandle>;
+    open(sessionId: string): Promise<SessionHandle>;
+    get(sessionId: string): Promise<Session>;
+    list(query?: SessionListQuery): Promise<SessionListPage>;
+    run(options: SessionRunOptions): Promise<SessionRunResult>;
+}
+export declare const ChatClient: typeof SessionClient;
+export type ChatClient = SessionClient;
 export interface StreamEventsOptions {
     /** Poll interval in ms for the `RunEvent` snapshot loop. Default 1000. */
     readonly intervalMs?: number;
@@ -397,6 +480,8 @@ export declare class AgentExecutor {
     readonly agentsMd: AgentsMdClient;
     readonly files: FilesClient;
     readonly secrets: SecretsClient;
+    readonly sessions: SessionClient;
+    readonly chat: ChatClient;
     constructor(options: AgentExecutorOptions);
     /**
      * Internal: satisfies the `SecretUploader` surface so a
@@ -422,26 +507,20 @@ export declare class AgentExecutor {
         readonly contentType?: string;
     }): Promise<UploadedAsset>;
     /**
-     * Submit a run, wait until its RECORD is terminal, and collect the full
-     * {@link RunResult} — the settle-consistent "do it and give me the result"
-     * primitive. Folds the poll loop every consumer hand-rolled into one call:
-     * submit → {@link waitForRun} (polls `getRun`, NOT the earlier RUN_FINISHED
-     * event) → poll `listEvents` until the snapshot is settle-bracketed
-     * (RUN_STARTED + a terminal event present) → `listOutputs` → decode the trace
-     * and assistant text. On resolve, `getRun`/`listOutputs` are guaranteed
-     * consistent.
-     *
-     * Uses polling (portable across backends), NOT the coordinator WebSocket. By
-     * default a failed run resolves with `ok: false` and a populated `error`; pass
-     * `{ throwOnFailure: true }` to throw instead. For live events prefer `submit`
-     * + `streamEnvelopes(runId, { settleConsistent: true })`.
+     * Convenience one-shot on top of the canonical session API:
+     * open a session, send `message` as the first turn, stream until the session
+     * parks (`idle` / `suspended` / `error`), then return the collected text,
+     * events, outputs, and session record. The returned `runId` is the session id,
+     * so callers can resume later with `openSession(runId)`.
      */
-    run(options: SubmitOptions, opts?: RunCollectOptions): Promise<RunResult>;
+    run(options: SessionRunOptions, opts?: RunCollectOptions): Promise<RunResult>;
     /**
-     * Explicit, discoverable alias for {@link run}: submit, wait, and collect the
-     * full {@link RunResult} in one call.
+     * Explicit, discoverable alias for {@link run}: open a one-shot session turn
+     * and collect the full {@link RunResult} in one call.
      */
-    runAndCollect(options: SubmitOptions, opts?: RunCollectOptions): Promise<RunResult>;
+    runAndCollect(options: SessionRunOptions, opts?: RunCollectOptions): Promise<RunResult>;
+    openSession(options: SessionCreateOptions): Promise<SessionHandle>;
+    openSession(sessionId: string): Promise<SessionHandle>;
     /**
      * Submit a run and return its run id immediately. Use that id with
      * `wait`, `stream`, `outputs`, `download`, `cancel`, or `delete`.
@@ -592,4 +671,7 @@ export declare class AgentExecutor {
     /** Download only the run record (the `metadata` namespace) as a zip. */
     downloadMetadata(runId: string, options?: OutputDownloadOptions): Promise<Uint8Array>;
 }
+/** Canonical SDK client name. `AgentExecutor` remains as a compatibility alias. */
+export declare class Aex extends AgentExecutor {
+}
 export type { OutputFileType, OutputLink, OutputLinkOptions, OutputQuery, PlatformProxyEndpoint, PlatformProxyEndpointAuth };