@agent-os-sdk/client 0.9.19 → 0.9.21

package/src/modules/agents.ts

@@ -70,8 +70,8 @@ export interface AgentDraftIrResponse {
 }
 
 export interface UpsertAgentCredentialBindingRequest {
-    credential_id: string;
-    alias: string;
+    credential_instance_ref: string;
+    binding_key: string;
     priority?: number;
 }
 
@@ -79,9 +79,27 @@ export interface AgentCredentialBindingUpsertResponse {
     id: string;
     updated: boolean;
     agent_id: string;
-    credential_id: string;
-    alias: string;
+    binding_key: string;
     priority: number;
+    credential_instance_ref: string;
+    credential_type_ref: string;
+    credential_type_key: string;
+}
+
+export interface AgentCredentialBinding {
+    id: string;
+    agent_id: string;
+    binding_key: string;
+    priority: number;
+    credential_instance_ref: string;
+    credential_type_ref: string;
+    credential_type_key: string;
+    credential_name: string;
+}
+
+export interface AgentCredentialBindingListResponse {
+    items: AgentCredentialBinding[];
+    count: number;
 }
 
 export type AgentListResponse = PaginatedResponse<Agent>;
@@ -401,7 +419,7 @@ export class AgentsModule {
     }
 
     /**
-     * Creates or updates an agent credential binding by alias.
+     * Creates or updates an agent credential binding by binding key.
      */
     async upsertCredentialBinding(
         agentId: string,
@@ -410,14 +428,26 @@ export class AgentsModule {
         return this.client.POST<AgentCredentialBindingUpsertResponse>("/v1/api/agents/{id}/credential-bindings", {
             params: { path: { id: agentId } },
             body: {
-                credential_id: body.credential_id,
-                alias: body.alias,
+                credential_instance_ref: body.credential_instance_ref,
+                binding_key: body.binding_key,
                 priority: body.priority ?? 0,
             },
             headers: this.headers(),
         });
     }
 
+    /**
+     * Lists credential bindings for an agent.
+     */
+    async listCredentialBindings(
+        agentId: string
+    ): Promise<APIResponse<AgentCredentialBindingListResponse>> {
+        return this.client.GET<AgentCredentialBindingListResponse>("/v1/api/agents/{id}/credential-bindings", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+        });
+    }
+
 }
 
 // Bundle manifest response type

package/src/modules/catalog.ts

