@mutagent/cli 0.1.90 → 0.1.92

package/dist/bin/cli.js

@@ -616,6 +616,20 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
+  async getDataset(datasetId) {
+    try {
+      return await this.request(`/api/prompts/datasets/${String(datasetId)}`);
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async getDatasetItem(itemId) {
+    try {
+      return await this.request(`/api/prompts/dataset-items/${String(itemId)}`);
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
   async listDatasets(promptId) {
     try {
       const response = await this.request(`/api/prompt/${promptId}/datasets`);
@@ -3443,8 +3457,10 @@ function registerDatasetCommands(prompts) {
   const dataset = new Command3("dataset").description("Manage datasets for prompts").addHelpText("after", `
 Examples:
   ${chalk8.dim("$")} mutagent prompts dataset list <prompt-id>
+  ${chalk8.dim("$")} mutagent prompts dataset get <dataset-id>
   ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{...},"expectedOutput":{...}}]'
   ${chalk8.dim("$")} mutagent prompts dataset delete <prompt-id> <dataset-id>
+  ${chalk8.dim("$")} mutagent prompts dataset items get <item-id>
     `).action(() => {
     dataset.help();
   });
@@ -3482,6 +3498,60 @@ Examples:
       handleError(error, isJson);
     }
   });
+  dataset.command("get").description("Get full details of a single dataset").argument("<dataset-id>", "Dataset ID (from: mutagent prompts dataset list <prompt-id>)").addHelpText("after", `
+Examples:
+  ${chalk8.dim("$")} mutagent prompts dataset get <dataset-id>
+  ${chalk8.dim("$")} mutagent prompts dataset get <dataset-id> --json
+
+${chalk8.dim("Tip: Use this after `dataset list` to drill into a single dataset.")}
+    `).action(async (datasetId) => {
+    const isJson = getJsonFlag(prompts);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      if (!/^\d+$/.test(datasetId)) {
+        throw new MutagentError("INVALID_ARGUMENT", `Invalid dataset ID: "${datasetId}" (must be numeric)`, `Run: mutagent prompts dataset list <prompt-id>
+Dataset IDs are numeric. Example: mutagent prompts dataset get 42`);
+      }
+      const client = await getSDKClient();
+      const ds = await client.getDataset(datasetId);
+      const promptGroupId = ds.promptGroupId;
+      if (isJson) {
+        output.output({
+          ...ds,
+          _links: datasetLinks(promptGroupId, ds.id)
+        });
+      } else {
+        output.success(`Dataset: ${ds.name} (id: ${String(ds.id)})`);
+        if (ds.description)
+          output.info(`Description: ${ds.description}`);
+        if (ds.itemCount !== undefined)
+          output.info(`Items: ${String(ds.itemCount)}`);
+        if (ds.updatedAt)
+          output.info(`Updated: ${new Date(String(ds.updatedAt)).toLocaleString()}`);
+        if (ds.createdAt)
+          output.info(`Created: ${new Date(String(ds.createdAt)).toLocaleString()}`);
+        if (ds.createdBy)
+          output.info(`Created by: ${ds.createdBy}`);
+        if (ds.labels && ds.labels.length > 0)
+          output.info(`Labels: ${ds.labels.join(", ")}`);
+        const hints = formatCreationHints({
+          resourceType: "Dataset",
+          id: ds.id,
+          name: ds.name,
+          dashboardUrl: datasetLink(promptGroupId, ds.id),
+          apiPath: `/api/prompts/datasets/${String(ds.id)}`
+        });
+        console.log(hints);
+      }
+    } catch (error) {
+      if (error instanceof ApiError && error.statusCode === 404) {
+        handleError(new MutagentError("NOT_FOUND", `Dataset ${datasetId} not found`, `Run: mutagent prompts dataset list <prompt-id>
+Verify the dataset ID exists, or list datasets for a prompt to find valid IDs.`), isJson);
+      } else {
+        handleError(error, isJson);
+      }
+    }
+  });
   dataset.command("add").description("Add dataset to a prompt").argument("<prompt-id>", "Prompt ID (from: mutagent prompts list)").option("-d, --data <json>", "Inline JSON array of dataset items").option("-n, --name <name>", "Dataset name").addHelpText("after", `
 Examples:
   ${chalk8.dim("$")} mutagent prompts dataset add <prompt-id> -d '[{"input":{"text":"hello"},"expectedOutput":{"result":"world"}}]'
@@ -3612,6 +3682,66 @@ Examples:
       handleError(error, isJson);
     }
   });
+  const items = new Command3("items").description("Manage individual dataset items").addHelpText("after", `
+Examples:
+  ${chalk8.dim("$")} mutagent prompts dataset items get <item-id>
+  ${chalk8.dim("$")} mutagent prompts dataset items get <item-id> --json
+    `).action(() => {
+    items.help();
+  });
+  dataset.addCommand(items);
+  items.command("get").description("Get full details of a single dataset item").argument("<item-id>", "Dataset item ID").addHelpText("after", `
+Examples:
+  ${chalk8.dim("$")} mutagent prompts dataset items get <item-id>
+  ${chalk8.dim("$")} mutagent prompts dataset items get <item-id> --json
+
+${chalk8.dim("Tip: Dataset item IDs are shown in dataset exports and optimization results.")}
+    `).action(async (itemId) => {
+    const isJson = getJsonFlag(prompts);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      if (!/^\d+$/.test(itemId)) {
+        throw new MutagentError("INVALID_ARGUMENT", `Invalid dataset item ID: "${itemId}" (must be numeric)`, `Run: mutagent prompts dataset items get --help
+Dataset item IDs are numeric. Example: mutagent prompts dataset items get 17`);
+      }
+      const client = await getSDKClient();
+      const item = await client.getDatasetItem(itemId);
+      const itemWithDs = item;
+      const dsId = itemWithDs.datasetId;
+      if (isJson) {
+        output.output({
+          ...item,
+          _links: {
+            api: `/api/prompts/dataset-items/${String(item.id)}`,
+            ...dsId !== undefined ? { dataset: `/api/prompts/datasets/${String(dsId)}` } : {}
+          }
+        });
+      } else {
+        output.success(`Dataset Item: ${String(item.id)}`);
+        if (dsId !== undefined)
+          output.info(`Dataset ID: ${String(dsId)}`);
+        output.info(`Input: ${JSON.stringify(item.input, null, 2)}`);
+        if (item.expectedOutput !== undefined) {
+          output.info(`Expected output: ${typeof item.expectedOutput === "string" ? item.expectedOutput : JSON.stringify(item.expectedOutput, null, 2)}`);
+        }
+        if (item.metadata && Object.keys(item.metadata).length > 0) {
+          output.info(`Metadata: ${JSON.stringify(item.metadata)}`);
+        }
+        if (item.createdAt)
+          output.info(`Created: ${new Date(String(item.createdAt)).toLocaleString()}`);
+        const itemWithUpdated = item;
+        if (itemWithUpdated.updatedAt)
+          output.info(`Updated: ${new Date(String(itemWithUpdated.updatedAt)).toLocaleString()}`);
+      }
+    } catch (error) {
+      if (error instanceof ApiError && error.statusCode === 404) {
+        handleError(new MutagentError("NOT_FOUND", `Dataset item ${itemId} not found`, `Run: mutagent prompts dataset items get --help
+Verify the item ID exists. Use the dashboard or dataset exports to find valid item IDs.`), isJson);
+      } else {
+        handleError(error, isJson);
+      }
+    }
+  });
 }
 
 // src/commands/prompts/evaluations.ts
@@ -9105,5 +9235,5 @@ program.addCommand(createHooksCommand());
 program.addCommand(createFeedbackCommand());
 program.parse();
 
-//# debugId=A8E80F0BEF0DA5B364756E2164756E21
+//# debugId=A84DFC92DB1ED69764756E2164756E21
 //# sourceMappingURL=cli.js.map