@agent-os-sdk/client 0.3.0 → 0.3.2

package/dist/modules/runs.js

@@ -6,15 +6,11 @@
  * - list* for collections
  * - create*, update*, delete* for mutations
  */
-import { streamSSE } from "../sse/client.js";
+import { parseSSE } from "../sse/client.js";
 export class RunsModule {
     client;
-    baseUrl;
-    headers;
-    constructor(client, baseUrl, headers) {
+    constructor(client) {
         this.client = client;
-        this.baseUrl = baseUrl;
-        this.headers = headers;
     }
     // ======================== CRUD ========================
     /**
@@ -30,7 +26,6 @@ export class RunsModule {
     async create(body) {
         return this.client.POST("/v1/api/runs", {
             body,
-            headers: this.headers(),
         });
     }
     /**
@@ -39,7 +34,6 @@ export class RunsModule {
     async get(runId) {
         return this.client.GET("/v1/api/runs/{runId}", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
     /**
@@ -48,7 +42,6 @@ export class RunsModule {
     async list(params) {
         return this.client.GET("/v1/api/runs", {
             params: { query: params },
-            headers: this.headers(),
         });
     }
     // ======================== Execution ========================
@@ -58,7 +51,6 @@ export class RunsModule {
     async wait(body) {
         return this.client.POST("/v1/api/runs/wait", {
             body,
-            headers: this.headers(),
         });
     }
     /**
@@ -67,7 +59,6 @@ export class RunsModule {
     async batch(body) {
         return this.client.POST("/v1/api/runs/batch", {
             body,
-            headers: this.headers(),
         });
     }
     /**
@@ -77,7 +68,6 @@ export class RunsModule {
         return this.client.POST("/v1/api/runs/{runId}/cancel", {
             params: { path: { runId } },
             body: { reason },
-            headers: this.headers(),
         });
     }
     /**
@@ -106,7 +96,6 @@ export class RunsModule {
         return this.client.POST("/v1/api/runs/{runId}/resume", {
             params: { path: { runId } },
             body,
-            headers: this.headers(),
         });
     }
     /**
@@ -115,7 +104,6 @@ export class RunsModule {
     async rerun(runId) {
         return this.client.POST("/v1/api/runs/{runId}/rerun", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
     /**
@@ -144,7 +132,6 @@ export class RunsModule {
                 mode: options?.mode,
                 reason: options?.reason
             },
-            headers: this.headers(),
         });
     }
     // ======================== Events ========================
@@ -158,7 +145,6 @@ export class RunsModule {
     async getEvents(runId, params) {
         return this.client.GET("/v1/api/runs/{runId}/events", {
             params: { path: { runId }, query: params },
-            headers: this.headers(),
         });
     }
     /** Alias: runs.events() -> runs.getEvents() */
@@ -193,7 +179,6 @@ export class RunsModule {
                     limit: params?.limit ?? 100
                 }
             },
-            headers: this.headers(),
         });
     }
     // ======================== Checkpoints ========================
