@xpert-ai/xpert-sdk 0.0.17 → 0.1.1

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { Assistant, AssistantGraph, AssistantSortBy, AssistantSelectField, AssistantVersion, CancelAction, Checkpoint, Config, Cron, CronSelectField, CronCreateForThreadResponse, CronCreateResponse, CronSortBy, DefaultValues, GraphSchema, Item, ListNamespaceResponse, Metadata, Run, RunSelectField, RunStatus, SearchItemsResponse, SortOrder, Subgraphs, Thread, ThreadContextUsage, ThreadSelectField, ThreadSortBy, ThreadState, ThreadStatus, Knowledgebase, ChatConversation, ChatMessage, ChatMessageFeedback, ChatTaskSummarySection, ChatTaskSummarySectionPage, ChatTaskSummarySnapshot, Pagination, RuntimeCapabilitiesResponse, AssistantModelsResponse, SandboxManagedService, SandboxManagedServiceLogs, SandboxManagedServicePreviewSession, SandboxManagedServiceStartInput, ThreadGoal, ThreadGoalPatchRequest, ThreadGoalSetRequest } from "./schema.js";
+import { Assistant, AssistantGraph, AssistantSortBy, AssistantSelectField, AssistantVersion, CancelAction, Checkpoint, Config, Cron, CronSelectField, CronCreateForThreadResponse, CronCreateResponse, CronSortBy, DefaultValues, GraphSchema, Item, ListNamespaceResponse, Metadata, Run, RunSelectField, RunStatus, SearchItemsResponse, SortOrder, Subgraphs, Thread, ThreadContextUsage, ThreadSelectField, ThreadSortBy, ThreadState, ThreadStatus, Knowledgebase, ChatConversation, ChatMessage, ChatMessageFeedback, ChatTaskSummarySection, ChatTaskSummarySectionPage, ChatTaskSummarySnapshot, Pagination, RuntimeCapabilitiesResponse, AssistantModelsResponse, SandboxManagedService, SandboxManagedServiceLogs, SandboxManagedServicePreviewSession, SandboxManagedServiceStartInput, ThreadGoal, ThreadGoalPatchRequest, ThreadGoalSetRequest, XpertProject, XpertProjectListOptions, XpertWorkspaceFile, XpertWorkspaceFileListOptions, XpertWorkspace, XpertWorkspaceDefaultOptions, ConnectorConnectRequest, ConnectorConnectResponse, ConnectorConsentRequest, ConnectorBinding, ConnectorBindingCreateRequest, ConnectorPersonalAccountInstance, ConnectorRuntimeOptionsResponse, ConnectorScope, ConnectorOAuthStatusResponse, ConnectorStrategyDefinition } from "./schema.js";
 import type { Command, CronsCreatePayload, OnConflictBehavior, RunsCreatePayload, RunsStreamPayload, RunsWaitPayload, StreamEvent } from "./types.js";
 import type { StreamMode, ThreadStreamMode, TypedAsyncGenerator } from "./types.stream.js";
 import { AsyncCaller, AsyncCallerParams } from "./utils/async_caller.js";
