@aexhq/sdk 0.34.0 → 0.36.0

package/dist/cli.mjs.sha256

@@ -1 +1 @@
-fe0642cff5926cbaf21e48544c4e022a183f284d8e4c25818784fc84b1df2c5a  cli.mjs
+07c9307bf82f025b845d4495eb41039ac3f684c4a75244af85871809206bf704  cli.mjs

package/dist/client.d.ts

@@ -1,15 +1,17 @@
-import { HttpClient, SecretString, type AexEvent, type AgentsMdRecord, type AssistantTextEntry, type DebugSink, type FetchLike, type FileRecord, type Output, type OutputFileType, type OutputLink, type OutputLinkOptions, type OutputQuery, type OutputText, type OutputMode, type ReadOutputTextOptions, type OutputSearchQuery, type OutputSearchPage, type Session, type SessionCreateRequest, type SessionEvent, type SessionListPage, type SessionListQuery, type SessionStateChangeAccepted, type SessionTurn, type PlatformEnvironmentInput, type PlatformSubmission, type PlatformProxyEndpoint, type PlatformProxyEndpointAuth, type Run, type RunModel, type RunEvent, type RunTrace, type UsageSummary, type RunWebhookDelivery, type RunProvider, type SecretRecord, type RunUnit, type BuiltinToolName, type RuntimeSize, type WebSocketFactory, 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 OutputSearchQuery, type OutputSearchPage, type Session, type SessionCreateRequest, type SessionEvent, type SessionListPage, type SessionListQuery, type SessionMessage, type SessionStateChangeAccepted, type SessionTurn, type PlatformEnvironmentInput, type PlatformSubmission, type Run, type RunModel, type RunEvent, type RunTrace, type UsageSummary, type RunWebhookDelivery, type RunProvider, type SecretRecord, type RunUnit, type BuiltinToolName, type RuntimeSize, 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";
 import { McpServer } from "./mcp-server.js";
-import { ProxyEndpoint } from "./proxy-endpoint.js";
+import { type RetryOptions } from "./retry.js";
 import { Secret } from "./secret.js";
 import { SkillTool } from "./skill-tool.js";
 import { Tool } from "./tool.js";
-export interface AgentExecutorOptions {
+export interface AexOptions {
     /** Workspace-scoped SDK API token. */
-    readonly apiToken: string;
+    readonly apiKey?: string;
+    /** @deprecated Use `apiKey`; kept as a source-compatible alias during launch. */
+    readonly apiToken?: string;
     /**
      * API plane root, e.g. `https://aex.example.com`. Optional —
      * defaults to the canonical hosted URL (`https://api.aex.dev`).
@@ -24,9 +26,19 @@ export interface AgentExecutorOptions {
      * route the traces elsewhere. Purely local — nothing is uploaded.
      */
     readonly debug?: boolean | DebugSink;
+    /**
+     * Built-in transport retry policy. Every BFF request is retried on transient
+     * failures (HTTP 429/500/502/503/504/529 and network errors) with bounded
+     * exponential backoff + jitter, honoring `Retry-After`. Billable submits carry
+     * a stable idempotency key, so a retry never creates a duplicate billable run.
+     *
+     * Omit for sensible defaults (4 attempts, ~2 min budget); pass an object to
+     * tune `maxAttempts` / delays / `maxElapsedMs`; pass `false` to disable.
+     */
+    readonly retry?: RetryOptions | false;
 }
 /**
- * The settle-consistent result of {@link AgentExecutor.run}:
+ * The settle-consistent result of {@link Aex.run}:
  * 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.
@@ -46,6 +58,8 @@ export interface RunResult {
     readonly ok: boolean;
     /** The assistant's final text. */
     readonly text: string;
+    /** Assistant messages projected from the settled event stream. */
+    readonly messages: readonly Message[];
     /** The session turn event stream. */
     readonly events: readonly RunEvent[];
     /** Decoded view of the events: tool calls + usage + assistant text. */
@@ -59,7 +73,7 @@ export interface RunResult {
     /** The run's error message when `!ok`. */
     readonly error?: string;
 }
-/** Options for {@link AgentExecutor.run}. */
+/** Options for {@link Aex.run}. */
 export interface RunCollectOptions {
     /** Overall wait budget (ms) for the one-shot session turn to park. */
     readonly timeoutMs?: number;
@@ -91,9 +105,8 @@ export interface SessionOverrides {
  *   - `agentsMd` / `files` — local composition instances
  *     (`AgentsMd.fromContent` / `File.fromBytes`, …), materialized to the
  *     hosted asset store before the session lands.
- *   - `mcpServers` / `proxyEndpoints` — instances whose secrets are split into
- *     the vaulted secrets channel server-side; the public submission carries
- *     only the declarations.
+ *   - `mcpServers` — instances whose secrets are split into the vaulted secrets
+ *     channel server-side; the public submission carries only the declarations.
  *   - `apiKeys` — the BYOK provider key(s), keyed by provider. A key for the
  *     selected provider is REQUIRED. The platform never holds a long-lived
  *     provider key on your behalf.
@@ -147,7 +160,6 @@ export interface SessionCreateOptions {
     readonly outputMode?: OutputMode;
     readonly metadata?: PlatformSubmission["metadata"];
     readonly idempotencyKey?: string;
-    readonly proxyEndpoints?: readonly ProxyEndpoint[];
     /** BYOK provider key(s), keyed by provider. */
     readonly apiKeys?: Partial<Record<RunProvider, string>>;
     readonly environment?: SessionEnvironmentOptions;
@@ -188,6 +200,7 @@ export interface SessionTurnResult {
     readonly text: string;
     readonly events: readonly SessionEvent[];
     readonly outputs: readonly Output[];
+    readonly messages: readonly Message[];
 }
 export interface SessionRunResult extends SessionTurnResult {
 }
@@ -197,14 +210,18 @@ export declare class SessionTurnStream implements AsyncIterable<SessionEvent> {
     [Symbol.asyncIterator](): AsyncIterator<SessionEvent>;
     done(): Promise<SessionTurnResult>;
 }
+type CallableSessionMessages = SessionMessages & (() => SessionMessages);
+export type Message = SessionMessage;
 /**
- * Accessor over the session's decoded assistant messages. `session.messages()`
- * returns this synchronously; each method fetches on call.
+ * Accessor over the session's assistant messages. `session.messages` returns
+ * this synchronously; each method fetches on call.
  */
 export interface SessionMessages {
-    list(): Promise<readonly AssistantTextEntry[]>;
-    last(): Promise<AssistantTextEntry | undefined>;
-    first(): Promise<AssistantTextEntry | undefined>;
+    all(): Promise<readonly Message[]>;
+    /** Compatibility alias for {@link SessionMessages.all}. */
+    list(): Promise<readonly Message[]>;
+    last(): Promise<Message | undefined>;
+    first(): Promise<Message | undefined>;
 }
 /**
  * Accessor over the session's event stream (`session.events()`): the buffered
@@ -250,16 +267,25 @@ export declare class SessionHandle {
     get id(): string;
     get record(): Session;
     send(input: SessionInput, options?: SessionSendOptions): SessionTurnStream;
+    /**
+     * Re-send the last message on this session — the clean way to retry a turn a
+     * throttle or transient failure interrupted. By default it REUSES the previous
+     * message's idempotency key, so if the original turn actually landed
+     * server-side the replay de-duplicates instead of creating a second billable
+     * turn; pass a fresh `idempotencyKey` to force a brand-new turn.
+     */
+    replayLast(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>;
     /**
-     * Accessor for the session's decoded assistant messages (buffered output
-     * mode: one entry per assistant message). `list()` returns them oldest-first;
-     * `last()`/`first()` return a single entry or `undefined` when empty.
+     * Accessor for the session's assistant messages. `all()` returns them
+     * oldest-first; `last()`/`first()` return a single entry or `undefined` when
+     * empty. The accessor is callable as a compatibility shim for older
+     * `session.messages().list()` callers.
      */
-    messages(): SessionMessages;
+    get messages(): CallableSessionMessages;
     /**
      * Accessor for the session's event stream: the buffered `SessionEvent`
      * snapshots (`list`/`last`/`first`), the polling `RunEvent` iterator
@@ -454,13 +480,14 @@ export declare class SecretsClient {
  * `client.whoami()` if you want to introspect which workspace the
  * token resolves to.
  */
-export declare class AgentExecutor {
+export declare class Aex {
     #private;
     readonly agentsMd: AgentsMdClient;
     readonly files: FilesClient;
     readonly secrets: SecretsClient;
     readonly sessions: SessionClient;
-    constructor(options: AgentExecutorOptions);
+    constructor(apiKey: string, options?: Omit<AexOptions, "apiKey" | "apiToken">);
+    constructor(options: AexOptions);
     /**
      * Internal: satisfies the `SecretUploader` surface so a
      * `Secret.value(...).upload(client, { name })` promotes an ephemeral secret
@@ -503,7 +530,4 @@ export declare class AgentExecutor {
     deleteWorkspaceAsset(hash: string): Promise<void>;
     whoami(): Promise<WhoAmI>;
 }
-/** Canonical SDK client name. `AgentExecutor` remains as a compatibility alias. */
-export declare class Aex extends AgentExecutor {
-}
-export type { OutputFileType, OutputLink, OutputLinkOptions, OutputQuery, PlatformProxyEndpoint, PlatformProxyEndpointAuth };
+export type { OutputFileType, OutputLink, OutputLinkOptions, OutputQuery };