@xpert-ai/xpert-sdk 0.5.0 → 0.7.0

package/dist/workbench.js

@@ -0,0 +1,169 @@
+function scopePath(scope) {
+    const id = scope.kind === 'assistant' ? scope.assistantId : scope.conversationId;
+    if (!id.trim())
+        throw new Error('A workspace scope is required.');
+    return scope.kind === 'assistant'
+        ? `/ai/assistants/${encodeURIComponent(id)}/workspace`
+        : `/ai/conversations/${encodeURIComponent(id)}`;
+}
+export class WorkbenchClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    listFiles(scope, path = '', options = {}) {
+        return this.transport.json(`${scopePath(scope)}/files`, { params: { path }, ...options });
+    }
+    readFile(scope, path, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, { params: { path }, ...options });
+    }
+    saveFile(scope, path, content, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, {
+            method: 'PUT',
+            json: { path, content },
+            ...options,
+        });
+    }
+    uploadFile(scope, path, file, filename, options = {}) {
+        const body = new FormData();
+        body.append('file', file, filename);
+        body.append('path', path);
+        return this.transport.json(`${scopePath(scope)}/file/upload`, {
+            method: 'POST',
+            body,
+            ...options,
+        });
+    }
+    saveBinaryFile(scope, path, file, options = {}) {
+        const separator = path.lastIndexOf('/');
+        if (scope.kind === 'conversation')
+            return this.uploadFile(scope, path.slice(0, Math.max(0, separator)), file, path.slice(separator + 1), options);
+        const body = new FormData();
+        body.append('file', file, path.slice(separator + 1));
+        body.append('path', path);
+        return this.transport.json(`${scopePath(scope)}/file/save-binary`, {
+            method: 'POST',
+            body,
+            ...options,
+        });
+    }
+    deleteFile(scope, path, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, {
+            method: 'DELETE',
+            params: { path },
+            ...options,
+        });
+    }
+    downloadFile(scope, path, options = {}) {
+        return this.transport.blob(`${scopePath(scope)}/file/download`, {
+            params: { path },
+            ...options,
+        });
+    }
+    /** Read an immutable delivery or review report belonging to this conversation. */
+    downloadArtifact(conversationId, resource, options = {}) {
+        if (![conversationId, resource.artifactId, resource.artifactVersionId].every(id => id.trim()))
+            throw new Error('A conversation and an immutable artifact version are required.');
+        return this.transport.blob(`/ai/conversations/${encodeURIComponent(conversationId)}/artifacts/${encodeURIComponent(resource.artifactId)}/versions/${encodeURIComponent(resource.artifactVersionId)}/content`, options);
+    }
+    async connectTerminal(options) {
+        if (!options.conversationId.trim())
+            throw new Error('A conversation is required.');
+        options.signal?.throwIfAborted();
+        const [{ io }, auth] = await Promise.all([
+            import('socket.io-client'),
+            this.transport.socketAuthentication(),
+        ]);
+        options.signal?.throwIfAborted();
+        const socket = io(`${auth.url}/sandbox-terminal`, {
+            path: auth.path,
+            transports: ['websocket'],
+            autoConnect: false,
+            auth: { token: auth.token, organizationId: auth.organizationId },
+        });
+        let sessionId = null;
+        let requestId = '';
+        let closed = false;
+        const send = (event) => {
+            if (!closed)
+                options.onEvent(event);
+        };
+        const dimensions = { cols: options.cols, rows: options.rows };
+        socket.on('connect', () => {
+            sessionId = null;
+            requestId = globalThis.crypto.randomUUID();
+            send({ type: 'connected' });
+            socket.emit('open', {
+                ...dimensions,
+                conversationId: options.conversationId,
+                projectId: options.projectId,
+                requestId,
+            });
+        });
+        socket.on('opened', (data) => {
+            if (data.requestId !== requestId)
+                return;
+            sessionId = data.sessionId;
+            send({ ...data, type: 'opened' });
+        });
+        socket.on('output', (data) => {
+            // The server can emit initial PTY output before acknowledging open.
+            if (!sessionId || data.sessionId === sessionId)
+                send({ ...data, type: 'output' });
+        });
+        socket.on('exit', (data) => {
+            if (data.sessionId === sessionId)
+                send({ ...data, type: 'exit' });
+        });
+        socket.on('closed', (data) => {
+            if (data.sessionId === sessionId || data.requestId === requestId) {
+                sessionId = null;
+                send({ ...data, type: 'closed' });
+            }
+        });
+        socket.on('error', (data) => {
+            if (data.requestId === requestId || data.sessionId === sessionId)
+                send({ ...data, type: 'error' });
+        });
+        socket.on('exception', (data) => {
+            sessionId = null;
+            send({
+                type: 'error',
+                code: String(data.status ?? 'authorization'),
+                message: data.message ?? 'Terminal authorization failed.',
+            });
+            socket.disconnect();
+        });
+        socket.on('connect_error', (error) => send({ type: 'error', code: 'connection', message: error.message }));
+        socket.on('disconnect', (reason) => {
+            sessionId = null;
+            send({ type: 'disconnected', message: reason });
+        });
+        const connection = {
+            input: (data) => {
+                if (!closed && sessionId && socket.connected)
+                    socket.emit('input', { sessionId, data });
+            },
+            resize: (cols, rows) => {
+                dimensions.cols = cols;
+                dimensions.rows = rows;
+                if (!closed && sessionId && socket.connected)
+                    socket.emit('resize', { sessionId, cols, rows });
+            },
+            close: () => {
+                if (closed)
+                    return;
+                closed = true;
+                if (socket.connected)
+                    socket.emit('close', sessionId ? { sessionId } : { requestId });
+                socket.removeAllListeners();
+                socket.disconnect();
+                options.signal?.removeEventListener('abort', connection.close);
+            },
+        };
+        options.signal?.addEventListener('abort', connection.close, { once: true });
+        socket.connect();
+        return connection;
+    }
+}
+//# sourceMappingURL=workbench.js.map

