@aexhq/sdk 0.28.1 → 0.30.0

package/dist/_contracts/submission.js

@@ -115,18 +115,27 @@ export const Providers = {
     DOUBAO_CN: "doubao-cn"
 };
 /**
- * Product placement tokens accepted on run submission. These are not exact
- * city guarantees: the hosted platform maps each token to the configured
- * database, object store, Durable Object, and sandbox backing available for
- * that product region.
+ * Product placement regions accepted on run submission. These are
+ * product-level tokens, not exact city guarantees: the hosted platform maps
+ * each region to co-located managed Postgres, object storage, run-state
+ * placement, and sandbox backing.
+ *
+ *   eu-west       → London        (Western Europe)
+ *   us-west       → N. California (Western North America)
+ *   ap-northeast  → Seoul         (Northeast Asia)
+ *
+ * Prefer the {@link Regions} accessors over raw strings so a typo is a compile
+ * error, not a runtime 400.
  */
-export const RUN_REGIONS = ["lhr", "iad", "sfo", "bom"];
-/** Symbol-style accessors for the closed run-region set. */
-export const RunRegions = {
-    LHR: "lhr",
-    IAD: "iad",
-    SFO: "sfo",
-    BOM: "bom"
+export const REGIONS = ["eu-west", "us-west", "ap-northeast"];
+/** Symbol-style accessors for the closed region set — e.g. `Regions.EU_WEST`. */
+export const Regions = {
+    /** Western Europe — London. */
+    EU_WEST: "eu-west",
+    /** Western North America — N. California. */
+    US_WEST: "us-west",
+    /** Northeast Asia — Seoul. */
+    AP_NORTHEAST: "ap-northeast"
 };
 /**
  * Customer-facing runtime selector. Optional on the wire; absent resolves
@@ -988,6 +997,19 @@ export function optionalPositiveInt(input, field) {
     }
     return input;
 }
+/**
+ * A finite positive NUMBER (fractional allowed — e.g. a USD amount like `2.5`), or
+ * undefined when absent. Rejects non-numbers, NaN/Infinity, and `<= 0`.
+ */
+export function optionalPositiveNumber(input, field) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (typeof input !== "number" || !Number.isFinite(input) || input <= 0) {
+        throw new Error(`${field} must be a positive finite number`);
+    }
+    return input;
+}
 function parseOptionalBoundedInt(input, field, min, max) {
     if (input === undefined) {
         return undefined;
@@ -1062,7 +1084,7 @@ export function parseRunSubmissionRequest(input, options = {}) {
     }
     const provider = parseRunProvider(value.provider);
     const runtime = parseRuntimeKind(value.runtime);
-    const region = parseRunRegion(value.region);
+    const region = parseRegion(value.region);
     const credentialMode = parseCredentialMode(value.credentialMode);
     void options;
     // Cross-field validation via the centralized runtime-support validator.
@@ -1189,7 +1211,7 @@ export function parseRunLimits(input) {
         return undefined;
     }
     const value = requireRecord(input, "limits");
-    const allowed = new Set(["maxConcurrentChildRuns", "maxSubagentDepth"]);
+    const allowed = new Set(["maxConcurrentChildRuns", "maxSubagentDepth", "maxSpendUsd"]);
     for (const key of Object.keys(value)) {
         if (!allowed.has(key)) {
             throw new Error(`limits.${key} is not an allowed field; permitted: ${[...allowed].join(", ")}`);
@@ -1197,23 +1219,28 @@ export function parseRunLimits(input) {
     }
     const maxConcurrentChildRuns = optionalPositiveInt(value.maxConcurrentChildRuns, "limits.maxConcurrentChildRuns");
     const maxSubagentDepth = optionalPositiveInt(value.maxSubagentDepth, "limits.maxSubagentDepth");
+    // maxSpendUsd is a USD amount (may be fractional, e.g. $2.50) so it is a positive
+    // NUMBER, not a positive int. Clamping to the workspace/platform ceiling is the
+    // resolver's job; here we only enforce shape + positivity.
+    const maxSpendUsd = optionalPositiveNumber(value.maxSpendUsd, "limits.maxSpendUsd");
     // Collapse an all-absent override (e.g. `limits: {}`) to `undefined` so it never
     // lands an empty object on the request — matches sibling parsers (parseRunWebhook,
     // parseEnvironment). The resolver supplies platform defaults for absent fields.
-    if (maxConcurrentChildRuns === undefined && maxSubagentDepth === undefined) {
+    if (maxConcurrentChildRuns === undefined && maxSubagentDepth === undefined && maxSpendUsd === undefined) {
         return undefined;
     }
     return {
         ...(maxConcurrentChildRuns !== undefined ? { maxConcurrentChildRuns } : {}),
-        ...(maxSubagentDepth !== undefined ? { maxSubagentDepth } : {})
+        ...(maxSubagentDepth !== undefined ? { maxSubagentDepth } : {}),
+        ...(maxSpendUsd !== undefined ? { maxSpendUsd } : {})
     };
 }
-export function parseRunRegion(input) {
+export function parseRegion(input) {
     if (input === undefined) {
         return undefined;
     }
-    if (typeof input !== "string" || !RUN_REGIONS.includes(input)) {
-        throw new Error(`region must be one of: ${RUN_REGIONS.join(", ")} (got ${JSON.stringify(input)})`);
+    if (typeof input !== "string" || !REGIONS.includes(input)) {
+        throw new Error(`region must be one of: ${REGIONS.join(", ")} (got ${JSON.stringify(input)})`);
     }
     return input;
 }

package/dist/agents-md.d.ts

@@ -15,7 +15,10 @@ export declare class AgentsMd {
     constructor(ref: AgentsMdRef | DraftAgentsMdRef, zipBytes?: Uint8Array);
     get ref(): AgentsMdRef | DraftAgentsMdRef;
     get isDraft(): boolean;
-    get isConsumed(): boolean;
+    /** Internal: the asset id resolved on a prior submit, or undefined. */
+    get _cachedAssetId(): string | undefined;
+    /** Internal: remember the asset id resolved for this draft's bytes. */
+    _rememberAsset(assetId: string): void;
     /**
      * Build a draft AgentsMd from a markdown string. The SDK zips the
      * content under the canonical filename `AGENTS.md` so the hash is a

package/dist/agents-md.js

@@ -15,7 +15,8 @@ import { strToU8, zipSync } from "fflate";
 export class AgentsMd {
     #ref;
     #zipBytes;
-    #consumed = false;
+    /** Asset id cached after the first submit, so reuse skips a re-upload. */
+    #assetId;
     constructor(ref, zipBytes) {
         this.#ref = ref;
         this.#zipBytes = zipBytes;
@@ -24,10 +25,15 @@ export class AgentsMd {
         return this.#ref;
     }
     get isDraft() {
-        return this.#ref.kind === "draft" && !this.#consumed;
+        return this.#ref.kind === "draft";
     }
-    get isConsumed() {
-        return this.#consumed;
+    /** Internal: the asset id resolved on a prior submit, or undefined. */
+    get _cachedAssetId() {
+        return this.#assetId;
+    }
+    /** Internal: remember the asset id resolved for this draft's bytes. */
+    _rememberAsset(assetId) {
+        this.#assetId = assetId;
     }
     /**
      * Build a draft AgentsMd from a markdown string. The SDK zips the
@@ -56,14 +62,9 @@ export class AgentsMd {
      * `client.submit` can upload it as an asset.
      */
     _takeDraftBundle() {
-        if (this.#consumed) {
-            throw new Error("AgentsMd: cannot reuse a consumed AgentsMd in submit. Build a fresh one " +
-                "via AgentsMd.fromContent(...) / AgentsMd.fromPath(...) per submit call.");
-        }
         if (this.#ref.kind !== "draft" || !this.#zipBytes) {
             return undefined;
         }
-        this.#consumed = true;
         return {
             name: this.#ref.name,
             contentHash: this.#ref.contentHash,

package/dist/agents-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../src/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,QAAQ;IACV,IAAI,CAAiC;IACrC,SAAS,CAAyB;IAC3C,0EAA0E;IAC1E,QAAQ,CAAqB;IAE7B,YAAY,GAAmC,EAAE,QAAqB;QACpE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;IACpC,CAAC;IAED,uEAAuE;IACvE,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,uEAAuE;IACvE,cAAc,CAAC,OAAe;QAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAA+B;QACvE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,yCAAyC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7F,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;QAC9E,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA+B;QACjE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,KAAK,EAAE,IAAI,CAAC,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,8EAA8E;gBAC5E,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAQD,MAAM,iBAAiB,GAAG,mCAAmC,CAAC;AAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC"}