@agent-os-sdk/client 0.3.0 → 0.3.1

package/src/generated/swagger.json

@@ -1222,6 +1222,50 @@
         }
       }
     },
+    "/v1/api/catalog/nodes": {
+      "get": {
+        "tags": [
+          "Catalog"
+        ],
+        "summary": "Get the Node Catalog (v1).",
+        "parameters": [
+          {
+            "name": "version",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
+    "/v1/api/triggers/templates": {
+      "get": {
+        "tags": [
+          "Catalog"
+        ],
+        "summary": "Get the Trigger Templates Catalog (v1).",
+        "parameters": [
+          {
+            "name": "version",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/workspaces/{workspaceId}/runs/{runId}/checkpoints": {
       "get": {
         "tags": [
@@ -5233,7 +5277,17 @@
         "tags": [
           "Tools"
         ],
-        "summary": "List all tool definitions.",
+        "summary": "List all tool definitions.\nSupports ?version=1 for canonical ToolCatalog format.",
+        "parameters": [
+          {
+            "name": "version",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "default": "1"
+            }
+          }
+        ],
         "responses": {
           "200": {
             "description": "OK"
@@ -5246,7 +5300,17 @@
         "tags": [
           "Tools"
         ],
-        "summary": "List all tool definitions.",
+        "summary": "List all tool definitions.\nSupports ?version=1 for canonical ToolCatalog format.",
+        "parameters": [
+          {
+            "name": "version",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "default": "1"
+            }
+          }
+        ],
         "responses": {
           "200": {
             "description": "OK"
@@ -5826,25 +5890,13 @@
         }
       }
     },
-    "/v1/api/workspaces/{workspaceId}/vector-stores": {
+    "/v1/api/vector-stores": {
       "post": {
         "tags": [
           "VectorStores"
         ],
         "summary": "Creates a new vector store for semantic document search.",
         "description": "Creates a vector store with the specified embedding configuration.\nThe store is ready to accept file attachments immediately after creation.\n\n**Default Configuration:**\n- Provider: `openai`\n- Model: `text-embedding-3-small`\n- Dimension: `1536`",
-        "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "description": "The workspace to create the vector store in.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
         "requestBody": {
           "description": "Vector store configuration.",
           "content": {
@@ -5876,6 +5928,16 @@
               }
             }
           },
+          "401": {
+            "description": "Authentication or Workspace context required.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Workspace not found.",
             "content": {
@@ -5894,15 +5956,6 @@
         ],
         "summary": "List vector stores in a workspace.",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "limit",
             "in": "query",
@@ -5935,26 +5988,27 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           }
         }
       }
     },
-    "/v1/api/workspaces/{workspaceId}/vector-stores/{vectorStoreId}": {
+    "/v1/api/vector-stores/{vectorStoreId}": {
       "get": {
         "tags": [
           "VectorStores"
         ],
         "summary": "Get a vector store by ID.",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "vectorStoreId",
             "in": "path",
@@ -5976,6 +6030,16 @@
               }
             }
           },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Not Found",
             "content": {
@@ -5994,15 +6058,6 @@
         ],
         "summary": "Delete a vector store.",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "vectorStoreId",
             "in": "path",
@@ -6017,6 +6072,16 @@
           "204": {
             "description": "No Content"
           },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Not Found",
             "content": {
@@ -6030,22 +6095,13 @@
         }
       }
     },
-    "/v1/api/workspaces/{workspaceId}/vector-stores/{vectorStoreId}/files": {
+    "/v1/api/vector-stores/{vectorStoreId}/files": {
       "post": {
         "tags": [
           "VectorStores"
         ],
         "summary": "Attach a file to a vector store for embedding.",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "vectorStoreId",
             "in": "path",
@@ -6086,6 +6142,16 @@
               }
             }
           },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Not Found",
             "content": {
@@ -6099,7 +6165,7 @@
         }
       }
     },
-    "/v1/api/workspaces/{workspaceId}/vector-stores/{vectorStoreId}/query": {
+    "/v1/api/vector-stores/{vectorStoreId}/query": {
       "post": {
         "tags": [
           "VectorStores"
@@ -6107,16 +6173,6 @@
         "summary": "Performs semantic similarity search against the vector store.",
         "description": "Executes a cosine similarity search to find document chunks most relevant\nto the query. Results are ranked by similarity score.\n\n**Note:** The query is automatically embedded using the store's configured\nembedding provider before search.\n\n**Example Request:**\n```json\n{\n  \"query\": \"How do I configure authentication?\",\n  \"top_k\": 5,\n  \"min_score\": 0.7\n}\n```",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "description": "The workspace containing the vector store.",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "vectorStoreId",
             "in": "path",
@@ -6159,6 +6215,16 @@
               }
             }
           },
+          "401": {
+            "description": "Authentication or Workspace context required.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Vector store not found.",
             "content": {
@@ -6172,22 +6238,13 @@
         }
       }
     },
-    "/v1/api/workspaces/{workspaceId}/vector-stores/{vectorStoreId}/bind-agent": {
+    "/v1/api/vector-stores/{vectorStoreId}/bind-agent": {
       "post": {
         "tags": [
           "VectorStores"
         ],
         "summary": "Bind a vector store to an agent.",
         "parameters": [
-          {
-            "name": "workspaceId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "vectorStoreId",
             "in": "path",
@@ -6221,6 +6278,16 @@
           "204": {
             "description": "No Content"
           },
+          "401": {
+            "description": "Unauthorized",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "404": {
             "description": "Not Found",
             "content": {
@@ -6934,14 +7001,6 @@
       "CreateAgentRequest": {
         "type": "object",
         "properties": {
-          "tenant_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid"
-          },
           "name": {
             "type": "string",
             "nullable": true
@@ -8716,6 +8775,9 @@
     {
       "name": "Builder"
     },
+    {
+      "name": "Catalog"
+    },
     {
       "name": "Checkpoints"
     },

package/src/modules/builder.ts

@@ -7,6 +7,8 @@
  * 
  * Flow: Frontend → CP:5000/v1/api/builder/{agentId}/chat → DP:8001/v1/internal/builder/{agentId}/chat
  * 
+ * ALL HTTP goes through rawClient - no direct fetch calls.
+ * 
  * @example
  * ```ts
  * const client = new AgentOsClient({ ... })
@@ -25,7 +27,8 @@
  * ```
  */
 
-import { streamSSE, type SSEEvent, type SSEOptions } from "../sse/client.js";
+import type { RawClient, APIResponse } from "../client/raw.js";
+import type { SSEOptions } from "../sse/client.js";
 
 export type BuilderChatRequest = {
     message: string;
@@ -55,36 +58,29 @@ export type BuilderChatResponse = {
 };
 
 export class BuilderModule {
-    constructor(
-        private baseUrl: string,
-        private headers: () => Record<string, string>
-    ) { }
+    constructor(private client: RawClient) { }
 
     /**
      * Stream chat with meta-agent (SSE).
      * Returns async generator of events.
+     * 
+     * Uses rawClient.streamPost() - headers resolved asynchronously.
      */
     async *chat(
         agentId: string,
         request: BuilderChatRequest,
         options?: SSEOptions
     ): AsyncGenerator<BuilderStreamEvent> {
-        // Use public API route (CP proxies to DP)
-        const url = `${this.baseUrl}/v1/api/builder/${agentId}/chat`;
-
-        const response = await fetch(url, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Accept: "text/event-stream",
-                ...this.headers(),
-            },
-            body: JSON.stringify(request),
+        // Use rawClient.streamPost() - ALL auth headers resolved automatically
+        const response = await this.client.streamPost("/v1/api/builder/{agentId}/chat", {
+            params: { path: { agentId } },
+            body: request,
             signal: options?.signal,
         });
 
         if (!response.ok) {
-            throw new Error(`Builder chat failed: ${response.status}`);
+            const errorText = await response.text();
+            throw new Error(`Builder chat failed: ${response.status} - ${errorText}`);
         }
 
         if (!response.body) {
@@ -133,29 +129,26 @@ export class BuilderModule {
 
     /**
      * Sync chat with meta-agent (no streaming).
+     * 
+     * Uses rawClient.POST() - headers resolved asynchronously.
      */
     async chatSync(
         agentId: string,
         request: BuilderChatRequest
     ): Promise<BuilderChatResponse> {
-        // Use public API route (CP proxies to DP)
-        const url = `${this.baseUrl}/v1/api/builder/${agentId}/chat/sync`;
-
-        const response = await fetch(url, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                ...this.headers(),
-            },
-            body: JSON.stringify(request),
-        });
+        const { data, error } = await this.client.POST<BuilderChatResponse>(
+            "/v1/api/builder/{agentId}/chat/sync",
+            {
+                params: { path: { agentId } },
+                body: request,
+            }
+        );
 
-        if (!response.ok) {
-            const error = await response.text();
-            throw new Error(`Builder chat failed: ${response.status} - ${error}`);
+        if (error) {
+            throw new Error(`Builder chat failed: ${error.code} - ${error.message}`);
         }
 
-        return response.json();
+        return data!;
     }
 
     /**

package/src/modules/metrics.ts

@@ -1,20 +1,27 @@
 /**
  * Metrics Module - Fully Typed
+ * 
+ * ALL HTTP goes through rawClient - no direct fetch calls.
  */
 
+import type { RawClient } from "../client/raw.js";
+
 export interface MetricsResponse {
     raw: string;
 }
 
 export class MetricsModule {
-    constructor(private baseUrl: string, private headers: () => Record<string, string>) { }
+    constructor(private client: RawClient) { }
 
     /**
      * Get Prometheus metrics.
+     * 
+     * Uses rawClient - headers resolved asynchronously.
      */
     async get(): Promise<MetricsResponse> {
-        const response = await fetch(`${this.baseUrl}/metrics`, {
-            headers: this.headers(),
+        // Use streamGet for raw text response (metrics endpoint returns text/plain)
+        const response = await this.client.streamGet("/metrics", {
+            headers: { Accept: "text/plain" }
         });
 
         if (!response.ok) {

package/src/modules/runs.ts

@@ -9,7 +9,7 @@
 
 import type { RawClient, APIResponse, components } from "../client/raw.js";
 import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
-import { streamSSE, type SSEEvent, type RunStreamEvent, type SSEOptions } from "../sse/client.js";
+import { parseSSE, type SSEEvent, type RunStreamEvent, type SSEOptions } from "../sse/client.js";
 
 // Type aliases from OpenAPI
 type WaitRunResponse = components["schemas"]["WaitRunResponse"];
@@ -91,11 +91,7 @@ export interface RunEventDto {
 }
 
 export class RunsModule {
-    constructor(
-        private client: RawClient,
-        private baseUrl: string,
-        private headers: () => Record<string, string>
-    ) { }
+    constructor(private client: RawClient) { }
 
     // ======================== CRUD ========================
 
@@ -117,7 +113,6 @@ export class RunsModule {
     }): Promise<APIResponse<CreateRunResponse>> {
         return this.client.POST<CreateRunResponse>("/v1/api/runs", {
             body,
-            headers: this.headers(),
         });
     }
 
@@ -127,7 +122,6 @@ export class RunsModule {
     async get(runId: string): Promise<APIResponse<Run>> {
         return this.client.GET<Run>("/v1/api/runs/{runId}", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
 
@@ -141,7 +135,6 @@ export class RunsModule {
     }): Promise<APIResponse<RunListResponse>> {
         return this.client.GET<RunListResponse>("/v1/api/runs", {
             params: { query: params },
-            headers: this.headers(),
         });
     }
 
@@ -158,7 +151,6 @@ export class RunsModule {
     }): Promise<APIResponse<WaitRunResponse>> {
         return this.client.POST<WaitRunResponse>("/v1/api/runs/wait", {
             body,
-            headers: this.headers(),
         });
     }
 
@@ -171,7 +163,6 @@ export class RunsModule {
     }): Promise<APIResponse<BatchRunResponse>> {
         return this.client.POST<BatchRunResponse>("/v1/api/runs/batch", {
             body,
-            headers: this.headers(),
         });
     }
 
@@ -182,7 +173,6 @@ export class RunsModule {
         return this.client.POST<CancelRunResponse>("/v1/api/runs/{runId}/cancel", {
             params: { path: { runId } },
             body: { reason },
-            headers: this.headers(),
         });
     }
 
@@ -212,7 +202,6 @@ export class RunsModule {
         return this.client.POST<Run>("/v1/api/runs/{runId}/resume", {
             params: { path: { runId } },
             body,
-            headers: this.headers(),
         });
     }
 
@@ -222,7 +211,6 @@ export class RunsModule {
     async rerun(runId: string): Promise<APIResponse<CreateRunResponse>> {
         return this.client.POST<CreateRunResponse>("/v1/api/runs/{runId}/rerun", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
 
@@ -259,7 +247,6 @@ export class RunsModule {
                 mode: options?.mode,
                 reason: options?.reason
             },
-            headers: this.headers(),
         });
     }
 
@@ -275,7 +262,6 @@ export class RunsModule {
     async getEvents(runId: string, params?: PaginationParams): Promise<APIResponse<RunEventsResponse>> {
         return this.client.GET<RunEventsResponse>("/v1/api/runs/{runId}/events", {
             params: { path: { runId }, query: params },
-            headers: this.headers(),
         });
     }
 
@@ -315,7 +301,6 @@ export class RunsModule {
                     limit: params?.limit ?? 100
                 }
             },
-            headers: this.headers(),
         });
     }
 
@@ -327,7 +312,6 @@ export class RunsModule {
     async getCheckpoints(runId: string): Promise<APIResponse<CheckpointListResponse>> {
         return this.client.GET<CheckpointListResponse>("/v1/api/runs/{runId}/checkpoints", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
 
@@ -345,12 +329,12 @@ export class RunsModule {
      * }
      * ```
      */
-    stream(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>> {
-        const url = `${this.baseUrl}/v1/api/runs/${runId}/stream`;
-        return streamSSE<RunStreamEvent>(url, {
-            ...options,
-            headers: { ...this.headers(), ...options?.headers },
+    async *stream(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>> {
+        const response = await this.client.streamGet("/v1/api/runs/{runId}/stream", {
+            params: { path: { runId } },
+            headers: options?.headers,
         });
+        yield* parseSSE<RunStreamEvent>(response, { onOpen: options?.onOpen });
     }
 
     /**
@@ -385,11 +369,11 @@ export class RunsModule {
     /**
      * Join an existing run's stream (resume watching).
      */
-    join(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>> {
-        const url = `${this.baseUrl}/v1/api/runs/${runId}/join`;
-        return streamSSE<RunStreamEvent>(url, {
-            ...options,
-            headers: { ...this.headers(), ...options?.headers },
+    async *join(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>> {
+        const response = await this.client.streamGet("/v1/api/runs/{runId}/join", {
+            params: { path: { runId } },
+            headers: options?.headers,
         });
+        yield* parseSSE<RunStreamEvent>(response, { onOpen: options?.onOpen });
     }
 }