@axiom-lattice/client-sdk 4.2.0 → 4.2.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { AgentWebApp, Message, MessageChunk, DatabaseConfigEntry, MetricsServerConfigEntry, DataSource, McpServerConfigEntry, McpTool, LocalA2ATemplateDefinition, TaskItem, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, ConnectionEntry, CreateTaskRequest, UpdateTaskRequest, TaskWorkItem, LocalA2AProviderState, CreateAgentWebAppInput, UpdateAgentWebAppInput, Skill, CreateSkillRequest, CreateShareRequest, ShareResult, ShareRecord } from '@axiom-lattice/protocols';
-export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppScope, AgentWebAppStatus, CreateAgentWebAppInput, LocalA2AProviderId, LocalA2AProviderState, LocalA2AProviderStatus, LocalA2ATemplateDefinition, LocalRuntimeConfig, UpdateAgentWebAppInput } from '@axiom-lattice/protocols';
+import { CapabilityBundle, CapabilityPreview, AgentWebApp, Message, MessageChunk, DatabaseConfigEntry, MetricsServerConfigEntry, DataSource, McpServerConfigEntry, McpTool, LocalA2ATemplateDefinition, TaskItem, CreateDatabaseConfigRequest, UpdateDatabaseConfigRequest, CreateMetricsServerConfigRequest, UpdateMetricsServerConfigRequest, CreateMcpServerConfigRequest, UpdateMcpServerConfigRequest, ConnectionEntry, CreateTaskRequest, UpdateTaskRequest, TaskWorkItem, LocalA2AProviderState, CreateCapabilityBundleInput, UpdateCapabilityBundleInput, CreateAgentWebAppInput, UpdateAgentWebAppInput, Skill, CreateSkillRequest, CreateShareRequest, ShareResult, ShareRecord } from '@axiom-lattice/protocols';
+export { AgentWebApp, AgentWebAppAppearance, AgentWebAppFeatures, AgentWebAppScope, AgentWebAppStatus, CapabilityBundle, CapabilityPreview, CreateAgentWebAppInput, CreateCapabilityBundleInput, LocalA2AProviderId, LocalA2AProviderState, LocalA2AProviderStatus, LocalA2ATemplateDefinition, LocalRuntimeConfig, UpdateAgentWebAppInput, UpdateCapabilityBundleInput } from '@axiom-lattice/protocols';
 
 /**
  * Core types for the Axiom Lattice Client SDK
@@ -10,6 +10,24 @@ interface ListAgentWebAppsParams {
     /** Return only publications for this assistant. */
     assistantId?: string;
 }
