roe-typescript 1.0.803 → 1.1.1

package/README.md

@@ -2,9 +2,11 @@
 
 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.
+<!-- ROE-SDK:RELEASE-BANNER:START -->
+> **v1.1.1** - SDK operation coverage is synchronized across Python,
+> TypeScript, and Go. See `SDK_EXAMPLES.md` for copy-ready examples and use
+> cases.
+<!-- ROE-SDK:RELEASE-BANNER:END -->
 
 > **v1.0.80** — `RoeHTTPClient`/axios were replaced by the generated
 > `openapi-fetch` client exposed as `client.raw`; use `components["schemas"]`
@@ -123,9 +125,9 @@ console.log(response.response.status);
 ```
 
 <!-- ROE-SDK:GENERATED-FRIENDLY-APIS:START -->
-## Generated Friendly APIs
+## SDK Operation Groups
 
-This block is synced from `roe-main/roe-sdk/sdk_contract.yml` during SDK fan-out.
+Common operations are available directly on the SDK client.
 
 ```typescript
 const engines = await client.discovery.listAgentEngineTypes();
@@ -520,6 +522,16 @@ const agent = await client.agents.create({
 | AML Investigation | `AMLInvestigationEngine` |
 | Fraud Investigation | `FraudInvestigationEngine` |
 
+## Development
+
+Before opening a PR, format and lint the codebase by running:
+
+```bash
+./roe-cli format
+```
+
+CI runs the same checks (`biome ci`) on every pull request and on merges to `main`, and they must pass before a PR can be merged.
+
 ## Links
 
 - [Roe](https://www.roe-ai.com/)

package/dist/api/agents.d.ts

@@ -5,7 +5,8 @@ import { Job, JobBatch } from "../models/job.js";
 type BaseAgent = components["schemas"]["BaseAgent"];
 type PaginatedBaseAgentList = components["schemas"]["PaginatedBaseAgentList"];
 type AgentVersion = components["schemas"]["AgentVersion"];
-type AgentJobStatus = components["schemas"]["AgentJobStatus"];
+type AgentJobStatus = components["schemas"]["AgentJobSingleStatus"];
+type AgentJobBatchStatus = components["schemas"]["AgentJobStatus"];
 type AgentJobResultItem = components["schemas"]["AgentJobResultItem"];
 type AgentJobDeleteDataResponse = components["schemas"]["AgentJobDeleteDataResponse"];
 type AgentDatum = components["schemas"]["AgentDatum"];
@@ -38,7 +39,7 @@ export declare class AgentJobsAPI {
     private get organizationId();
     retrieveStatus(jobId: string): Promise<AgentJobStatus>;
     retrieveResult(jobId: string): Promise<components["schemas"]["AgentJobResultResponse"]>;
-    retrieveStatusMany(jobIds: string[]): Promise<AgentJobStatus[]>;
+    retrieveStatusMany(jobIds: string[]): Promise<AgentJobBatchStatus[]>;
     retrieveResultMany(jobIds: string[]): Promise<AgentJobResultItem[]>;
     downloadReference(jobId: string, resourceId: string, asAttachment?: boolean): Promise<Buffer>;
     cancel(jobId: string): Promise<void>;
@@ -83,7 +84,6 @@ export declare class AgentsAPI {
         agentId: string;
         batchInputs: Record<string, unknown>[];
         timeoutSeconds?: number;
-        metadata?: Record<string, unknown>;
     }): Promise<JobBatch>;
     runSync(agentId: string, inputs: Record<string, unknown>, metadata?: Record<string, unknown>): Promise<AgentDatum[]>;
     runVersion(params: {

package/dist/api/agents.js

@@ -1,7 +1,7 @@
-import { isUuidString } from "../utils/fileDetection.js";
-import { postDynamicInputs } from "../utils/dynamicInputs.js";
 import { BadRequestError, RoeAPIException } from "../exceptions.js";
 import { Job, JobBatch } from "../models/job.js";
+import { postDynamicInputs } from "../utils/dynamicInputs.js";
+import { isUuidString } from "../utils/fileDetection.js";
 function validateUuid(value, fieldName) {
     if (!isUuidString(value)) {
         throw new BadRequestError(`Invalid ${fieldName}: "${value}" is not a valid UUID`, 400);
@@ -30,7 +30,9 @@ export class AgentVersionsAPI {
     async retrieve(agentId, versionId, getSupportsEval) {
         validateUuid(agentId, "agentId");
         validateUuid(versionId, "versionId");
-        const query = { organization_id: this.organizationId };
+        const query = {
+            organization_id: this.organizationId,
+        };
         if (getSupportsEval !== undefined)
             query.get_supports_eval = String(getSupportsEval).toLowerCase();
         const { data } = await this.raw.GET("/v1/agents/{agent_id}/versions/{agent_version_id}/", {
@@ -154,11 +156,12 @@ export class AgentJobsAPI {
                 params: { query: { organization_id: this.organizationId } },
                 body: { job_ids: chunk },
             });
-            if (Array.isArray(data)) {
-                results.push(...data);
+            const payload = data;
+            if (Array.isArray(payload)) {
+                results.push(...payload);
             }
-            else if (data?.results) {
-                results.push(...data.results);
+            else if (payload?.results) {
+                results.push(...payload.results);
             }
         }
         return results;
@@ -168,7 +171,9 @@ export class AgentJobsAPI {
         // The endpoint streams binary; openapi-fetch's typed GET expects a JSON
         // response per the spec, so we use parseAs:"arrayBuffer" to skip JSON
         // parsing and read raw bytes.
-        const query = { organization_id: this.organizationId };
+        const query = {
+            organization_id: this.organizationId,
+        };
         if (asAttachment)
             query.download = "true";
         const result = await this.raw.GET("/v1/agents/jobs/{agent_job_id}/references/{resource_id}/", {
@@ -304,7 +309,11 @@ export class AgentsAPI {
         validateUuid(params.agentId, "agentId");
         const response = await postDynamicInputs(this.raw, "/v1/agents/run/{agent_id}/async/", { agent_id: params.agentId }, { organization_id: this.config.organizationId }, params.inputs, params.metadata, this.config.maxRetries);
         const jobId = this.extractJobId(response);
-        return new Job({ agentsApi: this, jobId, timeoutSeconds: params.timeoutSeconds });
+        return new Job({
+            agentsApi: this,
+            jobId,
+            timeoutSeconds: params.timeoutSeconds,
+        });
     }
     async runMany(params) {
         validateUuid(params.agentId, "agentId");
@@ -312,17 +321,12 @@ export class AgentsAPI {
         for (const chunk of this.iterChunks(params.batchInputs, AgentsAPI.MAX_BATCH_SIZE)) {
             if (!chunk.length)
                 continue;
-            // Generated request type only models { inputs }, but the backend also
-            // accepts a sibling `metadata` field — attach it via a serializer cast.
-            const body = { inputs: chunk };
-            if (params.metadata !== undefined)
-                body.metadata = params.metadata;
             const { data } = await this.raw.POST("/v1/agents/run/{agent_id}/async/many/", {
                 params: {
                     path: { agent_id: params.agentId },
                     query: { organization_id: this.config.organizationId },
                 },
-                body: body,
+                body: { inputs: chunk },
             });
             const ids = Array.isArray(data) ? data : [];
             for (const jobId of ids) {
@@ -332,7 +336,11 @@ export class AgentsAPI {
                 allJobIds.push(jobId);
             }
         }
-        return new JobBatch({ agentsApi: this, jobIds: allJobIds, timeoutSeconds: params.timeoutSeconds });
+        return new JobBatch({
+            agentsApi: this,
+            jobIds: allJobIds,
+            timeoutSeconds: params.timeoutSeconds,
+        });
     }
     async runSync(agentId, inputs, metadata) {
         validateUuid(agentId, "agentId");
@@ -343,7 +351,11 @@ export class AgentsAPI {
         validateUuid(params.versionId, "versionId");
         const response = await postDynamicInputs(this.raw, "/v1/agents/run/{agent_id}/versions/{agent_version_id}/async/", { agent_id: params.agentId, agent_version_id: params.versionId }, { organization_id: this.config.organizationId }, params.inputs, params.metadata, this.config.maxRetries);
         const jobId = this.extractJobId(response);
-        return new Job({ agentsApi: this, jobId, timeoutSeconds: params.timeoutSeconds });
+        return new Job({
+            agentsApi: this,
+            jobId,
+            timeoutSeconds: params.timeoutSeconds,
+        });
     }
     async runVersionSync(agentId, versionId, inputs, metadata) {
         validateUuid(agentId, "agentId");

package/dist/api/discovery.d.ts

@@ -8,6 +8,8 @@ export declare class DiscoveryAPI {
     readonly raw: RoeRawClient;
     /** API for discovering valid agent engine types and model IDs. */
     constructor(config: RoeConfig, raw: RoeRawClient);
+    protected get rawClient(): RoeRawClient;
+    protected get organizationId(): string;
     /** Return production engine_class_id values accepted by agent creation. */
     listAgentEngineTypes(): Promise<AgentEngineTypeList>;
     /** Return non-deprecated model IDs accepted in engine_config.model. */

package/dist/api/discovery.js

@@ -8,6 +8,12 @@ export class DiscoveryAPI {
         this.config = config;
         this.raw = raw;
     }
+    get rawClient() {
+        return this.raw;
+    }
+    get organizationId() {
+        return this.config.organizationId;
+    }
     /** Return production engine_class_id values accepted by agent creation. */
     async listAgentEngineTypes() {
         const result = await this.raw.GET("/v1/agents/types/");

package/dist/api/policies.d.ts

@@ -1,18 +1,22 @@
-import { RoeConfig } from "../config.js";
+import type { RoeConfig } from "../config.js";
 import type { RoeRawClient } from "../generated/client.js";
 import type { components } from "../generated/schema.js";
-type Policy = components["schemas"]["Policy"];
 type CreatePolicy = components["schemas"]["CreatePolicy"];
-type UpdatePolicy = components["schemas"]["UpdatePolicy"];
-type PolicyVersion = components["schemas"]["PolicyVersion"];
 type PaginatedPolicyList = components["schemas"]["PaginatedPolicyList"];
+type Policy = components["schemas"]["Policy"];
+type PolicyVersion = components["schemas"]["PolicyVersion"];
+type UpdatePolicy = components["schemas"]["UpdatePolicy"];
 export declare class PolicyVersionsAPI {
     private readonly policiesApi;
+    /** API for managing the versions of a policy. */
     constructor(policiesApi: PoliciesAPI);
-    private get raw();
-    private get organizationId();
+    protected get rawClient(): RoeRawClient;
+    protected get organizationId(): string;
+    /** List all versions of a policy. */
     list(policyId: string): Promise<PolicyVersion[]>;
+    /** Retrieve a single policy version. */
     retrieve(policyId: string, versionId: string): Promise<PolicyVersion>;
+    /** Create a new version of a policy. */
     create(params: {
         policyId: string;
         content: Record<string, unknown>;
@@ -23,23 +27,31 @@ export declare class PolicyVersionsAPI {
 export declare class PoliciesAPI {
     readonly config: RoeConfig;
     readonly raw: RoeRawClient;
+    /** API for managing Roe policies and their versions. */
     readonly versions: PolicyVersionsAPI;
     constructor(config: RoeConfig, raw: RoeRawClient);
+    protected get rawClient(): RoeRawClient;
+    protected get organizationId(): string;
+    /** List policies in the organization (paginated). */
     list(params?: {
         page?: number;
         pageSize?: number;
     }): Promise<PaginatedPolicyList>;
+    /** Retrieve a single policy by ID. */
     retrieve(policyId: string): Promise<Policy>;
+    /** Create a new policy together with its first version. */
     create(params: {
         name: string;
         content: Record<string, unknown>;
         description?: string;
         versionName?: string;
     }): Promise<CreatePolicy>;
+    /** Update mutable fields of a policy. */
     update(policyId: string, updates: {
         name?: string;
         description?: string;
     }): Promise<UpdatePolicy>;
+    /** Delete a policy. */
     delete(policyId: string): Promise<void>;
 }
 export {};

package/dist/api/policies.js

@@ -1,38 +1,40 @@
-import { isUuidString } from "../utils/fileDetection.js";
+// Auto-generated friendly API facades for the Roe SDK.
+// Generated by scripts/generate-sdk from openapi/wrappers.yml.
+// Do not edit by hand.
 import { BadRequestError, RoeAPIException } from "../exceptions.js";
-/**
- * Validates that a value is a valid UUID string.
- * @throws BadRequestError if the value is not a valid UUID
- */
+import { isUuidString } from "../utils/fileDetection.js";
 function validateUuid(value, fieldName) {
     if (!isUuidString(value)) {
         throw new BadRequestError(`Invalid ${fieldName}: "${value}" is not a valid UUID`, 400);
     }
 }
 export class PolicyVersionsAPI {
+    /** API for managing the versions of a policy. */
     constructor(policiesApi) {
         this.policiesApi = policiesApi;
     }
-    get raw() {
+    get rawClient() {
         return this.policiesApi.raw;
     }
     get organizationId() {
         return this.policiesApi.config.organizationId;
     }
+    /** List all versions of a policy. */
     async list(policyId) {
         validateUuid(policyId, "policyId");
-        const { data } = await this.raw.GET("/v1/policies/{policy_id}/versions/", {
+        const { data } = await this.rawClient.GET("/v1/policies/{policy_id}/versions/", {
             params: {
                 path: { policy_id: policyId },
                 query: { organization_id: this.organizationId },
             },
         });
-        return data?.results ?? [];
+        return (data?.results ?? []);
     }
+    /** Retrieve a single policy version. */
     async retrieve(policyId, versionId) {
         validateUuid(policyId, "policyId");
         validateUuid(versionId, "versionId");
-        const { data } = await this.raw.GET("/v1/policies/{policy_id}/versions/{version_id}/", {
+        const { data } = await this.rawClient.GET("/v1/policies/{policy_id}/versions/{version_id}/", {
             params: {
                 path: { policy_id: policyId, version_id: versionId },
                 query: { organization_id: this.organizationId },
@@ -40,18 +42,21 @@ export class PolicyVersionsAPI {
         });
         return data;
     }
+    /** Create a new version of a policy. */
     async create(params) {
         validateUuid(params.policyId, "policyId");
-        if (params.baseVersionId !== undefined)
+        if (params.baseVersionId != null)
             validateUuid(params.baseVersionId, "baseVersionId");
         const body = {
             content: params.content,
+            ...(params.versionName !== undefined
+                ? { version_name: params.versionName }
+                : {}),
+            ...(params.baseVersionId !== undefined
+                ? { base_version_id: params.baseVersionId }
+                : {}),
         };
-        if (params.versionName !== undefined)
-            body.version_name = params.versionName;
-        if (params.baseVersionId !== undefined)
-            body.base_version_id = params.baseVersionId;
-        const { data } = await this.raw.POST("/v1/policies/{policy_id}/versions/", {
+        const { data } = await this.rawClient.POST("/v1/policies/{policy_id}/versions/", {
             params: {
                 path: { policy_id: params.policyId },
                 query: { organization_id: this.organizationId },
@@ -61,7 +66,6 @@ export class PolicyVersionsAPI {
         if (!data?.id) {
             throw new RoeAPIException(`Unexpected response from server: ${JSON.stringify(data)}`);
         }
-        // POST returns a partial CreatePolicyVersion; re-fetch to get the full version.
         return this.retrieve(params.policyId, data.id);
     }
 }
@@ -71,28 +75,39 @@ export class PoliciesAPI {
         this.raw = raw;
         this.versions = new PolicyVersionsAPI(this);
     }
+    get rawClient() {
+        return this.raw;
+    }
+    get organizationId() {
+        return this.config.organizationId;
+    }
+    /** List policies in the organization (paginated). */
     async list(params) {
-        const { data } = await this.raw.GET("/v1/policies/", {
+        const { data } = await this.rawClient.GET("/v1/policies/", {
             params: {
                 query: {
-                    organization_id: this.config.organizationId,
-                    page: params?.page,
-                    page_size: params?.pageSize,
+                    organization_id: this.organizationId,
+                    ...(params?.page !== undefined ? { page: params?.page } : {}),
+                    ...(params?.pageSize !== undefined
+                        ? { page_size: params?.pageSize }
+                        : {}),
                 },
             },
         });
         return data;
     }
+    /** Retrieve a single policy by ID. */
     async retrieve(policyId) {
         validateUuid(policyId, "policyId");
-        const { data } = await this.raw.GET("/v1/policies/{id}/", {
+        const { data } = await this.rawClient.GET("/v1/policies/{id}/", {
             params: {
                 path: { id: policyId },
-                query: { organization_id: this.config.organizationId },
+                query: { organization_id: this.organizationId },
             },
         });
         return data;
     }
+    /** Create a new policy together with its first version. */
     async create(params) {
         const body = {
             name: params.name,
@@ -100,34 +115,37 @@ export class PoliciesAPI {
             description: params.description ?? "",
             version_name: params.versionName ?? "version 1",
         };
-        const { data } = await this.raw.POST("/v1/policies/", {
-            params: { query: { organization_id: this.config.organizationId } },
+        const { data } = await this.rawClient.POST("/v1/policies/", {
+            params: { query: { organization_id: this.organizationId } },
             body,
         });
         return data;
     }
+    /** Update mutable fields of a policy. */
     async update(policyId, updates) {
         validateUuid(policyId, "policyId");
-        const body = {};
-        if (updates.name !== undefined)
-            body.name = updates.name;
-        if (updates.description !== undefined)
-            body.description = updates.description;
-        const { data } = await this.raw.PATCH("/v1/policies/{id}/", {
+        const body = {
+            ...(updates.name !== undefined ? { name: updates.name } : {}),
+            ...(updates.description !== undefined
+                ? { description: updates.description }
+                : {}),
+        };
+        const { data } = await this.rawClient.PATCH("/v1/policies/{id}/", {
             params: {
                 path: { id: policyId },
-                query: { organization_id: this.config.organizationId },
+                query: { organization_id: this.organizationId },
             },
             body,
         });
         return data;
     }
+    /** Delete a policy. */
     async delete(policyId) {
         validateUuid(policyId, "policyId");
-        await this.raw.DELETE("/v1/policies/{id}/", {
+        await this.rawClient.DELETE("/v1/policies/{id}/", {
             params: {
                 path: { id: policyId },
-                query: { organization_id: this.config.organizationId },
+                query: { organization_id: this.organizationId },
             },
         });
     }

package/dist/api/tables.d.ts

@@ -15,6 +15,8 @@ export declare class TablesAPI {
     readonly raw: RoeRawClient;
     /** API for uploading CSV files into Roe tables. */
     constructor(config: RoeConfig, raw: RoeRawClient);
+    protected get rawClient(): RoeRawClient;
+    protected get organizationId(): string;
     /** Upload a CSV file and create a Roe table. */
     upload(params: TableUploadParams): Promise<TableUploadResponse>;
 }

package/dist/api/tables.js

@@ -9,6 +9,12 @@ export class TablesAPI {
         this.config = config;
         this.raw = raw;
     }
+    get rawClient() {
+        return this.raw;
+    }
+    get organizationId() {
+        return this.config.organizationId;
+    }
     /** Upload a CSV file and create a Roe table. */
     async upload(params) {
         const inputs = {

package/dist/auth.d.ts

@@ -1,4 +1,4 @@
-import { RoeConfig } from "./config.js";
+import type { RoeConfig } from "./config.js";
 export declare class RoeAuth {
     private readonly config;
     constructor(config: RoeConfig);

package/dist/auth.js

@@ -1,6 +1,6 @@
-import { readFileSync } from "fs";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 // 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

package/dist/client.d.ts

@@ -1,9 +1,9 @@
-import { AgentsAPI } from "./api/agents.js";
 import { type GeneratedApis } from "./api/_generated.js";
+import { AgentsAPI } from "./api/agents.js";
 import { PoliciesAPI } from "./api/policies.js";
 import { UsersAPI } from "./api/users.js";
 import { RoeAuth } from "./auth.js";
-import { RoeConfig, RoeConfigInput } from "./config.js";
+import { RoeConfig, type RoeConfigInput } from "./config.js";
 import { type RoeRawClient } from "./generated/client.js";
 export declare class RoeClient {
     readonly config: RoeConfig;

package/dist/client.js

@@ -1,5 +1,5 @@
-import { AgentsAPI } from "./api/agents.js";
 import { createGeneratedApis } from "./api/_generated.js";
+import { AgentsAPI } from "./api/agents.js";
 import { PoliciesAPI } from "./api/policies.js";
 import { UsersAPI } from "./api/users.js";
 import { RoeAuth } from "./auth.js";

package/dist/config.js

@@ -11,7 +11,9 @@ export class RoeConfig {
         const organizationId = input.organizationId ?? process.env.ROE_ORGANIZATION_ID;
         const baseUrl = input.baseUrl ?? process.env.ROE_BASE_URL ?? "https://api.roe-ai.com";
         // Parse ROE_TIMEOUT with NaN check to avoid poisoning timeoutMs
-        const timeoutSecondsEnvRaw = process.env.ROE_TIMEOUT ? Number(process.env.ROE_TIMEOUT) : undefined;
+        const timeoutSecondsEnvRaw = process.env.ROE_TIMEOUT
+            ? Number(process.env.ROE_TIMEOUT)
+            : undefined;
         const timeoutSecondsEnv = timeoutSecondsEnvRaw !== undefined && !Number.isNaN(timeoutSecondsEnvRaw)
             ? timeoutSecondsEnvRaw
             : undefined;

package/dist/exceptions.js

@@ -70,7 +70,9 @@ export function extractErrorMessage(data, statusCode) {
             const firstError = obj.errors[0];
             if (typeof firstError === "string")
                 return firstError;
-            if (typeof firstError === "object" && firstError !== null && typeof firstError.message === "string") {
+            if (typeof firstError === "object" &&
+                firstError !== null &&
+                typeof firstError.message === "string") {
                 return firstError.message;
             }
         }

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-export { RoeClient } from "./client.js";
-export { RoeConfig } from "./config.js";
-export type { RoeConfigInput } from "./config.js";
-export { RoeAuth } from "./auth.js";
-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";
-export { Job, JobBatch, JobStatus } from "./models/job.js";
-export type { JobResult, JobBatchItem } from "./models/job.js";
+export { RoeAuth } from "./auth.js";
+export { RoeClient } from "./client.js";
+export type { RoeConfigInput } from "./config.js";
+export { RoeConfig } from "./config.js";
+export * from "./exceptions.js";
+export type { RoeApiComponents, RoeApiPaths, RoeRawClient, } from "./generated/client.js";
+export { createRoeRawClient } from "./generated/client.js";
+export type { components, paths } from "./generated/schema.js";
 export { FileUpload } from "./models/file.js";
+export type { JobBatchItem, JobResult } from "./models/job.js";
+export { Job, JobBatch, JobStatus } from "./models/job.js";

package/dist/index.js

@@ -1,14 +1,14 @@
-export { RoeClient } from "./client.js";
-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";
-export { Job, JobBatch, JobStatus } from "./models/job.js";
+export { RoeAuth } from "./auth.js";
+export { RoeClient } from "./client.js";
+export { RoeConfig } from "./config.js";
+export * from "./exceptions.js";
+export { createRoeRawClient } from "./generated/client.js";
 export { FileUpload } from "./models/file.js";
+export { Job, JobBatch, JobStatus } from "./models/job.js";
 // Hand-written response models removed in v1.0 (Agent, BaseAgent, Policy, PolicyVersion,
 // AgentVersion, AgentDatum, AgentJobResult, AgentJobStatus, Reference, JobDataDeleteResponse,
 // PaginatedResponse, UserInfo). Import the generated equivalents instead, e.g.:

package/dist/models/file.js

@@ -1,5 +1,5 @@
-import fs from "fs";
-import path from "path";
+import fs from "node:fs";
+import path from "node:path";
 import mime from "mime-types";
 import { BadRequestError } from "../exceptions.js";
 /** Maximum file size: 2GB (aligned with main-roe backend) */
@@ -89,7 +89,9 @@ export class FileUpload {
             for await (const chunk of this.file) {
                 chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
             }
-            this._streamBlob = new Blob([Buffer.concat(chunks)], { type: this.effectiveMimeType });
+            this._streamBlob = new Blob([Buffer.concat(chunks)], {
+                type: this.effectiveMimeType,
+            });
             return this._streamBlob;
         }
         throw new Error("No file source available");

package/dist/models/job.d.ts

@@ -1,4 +1,4 @@
-import { AgentsAPI } from "../api/agents.js";
+import type { AgentsAPI } from "../api/agents.js";
 import type { components } from "../generated/schema.js";
 export declare enum JobStatus {
     PENDING = 0,
@@ -9,7 +9,7 @@ export declare enum JobStatus {
     CANCELLED = 5,
     CACHED = 6
 }
-type AgentJobStatus = components["schemas"]["AgentJobStatus"];
+type AgentJobStatus = components["schemas"]["AgentJobSingleStatus"];
 type AgentJobResultResponse = components["schemas"]["AgentJobResultResponse"];
 type AgentJobResultItem = components["schemas"]["AgentJobResultItem"];
 type AgentDatum = components["schemas"]["AgentDatum"];

package/dist/models/job.js

@@ -81,7 +81,11 @@ export class JobBatch {
         }
     }
     get jobs() {
-        return this.jobIds.map((id) => new Job({ agentsApi: this.agentsApi, jobId: id, timeoutSeconds: this.timeoutSeconds }));
+        return this.jobIds.map((id) => new Job({
+            agentsApi: this.agentsApi,
+            jobId: id,
+            timeoutSeconds: this.timeoutSeconds,
+        }));
     }
     async wait(params) {
         const intervalSeconds = params?.intervalSeconds ?? 5;
@@ -96,8 +100,6 @@ export class JobBatch {
             const statusBatch = await this.agentsApi.jobs.retrieveStatusMany(pending);
             const completedIds = [];
             for (const status of statusBatch) {
-                // The bulk status endpoint returns AgentJobStatus[]; the schema lacks an `id`
-                // field on each, but the backend includes it in practice — extract via cast.
                 const id = status.id;
                 if (!id) {
                     throw new Error("AgentJobStatus response is missing an `id` field; backend schema may have changed");
@@ -113,15 +115,16 @@ export class JobBatch {
                     this.statuses[id] = {
                         id,
                         status: code,
-                        timestamp: status.timestamp,
-                        error_message: status.error_message,
+                        timestamp: status.timestamp ?? 0,
+                        error_message: status.error_message ?? undefined,
                     };
                 }
             }
             if (completedIds.length) {
                 let resultBatch;
                 try {
-                    resultBatch = await this.agentsApi.jobs.retrieveResultMany(completedIds);
+                    resultBatch =
+                        await this.agentsApi.jobs.retrieveResultMany(completedIds);
                 }
                 catch (err) {
                     // Only synthesize for failed/cancelled — can't fake results for success/cached
@@ -147,7 +150,8 @@ export class JobBatch {
                 }
                 for (const res of resultBatch) {
                     const jobStatus = res.status ?? this.statuses[res.id]?.status ?? null;
-                    const isFailed = jobStatus === JobStatus.FAILURE || jobStatus === JobStatus.CANCELLED;
+                    const isFailed = jobStatus === JobStatus.FAILURE ||
+                        jobStatus === JobStatus.CANCELLED;
                     if (!res.agent_id || !res.agent_version_id) {
                         if (!isFailed) {
                             const id = res.id ?? "unknown";
@@ -192,7 +196,12 @@ export class JobBatch {
     async retrieveStatus() {
         const statusMap = {};
         const toQuery = [];
-        const TERMINAL = new Set([JobStatus.SUCCESS, JobStatus.CACHED, JobStatus.FAILURE, JobStatus.CANCELLED]);
+        const TERMINAL = new Set([
+            JobStatus.SUCCESS,
+            JobStatus.CACHED,
+            JobStatus.FAILURE,
+            JobStatus.CANCELLED,
+        ]);
         for (const id of this.jobIds) {
             const cached = this.statuses[id];
             if (cached !== undefined && TERMINAL.has(cached.status)) {
@@ -213,8 +222,8 @@ export class JobBatch {
                     const js = {
                         id,
                         status: s.status,
-                        timestamp: s.timestamp,
-                        error_message: s.error_message,
+                        timestamp: s.timestamp ?? 0,
+                        error_message: s.error_message ?? undefined,
                     };
                     this.statuses[id] = js;
                     statusMap[id] = js;

package/dist/utils/dynamicInputs.js

@@ -27,7 +27,8 @@ export async function classifyInputs(inputs) {
             files[key] = value;
             continue;
         }
-        if (typeof value === "object" && typeof value.pipe === "function") {
+        if (typeof value === "object" &&
+            typeof value.pipe === "function") {
             files[key] = new FileUpload({ file: value });
             continue;
         }
@@ -110,5 +111,6 @@ export async function postDynamicInputs(raw, path, pathParams, queryParams, inpu
             throw err;
         }
     }
-    throw lastErr ?? new Error("postDynamicInputs exhausted retries without producing an error");
+    throw (lastErr ??
+        new Error("postDynamicInputs exhausted retries without producing an error"));
 }

package/dist/utils/fileDetection.js

@@ -1,4 +1,4 @@
-import fs from "fs";
+import fs from "node:fs";
 const uuidRegex = /^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/i;
 export function isUuidString(value) {
     return typeof value === "string" && uuidRegex.test(value);

package/dist/utils/middleware.d.ts

@@ -1,5 +1,5 @@
 import type { Middleware } from "openapi-fetch";
-import { RoeAuth } from "../auth.js";
+import type { RoeAuth } from "../auth.js";
 export declare function shouldBypassRetry(request: Request): boolean;
 export declare function authMiddleware(auth: RoeAuth): Middleware;
 export declare function retryMiddleware(maxRetries: number): Middleware;

package/dist/utils/middleware.js

@@ -1,4 +1,4 @@
-import { extractErrorMessage, getExceptionForStatusCode } from "../exceptions.js";
+import { extractErrorMessage, getExceptionForStatusCode, } from "../exceptions.js";
 const RETRY_BYPASS_HEADER = "x-roe-retry-bypass";
 export function shouldBypassRetry(request) {
     if (request.headers.get(RETRY_BYPASS_HEADER))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roe-typescript",
-  "version": "1.0.803",
+  "version": "1.1.1",
   "description": "TypeScript SDK for the Roe API (feature parity with roe-python).",
   "type": "module",
   "main": "dist/index.js",
@@ -13,6 +13,8 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
+    "format": "biome check --write .",
+    "format:check": "biome ci .",
     "generate-sdk": "bash scripts/generate-sdk",
     "lint": "tsc --noEmit",
     "test": "vitest run tests/unit --passWithNoTests",
@@ -23,9 +25,10 @@
     "mime-types": "^2.1.35",
     "openapi-fetch": "^0.13.8",
     "undici": "^6.25.0",
-    "uuid": "^11.0.3"
+    "uuid": "^11.1.1"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.4.9",
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.9.0",
     "@types/uuid": "^10.0.0",