@axiom-lattice/client-sdk 3.0.5 → 4.0.0

package/dist/export-import.js

@@ -1,81 +1,175 @@
-/**
- * ExportImportClient
- *
- * Client for tenant export/import API: exportable types, export config,
- * import preview, and import apply.
- */
+function base64ToBytes(base64) {
+    if (typeof globalThis.atob === "function") {
+        const binary = globalThis.atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let index = 0; index < binary.length; index += 1) {
+            bytes[index] = binary.charCodeAt(index);
+        }
+        return bytes;
+    }
+    return new Uint8Array(Buffer.from(base64, "base64"));
+}
+function bytesToArrayBuffer(bytes) {
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+async function archiveToBlob(archive) {
+    if (typeof archive === "string") {
+        return {
+            blob: new Blob([bytesToArrayBuffer(base64ToBytes(archive))], { type: "application/gzip" }),
+            filename: "tenant-import.tar.gz",
+        };
+    }
+    if (archive instanceof Blob) {
+        const filename = "name" in archive && typeof archive.name === "string"
+            ? archive.name
+            : "tenant-import.tar.gz";
+        return { blob: archive, filename };
+    }
+    const bytes = archive instanceof Uint8Array
+        ? archive
+        : archive instanceof ArrayBuffer
+            ? new Uint8Array(archive)
+            : new Uint8Array(await archive.arrayBuffer());
+    return {
+        blob: new Blob([bytesToArrayBuffer(bytes)], { type: "application/gzip" }),
+        filename: "tenant-import.tar.gz",
+    };
+}
+function attachmentFilename(contentDisposition) {
+    if (!contentDisposition)
+        return "tenant-export.tar.gz";
+    const encoded = contentDisposition.match(/filename\*=UTF-8''([^;]+)/i)?.[1];
+    if (encoded) {
+        try {
+            return decodeURIComponent(encoded);
+        }
+        catch {
+            return encoded;
+        }
+    }
+    return contentDisposition.match(/filename="([^"]+)"/i)?.[1]
+        ?? contentDisposition.match(/filename=([^;\s]+)/i)?.[1]
+        ?? "tenant-export.tar.gz";
+}
+/** Client for the gateway tenant export/import archive API. */
 export class ExportImportClient {
-    constructor(config) {
+    /**
+     * Creates an export/import client.
+     *
+     * @param config - Base client configuration.
+     * @param headerProvider - Optional provider for headers that change after construction.
+     */
+    constructor(config, headerProvider) {
         this.baseURL = config.baseURL;
         this.headers = {
             "Content-Type": "application/json",
             Authorization: `Bearer ${config.apiKey}`,
             ...config.headers,
         };
+        this.headerProvider = headerProvider;
     }
     async request(url, options = {}) {
-        const fullUrl = `${this.baseURL}${url}`;
-        const response = await fetch(fullUrl, {
+        const headers = {
+            ...this.headers,
+            ...this.headerProvider?.(),
+            ...options.headers,
+        };
+        if (options.body instanceof FormData) {
+            for (const name of Object.keys(headers)) {
+                if (name.toLowerCase() === "content-type")
+                    delete headers[name];
+            }
+        }
+        const response = await fetch(`${this.baseURL}${url}`, {
+            method: options.method ?? "GET",
             ...options,
-            headers: {
-                ...this.headers,
-                ...options.headers,
-            },
+            headers,
         });
-        if (!response.ok) {
-            const err = (await response.json().catch(() => ({})));
-            throw new Error(err.message || `HTTP error! Status: ${response.status}`);
+        const envelope = (await response.json().catch(() => ({})));
+        if (!response.ok || envelope.success === false) {
+            throw new Error(envelope.message || envelope.error || `HTTP error! Status: ${response.status}`);
+        }
+        if (envelope.data === undefined) {
+            throw new Error(envelope.message || envelope.error || "API response contained no data");
         }
-        return response.json();
+        return envelope.data;
     }
-    async getExportableTypes() {
-        const response = await this.request("/api/tenants/exportable-types");
-        return response.data || [];
+    /** Returns all entity types registered for export. */
+    getExportableTypes() {
+        return this.request("/api/tenants/exportable-types");
     }
-    async exportConfig(tenantId, entityTypes) {
-        const response = await this.request(`/api/tenants/${tenantId}/export`, {
+    /** Starts an export or returns dependencies requiring confirmation. */
+    exportConfig(tenantId, entityTypes, entityIds) {
+        return this.request(`/api/tenants/${tenantId}/export`, {
             method: "POST",
-            body: JSON.stringify({ entityTypes }),
+            body: JSON.stringify({ entityTypes, ...(entityIds ? { entityIds } : {}) }),
         });
-        return response.data;
     }
-    async exportConfigConfirm(tenantId, entityTypes) {
-        const response = await this.request(`/api/tenants/${tenantId}/export/confirm`, {
+    /** Starts an export after confirming dependency additions. */
+    exportConfigConfirm(tenantId, entityTypes, entityIds) {
+        return this.request(`/api/tenants/${tenantId}/export/confirm`, {
             method: "POST",
-            body: JSON.stringify({ entityTypes }),
+            body: JSON.stringify({ entityTypes, ...(entityIds ? { entityIds } : {}) }),
         });
-        return response.data;
     }
+    /** Lists selectable entities for the requested export types. */
+    previewEntities(tenantId, entityTypes) {
+        return this.request(`/api/tenants/${tenantId}/export/entities`, { method: "POST", body: JSON.stringify({ entityTypes }) });
+    }
+    /** Returns the gateway URL for an export download job. */
     getExportDownloadUrl(tenantId, jobId) {
         return `${this.baseURL}/api/tenants/${tenantId}/export/${jobId}/download`;
     }
-    async importPreview(tenantId, file) {
-        const formData = new FormData();
-        formData.append("file", file);
-        const fullUrl = `${this.baseURL}/api/tenants/${tenantId}/import/preview`;
-        const headers = { ...this.headers };
-        delete headers["Content-Type"];
-        const response = await fetch(fullUrl, {
-            method: "POST",
-            headers,
-            body: formData,
+    /** Downloads an export archive as raw bytes. */
+    async downloadExport(tenantId, jobId) {
+        const response = await fetch(`${this.baseURL}/api/tenants/${tenantId}/export/${jobId}/download`, {
+            method: "GET",
+            headers: {
+                ...this.headers,
+                ...this.headerProvider?.(),
+            },
         });
         if (!response.ok) {
-            const err = (await response.json().catch(() => ({})));
-            throw new Error(err.message || `HTTP error! Status: ${response.status}`);
+            const envelope = await response.json().catch(() => ({}));
+            throw new Error(envelope.message || envelope.error || `HTTP error! Status: ${response.status}`);
         }
-        const json = (await response.json());
-        if (!json.success || !json.data) {
-            throw new Error(json.error || "Import preview failed");
+        return {
+            filename: attachmentFilename(response.headers.get("Content-Disposition")),
+            data: new Uint8Array(await response.arrayBuffer()),
+        };
+    }
+    /** Previews an archive or plain JSON bundle import. */
+    async importPreview(tenantId, source) {
+        if (source.archive !== undefined) {
+            const form = new FormData();
+            const { blob, filename } = await archiveToBlob(source.archive);
+            form.append("file", blob, filename);
+            return this.request(`/api/tenants/${tenantId}/import/preview`, {
+                method: "POST",
+                body: form,
+            });
         }
-        return json.data;
+        return this.request(`/api/tenants/${tenantId}/import/preview`, {
+            method: "POST",
+            body: JSON.stringify({ bundle: source.bundle }),
+        });
     }
-    async importApply(tenantId, bundle, resolutions) {
-        const response = await this.request(`/api/tenants/${tenantId}/import/apply`, {
+    /** Applies an archive or plain JSON bundle import with conflict resolutions. */
+    async importApply(tenantId, source, resolutions) {
+        if (source.archive !== undefined) {
+            const form = new FormData();
+            const { blob, filename } = await archiveToBlob(source.archive);
+            form.append("file", blob, filename);
+            form.append("resolutions", JSON.stringify(resolutions));
+            return this.request(`/api/tenants/${tenantId}/import/apply`, {
+                method: "POST",
+                body: form,
+            });
+        }
+        return this.request(`/api/tenants/${tenantId}/import/apply`, {
             method: "POST",
-            body: JSON.stringify({ bundle, resolutions }),
+            body: JSON.stringify({ bundle: source.bundle, resolutions }),
         });
-        return response.data;
     }
 }
 //# sourceMappingURL=export-import.js.map

package/dist/export-import.js.map

@@ -1 +1 @@
-{"version":3,"file":"export-import.js","sourceRoot":"","sources":["../src/export-import.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"export-import.js","sourceRoot":"","sources":["../src/export-import.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -717,6 +717,12 @@ interface UpdateWorkspaceRequest {
     description?: string;
     storageType?: StorageType;
 }
+/**
+ * Project kind classification
+ *
+ * Defaults to "business" for legacy data and omitted input.
+ */
+type ProjectKind = "business" | "training" | "personal";
 /**
  * Project information
  */
@@ -728,6 +734,8 @@ interface Project {
     description?: string;
     /** Application-specific configuration stored as JSON */
     config?: Record<string, unknown>;
+    /** Project classification; defaults to "business" when omitted */
+    kind?: ProjectKind;
     createdAt: Date | string;
     updatedAt: Date | string;
 }
@@ -739,6 +747,8 @@ interface CreateProjectRequest {
     description?: string;
     /** Application-specific configuration stored as JSON (optional) */
     config?: Record<string, unknown>;
+    /** Project classification; defaults to "business" when omitted */
+    kind?: ProjectKind;
 }
 /**
  * Update project request
@@ -752,6 +762,8 @@ interface UpdateProjectRequest {
     description?: string;
     /** Application-specific configuration stored as JSON (replaces existing if provided) */
     config?: Record<string, unknown>;
+    /** Project classification */
+    kind?: ProjectKind;
 }
 /**
  * File item in workspace
@@ -849,6 +861,40 @@ interface LocalA2ATemplatesListResponse {
         total: number;
     };
 }
+/**
+ * A single A2A API key as returned by the management endpoints.
+ *
+ * The `key` value is masked in list responses (only the first 8 characters
+ * followed by "..." are returned); only create/rotate responses expose the
+ * full key value.
+ */
+interface A2AKeyListItem {
+    id: string;
+    key: string;
+    tenantId: string;
+    projectId: string;
+    assistantIds?: string[];
+    label?: string;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Input for creating a new A2A API key.
+ */
+interface CreateA2AKeyInput {
+    tenantId: string;
+    projectId: string;
+    assistantIds?: string[];
+    label?: string;
+}
+/**
+ * A2A API key list response (already unwrapped from `{ success, data }`).
+ */
+interface A2AKeysListResponse {
+    records: A2AKeyListItem[];
+    total: number;
+}
 /**
  * Options for removing a pending message
  */
@@ -890,6 +936,20 @@ interface TaskResponse {
     data?: TaskItem;
     error?: string;
 }
+/** A recoverable lifecycle evidence write failure returned with task completion. */
+interface TaskLifecycleWarning {
+    code: string;
+    taskId: string;
+    evidenceId?: string;
+    eventKey?: string;
+    parentTaskId?: string;
+}
+/** The full response envelope returned by the task completion endpoint. */
+interface CompleteTaskResponse extends TaskResponse {
+    evidenceId?: string;
+    eventKey?: string;
+    warnings?: TaskLifecycleWarning[];
+}
 /**
  * A single parsed Server-Sent Events payload yielded by `Client.streamEvents`.
  */
@@ -898,6 +958,16 @@ interface StreamEvent {
     data: Record<string, unknown>;
 }
 
+/** Completion evidence accepted by the task lifecycle endpoint. */
+interface CompleteTaskInput {
+    result: string;
+    beliefImpact?: Array<{
+        key: string;
+        after: number;
+        basis: string;
+    }>;
+}
+
 /**
  * Abstract client class for interacting with the Axiom Lattice Agent Service API
  * Provides common functionality for different client implementations
@@ -984,7 +1054,7 @@ declare abstract class AbstractClient {
         create: (data: CreateTaskRequest) => Promise<TaskItem>;
         update: (id: string, data: UpdateTaskRequest) => Promise<TaskItem>;
         delete: (id: string) => Promise<void>;
-        complete: (id: string) => Promise<TaskItem>;
+        complete: (id: string, data: CompleteTaskInput) => Promise<CompleteTaskResponse>;
         workItems: {
             list: (taskId: string, params?: {
                 action?: string;
@@ -1257,6 +1327,54 @@ declare abstract class AbstractClient {
             };
         };
     };
+    /**
+     * A2A API keys namespace for managing A2A API keys
+     */
+    a2aKeys: {
+        /**
+         * Lists A2A API keys, optionally filtered by tenant
+         * Key values are masked in list responses
+         * @param params - Optional tenant filter and pagination
+         * @returns A promise that resolves to the list of key records and total
+         */
+        list: (params?: {
+            tenantId?: string;
+            limit?: number;
+            offset?: number;
+        }) => Promise<A2AKeysListResponse>;
+        /**
+         * Creates a new A2A API key
+         * The full key value is returned only from this call
+         * @param input - Key creation input (tenant, project, optional assistant whitelist and label)
+         * @returns A promise that resolves to the created key record (full key value)
+         */
+        create: (input: CreateA2AKeyInput) => Promise<A2AKeyListItem>;
+        /**
+         * Permanently deletes an A2A API key
+         * @param id - Key identifier
+         * @returns A promise that resolves when the key is deleted
+         */
+        delete: (id: string) => Promise<void>;
+        /**
+         * Disables an A2A API key
+         * @param id - Key identifier
+         * @returns A promise that resolves to the updated key record
+         */
+        disable: (id: string) => Promise<A2AKeyListItem>;
+        /**
+         * Enables a previously disabled A2A API key
+         * @param id - Key identifier
+         * @returns A promise that resolves to the updated key record
+         */
+        enable: (id: string) => Promise<A2AKeyListItem>;
+        /**
+         * Rotates an A2A API key, generating a new key value
+         * The full new key value is returned only from this call
+         * @param id - Key identifier
+         * @returns A promise that resolves to the updated key record (full new key value)
+         */
+        rotate: (id: string) => Promise<A2AKeyListItem>;
+    };
     /**
      * Skills namespace for managing skills
      */
@@ -1454,12 +1572,154 @@ declare class ResourcesClient {
     listShares(): Promise<ShareRecord[]>;
 }
 
+/** A registered entity type that can be exported. */
+interface ExportableTypeInfo {
+    entityType: string;
+    label: string;
+    category: "core" | "plugin";
+    dependsOn: string[];
+    cascadeParents: string[];
+}
+/** Explicit entity IDs selected for each exportable type. */
+type ExportEntityIds = Record<string, string[]>;
+/** A completed export job returned by the gateway. */
+interface ExportJobResult {
+    jobId: string;
+    summary: Record<string, number>;
+}
+/** An export preview that requires dependency confirmation. */
+interface ExportConfirmationRequired {
+    needsConfirmation: true;
+    missingDependencies: string[];
+    cascadeAdditions: string[];
+}
+/** Result of starting an export. */
+type ExportConfigResult = ExportJobResult | ExportConfirmationRequired;
+/** A selectable entity shown before an export. */
+interface ExportEntityPreview {
+    id: string;
+    name: string;
+    description?: string;
+}
+/** Selectable entities grouped by entity type. */
+type ExportEntityPreviewMap = Record<string, ExportEntityPreview[]>;
+/** A single entity stored in an export bundle. */
+interface ExportableEntity {
+    _exportId: string;
+    data: Record<string, unknown>;
+}
+/** Plain JSON bundle contained in an export archive. */
+interface ExportBundle {
+    version: 1;
+    exportedAt: string;
+    sourceTenantId: string;
+    entities: Record<string, ExportableEntity[]>;
+    dependencyOrder: string[];
+    _warning?: string;
+}
+/** A conflict discovered while previewing an import. */
+interface ImportConflict {
+    _exportId: string;
+    entityType: string;
+    conflictType: "id_exists" | "unique_constraint";
+    existingName?: string;
+    existingId?: string;
+    field?: string;
+}
+/** A new entity discovered while previewing an import. */
+interface ImportInsertion {
+    _exportId: string;
+    entityType: string;
+    name: string;
+}
+/** An invalid entity discovered while previewing an import. */
+interface ImportPreviewError {
+    _exportId: string;
+    entityType: string;
+    error: string;
+}
+/** Gateway result for an import preview. */
+interface ImportPreviewResult {
+    conflicts: ImportConflict[];
+    insertions: ImportInsertion[];
+    errors: ImportPreviewError[];
+}
+/** Resolution selected for an import conflict. */
+interface ImportResolution {
+    _exportId: string;
+    action: "skip" | "overwrite" | "rename";
+    newId?: string;
+}
+/** Import conflict resolutions keyed by export ID. */
+type ImportResolutions = Record<string, ImportResolution>;
+/** Result for one imported entity. */
+interface ImportEntityResult {
+    _exportId: string;
+    entityType: string;
+    status: "created" | "updated" | "skipped" | "failed";
+    newId?: string;
+    error?: string;
+}
+/** Gateway result after applying an import. */
+interface ImportApplyResult {
+    results: ImportEntityResult[];
+    idMap: Record<string, string>;
+}
+/** Binary or encoded archive accepted by import operations. */
+type ArchiveInput = File | Blob | ArrayBuffer | Uint8Array | string;
+/** Explicit archive or plain-bundle source for an import operation. */
+type ImportSource = {
+    archive: ArchiveInput;
+    bundle?: never;
+} | {
+    bundle: ExportBundle;
+    archive?: never;
+};
+/** Decoded archive returned by an export download. */
+interface ExportDownload {
+    filename: string;
+    data: Uint8Array;
+}
+
+type HeaderProvider = () => Record<string, string>;
+/** Client for the gateway tenant export/import archive API. */
+declare class ExportImportClient {
+    private readonly baseURL;
+    private readonly headers;
+    private readonly headerProvider?;
+    /**
+     * Creates an export/import client.
+     *
+     * @param config - Base client configuration.
+     * @param headerProvider - Optional provider for headers that change after construction.
+     */
+    constructor(config: ClientConfig, headerProvider?: HeaderProvider);
+    private request;
+    /** Returns all entity types registered for export. */
+    getExportableTypes(): Promise<ExportableTypeInfo[]>;
+    /** Starts an export or returns dependencies requiring confirmation. */
+    exportConfig(tenantId: string, entityTypes: string[], entityIds?: ExportEntityIds): Promise<ExportConfigResult>;
+    /** Starts an export after confirming dependency additions. */
+    exportConfigConfirm(tenantId: string, entityTypes: string[], entityIds?: ExportEntityIds): Promise<ExportJobResult>;
+    /** Lists selectable entities for the requested export types. */
+    previewEntities(tenantId: string, entityTypes: string[]): Promise<ExportEntityPreviewMap>;
+    /** Returns the gateway URL for an export download job. */
+    getExportDownloadUrl(tenantId: string, jobId: string): string;
+    /** Downloads an export archive as raw bytes. */
+    downloadExport(tenantId: string, jobId: string): Promise<ExportDownload>;
+    /** Previews an archive or plain JSON bundle import. */
+    importPreview(tenantId: string, source: ImportSource): Promise<ImportPreviewResult>;
+    /** Applies an archive or plain JSON bundle import with conflict resolutions. */
+    importApply(tenantId: string, source: ImportSource, resolutions: ImportResolutions): Promise<ImportApplyResult>;
+}
+
 /**
  * Web client class for interacting with the Axiom Lattice Agent Service API
  */
 declare class Client extends AbstractClient {
     private headers;
     resources: ResourcesClient;
+    exportImport: ExportImportClient;
     /**
      * Creates a new Client instance
      * @param config - Configuration options for the client
@@ -1648,7 +1908,7 @@ declare class WorkspaceClient {
     getWorkspace(workspaceId: string): Promise<Workspace>;
     updateWorkspace(workspaceId: string, updates: UpdateWorkspaceRequest): Promise<Workspace>;
     deleteWorkspace(workspaceId: string): Promise<void>;
-    listProjects(workspaceId: string): Promise<Project[]>;
+    listProjects(workspaceId: string, kind?: ProjectKind): Promise<Project[]>;
     createProject(workspaceId: string, data: CreateProjectRequest): Promise<Project>;
     getProject(workspaceId: string, projectId: string): Promise<Project>;
     updateProject(workspaceId: string, projectId: string, updates: UpdateProjectRequest): Promise<Project>;
@@ -1688,36 +1948,6 @@ declare class WorkspaceClient {
     }>;
 }
 
-/**
- * ExportImportClient
- *
- * Client for tenant export/import API: exportable types, export config,
- * import preview, and import apply.
- */
-
-declare class ExportImportClient {
-    private baseURL;
-    private headers;
-    constructor(config: ClientConfig);
-    private request;
-    getExportableTypes(): Promise<any[]>;
-    exportConfig(tenantId: string, entityTypes: string[]): Promise<{
-        jobId: string;
-        summary: Record<string, number>;
-    } | {
-        needsConfirmation: boolean;
-        missingDependencies: string[];
-        cascadeAdditions: string[];
-    }>;
-    exportConfigConfirm(tenantId: string, entityTypes: string[]): Promise<{
-        jobId: string;
-        summary: Record<string, number>;
-    }>;
-    getExportDownloadUrl(tenantId: string, jobId: string): string;
-    importPreview(tenantId: string, file: File | Blob): Promise<any>;
-    importApply(tenantId: string, bundle: any, resolutions: Record<string, any>): Promise<any>;
-}
-
 /**
  * ChunkMessageMerger
  *
@@ -1737,4 +1967,4 @@ declare function createSimpleMessageMerger(): {
     reset: () => void;
 };
 
-export { AbortAgentParams, AbstractClient, AgentState, ApiError, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportImportClient, FileItem, GetMessagesOptions, GetScheduledTasksOptions, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, MetricsConfigResponse, MetricsConfigsListResponse, NetworkError, PendingMessage, Project, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeStreamOptions, RetryConfig, RunOptions, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, StorageType, StreamCallbacks, StreamEvent, 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, 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, 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 };