@agent-os-sdk/client 0.9.6 → 0.9.8

package/dist/client/HttpRequestBuilder.d.ts

@@ -39,6 +39,7 @@ export declare class HttpRequestBuilder {
      * @throws Error if requireFlow is true and correlationId is missing
      */
     build(opts: HttpRequestBuilderOptions): Record<string, string>;
+    private resolveCorrelationId;
     /**
      * Build User-Agent string with SDK version and runtime info
      */

package/dist/client/HttpRequestBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpRequestBuilder.d.ts","sourceRoot":"","sources":["../../src/client/HttpRequestBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAmC9D;;OAEG;IACH,OAAO,CAAC,cAAc;CAYzB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}
+{"version":3,"file":"HttpRequestBuilder.d.ts","sourceRoot":"","sources":["../../src/client/HttpRequestBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiC9D,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,cAAc;CAYzB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/client/HttpRequestBuilder.js

@@ -16,6 +16,7 @@
  */
 import { sanitizeHeader, sanitizeHeaders } from "./sanitize.js";
 const SDK_VERSION = typeof __SDK_VERSION__ !== "undefined" ? __SDK_VERSION__ : "0.7.12-dev";
+const CORRELATION_ID_PATTERN = /^[A-Za-z0-9._:-]{8,128}$/;
 /**
  * Build headers for HTTP requests.
  * This is the SINGLE SOURCE OF TRUTH for header generation.
@@ -36,9 +37,7 @@ export class HttpRequestBuilder {
         if (opts.requireFlow && !opts.context?.correlationId) {
             throw new Error("X-Correlation-Id required for flow-scoped operations");
         }
-        if (opts.context?.correlationId) {
-            headers["X-Correlation-Id"] = opts.context.correlationId;
-        }
+        headers["X-Correlation-Id"] = this.resolveCorrelationId(opts.context?.correlationId);
         // Authorization
         if (opts.token) {
             headers["Authorization"] = `Bearer ${opts.token}`;
@@ -53,6 +52,13 @@ export class HttpRequestBuilder {
         }
         return sanitizeHeaders(headers);
     }
+    resolveCorrelationId(raw) {
+        const candidate = sanitizeHeader((raw ?? "").trim());
+        if (CORRELATION_ID_PATTERN.test(candidate)) {
+            return candidate;
+        }
+        return crypto.randomUUID();
+    }
     /**
      * Build User-Agent string with SDK version and runtime info
      */

package/dist/modules/evaluation.js

@@ -13,7 +13,7 @@ export class EvaluationModule {
      * List all evaluation datasets.
      */
     async listDatasets(params) {
-        return this.client.GET("/v1/api/evaluation/datasets", {
+        return this.client.GET("/v1/api/evaluations/datasets", {
             params: { query: params },
             headers: this.headers(),
         });
@@ -22,7 +22,7 @@ export class EvaluationModule {
      * Get a dataset by ID.
      */
     async getDataset(datasetId) {
-        return this.client.GET("/v1/api/evaluation/datasets/{id}", {
+        return this.client.GET("/v1/api/evaluations/datasets/{id}", {
             params: { path: { id: datasetId } },
             headers: this.headers(),
         });
@@ -31,7 +31,7 @@ export class EvaluationModule {
      * Create a new dataset.
      */
     async createDataset(body) {
-        return this.client.POST("/v1/api/evaluation/datasets", {
+        return this.client.POST("/v1/api/evaluations/datasets", {
             body,
             headers: this.headers(),
         });
@@ -40,7 +40,7 @@ export class EvaluationModule {
      * Delete a dataset.
      */
     async deleteDataset(datasetId) {
-        return this.client.DELETE("/v1/api/evaluation/datasets/{id}", {
+        return this.client.DELETE("/v1/api/evaluations/datasets/{id}", {
             params: { path: { id: datasetId } },
             headers: this.headers(),
         });
@@ -50,7 +50,7 @@ export class EvaluationModule {
      * List examples in a dataset.
      */
     async listExamples(datasetId, params) {
-        return this.client.GET("/v1/api/evaluation/datasets/{id}/examples", {
+        return this.client.GET("/v1/api/evaluations/datasets/{id}/examples", {
             params: { path: { id: datasetId }, query: params },
             headers: this.headers(),
         });
@@ -59,7 +59,7 @@ export class EvaluationModule {
      * Add examples to a dataset.
      */
     async addExamples(datasetId, examples) {
-        return this.client.POST("/v1/api/evaluation/datasets/{id}/examples", {
+        return this.client.POST("/v1/api/evaluations/datasets/{id}/examples", {
             params: { path: { id: datasetId } },
             body: { examples },
             headers: this.headers(),
@@ -70,7 +70,7 @@ export class EvaluationModule {
      * List all experiments.
      */
     async listExperiments(params) {
-        return this.client.GET("/v1/api/evaluation/experiments", {
+        return this.client.GET("/v1/api/evaluations/experiments", {
             params: { query: params },
             headers: this.headers(),
         });
@@ -79,7 +79,7 @@ export class EvaluationModule {
      * Get an experiment by ID.
      */
     async getExperiment(experimentId) {
-        return this.client.GET("/v1/api/evaluation/experiments/{id}", {
+        return this.client.GET("/v1/api/evaluations/experiments/{id}", {
             params: { path: { id: experimentId } },
             headers: this.headers(),
         });
@@ -88,7 +88,7 @@ export class EvaluationModule {
      * Create a new experiment.
      */
     async createExperiment(body) {
-        return this.client.POST("/v1/api/evaluation/experiments", {
+        return this.client.POST("/v1/api/evaluations/experiments", {
             body,
             headers: this.headers(),
         });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@agent-os-sdk/client",
-    "version": "0.9.6",
+    "version": "0.9.8",
     "description": "Official TypeScript SDK for Agent OS platform",
     "type": "module",
     "main": "./dist/index.js",
@@ -50,4 +50,4 @@
         "dist",
         "src"
     ]
-}
+}

package/src/client/HttpRequestBuilder.ts

@@ -21,6 +21,7 @@ import { sanitizeHeader, sanitizeHeaders } from "./sanitize.js";
 // SDK version injected at build time, fallback for local dev
 declare const __SDK_VERSION__: string | undefined;
 const SDK_VERSION = typeof __SDK_VERSION__ !== "undefined" ? __SDK_VERSION__ : "0.7.12-dev";
+const CORRELATION_ID_PATTERN = /^[A-Za-z0-9._:-]{8,128}$/;
 
 /**
  * Options for building request headers
@@ -59,9 +60,7 @@ export class HttpRequestBuilder {
         if (opts.requireFlow && !opts.context?.correlationId) {
             throw new Error("X-Correlation-Id required for flow-scoped operations");
         }
-        if (opts.context?.correlationId) {
-            headers["X-Correlation-Id"] = opts.context.correlationId;
-        }
+        headers["X-Correlation-Id"] = this.resolveCorrelationId(opts.context?.correlationId);
 
         // Authorization
         if (opts.token) {
@@ -81,6 +80,15 @@ export class HttpRequestBuilder {
         return sanitizeHeaders(headers);
     }
 
+    private resolveCorrelationId(raw?: string): string {
+        const candidate = sanitizeHeader((raw ?? "").trim());
+        if (CORRELATION_ID_PATTERN.test(candidate)) {
+            return candidate;
+        }
+
+        return crypto.randomUUID();
+    }
+
     /**
      * Build User-Agent string with SDK version and runtime info
      */

package/src/modules/evaluation.ts

@@ -77,7 +77,7 @@ export class EvaluationModule {
         limit?: number;
         offset?: number;
     }): Promise<APIResponse<DatasetListResponse>> {
-        return this.client.GET<DatasetListResponse>("/v1/api/evaluation/datasets", {
+        return this.client.GET<DatasetListResponse>("/v1/api/evaluations/datasets", {
             params: { query: params },
             headers: this.headers(),
         });
@@ -87,7 +87,7 @@ export class EvaluationModule {
      * Get a dataset by ID.
      */
     async getDataset(datasetId: string): Promise<APIResponse<EvalDataset>> {
-        return this.client.GET<EvalDataset>("/v1/api/evaluation/datasets/{id}", {
+        return this.client.GET<EvalDataset>("/v1/api/evaluations/datasets/{id}", {
             params: { path: { id: datasetId } },
             headers: this.headers(),
         });
@@ -101,7 +101,7 @@ export class EvaluationModule {
         description?: string;
         agent_id?: string;
     }): Promise<APIResponse<EvalDataset>> {
-        return this.client.POST<EvalDataset>("/v1/api/evaluation/datasets", {
+        return this.client.POST<EvalDataset>("/v1/api/evaluations/datasets", {
             body,
             headers: this.headers(),
         });
@@ -111,7 +111,7 @@ export class EvaluationModule {
      * Delete a dataset.
      */
     async deleteDataset(datasetId: string): Promise<APIResponse<void>> {
-        return this.client.DELETE<void>("/v1/api/evaluation/datasets/{id}", {
+        return this.client.DELETE<void>("/v1/api/evaluations/datasets/{id}", {
             params: { path: { id: datasetId } },
             headers: this.headers(),
         });
@@ -126,7 +126,7 @@ export class EvaluationModule {
         limit?: number;
         offset?: number;
     }): Promise<APIResponse<ExamplesListResponse>> {
-        return this.client.GET<ExamplesListResponse>("/v1/api/evaluation/datasets/{id}/examples", {
+        return this.client.GET<ExamplesListResponse>("/v1/api/evaluations/datasets/{id}/examples", {
             params: { path: { id: datasetId }, query: params },
             headers: this.headers(),
         });
@@ -136,7 +136,7 @@ export class EvaluationModule {
      * Add examples to a dataset.
      */
     async addExamples(datasetId: string, examples: ExampleData[]): Promise<APIResponse<void>> {
-        return this.client.POST<void>("/v1/api/evaluation/datasets/{id}/examples", {
+        return this.client.POST<void>("/v1/api/evaluations/datasets/{id}/examples", {
             params: { path: { id: datasetId } },
             body: { examples },
             headers: this.headers(),
@@ -155,7 +155,7 @@ export class EvaluationModule {
         limit?: number;
         offset?: number;
     }): Promise<APIResponse<ExperimentListResponse>> {
-        return this.client.GET<ExperimentListResponse>("/v1/api/evaluation/experiments", {
+        return this.client.GET<ExperimentListResponse>("/v1/api/evaluations/experiments", {
             params: { query: params },
             headers: this.headers(),
         });
@@ -165,7 +165,7 @@ export class EvaluationModule {
      * Get an experiment by ID.
      */
     async getExperiment(experimentId: string): Promise<APIResponse<Experiment>> {
-        return this.client.GET<Experiment>("/v1/api/evaluation/experiments/{id}", {
+        return this.client.GET<Experiment>("/v1/api/evaluations/experiments/{id}", {
             params: { path: { id: experimentId } },
             headers: this.headers(),
         });
@@ -181,7 +181,7 @@ export class EvaluationModule {
         name?: string;
         config?: Record<string, unknown>;
     }): Promise<APIResponse<Experiment>> {
-        return this.client.POST<Experiment>("/v1/api/evaluation/experiments", {
+        return this.client.POST<Experiment>("/v1/api/evaluations/experiments", {
             body,
             headers: this.headers(),
         });