@agent-os-sdk/client 0.9.8 → 0.9.10

package/src/generated/swagger.json

@@ -1192,6 +1192,9 @@
                 }
               }
             }
+          },
+          "500": {
+            "description": "Internal Server Error"
           }
         }
       }
@@ -1354,12 +1357,10 @@
         "tags": [
           "Catalog"
         ],
-        "summary": "Get the Node Types Catalog.",
         "parameters": [
           {
             "name": "version",
             "in": "query",
-            "description": "API version (default: 1)",
             "schema": {
               "type": "integer",
               "format": "int32",
@@ -1386,12 +1387,10 @@
         "tags": [
           "Catalog"
         ],
-        "summary": "Get the Trigger Templates Catalog.",
         "parameters": [
           {
             "name": "version",
             "in": "query",
-            "description": "API version (default: 1)",
             "schema": {
               "type": "integer",
               "format": "int32",
@@ -1418,12 +1417,10 @@
         "tags": [
           "Catalog"
         ],
-        "summary": "Get the Node Presets Catalog.",
         "parameters": [
           {
             "name": "version",
             "in": "query",
-            "description": "API version (default: 1)",
             "schema": {
               "type": "integer",
               "format": "int32",
@@ -3633,125 +3630,12 @@
         }
       }
     },
-    "/v1/api/knowledge/datasets": {
-      "get": {
-        "tags": [
-          "Knowledge"
-        ],
-        "summary": "List datasets (alias for vector stores).",
-        "parameters": [
-          {
-            "name": "limit",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "format": "int32",
-              "default": 20
-            }
-          },
-          {
-            "name": "offset",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "format": "int32",
-              "default": 0
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/knowledge/datasets/{id}": {
-      "get": {
-        "tags": [
-          "Knowledge"
-        ],
-        "summary": "Get a specific dataset.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/knowledge/retrieve": {
-      "post": {
-        "tags": [
-          "Knowledge"
-        ],
-        "summary": "Semantic search across datasets.",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/RetrieveRequest"
-              }
-            },
-            "text/json": {
-              "schema": {
-                "$ref": "#/components/schemas/RetrieveRequest"
-              }
-            },
-            "application/*+json": {
-              "schema": {
-                "$ref": "#/components/schemas/RetrieveRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
-    "/v1/api/knowledge/datasets/{id}/sync": {
-      "post": {
-        "tags": [
-          "Knowledge"
-        ],
-        "summary": "Trigger dataset sync/reindexing.",
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK"
-          }
-        }
-      }
-    },
     "/v1/api/me": {
       "get": {
         "tags": [
           "Me"
         ],
-        "summary": "Get current user identity, tenant and workspace context (lightweight, backward compatible).",
+        "summary": "Get current user identity, tenant and workspace context (lightweight).",
         "responses": {
           "200": {
             "description": "OK"
@@ -4755,7 +4639,7 @@
           "Runs"
         ],
         "summary": "Starts a new agent run asynchronously.",
-        "description": "Creates a new run and queues it for execution. The run will be processed\nby the data plane and its status can be monitored via polling or SSE.\n\n**Thread Resolution:**\n- If `thread.id` is provided, uses existing thread\n- If `thread` is omitted, creates a new thread automatically\n\n**Idempotency:**\nProvide `Idempotency-Key` header to prevent duplicate runs.\nIf a run with the same key exists and is still valid, returns 200 instead of 201.\n\n**Example Request:**\n```json\n{\n  \"agent_id\": \"...\",\n  \"input\": { \"messages\": [{ \"role\": \"user\", \"content\": \"Hello\" }] }\n}\n```",
+        "description": "Creates a new run and queues it for execution. The run will be processed\nby the data plane and its status can be monitored via polling or SSE.\n\n**Thread Resolution:**\n- If `thread.id` is provided, uses existing thread\n- If `thread` is omitted, creates a new thread automatically\n\n**Idempotency:**\nProvide `idempotency_key` in request body to prevent duplicate runs.\nIf a run with the same key exists and is still valid, returns 200 instead of 201.\n\n**Example Request:**\n```json\n{\n  \"agent_id\": \"...\",\n  \"input\": { \"messages\": [{ \"role\": \"user\", \"content\": \"Hello\" }] }\n}\n```",
         "requestBody": {
           "description": "The run request with agent ID and input.",
           "content": {
@@ -4807,6 +4691,16 @@
               }
             }
           },
+          "422": {
+            "description": "Unprocessable Content",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
           "401": {
             "description": "Authentication required.",
             "content": {
@@ -5072,6 +4966,16 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Unprocessable Content",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           }
         }
       }
@@ -5122,6 +5026,16 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Unprocessable Content",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
           }
         }
       }
@@ -6421,6 +6335,19 @@
         }
       }
     },
+    "/v1/api/credentials/types": {
+      "get": {
+        "tags": [
+          "Tools"
+        ],
+        "summary": "List credential types.",
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/credential-types": {
       "get": {
         "tags": [
@@ -6434,6 +6361,29 @@
         }
       }
     },
+    "/v1/api/credentials/types/{name}": {
+      "get": {
+        "tags": [
+          "Tools"
+        ],
+        "summary": "Get a specific credential type.",
+        "parameters": [
+          {
+            "name": "name",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          }
+        }
+      }
+    },
     "/v1/api/credential-types/{name}": {
       "get": {
         "tags": [
@@ -7383,7 +7333,7 @@
         "tags": [
           "Usage"
         ],
-        "summary": "Get usage metrics with real data from usage_events.",
+        "summary": "Get usage metrics with real data from runtime.cost_events.",
         "parameters": [
           {
             "name": "workspaceId",
@@ -8622,7 +8572,7 @@
             },
             "nullable": true
           },
-          "scheduled_trigger_ids": {
+          "cron_job_ids": {
             "type": "array",
             "items": {
               "type": "string",
@@ -8965,6 +8915,10 @@
             "format": "uuid",
             "nullable": true
           },
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
           "workspace_id": {
             "type": "string",
             "format": "uuid",
@@ -8983,15 +8937,6 @@
             "type": "string",
             "format": "uuid",
             "nullable": true
-          },
-          "data": {
-            "type": "object",
-            "additionalProperties": { },
-            "nullable": true
-          },
-          "type": {
-            "type": "string",
-            "nullable": true
           }
         },
         "additionalProperties": false
@@ -10321,14 +10266,6 @@
       "PlaygroundRunRequest": {
         "type": "object",
         "properties": {
-          "tenant_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid"
-          },
           "agent_id": {
             "type": "string",
             "format": "uuid"
@@ -10343,7 +10280,7 @@
           }
         },
         "additionalProperties": false,
-        "description": "Playground request - note: TenantId/WorkspaceId from body are IGNORED,\nwe use IRequestContext for security."
+        "description": "Playground request."
       },
       "PresignedDownloadResponse": {
         "type": "object",
@@ -10467,6 +10404,21 @@
           },
           "set_as_live": {
             "type": "boolean"
+          },
+          "required_tools": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "nullable": true
+          },
+          "tool_credential_bindings": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "nullable": true
           }
         },
         "additionalProperties": false
@@ -10599,39 +10551,6 @@
         },
         "additionalProperties": false
       },
-      "RetrieveRequest": {
-        "type": "object",
-        "properties": {
-          "workspace_id": {
-            "type": "string",
-            "format": "uuid",
-            "nullable": true
-          },
-          "vector_store_id": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "query": {
-            "type": "string",
-            "nullable": true
-          },
-          "top_k": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "min_score": {
-            "type": "number",
-            "format": "float",
-            "nullable": true
-          },
-          "filters": {
-            "type": "object",
-            "additionalProperties": { },
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "RevisionDetailResponse": {
         "type": "object",
         "properties": {
@@ -11584,8 +11503,8 @@
       "TriggerTemplateDto": {
         "required": [
           "kind",
-          "name",
-          "slug"
+          "slug",
+          "title"
         ],
         "type": "object",
         "properties": {
@@ -11597,7 +11516,7 @@
             "type": "string",
             "nullable": true
           },
-          "name": {
+          "title": {
             "type": "string",
             "nullable": true
           },
@@ -12305,9 +12224,6 @@
     {
       "name": "GraphSpec"
     },
-    {
-      "name": "Knowledge"
-    },
     {
       "name": "Me"
     },

package/src/index.ts

@@ -98,11 +98,14 @@ export * from "./modules/agents.js";
 export * from "./modules/auth.js";
 export * from "./modules/chatwoot.js";
 export * from "./modules/credentials.js";
+export * from "./modules/datasets.js";
 export * from "./modules/me.js";
 export * from "./modules/members.js";
+export * from "./modules/observability.js";
 export * from "./modules/presets.js";
 export * from "./modules/prompts.js";
+export * from "./modules/roles.js";
 export * from "./modules/runs.js";
 export * from "./modules/triggers.js";
+export * from "./modules/usage.js";
 export * from "./modules/workspaces.js";
-

package/src/modules/agents.ts

@@ -53,6 +53,21 @@ export interface GraphValidationResponse {
     warnings?: string[];
 }
 
+export interface UpsertAgentCredentialBindingRequest {
+    credential_id: string;
+    alias: string;
+    priority?: number;
+}
+
+export interface AgentCredentialBindingUpsertResponse {
+    id: string;
+    updated: boolean;
+    agent_id: string;
+    credential_id: string;
+    alias: string;
+    priority: number;
+}
+
 export type AgentListResponse = PaginatedResponse<Agent>;
 
 export class AgentsModule {
@@ -219,6 +234,7 @@ export class AgentsModule {
         options?: {
             version_label?: string | null;
             set_as_live?: boolean;
+            required_tools?: string[];
             /** Idempotency key for safe retries */
             idempotency_key?: string;
         }
@@ -233,8 +249,9 @@ export class AgentsModule {
             body: {
                 graph_spec,
                 version_label: options?.version_label ?? null,
-                set_as_live: options?.set_as_live ?? true
-            },
+                set_as_live: options?.set_as_live ?? true,
+                required_tools: options?.required_tools ?? []
+            } as any,
             headers
         });
     }
@@ -257,6 +274,34 @@ export class AgentsModule {
         });
     }
 
+    /**
+     * Get Mermaid diagram for a specific bundle graph.
+     */
+    async getBundleMermaid(agentId: string, bundleId: string): Promise<APIResponse<BundleMermaidResponse>> {
+        return this.client.GET<BundleMermaidResponse>("/v1/api/agents/{agentId}/bundles/{bundleId}/graph/mermaid", {
+            params: { path: { agentId, bundleId } },
+            headers: this.headers(),
+        });
+    }
+
+    /**
+     * Creates or updates an agent credential binding by alias.
+     */
+    async upsertCredentialBinding(
+        agentId: string,
+        body: UpsertAgentCredentialBindingRequest
+    ): Promise<APIResponse<AgentCredentialBindingUpsertResponse>> {
+        return this.client.POST<AgentCredentialBindingUpsertResponse>("/v1/api/agents/{id}/credential-bindings", {
+            params: { path: { id: agentId } },
+            body: {
+                credential_id: body.credential_id,
+                alias: body.alias,
+                priority: body.priority ?? 0,
+            },
+            headers: this.headers(),
+        });
+    }
+
 }
 
 // Bundle manifest response type
@@ -272,3 +317,12 @@ export interface BundleManifestResponse {
     created_at?: string;
     graph_spec?: Record<string, unknown>;
 }
+
+export interface BundleMermaidResponse {
+    bundle_id: string;
+    agent_id: string;
+    mermaid: string;
+    format?: string;
+    node_count?: number;
+    edge_count?: number;
+}

package/src/modules/builder.ts

@@ -118,11 +118,6 @@ export type HintModel = {
 };
 
 export type GraphUpdateAction = {
-    // Legacy support
-    action: string;
-    // ... legacy fields omitted for brevity, keeping strict new protocol
-} | {
-    // New protocol (WAVE-3)
     graph_spec: Record<string, unknown>;
     hints?: HintModel[];
     has_errors?: boolean;
@@ -166,8 +161,6 @@ export type PatchOp = {
     label?: string;
     data?: Record<string, unknown>;
     set?: Record<string, unknown>;
-    source?: string;
-    target?: string;
     from?: string;
     to?: string;
     entrypoint?: string;

package/src/modules/credentials.ts

@@ -29,12 +29,15 @@ export interface CredentialListResponse {
 export interface CredentialType {
     id: string;
     name: string;
-    schema: Record<string, unknown>;
+    display_name?: string;
     description?: string;
+    schema_public_json?: Record<string, unknown> | null;
+    schema_secret_json?: Record<string, unknown> | null;
 }
 
 export interface CredentialTypesResponse {
     items: CredentialType[];
+    count?: number;
 }
 
 export interface ValidateCredentialResponse {
@@ -131,9 +134,48 @@ export class CredentialsModule {
      * List available credential types.
      */
     async listTypes(): Promise<APIResponse<CredentialTypesResponse>> {
-        return this.client.GET<CredentialTypesResponse>("/v1/api/credentials/types", {
+        const response = await this.client.GET<unknown>("/v1/api/credential-types", {
             headers: this.headers(),
         });
+
+        if (!response.data || response.error) {
+            return response as APIResponse<CredentialTypesResponse>;
+        }
+
+        const raw = response.data as Record<string, unknown>;
+        const rawItems = Array.isArray(raw)
+            ? raw
+            : Array.isArray(raw.items)
+                ? raw.items
+                : [];
+
+        const items: CredentialType[] = rawItems
+            .filter((item): item is Record<string, unknown> => Boolean(item) && typeof item === "object")
+            .map((item) => ({
+                id: String(item.id ?? ""),
+                name: String(item.name ?? item.key ?? ""),
+                display_name: typeof item.display_name === "string"
+                    ? item.display_name
+                    : typeof item.displayName === "string"
+                        ? item.displayName
+                        : undefined,
+                description: typeof item.description === "string" ? item.description : undefined,
+                schema_public_json: item.schema_public_json && typeof item.schema_public_json === "object"
+                    ? item.schema_public_json as Record<string, unknown>
+                    : null,
+                schema_secret_json: item.schema_secret_json && typeof item.schema_secret_json === "object"
+                    ? item.schema_secret_json as Record<string, unknown>
+                    : null,
+            }))
+            .filter((item) => item.id && item.name);
+
+        return {
+            ...response,
+            data: {
+                items,
+                count: typeof raw.count === "number" ? raw.count : items.length,
+            },
+        };
     }
 
     /**