@aexhq/sdk 0.35.0 → 0.37.0

package/dist/cli.mjs.sha256

@@ -1 +1 @@
-ebfa6eb1106a2447b2462511c45f0c96874889e3189a78fd4a66521d663bde76  cli.mjs
+0b259b81011fcda9d15954453cc67f17d1b28add9a32903218d068c3dd1c2e9d  cli.mjs

package/dist/client.d.ts

@@ -1,16 +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 BillingCheckoutRequest, type BillingHostedSession, type BillingLedgerPage, type BillingLedgerQuery, type BillingPortalRequest, type BillingSummary, 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 WebhookSigningSecret, 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`).
@@ -37,7 +38,7 @@ export interface AgentExecutorOptions {
     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.
@@ -57,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. */
@@ -70,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;
@@ -102,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.
@@ -158,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;
@@ -199,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 {
 }
@@ -208,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
@@ -274,11 +280,12 @@ export declare class SessionHandle {
     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
@@ -311,6 +318,12 @@ export declare class SessionHandle {
      * Fetch the self-contained `RunUnit` for this session: parsed submission,
      * attempts, indexed events, outputs, capture failures, proxy-call audit, and
      * resolved skills. Use this when you need fields beyond the session record.
+     *
+     * On the managed plane this is a LEAN summary — the aggregate collections
+     * (`attempts` / `events.entries` / `outputs` / `rawEventPages`) default to
+     * empty. For authoritative per-run data use `outputs()` / `events()` /
+     * `messages()`. The returned shape is always type-valid (never `undefined`
+     * where the type promises an array/page), so array/page access is safe.
      */
     unit(): Promise<RunUnit>;
     /**
@@ -473,13 +486,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
@@ -521,8 +535,38 @@ export declare class AgentExecutor {
      */
     deleteWorkspaceAsset(hash: string): Promise<void>;
     whoami(): Promise<WhoAmI>;
+    /**
+     * Read the workspace billing summary: prepaid `balanceUsd`, current-month
+     * `monthSpendUsd`, the enforced `spendCapUsd`, and plan fields. Backed by
+     * `GET /api/billing` (scope `billing:read`). The result is additive-tolerant:
+     * fields a newer deployment reports that this SDK does not know yet pass
+     * through on the returned object.
+     */
+    billing(): Promise<BillingSummary>;
+    /**
+     * Create a hosted checkout session for a paid plan (`pro` or `team`).
+     * Open the returned `url` in a browser. Plan activation happens after
+     * checkout completes.
+     */
+    billingCheckout(request: BillingCheckoutRequest): Promise<BillingHostedSession>;
+    /**
+     * Create a hosted billing-portal session for the workspace customer.
+     * Open the returned `url` in a browser.
+     */
+    billingPortal(request?: BillingPortalRequest): Promise<BillingHostedSession>;
+    /**
+     * Read recent workspace credit-ledger rows, newest first — top-ups, run
+     * charges, and redemptions with signed `amountUsd`. Backed by
+     * `GET /api/billing/ledger`; `limit` is clamped server-side to [1, 100]
+     * (default 25). Not cursor-paged.
+     */
+    billingLedger(query?: BillingLedgerQuery): Promise<BillingLedgerPage>;
+    /**
+     * Reveal the workspace webhook signing secret (creating one on first use) —
+     * the `whsec_<base64>` value `verifyAexWebhook` takes as `secret`. Backed by
+     * `POST /api/webhook/signing-secret`; repeat calls return the SAME value (the
+     * hosted API does not rotate it). Treat the reveal as sensitive: never log it.
+     */
+    webhookSigningSecret(): Promise<WebhookSigningSecret>;
 }
-/** 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 };