@@ -53,6 +53,7 @@ export interface NodeDefinition {
     capability_ref: string;
     capability_version: string;
     execution_binding: string;
+    required_credentials: string[];
     kind: string; // visual hint only
     title: string;
     category: string;
@@ -72,13 +73,13 @@ export interface ToolDefinition {
     capability_version: string;
     execution_binding: string;
     slug?: string; // compatibility/display only
+    required_credentials: string[];
     name: string;
     description?: string;
     type: string;
     version?: number;
     input_schema?: Record<string, unknown>;
     output_schema?: Record<string, unknown>;
-    credential_requirements?: unknown[];
 }
 
 export interface TriggerCatalogResponse extends CatalogMetadata {

package/src/modules/credentials.ts

@@ -9,10 +9,12 @@ type UpdateCredentialRequest = components["schemas"]["UpdateCredentialRequest"];
 
 export interface Credential {
     id: string;
+    credential_instance_ref?: string;
     name: string;
     scope: "workspace" | "tenant";
     type_id?: string;
     type?: string;
+    credential_type_ref?: string;
     workspace_id?: string;
     tenant_id: string;
     sharing_mode: "private" | "shared";
@@ -29,8 +31,14 @@ export interface CredentialListResponse {
 export interface CredentialType {
     id: string;
     name: string;
+    credential_type_ref?: string;
     display_name?: string;
     description?: string;
+    provider_family?: string;
+    version?: string;
+    status?: string;
+    masking_policy?: string;
+    materialization_policy?: string;
     schema_public_json?: Record<string, unknown> | null;
     schema_secret_json?: Record<string, unknown> | null;
 }
@@ -154,12 +162,20 @@ export class CredentialsModule {
             .map((item) => ({
                 id: String(item.id ?? ""),
                 name: String(item.name ?? item.key ?? ""),
+                credential_type_ref: typeof item.credential_type_ref === "string"
+                    ? item.credential_type_ref
+                    : undefined,
                 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,
+                provider_family: typeof item.provider_family === "string" ? item.provider_family : undefined,
+                version: typeof item.version === "string" ? item.version : undefined,
+                status: typeof item.status === "string" ? item.status : undefined,
+                masking_policy: typeof item.masking_policy === "string" ? item.masking_policy : undefined,
+                materialization_policy: typeof item.materialization_policy === "string" ? item.materialization_policy : undefined,
                 schema_public_json: item.schema_public_json && typeof item.schema_public_json === "object"
                     ? item.schema_public_json as Record<string, unknown>
                     : null,

package/src/modules/metaAgent.ts

@@ -33,6 +33,42 @@ export interface MetaAgentPatchProposal {
     ops: MetaAgentPatchOp[];
 }
 
+export interface MetaAgentDiffPreview {
+    added_node_ids: string[];
+    removed_node_ids: string[];
+    updated_node_ids: string[];
+    added_edge_ids: string[];
+    removed_edge_ids: string[];
+    entrypoint_changed: boolean;
+    before_entrypoint?: string | null;
+    after_entrypoint?: string | null;
+}
+
+export interface MetaAgentBlastRadiusCredentialImpact {
+    required_credential: string;
+    status: "bound" | "missing";
+    binding_key?: string | null;
+    credential_instance_ref?: string | null;
+    credential_name?: string | null;
+}
+
+export interface MetaAgentBlastRadius {
+    affected_node_ids: string[];
+    affected_edge_ids: string[];
+    added_capabilities: string[];
+    removed_capabilities: string[];
+    changed_capabilities: string[];
+    impacted_credentials: MetaAgentBlastRadiusCredentialImpact[];
+    warnings: MetaAgentPreviewValidationIssue[];
+}
+
+export interface MetaAgentValidationResult {
+    valid: boolean;
+    preview_valid: boolean;
+    errors: MetaAgentPatchValidationIssue[];
+    warnings: MetaAgentPreviewValidationIssue[];
+}
+
 export interface MetaAgentPatchProposalResponse {
     agent_id: string;
     draft_revision?: string | null;
@@ -41,11 +77,9 @@ export interface MetaAgentPatchProposalResponse {
     mode?: "chat" | "proposal";
     patch?: MetaAgentPatchProposal | null;
     preview_draft_ir?: Record<string, unknown> | null;
-    preview_valid: boolean;
-    preview_errors: MetaAgentPreviewValidationIssue[];
-    preview_warnings: MetaAgentPreviewValidationIssue[];
-    valid: boolean;
-    errors: MetaAgentPatchValidationIssue[];
+    diff_preview?: MetaAgentDiffPreview | null;
+    blast_radius?: MetaAgentBlastRadius | null;
+    validation_result: MetaAgentValidationResult;
     message: string;
 }
 

package/src/modules/tools.ts

@@ -9,7 +9,7 @@ export interface Tool {
     description?: string;
     category?: string;
     parameters?: Record<string, unknown>;
-    required_credentials?: string[];
+    required_credentials: string[];
     is_builtin: boolean;
     created_at?: string;
 }
@@ -24,13 +24,13 @@ export interface ToolDefinition {
     capability_version: string;
     execution_binding: string;
     slug?: string; // compatibility/display only
+    required_credentials: string[];
     name: string;
     description?: string;
     type: string;
     version?: number;
     input_schema?: Record<string, unknown>;
     output_schema?: Record<string, unknown>;
-    credential_requirements?: unknown[];
 }
 
 export interface ToolDefinitionsResponse {

package/src/modules/vectorStores.ts

@@ -14,7 +14,7 @@ export interface VectorStore {
     embedding_provider: string;
     embedding_model: string;
     dimension: number;
-    credential_binding_alias?: string;
+    credential_binding_key?: string;
     file_count: number;
     created_at: string;
 }
@@ -54,7 +54,7 @@ export interface VectorStoreFilesResponse {
 type VectorStoreLike = VectorStoreResponse & {
     embeddingProvider?: string;
     embeddingModel?: string;
-    credentialBindingAlias?: string;
+    credentialBindingKey?: string;
     fileCount?: number;
     createdAt?: string;
 };
@@ -71,7 +71,7 @@ function toVectorStore(item: VectorStoreLike): VectorStore {
         embedding_provider: item.embedding_provider ?? item.embeddingProvider ?? "",
         embedding_model: item.embedding_model ?? item.embeddingModel ?? "",
         dimension: item.dimension ?? 0,
-        credential_binding_alias: item.credential_binding_alias ?? item.credentialBindingAlias ?? undefined,
+        credential_binding_key: item.credential_binding_key ?? item.credentialBindingKey ?? undefined,
         file_count: item.file_count ?? item.fileCount ?? 0,
         created_at: item.created_at ?? item.createdAt ?? "",
     };
@@ -143,7 +143,7 @@ export class VectorStoresModule {
         embedding_provider?: string;
         embedding_model?: string;
         dimension?: number;
-        credential_binding_alias?: string;
+        credential_binding_key?: string;
     }): Promise<APIResponse<VectorStore>> {
         const response = await this.client.POST<VectorStoreResponse>("/v1/api/vector-stores", {
             body,