package/dist/workbench.js.map

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

package/dist/workbench.mjs

@@ -0,0 +1,169 @@
+function scopePath(scope) {
+    const id = scope.kind === 'assistant' ? scope.assistantId : scope.conversationId;
+    if (!id.trim())
+        throw new Error('A workspace scope is required.');
+    return scope.kind === 'assistant'
+        ? `/ai/assistants/${encodeURIComponent(id)}/workspace`
+        : `/ai/conversations/${encodeURIComponent(id)}`;
+}
+export class WorkbenchClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    listFiles(scope, path = '', options = {}) {
+        return this.transport.json(`${scopePath(scope)}/files`, { params: { path }, ...options });
+    }
+    readFile(scope, path, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, { params: { path }, ...options });
+    }
+    saveFile(scope, path, content, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, {
+            method: 'PUT',
+            json: { path, content },
+            ...options,
+        });
+    }
+    uploadFile(scope, path, file, filename, options = {}) {
+        const body = new FormData();
+        body.append('file', file, filename);
+        body.append('path', path);
+        return this.transport.json(`${scopePath(scope)}/file/upload`, {
+            method: 'POST',
+            body,
+            ...options,
+        });
+    }
+    saveBinaryFile(scope, path, file, options = {}) {
+        const separator = path.lastIndexOf('/');
+        if (scope.kind === 'conversation')
+            return this.uploadFile(scope, path.slice(0, Math.max(0, separator)), file, path.slice(separator + 1), options);
+        const body = new FormData();
+        body.append('file', file, path.slice(separator + 1));
+        body.append('path', path);
+        return this.transport.json(`${scopePath(scope)}/file/save-binary`, {
+            method: 'POST',
+            body,
+            ...options,
+        });
+    }
+    deleteFile(scope, path, options = {}) {
+        return this.transport.json(`${scopePath(scope)}/file`, {
+            method: 'DELETE',
+            params: { path },
+            ...options,
+        });
+    }
+    downloadFile(scope, path, options = {}) {
+        return this.transport.blob(`${scopePath(scope)}/file/download`, {
+            params: { path },
+            ...options,
+        });
+    }
+    /** Read an immutable delivery or review report belonging to this conversation. */
+    downloadArtifact(conversationId, resource, options = {}) {
+        if (![conversationId, resource.artifactId, resource.artifactVersionId].every(id => id.trim()))
+            throw new Error('A conversation and an immutable artifact version are required.');
+        return this.transport.blob(`/ai/conversations/${encodeURIComponent(conversationId)}/artifacts/${encodeURIComponent(resource.artifactId)}/versions/${encodeURIComponent(resource.artifactVersionId)}/content`, options);
+    }
+    async connectTerminal(options) {
+        if (!options.conversationId.trim())
+            throw new Error('A conversation is required.');
+        options.signal?.throwIfAborted();
+        const [{ io }, auth] = await Promise.all([
+            import('socket.io-client'),
+            this.transport.socketAuthentication(),
+        ]);
+        options.signal?.throwIfAborted();
+        const socket = io(`${auth.url}/sandbox-terminal`, {
+            path: auth.path,
+            transports: ['websocket'],
+            autoConnect: false,
+            auth: { token: auth.token, organizationId: auth.organizationId },
+        });
+        let sessionId = null;
+        let requestId = '';
+        let closed = false;
+        const send = (event) => {
+            if (!closed)
+                options.onEvent(event);
+        };
+        const dimensions = { cols: options.cols, rows: options.rows };
+        socket.on('connect', () => {
+            sessionId = null;
+            requestId = globalThis.crypto.randomUUID();
+            send({ type: 'connected' });
+            socket.emit('open', {
+                ...dimensions,
+                conversationId: options.conversationId,
+                projectId: options.projectId,
+                requestId,
+            });
+        });
+        socket.on('opened', (data) => {
+            if (data.requestId !== requestId)
+                return;
+            sessionId = data.sessionId;
+            send({ ...data, type: 'opened' });
+        });
+        socket.on('output', (data) => {
+            // The server can emit initial PTY output before acknowledging open.
+            if (!sessionId || data.sessionId === sessionId)
+                send({ ...data, type: 'output' });
+        });
+        socket.on('exit', (data) => {
+            if (data.sessionId === sessionId)
+                send({ ...data, type: 'exit' });
+        });
+        socket.on('closed', (data) => {
+            if (data.sessionId === sessionId || data.requestId === requestId) {
+                sessionId = null;
+                send({ ...data, type: 'closed' });
+            }
+        });
+        socket.on('error', (data) => {
+            if (data.requestId === requestId || data.sessionId === sessionId)
+                send({ ...data, type: 'error' });
+        });
+        socket.on('exception', (data) => {
+            sessionId = null;
+            send({
+                type: 'error',
+                code: String(data.status ?? 'authorization'),
+                message: data.message ?? 'Terminal authorization failed.',
+            });
+            socket.disconnect();
+        });
+        socket.on('connect_error', (error) => send({ type: 'error', code: 'connection', message: error.message }));
+        socket.on('disconnect', (reason) => {
+            sessionId = null;
+            send({ type: 'disconnected', message: reason });
+        });
+        const connection = {
+            input: (data) => {
+                if (!closed && sessionId && socket.connected)
+                    socket.emit('input', { sessionId, data });
+            },
+            resize: (cols, rows) => {
+                dimensions.cols = cols;
+                dimensions.rows = rows;
+                if (!closed && sessionId && socket.connected)
+                    socket.emit('resize', { sessionId, cols, rows });
+            },
+            close: () => {
+                if (closed)
+                    return;
+                closed = true;
+                if (socket.connected)
+                    socket.emit('close', sessionId ? { sessionId } : { requestId });
+                socket.removeAllListeners();
+                socket.disconnect();
+                options.signal?.removeEventListener('abort', connection.close);
+            },
+        };
+        options.signal?.addEventListener('abort', connection.close, { once: true });
+        socket.connect();
+        return connection;
+    }
+}
+//# sourceMappingURL=workbench.mjs.map

package/dist/workbench.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/xpert-sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "SDK Core functionality package",
   "type": "module",
   "main": "dist/index.js",
@@ -19,6 +19,7 @@
   "dependencies": {
     "p-queue": "^6.6.2",
     "p-retry": "4",
+    "socket.io-client": "^4.8.4",
     "uuid": "^9.0.0"
   },
   "devDependencies": {