roe-typescript 1.0.80 → 1.0.802

package/README.md

@@ -2,6 +2,10 @@
 
 TypeScript/Node SDK for the [Roe AI](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"]`
 > (or inferred types from the wrappers) where you need response shapes from
@@ -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:

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/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.80",
+  "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"