roe-typescript 1.0.79 → 1.0.802

package/README.md

@@ -2,7 +2,11 @@
 
 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.802** — Version synchronization across roe-python / roe-typescript /
+> roe-golang. No major-version migration; the public SDK packages now share a
+> single 1.0.x patch counter driven by the SDK OpenAPI spec.
+
+> **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 +72,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`:
@@ -84,6 +122,23 @@ const response = await client.raw.GET("/v1/users/current_user/");
 console.log(response.response.status);
 ```
 
+<!-- ROE-SDK:GENERATED-FRIENDLY-APIS:START -->
+## Generated Friendly APIs
+
+This block is synced from `roe-main/roe-sdk/sdk_contract.yml` during SDK fan-out.
+
+```typescript
+const engines = await client.discovery.listAgentEngineTypes();
+const models = await client.discovery.listSupportedModels("text");
+
+const upload = await client.tables.upload({
+  tableName: "customers",
+  file: "customers.csv",
+  withHeaders: true,
+});
+```
+<!-- ROE-SDK:GENERATED-FRIENDLY-APIS:END -->
+
 ## Full Example
 
 Create an agent that extracts structured data from websites:
@@ -150,6 +205,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 +483,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/api/_generated.d.ts

@@ -0,0 +1,11 @@
+import type { RoeConfig } from "../config.js";
+import type { RoeRawClient } from "../generated/client.js";
+import { DiscoveryAPI } from "./discovery.js";
+import { TablesAPI } from "./tables.js";
+export { DiscoveryAPI } from "./discovery.js";
+export { TablesAPI } from "./tables.js";
+export type GeneratedApis = {
+    readonly discovery: DiscoveryAPI;
+    readonly tables: TablesAPI;
+};
+export declare function createGeneratedApis(config: RoeConfig, raw: RoeRawClient): GeneratedApis;

package/dist/api/_generated.js

@@ -0,0 +1,13 @@
+// Auto-generated friendly API facades for the Roe AI SDK.
+// Generated by scripts/generate-sdk from openapi/wrappers.yml.
+// Do not edit by hand.
+import { DiscoveryAPI } from "./discovery.js";
+import { TablesAPI } from "./tables.js";
+export { DiscoveryAPI } from "./discovery.js";
+export { TablesAPI } from "./tables.js";
+export function createGeneratedApis(config, raw) {
+    return {
+        discovery: new DiscoveryAPI(config, raw),
+        tables: new TablesAPI(config, raw),
+    };
+}

package/dist/api/discovery.d.ts

@@ -0,0 +1,16 @@
+import type { RoeConfig } from "../config.js";
+import type { RoeRawClient } from "../generated/client.js";
+import type { components } from "../generated/schema.js";
+type AgentEngineTypeList = components["schemas"]["AgentEngineTypeList"];
+type SupportedLLMModelList = components["schemas"]["SupportedLLMModelList"];
+export declare class DiscoveryAPI {
+    readonly config: RoeConfig;
+    readonly raw: RoeRawClient;
+    /** API for discovering valid agent engine types and model IDs. */
+    constructor(config: RoeConfig, raw: RoeRawClient);
+    /** Return production engine_class_id values accepted by agent creation. */
+    listAgentEngineTypes(): Promise<AgentEngineTypeList>;
+    /** Return non-deprecated model IDs accepted in engine_config.model. */
+    listSupportedModels(capability?: string | null): Promise<SupportedLLMModelList>;
+}
+export {};

package/dist/api/discovery.js

@@ -0,0 +1,31 @@
+// Auto-generated friendly API facades for the Roe AI SDK.
+// Generated by scripts/generate-sdk from openapi/wrappers.yml.
+// Do not edit by hand.
+import { RoeAPIException } from "../exceptions.js";
+export class DiscoveryAPI {
+    /** API for discovering valid agent engine types and model IDs. */
+    constructor(config, raw) {
+        this.config = config;
+        this.raw = raw;
+    }
+    /** Return production engine_class_id values accepted by agent creation. */
+    async listAgentEngineTypes() {
+        const result = await this.raw.GET("/v1/agents/types/");
+        if (result.data == null) {
+            throw new RoeAPIException("agent engine discovery returned an empty response");
+        }
+        return result.data;
+    }
+    /** Return non-deprecated model IDs accepted in engine_config.model. */
+    async listSupportedModels(capability) {
+        const query = {};
+        if (capability != null)
+            query["capability"] = capability;
+        const init = Object.keys(query).length > 0 ? { params: { query } } : undefined;
+        const result = await this.raw.GET("/v1/agents/models/", init);
+        if (result.data == null) {
+            throw new RoeAPIException("model discovery returned an empty response");
+        }
+        return result.data;
+    }
+}