@@ -137,10 +137,12 @@ export declare class AssistantsClient extends BaseClient {
      * Get runtime-selectable skills and plugin middlewares for an assistant.
      *
      * @param assistantId The ID of the assistant.
+     * @param options.projectId Optional Project used to resolve Project-scoped capabilities.
      * @param options.signal Optional abort signal.
      * @returns Runtime capabilities available to the assistant.
      */
     getRuntimeCapabilities(assistantId: string, options?: {
+        projectId?: string;
         signal?: AbortSignal;
     }): Promise<RuntimeCapabilitiesResponse>;
     /** Get the Primary and user-selectable runtime models for an Assistant. */
@@ -251,11 +253,11 @@ export declare class ThreadsClient<TStateType = DefaultValues, TUpdateType = TSt
      */
     get<ValuesType = TStateType>(threadId: string): Promise<Thread<ValuesType>>;
     /**
-     * Get latest-run context usage for a agent in thread.
+     * Get the last measured context usage for an agent in a thread.
      *
      * @param threadId ID of the thread.
      * @param options.agentKey Agent key for usage filtering.
-     * @returns Context usage summary for the latest run tree.
+     * @returns Usage and freshness; run_id and updated_at identify the measurement.
      */
     getContextUsage(threadId: string, options?: {
         agentKey?: string;
@@ -720,12 +722,79 @@ export declare class Client<TStateType = DefaultValues, TUpdateType = TStateType
      * The client for Xpert extension views and their workspace-file grants.
      */
     viewHosts: ViewHostsClient;
+    /**
+     * The client for projects available to the current Xpert user.
+     */
+    projects: ProjectsClient;
+    /**
+     * The client for Xpert-specific workspace resources.
+     */
+    xperts: XpertsClient;
+    /**
+     * The client for workspaces available to the current Xpert user.
+     */
+    workspaces: WorkspacesClient;
+    /**
+     * The client for scoped Connector definitions and authorizations.
+     */
+    connectors: ConnectorsClient;
     /**
      * The client for MCP publications and MCP App runtime operations.
      */
     mcp: McpClient;
     constructor(config?: ClientConfig);
 }
+export declare class ProjectsClient extends BaseClient {
+    constructor(config?: ClientConfig);
+    list(options: XpertProjectListOptions): Promise<Pagination<XpertProject>>;
+    get(projectId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<XpertProject>;
+    listFiles(projectId: string, options?: XpertWorkspaceFileListOptions): Promise<XpertWorkspaceFile[]>;
+}
+export declare class XpertsClient extends BaseClient {
+    constructor(config?: ClientConfig);
+    listWorkspaceFiles(xpertId: string, options?: XpertWorkspaceFileListOptions): Promise<XpertWorkspaceFile[]>;
+}
+export declare class WorkspacesClient extends BaseClient {
+    constructor(config?: ClientConfig);
+    getDefault(options?: XpertWorkspaceDefaultOptions): Promise<XpertWorkspace | null>;
+}
+export declare class ConnectorsClient extends BaseClient {
+    constructor(config?: ClientConfig);
+    runtimeOptions(xpertId: string, options?: {
+        projectId?: string;
+        signal?: AbortSignal;
+    }): Promise<ConnectorRuntimeOptionsResponse>;
+    listBindings(scope: ConnectorScope, options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorBinding[]>;
+    definitions(scope: ConnectorScope, options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorStrategyDefinition[]>;
+    createBinding(input: ConnectorBindingCreateRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorBinding>;
+    deleteBinding(bindingId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    connect(bindingId: string, input: ConnectorConnectRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorConnectResponse>;
+    authorizationStatus(bindingId: string, options?: {
+        xpertId?: string;
+        signal?: AbortSignal;
+    }): Promise<ConnectorOAuthStatusResponse>;
+    consent(bindingId: string, input?: ConnectorConsentRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorBinding>;
+    disconnectPersonalAccount(accountId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    listPersonalAccounts(options?: {
+        signal?: AbortSignal;
+    }): Promise<ConnectorPersonalAccountInstance[]>;
+}
 export declare class ContextsClient extends BaseClient {
     uploadFile<TResponse = unknown>(file: Blob | BufferSource | string, options?: {
         filename?: string;
@@ -777,6 +846,7 @@ export declare class ViewHostsClient extends BaseClient {
 export declare class ConversationsClient extends BaseClient {
     create(payload: Partial<ChatConversation>): Promise<ChatConversation>;
     get(conversationId: string): Promise<ChatConversation>;
+    listWorkspaceFiles(conversationId: string, options?: XpertWorkspaceFileListOptions): Promise<XpertWorkspaceFile[]>;
     update(conversationId: string, payload: Partial<ChatConversation>): Promise<ChatConversation>;
     delete(conversationId: string): Promise<void>;
     search(query?: {

package/dist/client.js

@@ -365,11 +365,15 @@ export class AssistantsClient extends BaseClient {
      * Get runtime-selectable skills and plugin middlewares for an assistant.
      *
      * @param assistantId The ID of the assistant.
+     * @param options.projectId Optional Project used to resolve Project-scoped capabilities.
      * @param options.signal Optional abort signal.
      * @returns Runtime capabilities available to the assistant.
      */
     async getRuntimeCapabilities(assistantId, options) {
         return this.fetch(`/assistants/${assistantId}/runtime-capabilities`, {
+            params: options?.projectId
+                ? { projectId: options.projectId }
+                : undefined,
             signal: options?.signal,
         });
     }
@@ -525,11 +529,11 @@ export class ThreadsClient extends BaseClient {
         return this.fetch(`/threads/${threadId}`);
     }
     /**
-     * Get latest-run context usage for a agent in thread.
+     * Get the last measured context usage for an agent in a thread.
      *
      * @param threadId ID of the thread.
      * @param options.agentKey Agent key for usage filtering.
-     * @returns Context usage summary for the latest run tree.
+     * @returns Usage and freshness; run_id and updated_at identify the measurement.
      */
     async getContextUsage(threadId, options) {
         return this.fetch(`/threads/${threadId}/context-usage`, {
@@ -1287,6 +1291,22 @@ export class Client {
      * The client for Xpert extension views and their workspace-file grants.
      */
     viewHosts;
+    /**
+     * The client for projects available to the current Xpert user.
+     */
+    projects;
+    /**
+     * The client for Xpert-specific workspace resources.
+     */
+    xperts;
+    /**
+     * The client for workspaces available to the current Xpert user.
+     */
+    workspaces;
+    /**
+     * The client for scoped Connector definitions and authorizations.
+     */
+    connectors;
     /**
      * The client for MCP publications and MCP App runtime operations.
      */
@@ -1324,6 +1344,10 @@ export class Client {
         this.conversations = new ConversationsClient(config);
         this.sandbox = new SandboxClient(config);
         this.viewHosts = new ViewHostsClient(config);
+        this.projects = new ProjectsClient(config);
+        this.xperts = new XpertsClient(config);
+        this.workspaces = new WorkspacesClient(config);
+        this.connectors = new ConnectorsClient(config);
         this.mcp = new McpClient(new McpTransportClient(config));
         this["~ui"] = new UiClient(config);
     }
@@ -1336,6 +1360,148 @@ class McpTransportClient extends BaseClient {
         return this.fetch(path, options);
     }
 }
+function workspaceFileListParams(options) {
+    return {
+        path: options.path,
+        deepth: options.depth,
+    };
+}
+export class ProjectsClient extends BaseClient {
+    constructor(config) {
+        super({
+            ...config,
+            apiUrl: deriveXpertApiUrl(config?.apiUrl, "xpert-project"),
+        });
+    }
+    async list(options) {
+        return this.fetch("/available", {
+            params: {
+                xpertId: options.xpertId,
+                status: options.status ?? "active",
+                skip: options.skip ?? 0,
+                take: options.take ?? 100,
+            },
+            signal: options.signal,
+        });
+    }
+    async get(projectId, options) {
+        return this.fetch(`/${encodeURIComponent(projectId)}`, {
+            signal: options?.signal,
+        });
+    }
+    async listFiles(projectId, options = {}) {
+        return this.fetch(`/${encodeURIComponent(projectId)}/files`, {
+            params: workspaceFileListParams(options),
+            signal: options.signal,
+        });
+    }
+}
+export class XpertsClient extends BaseClient {
+    constructor(config) {
+        super({
+            ...config,
+            apiUrl: deriveXpertApiUrl(config?.apiUrl, "xpert"),
+        });
+    }
+    async listWorkspaceFiles(xpertId, options = {}) {
+        return this.fetch(`/${encodeURIComponent(xpertId)}/workspace/files`, {
+            params: workspaceFileListParams(options),
+            signal: options.signal,
+        });
+    }
+}
+export class WorkspacesClient extends BaseClient {
+    constructor(config) {
+        super({
+            ...config,
+            apiUrl: deriveXpertApiUrl(config?.apiUrl, "xpert-workspace"),
+        });
+    }
+    async getDefault(options = {}) {
+        return this.fetch("/my/default", {
+            params: options.purpose ? { purpose: options.purpose } : undefined,
+            signal: options.signal,
+        });
+    }
+}
+export class ConnectorsClient extends BaseClient {
+    constructor(config) {
+        super({
+            ...config,
+            apiUrl: deriveXpertApiUrl(config?.apiUrl, "connector"),
+        });
+    }
+    async runtimeOptions(xpertId, options) {
+        return this.fetch("/runtime-options", {
+            params: {
+                xpertId,
+                projectId: options?.projectId,
+            },
+            signal: options?.signal,
+        });
+    }
+    async listBindings(scope, options) {
+        return this.fetch("/bindings", {
+            params: connectorScopeParams(scope),
+            signal: options?.signal,
+        });
+    }
+    async definitions(scope, options) {
+        return this.fetch("/definitions", {
+            params: connectorScopeParams(scope),
+            signal: options?.signal,
+        });
+    }
+    async createBinding(input, options) {
+        return this.fetch("/bindings", {
+            method: "POST",
+            json: input,
+            signal: options?.signal,
+        });
+    }
+    async deleteBinding(bindingId, options) {
+        await this.fetch(`/bindings/${encodeURIComponent(bindingId)}`, {
+            method: "DELETE",
+            signal: options?.signal,
+        });
+    }
+    async connect(bindingId, input, options) {
+        return this.fetch(`/bindings/${encodeURIComponent(bindingId)}/connect`, {
+            method: "POST",
+            json: input,
+            signal: options?.signal,
+        });
+    }
+    async authorizationStatus(bindingId, options) {
+        return this.fetch(`/bindings/${encodeURIComponent(bindingId)}/authorization-status`, {
+            params: options?.xpertId ? { xpertId: options.xpertId } : undefined,
+            signal: options?.signal,
+        });
+    }
+    async consent(bindingId, input = {}, options) {
+        return this.fetch(`/bindings/${encodeURIComponent(bindingId)}/consent`, {
+            method: "POST",
+            json: input,
+            signal: options?.signal,
+        });
+    }
+    async disconnectPersonalAccount(accountId, options) {
+        await this.fetch(`/personal-accounts/${encodeURIComponent(accountId)}`, {
+            method: "DELETE",
+            signal: options?.signal,
+        });
+    }
+    async listPersonalAccounts(options) {
+        return this.fetch("/personal-accounts", {
+            signal: options?.signal,
+        });
+    }
+}
+function connectorScopeParams(scope) {
+    return scope.type === "project"
+        ? { scopeType: scope.type, scopeId: scope.projectId }
+        : { scopeType: scope.type, scopeId: scope.workspaceId };
+}
 /**
  * @internal Used to obtain a stable key representing the client.
  */
@@ -1556,7 +1722,8 @@ class WorkspaceViewFilesClient extends BaseClient {
         return this.fetch("/view-sessions", {
             method: "POST",
             credentials: "include",
-            json: { hostType, hostId, viewKey },
+            json: { hostType, hostId, viewKey, runtimeScope: options?.runtimeScope },
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
             signal: options?.signal,
         });
     }
@@ -1585,26 +1752,37 @@ export class ViewHostsClient extends BaseClient {
         this.workspaceFiles = new WorkspaceViewFilesClient(config);
     }
     listSlotViews(hostType, hostId, slot, options) {
-        return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/slots/${encodeViewPathSegment(slot)}/views`, { signal: options?.signal });
+        return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/slots/${encodeViewPathSegment(slot)}/views`, {
+            signal: options?.signal,
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
+        });
     }
     getManifest(hostType, hostId, viewKey, options) {
-        return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/manifest`, { signal: options?.signal });
+        return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/manifest`, {
+            signal: options?.signal,
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
+        });
     }
     getData(hostType, hostId, viewKey, query = {}, options) {
         return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/data`, {
             params: createViewQueryParams(query),
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
             signal: options?.signal,
         });
     }
     getRemoteComponentEntry(hostType, hostId, viewKey, options) {
         return this.fetchText(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/remote-component/entry`, {
-            headers: { Accept: "text/html" },
+            headers: {
+                Accept: "text/html",
+                ...createViewRuntimeHeaders(options?.runtimeScope),
+            },
             signal: options?.signal,
         });
     }
     getParameterOptions(hostType, hostId, viewKey, parameterKey, query = {}, options) {
         return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/parameters/${encodeViewPathSegment(parameterKey)}/options`, {
             params: createParameterOptionsParams(query),
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
             signal: options?.signal,
         });
     }
@@ -1612,6 +1790,7 @@ export class ViewHostsClient extends BaseClient {
         return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/actions/${encodeViewPathSegment(actionKey)}`, {
             method: "POST",
             json: request,
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
             signal: options?.signal,
         });
     }
@@ -1634,6 +1813,7 @@ export class ViewHostsClient extends BaseClient {
         return this.fetch(`/${encodeViewPathSegment(hostType)}/${encodeViewPathSegment(hostId)}/views/${encodeViewPathSegment(viewKey)}/actions/${encodeViewPathSegment(actionKey)}/file`, {
             method: "POST",
             body: formData,
+            headers: createViewRuntimeHeaders(options?.runtimeScope),
             signal: options?.signal,
         });
     }
@@ -1647,6 +1827,14 @@ export class ViewHostsClient extends BaseClient {
         return this.workspaceFiles.revokeSession(sessionId, options);
     }
 }
+function createViewRuntimeHeaders(scope) {
+    return {
+        ...(scope?.projectId ? { "x-xpert-view-project-id": scope.projectId } : {}),
+        ...(scope?.conversationId
+            ? { "x-xpert-view-conversation-id": scope.conversationId }
+            : {}),
+    };
+}
 // Conversations Client
 export class ConversationsClient extends BaseClient {
     async create(payload) {
@@ -1658,6 +1846,12 @@ export class ConversationsClient extends BaseClient {
     async get(conversationId) {
         return this.fetch(`/conversations/${conversationId}`);
     }
+    async listWorkspaceFiles(conversationId, options = {}) {
+        return this.fetch(`/conversations/${encodeURIComponent(conversationId)}/files`, {
+            params: workspaceFileListParams(options),
+            signal: options.signal,
+        });
+    }
     async update(conversationId, payload) {
         return this.fetch(`/conversations/${conversationId}`, {
             method: "PATCH",