@xpert-ai/xpert-sdk 0.2.1 → 0.4.0

package/dist/tests/runtime-resources.test.mjs

@@ -0,0 +1,131 @@
+import { describe, expect, it, vi } from 'vitest';
+import { Client, } from "../index.mjs";
+const selection = {
+    revision: 7,
+    resources: [{ bindingId: 'binding', version: 'digest' }],
+};
+function setup(value, status = 200) {
+    const fetch = vi.fn().mockImplementation(async () => new Response(JSON.stringify(value), {
+        status,
+        headers: { 'content-type': 'application/json' },
+    }));
+    const client = new Client({
+        apiUrl: 'https://xpert.example/api/ai',
+        callerOptions: { fetch },
+        onRequest: (_url, init) => ({
+            ...init,
+            headers: { ...init.headers, 'organization-id': 'org' },
+        }),
+    });
+    return { client, fetch };
+}
+describe('runtime resources contract', () => {
+    it('preserves display metadata, search scopes, cancellation and request hooks', async () => {
+        const catalog = {
+            total: 1,
+            items: [
+                {
+                    ...selection.resources[0],
+                    kind: 'middleware',
+                    title: 'Workbench',
+                    description: { en_US: 'Workbench tools', zh_Hans: '工作台工具' },
+                    avatar: { emoji: { id: 'robot', unified: '1f916' } },
+                    views: [{ key: 'view', title: 'Workbench', requiredFeatures: ['workbench'] }],
+                    status: 'ready',
+                    diagnostics: [],
+                    components: [],
+                },
+            ],
+        };
+        const { client, fetch } = setup(catalog);
+        const signal = new AbortController().signal;
+        await expect(client.assistants.getResources('assistant/1', {
+            projectId: 'project',
+            search: 'hello world',
+            kind: 'middleware',
+            offset: 0,
+            limit: 30,
+            signal,
+        })).resolves.toEqual(catalog);
+        const [url, init] = fetch.mock.calls[0];
+        expect(url.pathname).toBe('/api/ai/assistants/assistant%2F1/resources');
+        expect(Object.fromEntries(url.searchParams)).toEqual({
+            projectId: 'project',
+            search: 'hello world',
+            kind: 'middleware',
+            offset: '0',
+            limit: '30',
+        });
+        expect(init?.signal).toBe(signal);
+        expect(init?.headers).toMatchObject({ 'organization-id': 'org' });
+    });
+    it('validates the complete selection without writing conversation state', async () => {
+        const { client, fetch } = setup(selection);
+        await expect(client.assistants.validateResources('assistant/1', selection, 'project')).resolves.toEqual(selection);
+        const [url, init] = fetch.mock.calls[0];
+        expect(url.pathname).toBe('/api/ai/assistants/assistant%2F1/resources/validate');
+        expect(init?.method).toBe('POST');
+        expect(JSON.parse(String(init?.body))).toEqual({
+            runtimeResources: selection,
+            projectId: 'project',
+        });
+    });
+    it('preserves pinned versions and server revisions when reading and replacing selections', async () => {
+        const { client, fetch } = setup(selection);
+        await expect(client.conversations.getRuntimeResources('conversation/1')).resolves.toEqual(selection);
+        await expect(client.conversations.updateRuntimeResources('conversation/1', selection)).resolves.toEqual(selection);
+        expect(fetch.mock.calls.map(([url]) => url.pathname)).toEqual([
+            '/api/ai/conversations/conversation%2F1/runtime-resources',
+            '/api/ai/conversations/conversation%2F1/runtime-resources',
+        ]);
+        expect(fetch.mock.calls[0][1]?.body).toBeUndefined();
+        expect(fetch.mock.calls[1][1]?.method).toBe('PUT');
+        expect(JSON.parse(String(fetch.mock.calls[1][1]?.body))).toEqual(selection);
+    });
+    it('sends an empty replacement set to clear resources', async () => {
+        const empty = { revision: 8, resources: [] };
+        const { client, fetch } = setup(empty);
+        await expect(client.conversations.updateRuntimeResources('conversation', empty)).resolves.toEqual(empty);
+        expect(JSON.parse(String(fetch.mock.calls[0][1]?.body))).toEqual(empty);
+    });
+    it.each([401, 403, 409])('does not retry a rejected selection update (%s) with default retry settings', async (status) => {
+        const { client, fetch } = setup({ message: 'selection rejected' }, status);
+        await expect(client.conversations.updateRuntimeResources('conversation', selection)).rejects.toMatchObject({ status });
+        expect(fetch).toHaveBeenCalledOnce();
+    });
+    it('resolves a shared workspace dependency without starting individual OAuth', async () => {
+        const authorization = {
+            type: 'connector',
+            status: 'requires_auth',
+            connector: {
+                bindingId: 'connector-binding',
+                provider: 'mcp-service',
+                scope: { type: 'workspace', workspaceId: 'workspace' },
+                authorizationMode: 'shared',
+                canManage: true,
+                managementUrl: 'https://xpert.example/xpert/w/workspace/connectors',
+            },
+        };
+        const { client, fetch } = setup(authorization);
+        const input = { ...selection.resources[0], serverName: 'remote', projectId: 'project' };
+        await expect(client.assistants.authorizeResource('assistant/1', input)).resolves.toEqual(authorization);
+        expect(fetch).toHaveBeenCalledOnce();
+        const [url, init] = fetch.mock.calls[0];
+        expect(url.pathname).toBe('/api/ai/assistants/assistant%2F1/resources/authorize');
+        expect(init?.method).toBe('POST');
+        expect(JSON.parse(String(init?.body))).toEqual(input);
+        expect(init?.headers).toMatchObject({ 'organization-id': 'org' });
+    });
+    it('can still decode the legacy MCP OAuth response from older servers', async () => {
+        const legacy = {
+            status: 'pending',
+            authorizationUrl: 'https://oauth.example/authorize',
+        };
+        const { client } = setup(legacy);
+        await expect(client.assistants.authorizeResource('assistant', {
+            ...selection.resources[0],
+            serverName: 'remote',
+        })).resolves.toEqual(legacy);
+    });
+});
+//# sourceMappingURL=runtime-resources.test.mjs.map

package/dist/tests/runtime-resources.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-resources.test.mjs","sourceRoot":"","sources":["../../src/tests/runtime-resources.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/xpert-sdk",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "SDK Core functionality package",
   "type": "module",
   "main": "dist/index.js",