@aexhq/sdk 0.18.0 → 0.19.0

package/dist/skill.d.ts

@@ -1,7 +1,7 @@
 import { type AssetRef, type FetchLike, type SkillRef } from "./_contracts/index.js";
 import { type SkillFiles } from "./bundle.js";
 /**
- * One `Skill` class for skill bytes. `client.submitRun` materializes the bytes
+ * One `Skill` class for skill bytes. `client.submit` materializes the bytes
  * as an uploaded asset before the run lands; the wire ref becomes
  * `kind:"asset"`.
  *
@@ -30,7 +30,7 @@ export declare class Skill {
     /**
      * The wire-level reference. Returns the SDK-private draft shape for
      * un-materialized skills (kind:"draft", with name + contentHash).
-     * `client.submitRun` walks these and uploads them before the run
+     * `client.submit` walks these and uploads them before the run
      * lands.
      */
     get ref(): AssetRef | DraftSkillRef;
@@ -41,7 +41,7 @@ export declare class Skill {
      * Build a draft Skill from an inline files map. The SDK validates
      * basic safety (no path traversal, size caps, has `SKILL.md`),
      * deterministically zips the bundle, and computes the
-     * `sha256:<hex>` content hash. `client.submitRun` materializes
+     * `sha256:<hex>` content hash. `client.submit` materializes
      * these before the run lands.
      */
     static fromFiles(args: {
@@ -66,7 +66,7 @@ export declare class Skill {
      *
      * The archive must contain `SKILL.md` at its root, or inside a single
      * top-level folder (which is stripped). The signed URL only needs to be valid
-     * for this call; `client.submitRun` snapshots the bytes into the run.
+     * for this call; `client.submit` snapshots the bytes into the run.
      *
      * Universal (Node 18+ / browser): requires a global `fetch`, or pass one.
      */
@@ -86,7 +86,7 @@ export declare class Skill {
      * `Skill` record returned by `client.skills.list()` / `.get()`:
      *
      *   const [s] = await client.skills.list();
-     *   await client.submitRun({ ..., skills: [Skill.fromCatalog(s)] });
+     *   await client.submit({ ..., skills: [Skill.fromCatalog(s)] });
      *
      * The record must be `ready` (it has a content hash). Unlike the draft
      * builders this performs no upload — the bytes already live in the catalog.
@@ -96,9 +96,9 @@ export declare class Skill {
         readonly hash?: string | null;
     }): Skill;
     /**
-     * Internal: yield the draft's bytes + metadata so `client.submitRun`
+     * Internal: yield the draft's bytes + metadata so `client.submit`
      * can upload the asset. After this returns, the Skill is marked consumed
-     * so a second submitRun call against the same instance throws
+     * so a second submit call against the same instance throws
      * (avoid silently re-uploading; explicit re-construction is the
      * supported retry pattern).
      *
@@ -123,7 +123,7 @@ export declare class Skill {
 }
 /**
  * SDK-internal draft skill marker. Never reaches the wire; the
- * materialize step inside `client.submitRun` converts these to
+ * materialize step inside `client.submit` converts these to
  * `kind:"asset"` refs.
  */
 export interface DraftSkillRef {

package/dist/skill.js

@@ -3,7 +3,7 @@ import { bundleSkillFiles, hashSkillBundle } from "./bundle.js";
 import { fetchSkillArchive } from "./fetch-archive.js";
 import { readDirectoryAsFiles } from "./node-fs.js";
 /**
- * One `Skill` class for skill bytes. `client.submitRun` materializes the bytes
+ * One `Skill` class for skill bytes. `client.submit` materializes the bytes
  * as an uploaded asset before the run lands; the wire ref becomes
  * `kind:"asset"`.
  *
@@ -37,7 +37,7 @@ export class Skill {
     /**
      * The wire-level reference. Returns the SDK-private draft shape for
      * un-materialized skills (kind:"draft", with name + contentHash).
-     * `client.submitRun` walks these and uploads them before the run
+     * `client.submit` walks these and uploads them before the run
      * lands.
      */
     get ref() {
@@ -54,7 +54,7 @@ export class Skill {
      * Build a draft Skill from an inline files map. The SDK validates
      * basic safety (no path traversal, size caps, has `SKILL.md`),
      * deterministically zips the bundle, and computes the
-     * `sha256:<hex>` content hash. `client.submitRun` materializes
+     * `sha256:<hex>` content hash. `client.submit` materializes
      * these before the run lands.
      */
     static async fromFiles(args) {
@@ -92,7 +92,7 @@ export class Skill {
      *
      * The archive must contain `SKILL.md` at its root, or inside a single
      * top-level folder (which is stripped). The signed URL only needs to be valid
-     * for this call; `client.submitRun` snapshots the bytes into the run.
+     * for this call; `client.submit` snapshots the bytes into the run.
      *
      * Universal (Node 18+ / browser): requires a global `fetch`, or pass one.
      */
@@ -120,7 +120,7 @@ export class Skill {
      * `Skill` record returned by `client.skills.list()` / `.get()`:
      *
      *   const [s] = await client.skills.list();
-     *   await client.submitRun({ ..., skills: [Skill.fromCatalog(s)] });
+     *   await client.submit({ ..., skills: [Skill.fromCatalog(s)] });
      *
      * The record must be `ready` (it has a content hash). Unlike the draft
      * builders this performs no upload — the bytes already live in the catalog.
@@ -141,9 +141,9 @@ export class Skill {
         return new Skill(ref);
     }
     /**
-     * Internal: yield the draft's bytes + metadata so `client.submitRun`
+     * Internal: yield the draft's bytes + metadata so `client.submit`
      * can upload the asset. After this returns, the Skill is marked consumed
-     * so a second submitRun call against the same instance throws
+     * so a second submit call against the same instance throws
      * (avoid silently re-uploading; explicit re-construction is the
      * supported retry pattern).
      *
@@ -151,8 +151,8 @@ export class Skill {
      */
     _takeDraftBundle() {
         if (this.#consumed) {
-            throw new Error("Skill: cannot reuse a consumed Skill in submitRun. Build a fresh Skill via " +
-                "Skill.fromPath(...) / Skill.fromFiles(...) per submitRun call.");
+            throw new Error("Skill: cannot reuse a consumed Skill in submit. Build a fresh Skill via " +
+                "Skill.fromPath(...) / Skill.fromFiles(...) per submit call.");
         }
         if (this.#ref.kind !== "draft" || !this.#inlineBytes) {
             return undefined;
@@ -190,7 +190,7 @@ export class Skill {
     toJSON() {
         if (this.#ref.kind === "draft") {
             throw new Error("Skill: draft Skills cannot be JSON-serialised — they only become wire refs when " +
-                "client.submitRun uploads the bytes as an asset.");
+                "client.submit uploads the bytes as an asset.");
         }
         return this.#ref;
     }

package/dist/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  *
  * Used by the (future) User-Agent header on outbound SDK requests.
  */
-export declare const SDK_VERSION = "0.18.0";
+export declare const SDK_VERSION = "0.19.0";

package/dist/version.js

@@ -6,5 +6,5 @@
  *
  * Used by the (future) User-Agent header on outbound SDK requests.
  */
-export const SDK_VERSION = "0.18.0";
+export const SDK_VERSION = "0.19.0";
 //# sourceMappingURL=version.js.map

package/docs/cleanup.md

@@ -17,7 +17,7 @@ retention field is rejected if supplied.
 ```ts
 import { RunModels } from "@aexhq/sdk";
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt: "...",
   secrets: { apiKey: process.env.ANTHROPIC_API_KEY! }

package/docs/credentials.md

@@ -6,7 +6,7 @@ title: Credentials
 
 aex does not store provider keys or MCP credential values across runs.
 
-The caller passes a workspace-scoped SDK token and the provider key inline on every `submitRun` call. aex holds the bundle in run-scoped custody for the run lifecycle and attempts terminal cleanup/revocation for the aex-controlled references. MCP credentials and proxy endpoint auth values travel the same way.
+The caller passes a workspace-scoped SDK token and the provider key inline on every `submit` call. aex holds the bundle in run-scoped custody for the run lifecycle and attempts terminal cleanup/revocation for the aex-controlled references. MCP credentials and proxy endpoint auth values travel the same way.
 
 A run targets exactly one provider (selected by `provider`, default `anthropic`), so the key is a single flat field:
 
@@ -80,7 +80,7 @@ const proxyEndpointAuth = [
 // Fail fast at submission time when policy and auth disagree.
 validateProxyAuth(proxyEndpoints, proxyEndpointAuth);
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt: "…",
   proxyEndpoints,
@@ -119,7 +119,7 @@ const proxyEndpoints = [
   }
 ] as const;
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt: "…",
   proxyEndpoints,
@@ -155,4 +155,4 @@ const allowedHosts = buildPlatformAllowedHosts({
 
 ### Secrets are always explicit at the call site
 
-There is no `defaultSecrets` and no client-held secret state. Every `submitRun` call carries its full `secrets` bundle (one provider key + optional MCP credentials + optional `proxyEndpointAuth`). This is the agent-first invariant: the credentials being used on any given call are visible in the same line of code that submits the run.
+There is no `defaultSecrets` and no client-held secret state. Every `submit` call carries its full `secrets` bundle (one provider key + optional MCP credentials + optional `proxyEndpointAuth`). This is the agent-first invariant: the credentials being used on any given call are visible in the same line of code that submits the run.

package/docs/events.md

@@ -48,7 +48,7 @@ and `3` when `--timeout` elapses first (a `--timeout` on `events --follow` /
 `run --follow` uses the same exit-`3` convention). Durations accept `ms`/`s`/`m`/`h`
 suffixes or a bare millisecond integer.
 
-Both surfaces observe the same events. A subscriber attached after `submitRun()` returns replays the events it missed, then continues live.
+Both surfaces observe the same events. A subscriber attached after `submit()` returns replays the events it missed, then continues live.
 
 ## Terminal events vs. the run record
 
@@ -90,7 +90,7 @@ run's last stream event, immediately after the durable record commits.
 
 ## Event shape
 
-Events are typed as the discriminated `RunEvent` union for compatibility and as the versioned coordinator envelope for live consumers. aex records raw runtime/provider payloads **after** secret redaction and structural sanitization, so the bytes you see never contain the provider key, MCP credentials, or proxy bearer that were supplied to `submitRun`.
+Events are typed as the discriminated `RunEvent` union for compatibility and as the versioned coordinator envelope for live consumers. aex records raw runtime/provider payloads **after** secret redaction and structural sanitization, so the bytes you see never contain the provider key, MCP credentials, or proxy bearer that were supplied to `submit`.
 
 ## Typed helpers
 

package/docs/outputs.md

@@ -11,7 +11,7 @@ Every run produces durable metadata (status, events, snapshots, cleanup state) a
 ```ts
 import { RunModels } from "@aexhq/sdk";
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt: "Produce a report and save it as a file.",
   secrets: { apiKey }
@@ -90,7 +90,7 @@ console.log(looseReport.byteLength);
 ## `outputs.allowedDirs` — override capture roots
 
 ```ts
-aex.submitRun({
+aex.submit({
   /* ... */,
   outputs: {
     allowedDirs: ["/workspace/reports", "/workspace/state"]
@@ -115,7 +115,7 @@ Runtime notes:
 ## `outputs.deniedDirs` — subtract noise
 
 ```ts
-aex.submitRun({
+aex.submit({
   /* ... */,
   outputs: {
     deniedDirs: ["node_modules", "/var/cache", "*.tmp"]

package/docs/quickstart.md

@@ -16,7 +16,7 @@ const aex = new AgentExecutor({
   // baseUrl defaults to https://api.aex.dev - set it for local or staging planes.
 });
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt: "Write a short answer about agent-first SDK design.",
   secrets: { apiKey: process.env.ANTHROPIC_API_KEY! }
@@ -37,7 +37,7 @@ function summarise(topic: string) {
   };
 }
 
-const runId = await aex.submitRun({
+const runId = await aex.submit({
   ...summarise("agent-first SDK design"),
   secrets: { apiKey: process.env.ANTHROPIC_API_KEY! }
 });
@@ -58,7 +58,7 @@ For a config-file flow, pass `--config <path>` with a run-config JSON file for a
 
 ## Runtime controls
 
-`submitRun` also accepts per-run controls that are not secrets:
+`submit` also accepts per-run controls that are not secrets:
 
 - `runtimeSize` - a closed managed-runtime preset. Prefer `RuntimeSizes`, e.g. `RuntimeSizes.SHARED_2X_2GB`.
 - `timeout` - run deadline as a duration string such as `"30m"` or `"2h"`; bounded server-side.
@@ -75,7 +75,7 @@ Every kind of thing you want to ship at run time has exactly one right primitive
 | Non-secret paths or config (`BROLL_STORE`, mode flags) | `environment.envVars` | Mounted as `RUNTIME.env` / `RUNTIME.json`; `__KEY__` substitution in agent-facing markdown; echoed back as `run.runtimeManifest.envVars` |
 | Upstream HTTPS API keys (TMDB, Brave, Tavily, …) | `ProxyEndpoint` | Credentials live server-side; aex proxy injects them on outbound calls. The key never enters the container. |
 | MCP server credentials | `secrets.mcpServers` | Held in run-scoped custody, attached per run |
-| Provider API key | `secrets.apiKey` | Required on every `submitRun`; held in run-scoped custody. Carries the BYOK key for the selected `provider` |
+| Provider API key | `secrets.apiKey` | Required on every `submit`; held in run-scoped custody. Carries the BYOK key for the selected `provider` |
 | Non-secret reference data folders (transcripts, persona docs, PDFs) | `File.fromPath('./customer-folder/')` | Materialized under `files/<f_id>/<name>` in the run workspace by default and described in the agent-facing instructions |
 | Executable skill code (a `.pyz` wrapper, scripts, prompts) | `Skill.fromPath('./skills/my-skill/')` | Mounted under `skills/<name>/`; the bundle's `SKILL.md` is composed into the agent's instructions |
 | Agent instructions file | `AgentsMd.fromPath('./AGENTS.md')` | Prepended as the first user turn |
@@ -84,7 +84,7 @@ Every kind of thing you want to ship at run time has exactly one right primitive
 
 ## Safe retries with `idempotencyKey`
 
-Every `submitRun` call carries an `idempotencyKey`. When omitted the SDK auto-generates a UUID per call. Supplying your own key makes retries deterministic:
+Every `submit` call carries an `idempotencyKey`. When omitted the SDK auto-generates a UUID per call. Supplying your own key makes retries deterministic:
 
 | Submit shape | Server response |
 | --- | --- |
@@ -102,7 +102,7 @@ const idempotencyKey = crypto.randomUUID();
 async function submitWithRetry() {
   for (let attempt = 0; attempt < 3; attempt++) {
     try {
-      return await aex.submitRun({
+      return await aex.submit({
         model: RunModels.CLAUDE_HAIKU_4_5,
         prompt: "...",
         idempotencyKey,
@@ -113,7 +113,7 @@ async function submitWithRetry() {
       throw err;
     }
   }
-  throw new Error("submitRun failed after retries");
+  throw new Error("submit failed after retries");
 }
 ```
 

package/docs/run-config.md

@@ -4,7 +4,7 @@ title: Run configuration
 
 # Run configuration
 
-A run config is the credential-free subset of a `submitRun` request that you can keep in code or load from a JSON file. It is not a platform object, saved definition, DSL, trigger, or persistent agent profile. aex only stores the immutable run record created when you submit.
+A run config is the credential-free subset of a `submit` request that you can keep in code or load from a JSON file. It is not a platform object, saved definition, DSL, trigger, or persistent agent profile. aex only stores the immutable run record created when you submit.
 
 Allowed fields:
 
@@ -20,9 +20,9 @@ Allowed fields:
 - `proxyEndpoints` - array of `PlatformProxyEndpoint`; endpoint-level `retry` is allowed here and remains declaration-based.
 - `metadata` - non-secret structured metadata.
 
-`agentsMd`, `files`, `outputs`, `builtins`, and `outputMode` are top-level `submitRun` options, not run-config fields. They carry bytes, capture behavior, or agent tool/output controls that belong on a concrete run submission.
+`agentsMd`, `files`, `outputs`, `builtins`, and `outputMode` are top-level `submit` options, not run-config fields. They carry bytes, capture behavior, or agent tool/output controls that belong on a concrete run submission.
 
-Secrets never live in run config. Pass credentials through `submitRun({ ...config, secrets })` in the SDK or the equivalent host-mode flags (`--anthropic-api-key`, `--mcp-auth`, `--proxy-auth`) in the CLI. See [Credentials](credentials.md) for the proxy endpoint policy/auth split and retry fields.
+Secrets never live in run config. Pass credentials through `submit({ ...config, secrets })` in the SDK or the equivalent host-mode flags (`--anthropic-api-key`, `--mcp-auth`, `--proxy-auth`) in the CLI. See [Credentials](credentials.md) for the proxy endpoint policy/auth split and retry fields.
 
 ## Reuse in code
 
@@ -39,7 +39,7 @@ function summarise(topic: string) {
   };
 }
 
-await aex.submitRun({
+await aex.submit({
   ...summarise("agent-first SDK design"),
   secrets: { apiKey }
 });

package/docs/skills.md

@@ -12,7 +12,7 @@ that asset into the run's object-storage prefix before dispatch.
 There are three sources for skill bytes:
 
 - **Inline/local draft:** `Skill.fromFiles(...)`, `Skill.fromPath(...)`, or
-  `Skill.fromUrl(...)` builds a draft in the SDK process. `submitRun` uploads
+  `Skill.fromUrl(...)` builds a draft in the SDK process. `submit` uploads
   it before posting `/runs`.
 - **Pre-uploaded workspace asset:** call `await draft.upload(aex)` and reuse the
   returned materialized `Skill`, or pass an existing `kind:"asset"` ref from a
@@ -63,7 +63,7 @@ import { AgentExecutor, RunModels, Skill } from "@aexhq/sdk";
 
 const aex = new AgentExecutor({ apiToken });
 
-await aex.submitRun({
+await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt,
   skills: [await Skill.fromPath("./skills/rules", { name: "rules" })],
@@ -92,7 +92,7 @@ multiple submissions, upload the draft explicitly:
 const draft = await Skill.fromFiles({ name: "rules", files });
 const uploaded = await draft.upload(aex);
 
-await aex.submitRun({
+await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt,
   skills: [uploaded],
@@ -129,7 +129,7 @@ assets. Use them when a team wants a named, listed skill record:
 ```ts
 const [record] = await aex.skills.list();
 
-await aex.submitRun({
+await aex.submit({
   model: RunModels.CLAUDE_HAIKU_4_5,
   prompt,
   skills: [Skill.fromCatalog(record)],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/sdk",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "TypeScript SDK for running autonomous agent sessions across providers (Anthropic, OpenAI, DeepSeek, Gemini, Mistral) behind one interface.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,7 +26,7 @@
     "examples"
   ],
   "devDependencies": {
-    "@aexhq/contracts": "0.18.0"
+    "@aexhq/contracts": "0.19.0"
   },
   "engines": {
     "node": ">=20"