@agent-os-sdk/client 0.9.18 → 0.9.20

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

@@ -50,10 +50,11 @@ export interface NodeCatalogResponse extends CatalogMetadata {
 }
 
 export interface NodeDefinition {
-    capability_ref?: string;
-    capability_version?: string;
-    execution_binding?: string;
-    kind: string;
+    capability_ref: string;
+    capability_version: string;
+    execution_binding: string;
+    required_credentials: string[];
+    kind: string; // visual hint only
     title: string;
     category: string;
     description?: string;
@@ -68,14 +69,17 @@ export interface ToolCatalogResponse extends CatalogMetadata {
 }
 
 export interface ToolDefinition {
-    slug: string;
+    capability_ref: string;
+    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 {
@@ -83,8 +87,10 @@ export interface TriggerCatalogResponse extends CatalogMetadata {
 }
 
 export interface TriggerTemplate {
-    slug: string;
-    kind: string;
+    capability_ref: string;
+    capability_version: string;
+    slug?: string; // compatibility/display only
+    kind: string; // visual hint only
     description?: string;
     run_input_schema?: Record<string, unknown>;
 }
@@ -107,9 +113,39 @@ export class CatalogModule {
     constructor(private client: RawClient) { }
 
     async getPalette(version: string = "1"): Promise<APIResponse<PaletteCatalogResponse>> {
-        return this.client.GET<PaletteCatalogResponse>("/v1/api/catalog/palette", {
-            params: { query: { version } },
-        });
+        const [nodesRes, toolsRes, triggersRes, presetsRes] = await Promise.all([
+            this.getNodes(version),
+            this.getTools(version),
+            this.getTriggers(version),
+            this.getPresets(version),
+        ]);
+
+        const fallbackResponse =
+            nodesRes.response || toolsRes.response || triggersRes.response || presetsRes.response;
+
+        if (nodesRes.error || toolsRes.error || triggersRes.error || presetsRes.error) {
+            return {
+                data: undefined,
+                error:
+                    nodesRes.error ||
+                    toolsRes.error ||
+                    triggersRes.error ||
+                    presetsRes.error || { code: "NOT_FOUND", message: "Palette catalog is unavailable" },
+                response: fallbackResponse,
+            };
+        }
+
+        return {
+            data: {
+                version,
+                nodes: nodesRes.data?.nodes || [],
+                tools: toolsRes.data?.tools || [],
+                triggers: triggersRes.data?.templates || [],
+                presets: presetsRes.data?.presets || [],
+            },
+            error: undefined,
+            response: fallbackResponse,
+        };
     }
 
     /**

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

@@ -17,7 +17,8 @@ export interface MetaAgentPreviewValidationIssue {
 export interface MetaAgentPatchOp {
     op: string;
     node_id?: string | null;
-    kind?: string | null;
+    capability_ref?: string | null;
+    capability_version?: string | null;
     label?: string | null;
     data?: Record<string, unknown> | null;
     set?: Record<string, unknown> | null;
@@ -37,6 +38,7 @@ export interface MetaAgentPatchProposalResponse {
     draft_revision?: string | null;
     draft_etag: string;
     source_contract: "agent_ir.v1";
+    mode?: "chat" | "proposal";
     patch?: MetaAgentPatchProposal | null;
     preview_draft_ir?: Record<string, unknown> | null;
     preview_valid: boolean;
@@ -62,6 +64,14 @@ export interface MetaAgentApplyPatchResponse {
 export class MetaAgentModule {
     constructor(private client: RawClient, private headers: () => Record<string, string>) {}
 
+    async chat(agentId: string, message: string): Promise<APIResponse<MetaAgentPatchProposalResponse>> {
+        return this.client.POST<MetaAgentPatchProposalResponse>("/v1/api/agents/{id}/meta-agent/chat", {
+            params: { path: { id: agentId } },
+            headers: this.headers(),
+            body: { message },
+        });
+    }
+
     async propose(agentId: string, instruction: string): Promise<APIResponse<MetaAgentPatchProposalResponse>> {
         return this.client.POST<MetaAgentPatchProposalResponse>("/v1/api/agents/{id}/meta-agent/proposals", {
             params: { path: { id: agentId } },

package/src/modules/presets.ts

@@ -9,7 +9,7 @@ export interface AgentTemplateConfig {
   llm?: {
     credential_id?: string;
     model?: string;
-    system_prompt?: string;
+    instructions?: string;
   };
   bindings?: Array<{
     credential_id: string;
@@ -108,6 +108,7 @@ function generateAgentIr(config: AgentTemplateConfig): Record<string, unknown> {
       {
         id: "start",
         kind: "start",
+        capability_ref: "capability://agent-ir/start",
         label: triggerLabel,
         config: {},
         bindings: {},
@@ -116,6 +117,7 @@ function generateAgentIr(config: AgentTemplateConfig): Record<string, unknown> {
       {
         id: "draft_output",
         kind: "end",
+        capability_ref: "capability://agent-ir/end",
         label: outputLabel,
         config: {},
         bindings: {},

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;
 }
@@ -20,17 +20,17 @@ export interface ToolListResponse {
 }
 
 export interface ToolDefinition {
-    slug: string;
-    capability_ref?: string;
-    capability_version?: string;
-    execution_binding?: string;
+    capability_ref: string;
+    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,