roe-typescript 1.0.79 → 1.0.80

package/README.md

@@ -2,7 +2,7 @@
 
 TypeScript/Node SDK for the [Roe AI](https://www.roe-ai.com/) API.
 
-> **v1.0.79** — `RoeHTTPClient`/axios were replaced by the generated
+> **v1.0.80** — `RoeHTTPClient`/axios were replaced by the generated
 > `openapi-fetch` client exposed as `client.raw`; use `components["schemas"]`
 > (or inferred types from the wrappers) where you need response shapes from
 > the OpenAPI definitions. Highlights and migration notes across releases live
@@ -68,6 +68,40 @@ result.error_message // Error string or null
 result.outputs       // AgentDatum[] from components["schemas"]["AgentDatum"]
 ```
 
+## Errors
+
+Non-2xx responses throw typed exceptions from `roe-typescript`, all
+subclasses of `RoeAPIException`. Use them to handle expected failures
+without parsing error strings:
+
+```typescript
+import {
+  RoeAPIException,
+  BadRequestError,          // 400 — validation / bad input
+  AuthenticationError,      // 401 — missing or invalid API key
+  InsufficientCreditsError, // 402 — plan limit / billing
+  ForbiddenError,           // 403 — feature or resource forbidden
+  NotFoundError,            // 404 — resource not found
+  RateLimitError,           // 429 — throttled
+  ServerError,              // 5xx — server-side
+} from "roe-typescript";
+
+try {
+  await client.agents.retrieve("00000000-0000-0000-0000-000000000000");
+} catch (err) {
+  if (err instanceof NotFoundError) {
+    console.log(err.statusCode, err.message);
+  } else {
+    throw err;
+  }
+}
+```
+
+`job.wait()` does not throw on agent-side failures — instead the returned
+result carries `result.status === JobStatus.FAILURE` and
+`result.error_message`. Transport / HTTP errors hit the typed hierarchy
+above.
+
 ## Raw API Access
 
 The generated raw client is exposed as `client.raw`:
@@ -150,6 +184,10 @@ client.agents.delete("agent-uuid")          // Delete agent
 client.agents.duplicate("agent-uuid")       // Duplicate agent
 ```
 
+> `agents.duplicate(...)` returns an `AgentVersion` (the new agent's first
+> version), **not** a `BaseAgent`. The new agent's `id` is reachable on the
+> returned object as `.base_agent.id`.
+
 ### Running Agents
 
 ```typescript
@@ -424,30 +462,20 @@ const agent = await client.agents.create({
 
 | Model | Value |
 |-------|-------|
+| GPT-5.4 Pro | `gpt-5.4-pro-2026-03-05` |
 | GPT-5.4 | `gpt-5.4-2026-03-05` |
+| GPT-5.4 Mini | `gpt-5.4-mini-2026-03-17` |
+| GPT-5.4 Nano | `gpt-5.4-nano-2026-03-17` |
 | GPT-5.2 | `gpt-5.2-2025-12-11` |
-| GPT-5.1 | `gpt-5.1-2025-11-13` |
 | GPT-5 | `gpt-5-2025-08-07` |
-| GPT-5 Mini | `gpt-5-mini-2025-08-07` |
 | GPT-4.1 | `gpt-4.1-2025-04-14` |
-| GPT-4.1 Mini | `gpt-4.1-mini-2025-04-14` |
-| O3 Pro | `o3-pro-2025-06-10` |
-| O3 | `o3-2025-04-16` |
-| O4 Mini | `o4-mini-2025-04-16` |
+| Claude Opus 4.7 | `claude-opus-4-7` |
 | Claude Opus 4.6 | `claude-opus-4-6` |
 | Claude Sonnet 4.6 | `claude-sonnet-4-6` |
-| Claude Opus 4.5 | `claude-opus-4-5-20251101` |
-| Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` |
-| Claude Opus 4.1 | `claude-opus-4-1-20250805` |
-| Claude Opus 4 | `claude-opus-4-20250514` |
-| Claude Sonnet 4 | `claude-sonnet-4-20250514` |
 | Claude Haiku 4.5 | `claude-haiku-4-5-20251001` |
-| Gemini 3 Pro | `gemini-3-pro-preview` |
+| Gemini 3.1 Pro | `gemini-3.1-pro-preview` |
 | Gemini 3 Flash | `gemini-3-flash-preview` |
-| Gemini 2.5 Pro | `gemini-2.5-pro` |
-| Gemini 2.5 Flash | `gemini-2.5-flash` |
-| Grok 4 | `grok-4-0709` |
-| Grok 4.1 Fast Reasoning | `grok-4-1-fast-reasoning` |
+| Grok 4.20 Reasoning | `grok-4.20-0309-reasoning` |
 
 ## Engine Classes
 

package/dist/auth.js

@@ -1,3 +1,22 @@
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+// Resolve the package's own version at runtime so the User-Agent doesn't
+// silently drift across releases when the auto-release pipeline bumps
+// package.json without touching this file. Falls back to "0.0.0" if the
+// compiled module can't locate package.json (e.g. bundled by a downstream
+// consumer that strips the surrounding file tree).
+function resolvePackageVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const SDK_VERSION = resolvePackageVersion();
 export class RoeAuth {
     constructor(config) {
         this.config = config;
@@ -5,7 +24,7 @@ export class RoeAuth {
     getHeaders() {
         return {
             Authorization: `Bearer ${this.config.apiKey}`,
-            "User-Agent": "roe-typescript/0.1.0",
+            "User-Agent": `roe-typescript/${SDK_VERSION}`,
         };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roe-typescript",
-  "version": "1.0.79",
+  "version": "1.0.80",
   "description": "TypeScript SDK for the Roe AI API (feature parity with roe-python).",
   "type": "module",
   "main": "dist/index.js",