+/** Project capability bundle selection and its resolved preview. */
+interface ProjectCapabilitiesResponse {
+    project: Project;
+    persistedBundleIds?: string[];
+    bundles: CapabilityBundle[];
+    preview: CapabilityPreview;
+}
+/** Safe status for a persisted capability bundle that cannot be returned. */
+interface InvalidCapabilityBundleSummary {
+    bundleId: string;
+    code: "INVALID_BUNDLE_CONFIG";
+    message: string;
+}
+/** Valid capability bundles plus safe summaries for invalid legacy records. */
+interface CapabilityBundleListResponse {
+    bundles: CapabilityBundle[];
+    errors: InvalidCapabilityBundleSummary[];
+}
 /** Agent Web App list data, unwrapped from the gateway response envelope. */
 interface AgentWebAppsListResponse {
     records: AgentWebApp[];
@@ -1387,6 +1405,75 @@ declare abstract class AbstractClient {
          */
         rotate: (id: string) => Promise<A2AKeyListItem>;
     };
+    /** Capability bundle namespace for managing tenant-scoped bundles. */
+    capabilityBundles: {
+        /**
+         * List all capability bundles visible to the current tenant.
+         * @returns The tenant's capability bundles, unwrapped from the API response.
+         */
+        list: () => Promise<CapabilityBundle[]>;
+        /**
+         * List valid bundles together with safe invalid-record summaries.
+         * @returns Inventory suitable for management and remediation workflows.
+         */
+        listInventory: () => Promise<CapabilityBundleListResponse>;
+        /**
+         * Get one capability bundle by identifier.
+         * @param bundleId - Capability bundle identifier.
+         * @returns The requested capability bundle.
+         */
+        get: (bundleId: string) => Promise<CapabilityBundle>;
+        /**
+         * Create a capability bundle for the current tenant.
+          * @param input - Bundle name, optional description, and capabilities. The server generates the stable key.
+         * @returns The created capability bundle.
+         */
+        create: (input: CreateCapabilityBundleInput) => Promise<CapabilityBundle>;
+        /**
+         * Update a capability bundle for the current tenant.
+         * @param bundleId - Capability bundle identifier.
+          * @param input - The partial bundle fields and required expected revision to update.
+         * @returns The updated capability bundle.
+         */
+        update: (bundleId: string, input: UpdateCapabilityBundleInput) => Promise<CapabilityBundle>;
+        /**
+         * Delete a capability bundle when the backend permits deletion.
+         * @param bundleId - Capability bundle identifier.
+         * @returns A promise that resolves after the bundle is deleted.
+         * @throws ApiError when the bundle is missing, in use, or the request fails.
+         */
+        delete: (bundleId: string) => Promise<void>;
+    };
+    projects: {
+        capabilities: {
+            /**
+             * Get a project's selected bundles and its persisted capability preview.
+             * @param projectId - Project identifier.
+             * @returns The project, selected bundles, and preview resolved from persisted selections.
+             */
+            get: (projectId: string) => Promise<ProjectCapabilitiesResponse>;
+            /**
+             * Replace a project's selected capability bundles.
+             * @param projectId - Project identifier.
+             * @param bundleIds - Ordered capability bundle identifiers to persist.
+             * @returns The updated project, selected bundles, and persisted-selection preview.
+             */
+            update: (projectId: string, bundleIds: string[], expectedRevisions: Record<string, string>) => Promise<ProjectCapabilitiesResponse>;
+            /**
+             * Preview the capability bundles currently persisted on a project.
+             * @param projectId - Project identifier.
+             * @returns The preview resolved from the project's persisted bundle selections.
+             */
+            preview: (projectId: string) => Promise<CapabilityPreview>;
+            /**
+             * Preview a draft bundle selection without changing the project.
+             * @param projectId - Project identifier.
+             * @param bundleIds - Ordered capability bundle identifiers to preview.
+             * @returns The draft preview resolved from the supplied bundle IDs; no project state is changed.
+             */
+            previewWithBundles: (projectId: string, bundleIds: string[]) => Promise<CapabilityPreview>;
+        };
+    };
     /** Agent Web Apps namespace for managing React SDK publications. */
     webApps: {
         /**
@@ -1894,6 +1981,17 @@ declare class WeChatClient extends AbstractClient {
      * @param tenantId - Tenant identifier
      */
     setTenantId(tenantId: string): void;
+    /**
+     * Set workspace and project headers for requests made by this client.
+     * @param workspaceId - Workspace identifier, or undefined to leave it unchanged
+     * @param projectId - Project identifier, or undefined to leave it unchanged
+     */
+    setWorkspaceContext(workspaceId?: string, projectId?: string): void;
+    /**
+     * Get the workspace and project headers currently applied to this client.
+     * @returns A copy of the current workspace and project header values
+     */
+    getWorkspaceHeaders(): Record<string, string>;
     /**
      * Creates a new instance of the client with the given configuration
      * @param config - Configuration options for the client
@@ -2039,4 +2137,4 @@ declare function createSimpleMessageMerger(): {
     reset: () => void;
 };
 
-export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CompleteTaskInput, CompleteTaskResponse, CreateA2AKeyInput, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportJobResult, ExportableEntity, ExportableTypeInfo, FileItem, GetMessagesOptions, GetScheduledTasksOptions, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, ListAgentWebAppsParams, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, MetricsConfigResponse, MetricsConfigsListResponse, NetworkError, PendingMessage, Project, ProjectKind, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeStreamOptions, RetryConfig, RunOptions, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, StorageType, StreamCallbacks, StreamEvent, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadListResponse, ThreadResponse, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAssistantOptions, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, createSimpleMessageMerger };
+export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, CapabilityBundleListResponse, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CompleteTaskInput, CompleteTaskResponse, CreateA2AKeyInput, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportJobResult, ExportableEntity, ExportableTypeInfo, FileItem, GetMessagesOptions, GetScheduledTasksOptions, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, InvalidCapabilityBundleSummary, ListAgentWebAppsParams, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, MetricsConfigResponse, MetricsConfigsListResponse, NetworkError, PendingMessage, Project, ProjectCapabilitiesResponse, ProjectKind, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeStreamOptions, RetryConfig, RunOptions, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, StorageType, StreamCallbacks, StreamEvent, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadListResponse, ThreadResponse, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAssistantOptions, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, createSimpleMessageMerger };

package/dist/index.js

@@ -2224,6 +2224,127 @@ var AbstractClient = class {
         return response.data;
       }
     };
+    /** Capability bundle namespace for managing tenant-scoped bundles. */
+    this.capabilityBundles = {
+      /**
+       * List all capability bundles visible to the current tenant.
+       * @returns The tenant's capability bundles, unwrapped from the API response.
+       */
+      list: async () => {
+        const response = await this.makeRequest(
+          "/api/capability-bundles"
+        );
+        return response.data;
+      },
+      /**
+       * List valid bundles together with safe invalid-record summaries.
+       * @returns Inventory suitable for management and remediation workflows.
+       */
+      listInventory: async () => {
+        const response = await this.makeRequest("/api/capability-bundles");
+        return { bundles: response.data, errors: response.errors ?? [] };
+      },
+      /**
+       * Get one capability bundle by identifier.
+       * @param bundleId - Capability bundle identifier.
+       * @returns The requested capability bundle.
+       */
+      get: async (bundleId) => {
+        const response = await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`
+        );
+        return response.data;
+      },
+      /**
+       * Create a capability bundle for the current tenant.
+        * @param input - Bundle name, optional description, and capabilities. The server generates the stable key.
+       * @returns The created capability bundle.
+       */
+      create: async (input) => {
+        const response = await this.makeRequest(
+          "/api/capability-bundles",
+          { method: "POST", body: input }
+        );
+        return response.data;
+      },
+      /**
+       * Update a capability bundle for the current tenant.
+       * @param bundleId - Capability bundle identifier.
+        * @param input - The partial bundle fields and required expected revision to update.
+       * @returns The updated capability bundle.
+       */
+      update: async (bundleId, input) => {
+        const response = await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`,
+          { method: "PUT", body: input }
+        );
+        return response.data;
+      },
+      /**
+       * Delete a capability bundle when the backend permits deletion.
+       * @param bundleId - Capability bundle identifier.
+       * @returns A promise that resolves after the bundle is deleted.
+       * @throws ApiError when the bundle is missing, in use, or the request fails.
+       */
+      delete: async (bundleId) => {
+        await this.makeRequest(
+          `/api/capability-bundles/${encodeURIComponent(bundleId)}`,
+          { method: "DELETE" }
+        );
+      }
+    };
+    this.projects = {
+      capabilities: {
+        /**
+         * Get a project's selected bundles and its persisted capability preview.
+         * @param projectId - Project identifier.
+         * @returns The project, selected bundles, and preview resolved from persisted selections.
+         */
+        get: async (projectId) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-bundles`
+          );
+          return response.data;
+        },
+        /**
+         * Replace a project's selected capability bundles.
+         * @param projectId - Project identifier.
+         * @param bundleIds - Ordered capability bundle identifiers to persist.
+         * @returns The updated project, selected bundles, and persisted-selection preview.
+         */
+        update: async (projectId, bundleIds, expectedRevisions) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-bundles`,
+            { method: "PUT", body: { bundleIds, expectedRevisions } }
+          );
+          return response.data;
+        },
+        /**
+         * Preview the capability bundles currently persisted on a project.
+         * @param projectId - Project identifier.
+         * @returns The preview resolved from the project's persisted bundle selections.
+         */
+        preview: async (projectId) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-preview`
+          );
+          return response.data;
+        },
+        /**
+         * Preview a draft bundle selection without changing the project.
+         * @param projectId - Project identifier.
+         * @param bundleIds - Ordered capability bundle identifiers to preview.
+         * @returns The draft preview resolved from the supplied bundle IDs; no project state is changed.
+         */
+        previewWithBundles: async (projectId, bundleIds) => {
+          const response = await this.makeRequest(
+            `/api/projects/${encodeURIComponent(projectId)}/capability-preview`,
+            { method: "POST", body: { bundleIds } }
+          );
+          return response.data;
+        }
+      }
+    };
     /** Agent Web Apps namespace for managing React SDK publications. */
     this.webApps = {
       /**
@@ -3820,6 +3941,32 @@ var WeChatClient = class extends AbstractClient {
   setTenantId(tenantId) {
     this.tenantId = tenantId;
   }
+  /**
+   * Set workspace and project headers for requests made by this client.
+   * @param workspaceId - Workspace identifier, or undefined to leave it unchanged
+   * @param projectId - Project identifier, or undefined to leave it unchanged
+   */
+  setWorkspaceContext(workspaceId, projectId) {
+    if (workspaceId !== void 0) {
+      if (workspaceId)
+        this.workspaceHeaders["x-workspace-id"] = workspaceId;
+      else
+        delete this.workspaceHeaders["x-workspace-id"];
+    }
+    if (projectId !== void 0) {
+      if (projectId)
+        this.workspaceHeaders["x-project-id"] = projectId;
+      else
+        delete this.workspaceHeaders["x-project-id"];
+    }
+  }
+  /**
+   * Get the workspace and project headers currently applied to this client.
+   * @returns A copy of the current workspace and project header values
+   */
+  getWorkspaceHeaders() {
+    return { ...this.workspaceHeaders };
+  }
   /**
    * Creates a new instance of the client with the given configuration
    * @param config - Configuration options for the client
@@ -3850,7 +3997,8 @@ var WeChatClient = class extends AbstractClient {
     return this.wechatRequest({
       url: fullUrl,
       method,
-      data: options?.body
+      data: options?.body,
+      headers: this.getWorkspaceHeaders()
     });
   }
   /**
@@ -3930,11 +4078,12 @@ var WeChatClient = class extends AbstractClient {
    * @private
    */
   async wechatRequest(options) {
-    const { url, method, data } = options;
+    const { url, method, data, headers: requestHeaders } = options;
     const headers = {
       "Content-Type": "application/json",
       Authorization: `Bearer ${this.config.apiKey}`,
-      ...this.config.headers
+      ...this.config.headers,
+      ...requestHeaders
     };
     if (this.tenantId) {
       headers["x-tenant-id"] = this.tenantId;