roe-typescript 1.0.80 → 1.0.803

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Roe AI
+   Copyright 2025 Roe
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,6 +1,10 @@
-# Roe AI TypeScript SDK
+# Roe TypeScript SDK
 
-TypeScript/Node SDK for the [Roe AI](https://www.roe-ai.com/) API.
+TypeScript/Node SDK for the [Roe](https://www.roe-ai.com/) API.
+
+> **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"]`
@@ -118,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:
@@ -462,6 +483,8 @@ const agent = await client.agents.create({
 
 | Model | Value |
 |-------|-------|
+| GPT-5.5 Pro | `gpt-5.5-pro-2026-04-23` |
+| GPT-5.5 | `gpt-5.5-2026-04-23` |
 | 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` |
@@ -469,6 +492,7 @@ const agent = await client.agents.create({
 | GPT-5.2 | `gpt-5.2-2025-12-11` |
 | GPT-5 | `gpt-5-2025-08-07` |
 | GPT-4.1 | `gpt-4.1-2025-04-14` |
+| Claude Opus 4.8 | `claude-opus-4-8` |
 | Claude Opus 4.7 | `claude-opus-4-7` |
 | Claude Opus 4.6 | `claude-opus-4-6` |
 | Claude Sonnet 4.6 | `claude-sonnet-4-6` |
@@ -487,10 +511,10 @@ const agent = await client.agents.create({
 | Web Insights | `URLWebsiteExtractionEngine` |
 | Interactive Web | `InteractiveWebExtractionEngine` |
 | Web Search | `URLFinderEngine` |
-| Perplexity Search | `PerplexitySearchEngine` |
+| Research | `ResearchEngine` |
 | Maps Search | `GoogleMapsEntityExtractionEngine` |
-| LinkedIn Crawler | `LinkedInScraperEngine` |
 | Social Media | `SocialScraperEngine` |
+| Marketplace Storefront Analysis | `MarketplaceStorefrontAnalysisEngine` |
 | Product Compliance | `ProductPolicyEngine` |
 | Merchant Risk | `MerchantRiskEngine` |
 | AML Investigation | `AMLInvestigationEngine` |
@@ -498,6 +522,6 @@ const agent = await client.agents.create({
 
 ## Links
 
-- [Roe AI](https://www.roe-ai.com/)
+- [Roe](https://www.roe-ai.com/)
 - [API Docs](https://docs.roe-ai.com)
 - [Changelog](CHANGELOG.md)

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 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 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 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/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,7 +1,7 @@
 {
   "name": "roe-typescript",
-  "version": "1.0.80",
-  "description": "TypeScript SDK for the Roe AI API (feature parity with roe-python).",
+  "version": "1.0.803",
+  "description": "TypeScript SDK for the Roe API (feature parity with roe-python).",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -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"