release: 1.4.0-alpha.4

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
   lint:
     timeout-minutes: 10
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/warp-api-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: 'ubuntu-latest'
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -42,7 +42,7 @@ jobs:
   build:
     timeout-minutes: 5
     name: build
-    runs-on: ${{ github.repository == 'stainless-sdks/warp-api-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: 'ubuntu-latest'
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     permissions:
       contents: read
@@ -68,7 +68,7 @@ jobs:
 
       - name: Get GitHub OIDC Token
         if: |-
-          github.repository == 'stainless-sdks/warp-api-typescript' &&
+          github.repository == 'warpdotdev/oz-sdk-typescript-staging' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
         uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
@@ -77,7 +77,7 @@ jobs:
 
       - name: Upload tarball
         if: |-
-          github.repository == 'stainless-sdks/warp-api-typescript' &&
+          github.repository == 'warpdotdev/oz-sdk-typescript-staging' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
@@ -87,7 +87,7 @@ jobs:
   test:
     timeout-minutes: 10
     name: test
-    runs-on: ${{ github.repository == 'stainless-sdks/warp-api-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: 'ubuntu-latest'
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.4.0-alpha.3"
+  ".": "1.4.0-alpha.4"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-0bc171e3cd0224936953898ce9b7eb35e1bf1cbf58a673fc80b32c90ce84bcd0.yml
-openapi_spec_hash: 6c7d5f294b0800e878729314f57a09f0
-config_hash: 279b20eafe220bf54131676cc0b9cdd2
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-f1e163f81d2ce61db616cd94af50251c48dab7d623cfefe0b41f169340e5ffb8.yml
+openapi_spec_hash: 0a0b08761d73dee5ce8ba69cbe1bfb9b
+config_hash: acebc71033f2d7e71ccea0bf46712ab4

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.4.0-alpha.4 (2026-06-25)
+
+Full Changelog: [v1.4.0-alpha.3...v1.4.0-alpha.4](https://github.com/warpdotdev/oz-sdk-typescript/compare/v1.4.0-alpha.3...v1.4.0-alpha.4)
+
+### Features
+
+* Allow for empty-prompt cloud-agent handoff ([9c70c23](https://github.com/warpdotdev/oz-sdk-typescript/commit/9c70c23f280621a38982ad69d5558baa19461136))
+* **api:** api update ([9962d72](https://github.com/warpdotdev/oz-sdk-typescript/commit/9962d72c129a1a366a50a234cbec55a39c405d75))
+* **api:** api update ([6ca1066](https://github.com/warpdotdev/oz-sdk-typescript/commit/6ca106630fa48317e9da4907ed56c3132b0313d8))
+* **api:** api update ([eb49f4e](https://github.com/warpdotdev/oz-sdk-typescript/commit/eb49f4e0db257b83d8bd411572b127ce57ab8bb8))
+* **api:** api update ([d63714d](https://github.com/warpdotdev/oz-sdk-typescript/commit/d63714d943829a4e8e8f3d32b7ffa91717a94fcc))
+* **api:** api update ([9a36cd0](https://github.com/warpdotdev/oz-sdk-typescript/commit/9a36cd0f406cb1872ac4f77dad9793b5950629c0))
+* Followups for docs-syncing workflow ([5352485](https://github.com/warpdotdev/oz-sdk-typescript/commit/5352485eb4a7a32ab86779d3f8911720f3f980a1))
+
+
+### Bug Fixes
+
+* **client:** send content-type header for requests with an omitted optional body ([2786b6c](https://github.com/warpdotdev/oz-sdk-typescript/commit/2786b6cda95db75f3c00a9a049cb594f35e7fdfd))
+* update flatted to resolve CVE-2026-33228 ([#32](https://github.com/warpdotdev/oz-sdk-typescript/issues/32)) ([4841416](https://github.com/warpdotdev/oz-sdk-typescript/commit/48414165a2fa1070ff1aa231a5fc309cf862daad))
+
 ## 1.4.0-alpha.3 (2026-05-22)
 
 Full Changelog: [v1.4.0-alpha.2...v1.4.0-alpha.3](https://github.com/warpdotdev/oz-sdk-typescript/compare/v1.4.0-alpha.2...v1.4.0-alpha.3)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "oz-agent-sdk",
-  "version": "1.4.0-alpha.3",
+  "version": "1.4.0-alpha.4",
   "description": "The official TypeScript library for the Oz API API",
   "author": "Oz API <>",
   "types": "dist/index.d.ts",

scripts/utils/upload-artifact.sh

@@ -20,7 +20,7 @@ UPLOAD_RESPONSE=$(curl -v -X PUT \
 
 if echo "$UPLOAD_RESPONSE" | grep -q "HTTP/[0-9.]* 200"; then
   echo -e "\033[32mUploaded build to Stainless storage.\033[0m"
-  echo -e "\033[32mInstallation: npm install 'https://pkg.stainless.com/s/warp-api-typescript/$SHA'\033[0m"
+  echo -e "\033[32mInstallation: npm install 'https://pkg.stainless.com/s/oz-sdk-typescript-staging/$SHA'\033[0m"
 else
   echo -e "\033[31mFailed to upload artifact.\033[0m"
   exit 1

src/client.ts

@@ -717,11 +717,19 @@ export class OzAPI {
     return () => controller.abort();
   }
 
-  private buildBody({ options: { body, headers: rawHeaders } }: { options: FinalRequestOptions }): {
+  private buildBody({ options }: { options: FinalRequestOptions }): {
     bodyHeaders: HeadersLike;
     body: BodyInit | undefined;
   } {
+    const { body, headers: rawHeaders } = options;
     if (!body) {
+      // A resource method always passes a `body` key when its operation defines a
+      // request body, even if the caller omitted an optional body param. Keep the
+      // content-type for those, and only elide it for operations with no body at
+      // all (e.g. GET/DELETE).
+      if (body == null && 'body' in options) {
+        return this.#encoder({ body, headers: buildHeaders([rawHeaders]) });
+      }
       return { bodyHeaders: undefined, body: undefined };
     }
     const headers = buildHeaders([rawHeaders]);

src/resources/agent/agent.ts

@@ -104,8 +104,8 @@ export class Agent extends APIResource {
   }
 
   /**
-   * Alias for POST /agent/run. This is the preferred endpoint for creating new agent
-   * runs. Behavior is identical to POST /agent/run.
+   * Spawn a cloud agent with a prompt and optional configuration. The agent will be
+   * queued for execution and assigned a unique run ID.
    *
    * @example
    * ```ts
@@ -1109,7 +1109,8 @@ export interface AgentRunParams {
 
   /**
    * The prompt/instruction for the agent to execute. Required unless a skill is
-   * specified via the skill field, config.skill_spec, or config.skills.
+   * specified via the skill field, config.skill_spec, or config.skills. Handoff
+   * requests may omit prompt when conversation_id is set.
    */
   prompt?: string;