codemie-sdk 0.1.227 → 0.1.228

package/README.md

@@ -1079,5 +1079,49 @@ Then run the tests:
 npm run test:e2e
 ```
 
+### Assistant Versioning via SDK
+
+The Node.js SDK exposes assistant versioning capabilities delivered in EPMCDME-8285.
+
+- List versions
+```ts
+const versions = await client.assistants.listVersions("assistant-id", { page: 0, per_page: 20 });
+console.log(versions.map(v => v.version_number));
+```
+
+- Get specific version
+```ts
+const version = await client.assistants.getVersion("assistant-id", 2);
+console.log(version.system_prompt);
+```
+
+- Compare two versions
+```ts
+const diff = await client.assistants.compareVersions("assistant-id", 1, 3);
+console.log(diff.summary);
+```
+
+- Rollback to a version
+```ts
+const resp = await client.assistants.rollbackToVersion("assistant-id", 2);
+console.log(resp);
+```
+
+- Chat with a specific version
+```ts
+import { z } from "zod";
+
+const ResponseFormat = z.object({ answer: z.string(), followup_question: z.string() });
+const params = { text: "Hi", stream: false, output_schema: ResponseFormat };
+
+const resp = await client.assistants.chatWithVersion("assistant-id", 2, params);
+console.log(resp.generated);
+```
+
+Quick CLI example
+```bash
+npx ts-node codemie-sdk/sdk/codemie-nodejs/examples/assistant_versions.ts <assistant_id> [version_number]
+```
+
 ## Support
 For providing credentials please contact AI/Run CodeMie Team: Vadym_Vlasenko@epam.com or Nikita_Levyankov@epam.com

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(index_exports, {
   AssistantCreateParamsSchema: () => AssistantCreateParamsSchema,
   AssistantListParamsSchema: () => AssistantListParamsSchema,
   AssistantUpdateParamsSchema: () => AssistantUpdateParamsSchema,
+  AssistantVersionsListParamsSchema: () => AssistantVersionsListParamsSchema,
   BackgroundTaskStatus: () => BackgroundTaskStatus,
   ChatRole: () => ChatRole,
   CodeDataSourceType: () => CodeDataSourceType,
@@ -230,11 +231,16 @@ var AssistantChatParamsSchema = import_zod.z.object({
   background_task: import_zod.z.boolean().optional(),
   metadata: import_zod.z.record(import_zod.z.unknown()).optional(),
   mcp_server_single_usage: import_zod.z.boolean().optional(),
+  version: import_zod.z.number().optional(),
   output_schema: import_zod.z.union([
     import_zod.z.custom((val) => val instanceof import_zod.z.ZodType),
     import_zod.z.record(import_zod.z.unknown())
   ]).optional()
 }).readonly();
+var AssistantVersionsListParamsSchema = import_zod.z.object({
+  page: import_zod.z.number().optional(),
+  per_page: import_zod.z.number().optional()
+}).readonly();
 
 // src/utils/http.ts
 var import_node_https2 = require("https");
@@ -406,6 +412,37 @@ var AssistantService = class {
   async getPrebuiltBySlug(slug) {
     return this.api.get(`/v1/assistants/prebuilt/${slug}`);
   }
+  /**
+   * List assistant versions.
+   */
+  async listVersions(assistantId, _params = {}) {
+    const params = AssistantVersionsListParamsSchema.parse(_params);
+    const response = await this.api.get(
+      `/v1/assistants/${assistantId}/versions`,
+      params
+    );
+    if (Array.isArray(response)) {
+      return response;
+    }
+    if (response && "data" in response && Array.isArray(response.data)) {
+      return response.data;
+    }
+    if (response && "versions" in response && Array.isArray(response.versions)) {
+      return response.versions;
+    }
+    if (response && "items" in response && Array.isArray(response.items)) {
+      return response.items;
+    }
+    return [];
+  }
+  /**
+   * Get a specific assistant version by number.
+   */
+  async getVersion(assistantId, versionNumber) {
+    return this.api.get(
+      `/v1/assistants/${assistantId}/versions/${versionNumber}`
+    );
+  }
   /**
    * Send a chat request to an assistant.
    */
@@ -432,6 +469,49 @@ var AssistantService = class {
     }
     return mapped;
   }
+  /**
+   * Compare two assistant versions.
+   */
+  async compareVersions(assistantId, v1, v2) {
+    return this.api.get(
+      `/v1/assistants/${assistantId}/versions/${v1}/compare/${v2}`
+    );
+  }
+  /**
+   * Rollback assistant to a specific version. Creates a new version mirroring the target.
+   */
+  async rollbackToVersion(assistantId, versionNumber) {
+    return this.api.post(
+      `/v1/assistants/${assistantId}/versions/${versionNumber}/rollback`,
+      {}
+    );
+  }
+  /**
+   * Send a chat request to a specific assistant version.
+   */
+  async chatWithVersion(assistantId, versionNumber, _params) {
+    let zodSchema = void 0;
+    let params = { ..._params };
+    if (params.output_schema && params.output_schema instanceof import_zod2.z.ZodType) {
+      zodSchema = params.output_schema;
+      params.output_schema = (0, import_zod_to_json_schema.zodToJsonSchema)(zodSchema, {
+        definitions: {}
+      });
+    }
+    params = AssistantChatParamsSchema.parse(params);
+    const response = await this.api.post(
+      `/v1/assistants/${assistantId}/model`,
+      { ...params, version: versionNumber },
+      {
+        responseType: params.stream ? "stream" : void 0
+      }
+    );
+    const mapped = AssistantMapper.mapBaseModelApiResponse(response);
+    if (!params.stream && zodSchema && mapped.generated) {
+      mapped.generated = zodSchema.parse(mapped.generated);
+    }
+    return mapped;
+  }
 };
 
 // src/schemas/conversation.ts
@@ -1409,6 +1489,7 @@ var BackgroundTaskStatus = {
   AssistantCreateParamsSchema,
   AssistantListParamsSchema,
   AssistantUpdateParamsSchema,
+  AssistantVersionsListParamsSchema,
   BackgroundTaskStatus,
   ChatRole,
   CodeDataSourceType,