package/dist/api/tables.d.ts

@@ -0,0 +1,21 @@
+import type { RoeConfig } from "../config.js";
+import type { RoeRawClient } from "../generated/client.js";
+import type { components } from "../generated/schema.js";
+import type { FileUpload } from "../models/file.js";
+type TableUploadResponse = components["schemas"]["TableUploadResponse"];
+export type TableUploadFile = string | NodeJS.ReadableStream | FileUpload;
+export type TableUploadParams = {
+    tableName: string;
+    file: TableUploadFile;
+    withHeaders?: boolean;
+    organizationId?: string | null;
+};
+export declare class TablesAPI {
+    readonly config: RoeConfig;
+    readonly raw: RoeRawClient;
+    /** API for uploading CSV files into Roe tables. */
+    constructor(config: RoeConfig, raw: RoeRawClient);
+    /** Upload a CSV file and create a Roe table. */
+    upload(params: TableUploadParams): Promise<TableUploadResponse>;
+}
+export {};

package/dist/api/tables.js

@@ -0,0 +1,26 @@
+// Auto-generated friendly API facades for the Roe AI SDK.
+// Generated by scripts/generate-sdk from openapi/wrappers.yml.
+// Do not edit by hand.
+import { RoeAPIException } from "../exceptions.js";
+import { postDynamicInputs } from "../utils/dynamicInputs.js";
+export class TablesAPI {
+    /** API for uploading CSV files into Roe tables. */
+    constructor(config, raw) {
+        this.config = config;
+        this.raw = raw;
+    }
+    /** Upload a CSV file and create a Roe table. */
+    async upload(params) {
+        const inputs = {
+            table_name: params.tableName,
+            file: params.file,
+            with_headers: params.withHeaders ?? true,
+            organization_id: params.organizationId ?? this.config.organizationId,
+        };
+        const data = await postDynamicInputs(this.raw, "/v1/tables/upload/", {}, {}, inputs, undefined, this.config.maxRetries);
+        if (data == null) {
+            throw new RoeAPIException("table upload returned an empty response");
+        }
+        return data;
+    }
+}

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/dist/client.d.ts

@@ -1,4 +1,5 @@
 import { AgentsAPI } from "./api/agents.js";
+import { type GeneratedApis } from "./api/_generated.js";
 import { PoliciesAPI } from "./api/policies.js";
 import { UsersAPI } from "./api/users.js";
 import { RoeAuth } from "./auth.js";
@@ -18,3 +19,5 @@ export declare class RoeClient {
     /** No-op kept for source compatibility; the raw client manages its own connections. */
     close(): void;
 }
+export interface RoeClient extends GeneratedApis {
+}

package/dist/client.js

@@ -1,4 +1,5 @@
 import { AgentsAPI } from "./api/agents.js";
+import { createGeneratedApis } from "./api/_generated.js";
 import { PoliciesAPI } from "./api/policies.js";
 import { UsersAPI } from "./api/users.js";
 import { RoeAuth } from "./auth.js";
@@ -18,6 +19,7 @@ export class RoeClient {
         this._agents = new AgentsAPI(this.config, this.raw);
         this._policies = new PoliciesAPI(this.config, this.raw);
         this._users = new UsersAPI(this.config, this.raw);
+        Object.assign(this, createGeneratedApis(this.config, this.raw));
     }
     get agents() {
         return this._agents;

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { createRoeRawClient } from "./generated/client.js";
 export type { RoeApiComponents, RoeApiPaths, RoeRawClient } from "./generated/client.js";
 export type { components, paths } from "./generated/schema.js";
 export * from "./exceptions.js";
+export * from "./api/_generated.js";
 export * from "./api/agents.js";
 export * from "./api/policies.js";
 export * from "./api/users.js";

package/dist/index.js

@@ -3,6 +3,7 @@ export { RoeConfig } from "./config.js";
 export { RoeAuth } from "./auth.js";
 export { createRoeRawClient } from "./generated/client.js";
 export * from "./exceptions.js";
+export * from "./api/_generated.js";
 export * from "./api/agents.js";
 export * from "./api/policies.js";
 export * from "./api/users.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roe-typescript",
-  "version": "1.0.79",
+  "version": "1.0.802",
   "description": "TypeScript SDK for the Roe AI API (feature parity with roe-python).",
   "type": "module",
   "main": "dist/index.js",
@@ -29,6 +29,7 @@
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.9.0",
     "@types/uuid": "^10.0.0",
+    "js-yaml": "^4.1.1",
     "openapi-typescript": "^7.6.1",
     "typescript": "^5.6.3",
     "vitest": "^1.6.0"