@@ -203,7 +188,6 @@ export class RunsModule {
     async getCheckpoints(runId) {
         return this.client.GET("/v1/api/runs/{runId}/checkpoints", {
             params: { path: { runId } },
-            headers: this.headers(),
         });
     }
     /** Alias: runs.checkpoints() -> runs.getCheckpoints() */
@@ -218,12 +202,12 @@ export class RunsModule {
      * }
      * ```
      */
-    stream(runId, options) {
-        const url = `${this.baseUrl}/v1/api/runs/${runId}/stream`;
-        return streamSSE(url, {
-            ...options,
-            headers: { ...this.headers(), ...options?.headers },
+    async *stream(runId, options) {
+        const response = await this.client.streamGet("/v1/api/runs/{runId}/stream", {
+            params: { path: { runId } },
+            headers: options?.headers,
         });
+        yield* parseSSE(response, { onOpen: options?.onOpen });
     }
     /**
      * Create run and stream output.
@@ -248,11 +232,11 @@ export class RunsModule {
     /**
      * Join an existing run's stream (resume watching).
      */
-    join(runId, options) {
-        const url = `${this.baseUrl}/v1/api/runs/${runId}/join`;
-        return streamSSE(url, {
-            ...options,
-            headers: { ...this.headers(), ...options?.headers },
+    async *join(runId, options) {
+        const response = await this.client.streamGet("/v1/api/runs/{runId}/join", {
+            params: { path: { runId } },
+            headers: options?.headers,
         });
+        yield* parseSSE(response, { onOpen: options?.onOpen });
     }
 }

package/dist/sse/client.d.ts

@@ -2,6 +2,9 @@
  * Agent OS SDK - SSE Client
  *
  * Typed Server-Sent Events client for streaming endpoints.
+ *
+ * This module provides utilities for parsing SSE responses.
+ * The actual HTTP request should be made via rawClient.streamGet/streamPost.
  */
 export type SSEEvent<T = unknown> = {
     id?: string;
@@ -16,7 +19,29 @@ export type SSEOptions = {
     signal?: AbortSignal;
 };
 /**
- * Creates a typed SSE stream from a URL.
+ * Parse SSE events from a Response object.
+ * Use this with rawClient.streamGet() or rawClient.streamPost().
+ *
+ * @example
+ * ```ts
+ * const response = await client.streamGet("/v1/api/runs/{runId}/stream", {
+ *   params: { path: { runId } }
+ * });
+ * for await (const event of parseSSE<RunStreamEvent>(response)) {
+ *   console.log(event);
+ * }
+ * ```
+ */
+export declare function parseSSE<T>(response: Response, options?: {
+    onOpen?: () => void;
+}): AsyncGenerator<SSEEvent<T>>;
+/**
+ * Legacy streamSSE function - DEPRECATED.
+ * Use rawClient.streamGet() + parseSSE() instead.
+ *
+ * Kept for backward compatibility during migration.
+ *
+ * @deprecated Use rawClient.streamGet() + parseSSE() instead
  */
 export declare function streamSSE<T>(url: string, options?: SSEOptions): AsyncGenerator<SSEEvent<T>>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sse/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAAe,GACzB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CA0D7B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sse/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GAClC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAiD7B;AAED;;;;;;;GAOG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAAe,GACzB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAW7B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/sse/client.js

@@ -2,26 +2,32 @@
  * Agent OS SDK - SSE Client
  *
  * Typed Server-Sent Events client for streaming endpoints.
+ *
+ * This module provides utilities for parsing SSE responses.
+ * The actual HTTP request should be made via rawClient.streamGet/streamPost.
  */
 /**
- * Creates a typed SSE stream from a URL.
+ * Parse SSE events from a Response object.
+ * Use this with rawClient.streamGet() or rawClient.streamPost().
+ *
+ * @example
+ * ```ts
+ * const response = await client.streamGet("/v1/api/runs/{runId}/stream", {
+ *   params: { path: { runId } }
+ * });
+ * for await (const event of parseSSE<RunStreamEvent>(response)) {
+ *   console.log(event);
+ * }
+ * ```
  */
-export async function* streamSSE(url, options = {}) {
-    const response = await fetch(url, {
-        method: "GET",
-        headers: {
-            Accept: "text/event-stream",
-            ...options.headers,
-        },
-        signal: options.signal,
-    });
+export async function* parseSSE(response, options) {
     if (!response.ok) {
         throw new Error(`SSE connection failed: ${response.status}`);
     }
     if (!response.body) {
         throw new Error("No response body");
     }
-    options.onOpen?.();
+    options?.onOpen?.();
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let buffer = "";
@@ -64,3 +70,22 @@ export async function* streamSSE(url, options = {}) {
         reader.releaseLock();
     }
 }
+/**
+ * Legacy streamSSE function - DEPRECATED.
+ * Use rawClient.streamGet() + parseSSE() instead.
+ *
+ * Kept for backward compatibility during migration.
+ *
+ * @deprecated Use rawClient.streamGet() + parseSSE() instead
+ */
+export async function* streamSSE(url, options = {}) {
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            Accept: "text/event-stream",
+            ...options.headers,
+        },
+        signal: options.signal,
+    });
+    yield* parseSSE(response, { onOpen: options.onOpen });
+}

package/package.json

@@ -1,51 +1,52 @@
 {
-  "name": "@agent-os-sdk/client",
-  "version": "0.3.0",
-  "description": "Official TypeScript SDK for Agent OS platform",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "keywords": [
-    "agent-os",
-    "sdk",
-    "ai",
-    "agents",
-    "typescript"
-  ],
-  "author": "Agent OS Team",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yuri12344/agent-os.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "openapi-fetch": "^0.13.0"
-  },
-  "devDependencies": {
-    "openapi-typescript": "^7.4.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.0",
-    "vitest": "^4.0.18"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "generate": "tsx scripts/generate.ts",
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  }
-}
+    "name": "@agent-os-sdk/client",
+    "version": "0.3.2",
+    "description": "Official TypeScript SDK for Agent OS platform",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "generate": "tsx scripts/generate.ts",
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "pnpm build"
+    },
+    "keywords": [
+        "agent-os",
+        "sdk",
+        "ai",
+        "agents",
+        "typescript"
+    ],
+    "author": "Agent OS Team",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yuri12344/agent-os.git"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "openapi-fetch": "^0.13.0"
+    },
+    "devDependencies": {
+        "openapi-typescript": "^7.4.0",
+        "tsx": "^4.19.0",
+        "typescript": "^5.5.0",
+        "vitest": "^4.0.18"
+    },
+    "files": [
+        "dist",
+        "src"
+    ]
+}

package/src/client/AgentOsClient.ts

@@ -67,6 +67,7 @@ import { MeModule } from "../modules/me.js";
 import { InfoModule } from "../modules/info.js";
 import { MetricsModule } from "../modules/metrics.js";
 import { GraphsModule } from "../modules/graphs.js";
+import { CatalogModule } from "../modules/catalog.js";
 
 // Future modules (mocked)
 import { HandoffModule } from "../modules/handoff.js";
@@ -121,6 +122,7 @@ export class AgentOsClient {
     readonly info: InfoModule;
     readonly metrics: MetricsModule;
     readonly graphs: GraphsModule;
+    readonly catalog: CatalogModule;
 
     // Future modules (mocked)
     readonly handoff: HandoffModule;
@@ -167,13 +169,13 @@ export class AgentOsClient {
 
         // Initialize core modules
         this.agents = new AgentsModule(this._client, getHeaders);
-        this.runs = new RunsModule(this._client, this._baseUrl, getHeaders);
+        this.runs = new RunsModule(this._client);
         this.threads = new ThreadsModule(this._client, getHeaders);
         this.tools = new ToolsModule(this._client, getHeaders);
         this.knowledge = new KnowledgeModule(this._client, getWorkspaceId, getHeaders);
         this.triggers = new TriggersModule(this._client, getHeaders);
         this.credentials = new CredentialsModule(this._client, getWorkspaceId, getHeaders);
-        this.builder = new BuilderModule(this._baseUrl, getHeaders);
+        this.builder = new BuilderModule(this._client);
         this.members = new MembersModule(this._client, getHeaders);
         this.tenants = new TenantsModule(this._client, getHeaders);
         this.workspaces = new WorkspacesModule(this._client, getTenantId, getHeaders);
@@ -195,8 +197,9 @@ export class AgentOsClient {
         this.a2a = new A2aModule(this._client, getHeaders);
         this.me = new MeModule(this._client, getHeaders);
         this.info = new InfoModule(this._client, getHeaders);
-        this.metrics = new MetricsModule(this._baseUrl, getHeaders);
+        this.metrics = new MetricsModule(this._client);
         this.graphs = new GraphsModule(this._client, getHeaders);
+        this.catalog = new CatalogModule(this._client);
 
         // Initialize future modules (mocked)
         this.handoff = new HandoffModule(this._client, getHeaders);

package/src/client/raw.ts

@@ -151,6 +151,80 @@ export function createRawClient(options: ClientOptions) {
             request<T>("PATCH", path, opts),
         DELETE: <T>(path: string, opts?: Parameters<typeof request>[2]) =>
             request<T>("DELETE", path, opts),
+
+        /**
+         * Stream GET request - returns raw Response for SSE consumption.
+         * Headers are resolved asynchronously (includes Auth + Workspace).
+         */
+        streamGet: async (
+            path: string,
+            opts?: { params?: { path?: Record<string, string>; query?: Record<string, unknown> }; headers?: Record<string, string> }
+        ): Promise<Response> => {
+            let url = path;
+            if (opts?.params?.path) {
+                for (const [key, value] of Object.entries(opts.params.path)) {
+                    url = url.replace(`{${key}}`, encodeURIComponent(value));
+                }
+            }
+            if (opts?.params?.query) {
+                const query = new URLSearchParams();
+                for (const [key, value] of Object.entries(opts.params.query)) {
+                    if (value !== undefined && value !== null) {
+                        query.append(key, String(value));
+                    }
+                }
+                const queryStr = query.toString();
+                if (queryStr) url += `?${queryStr}`;
+            }
+            const fullUrl = `${baseUrl}${url}`;
+            const dynamicHeaders = headerProvider ? await headerProvider() : {};
+            const headers: Record<string, string> = {
+                ...defaultHeaders,
+                ...dynamicHeaders,
+                Accept: "text/event-stream",
+                ...opts?.headers,
+            };
+            return fetch(fullUrl, { method: "GET", headers });
+        },
+
+        /**
+         * Stream POST request - returns raw Response for SSE consumption.
+         * Headers are resolved asynchronously (includes Auth + Workspace).
+         */
+        streamPost: async (
+            path: string,
+            opts?: {
+                params?: { path?: Record<string, string> };
+                body?: unknown;
+                headers?: Record<string, string>;
+                signal?: AbortSignal;
+            }
+        ): Promise<Response> => {
+            let url = path;
+            if (opts?.params?.path) {
+                for (const [key, value] of Object.entries(opts.params.path)) {
+                    url = url.replace(`{${key}}`, encodeURIComponent(value));
+                }
+            }
+            const fullUrl = `${baseUrl}${url}`;
+            const dynamicHeaders = headerProvider ? await headerProvider() : {};
+            const headers: Record<string, string> = {
+                ...defaultHeaders,
+                ...dynamicHeaders,
+                "Content-Type": "application/json",
+                Accept: "text/event-stream",
+                ...opts?.headers,
+            };
+            return fetch(fullUrl, {
+                method: "POST",
+                headers,
+                body: opts?.body ? JSON.stringify(opts.body) : undefined,
+                signal: opts?.signal,
+            });
+        },
+
+        /** Base URL for constructing full URLs when needed */
+        baseUrl,
     };
 }