@mutagent/cli 0.1.11 → 0.1.13

package/dist/bin/cli.js

@@ -439,9 +439,9 @@ class SDKClientWrapper {
         systemPrompt: data.systemPrompt ?? undefined,
         humanPrompt: data.humanPrompt ?? undefined,
         rawPrompt: data.rawPrompt ?? undefined,
-        inputSchema: data.inputSchema ?? {},
-        outputSchema: data.outputSchema,
-        metadata: data.metadata,
+        inputSchema: data.inputSchema ?? undefined,
+        outputSchema: data.outputSchema ?? undefined,
+        metadata: data.metadata ?? undefined,
         tags: data.tags ?? undefined
       });
       return response;
@@ -1628,11 +1628,85 @@ function providerSettingsLink() {
 }
 function promptLinks(promptId) {
   return {
-    view: promptLink(promptId),
+    dashboard: promptLink(promptId),
+    api: `/api/prompts/${String(promptId)}`,
     datasets: promptDatasetsLink(promptId),
     evaluations: promptEvaluationsLink(promptId)
   };
 }
+function datasetLinks(promptId, datasetId) {
+  return {
+    dashboard: datasetLink(promptId, datasetId),
+    api: `/api/prompts/${String(promptId)}/datasets/${String(datasetId)}`
+  };
+}
+function evaluationLinks(promptId, evalId) {
+  return {
+    dashboard: evaluationLink(promptId, evalId),
+    api: `/api/prompts/${String(promptId)}/evaluations/${String(evalId)}`
+  };
+}
+function formatCreationHints(hint) {
+  const lines = [
+    "",
+    `  -> View in dashboard: ${hint.dashboardUrl}`,
+    `  -> API: GET ${hint.apiPath}`,
+    "",
+    "  Tip: Copy the link above to open in your browser or share with your team."
+  ];
+  return lines.join(`
+`);
+}
+
+// src/lib/schema-helpers.ts
+var SUPPORTED_SCHEMA_TYPES = ["string", "number", "boolean", "array", "object"];
+function isValidJsonSchema(schema) {
+  if (schema === null || schema === undefined)
+    return false;
+  if (typeof schema !== "object")
+    return false;
+  if (Array.isArray(schema))
+    return false;
+  const obj = schema;
+  if (!("type" in obj) || typeof obj.type !== "string")
+    return false;
+  if (obj.type === "object") {
+    if (!("properties" in obj) || typeof obj.properties !== "object" || obj.properties === null) {
+      return false;
+    }
+  }
+  return true;
+}
+function buildSchemaFromVariables(variables) {
+  const properties = {};
+  for (const variable of variables) {
+    const prop = { type: variable.type };
+    if (variable.description) {
+      prop.description = variable.description;
+    }
+    properties[variable.name] = prop;
+  }
+  return {
+    type: "object",
+    properties
+  };
+}
+function formatSchemaWarning(fieldName) {
+  return [
+    `${fieldName} doesn't appear to be a valid JSON Schema.`,
+    "",
+    "  Expected format:",
+    "  {",
+    '    "type": "object",',
+    '    "properties": {',
+    '      "variable_name": { "type": "string", "description": "Description here" }',
+    "    }",
+    "  }",
+    "",
+    "  You can also provide a schema file: mutagent prompts create --file schema.json"
+  ].join(`
+`);
+}
 
 // src/commands/prompts.ts
 var PREREQUISITES_TEXT = `
@@ -1659,16 +1733,116 @@ function parseValidationErrors(error) {
   }
   return ["An unknown error occurred"];
 }
-function isMissingOutputSchema(data) {
-  const schema = data.outputSchema;
-  if (schema === null || schema === undefined)
+function isSchemaEmpty(schema) {
+  if (schema === undefined || schema === null)
     return true;
-  if (typeof schema === "object" && Object.keys(schema).length === 0)
+  if (typeof schema !== "object")
+    return false;
+  const obj = schema;
+  if (Object.keys(obj).length === 0)
     return true;
   return false;
 }
-function warnMissingOutputSchema(output) {
-  output.warn("No outputSchema provided. Optimization jobs require an outputSchema to validate outputs. " + "Prompts without outputSchema cannot be optimized.");
+function warnMissingSchemas(data, output) {
+  if (isSchemaEmpty(data.inputSchema)) {
+    output.warn("No inputSchema provided. Optimization requires inputSchema with defined variables.");
+  } else if (!isValidJsonSchema(data.inputSchema)) {
+    output.warn(formatSchemaWarning("inputSchema"));
+  }
+  if (isSchemaEmpty(data.outputSchema)) {
+    output.warn("No outputSchema provided. This may limit optimization effectiveness.");
+  } else if (!isValidJsonSchema(data.outputSchema)) {
+    output.warn(formatSchemaWarning("outputSchema"));
+  }
+}
+async function collectSchemaInteractively() {
+  const inquirer3 = (await import("inquirer")).default;
+  const variables = [];
+  let addMore = true;
+  while (addMore) {
+    const answers = await inquirer3.prompt([
+      {
+        type: "input",
+        name: "name",
+        message: "Variable name:",
+        validate: (input) => {
+          if (!input.trim())
+            return "Variable name is required";
+          if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(input.trim())) {
+            return "Variable name must start with a letter/underscore and contain only alphanumeric/underscore";
+          }
+          return true;
+        }
+      },
+      {
+        type: "list",
+        name: "type",
+        message: "Variable type:",
+        choices: [...SUPPORTED_SCHEMA_TYPES]
+      },
+      {
+        type: "input",
+        name: "description",
+        message: "Description (optional):"
+      }
+    ]);
+    variables.push({
+      name: answers.name.trim(),
+      type: answers.type,
+      description: answers.description.trim() || undefined
+    });
+    const continueAnswer = await inquirer3.prompt([{
+      type: "confirm",
+      name: "addAnother",
+      message: "Add another variable?",
+      default: false
+    }]);
+    addMore = continueAnswer.addAnother;
+  }
+  return buildSchemaFromVariables(variables);
+}
+async function promptForInputSchema() {
+  const inquirer3 = (await import("inquirer")).default;
+  const answer = await inquirer3.prompt([{
+    type: "list",
+    name: "choice",
+    message: "Would you like to define input variables for this prompt?",
+    choices: [
+      { name: "Yes, define variables interactively", value: "interactive" },
+      { name: "Provide a JSON Schema file path", value: "file" },
+      { name: "Skip (not recommended for optimization)", value: "skip" }
+    ]
+  }]);
+  if (answer.choice === "interactive") {
+    return collectSchemaInteractively();
+  }
+  if (answer.choice === "file") {
+    const fileAnswer = await inquirer3.prompt([{
+      type: "input",
+      name: "path",
+      message: "JSON Schema file path:",
+      validate: (input) => {
+        if (!input.trim())
+          return "File path is required";
+        if (!existsSync2(input.trim()))
+          return `File not found: ${input.trim()}`;
+        return true;
+      }
+    }]);
+    const content = readFileSync2(fileAnswer.path.trim(), "utf-8");
+    try {
+      const parsed = JSON.parse(content);
+      if (!isValidJsonSchema(parsed)) {
+        console.log(chalk4.yellow(`
+  Warning: ${formatSchemaWarning("inputSchema")}
+`));
+      }
+      return parsed;
+    } catch {
+      throw new MutagentError("INVALID_JSON", `Failed to parse JSON Schema from ${fileAnswer.path.trim()}`, "Ensure the file contains valid JSON");
+    }
+  }
+  return;
 }
 function warnSingleBraceVariables(content, output) {
   const singleBracePattern = /(?<!\{)\{([a-zA-Z_][a-zA-Z0-9_]*)\}(?!\})/g;
@@ -1861,17 +2035,31 @@ ${chalk4.dim("Hint: Use --file with JSON or --raw-file for plain text. Get promp
       if (promptContent && !isJson) {
         warnSingleBraceVariables(promptContent, output);
       }
-      if (isMissingOutputSchema(data)) {
-        warnMissingOutputSchema(output);
+      if (!isJson && isSchemaEmpty(data.inputSchema)) {
+        if (process.stdin.isTTY) {
+          const schema = await promptForInputSchema();
+          if (schema) {
+            data.inputSchema = schema;
+          }
+        } else {
+          output.warn("No inputSchema provided. Optimization requires inputSchema with defined variables.");
+        }
       }
+      warnMissingSchemas(data, output);
       const client = getSDKClient();
       const prompt = await client.createPrompt(data);
       if (isJson) {
         output.output({ ...prompt, _links: promptLinks(prompt.id) });
       } else {
-        output.success(`Created prompt: ${prompt.name}`);
-        output.output(prompt);
-        output.info(`View: ${promptLink(prompt.id)}`);
+        output.success(`Created prompt: ${prompt.name} (id: ${String(prompt.id)})`);
+        const hints = formatCreationHints({
+          resourceType: "Prompt",
+          id: prompt.id,
+          name: prompt.name,
+          dashboardUrl: promptLink(prompt.id),
+          apiPath: `/api/prompts/${String(prompt.id)}`
+        });
+        console.log(hints);
       }
     } catch (error) {
       handleError(error, isJson);
@@ -1933,16 +2121,20 @@ Examples:
       if (promptContent && !isJson) {
         warnSingleBraceVariables(promptContent, output);
       }
-      if (options.file && isMissingOutputSchema(data)) {
-        warnMissingOutputSchema(output);
-      }
       const client = getSDKClient();
       const prompt = await client.updatePrompt(id, data);
       if (isJson) {
         output.output({ ...prompt, _links: promptLinks(prompt.id) });
       } else {
-        output.success(`Updated prompt: ${prompt.name}`);
-        output.output(prompt);
+        output.success(`Updated prompt: ${prompt.name} (id: ${String(prompt.id)})`);
+        const hints = formatCreationHints({
+          resourceType: "Prompt",
+          id: prompt.id,
+          name: prompt.name,
+          dashboardUrl: promptLink(prompt.id),
+          apiPath: `/api/prompts/${String(prompt.id)}`
+        });
+        console.log(hints);
       }
     } catch (error) {
       handleError(error, isJson);
@@ -1998,7 +2190,7 @@ Examples:
       if (isJson) {
         const withLinks = datasets.map((d) => ({
           ...d,
-          _links: { view: datasetLink(promptId, d.id) }
+          _links: datasetLinks(promptId, d.id)
         }));
         output.output(withLinks);
       } else {
@@ -2059,13 +2251,25 @@ ${chalk4.dim("Note: --file and -d are mutually exclusive. Provide one or the oth
       }
       const client = getSDKClient();
       const datasetResult = await client.addDataset(promptId, content, options.name);
-      if (!isJson) {
-        output.success(`Added dataset "${datasetResult.name}" to prompt: ${promptId}`);
+      if (isJson) {
+        output.output({
+          ...datasetResult,
+          _links: datasetLinks(promptId, datasetResult.id)
+        });
+      } else {
+        output.success(`Added dataset "${datasetResult.name}" to prompt: ${promptId} (id: ${String(datasetResult.id)})`);
         if (datasetResult.itemCount !== undefined && datasetResult.itemCount > 0) {
           output.info(`Items uploaded: ${String(datasetResult.itemCount)}`);
         }
+        const hints = formatCreationHints({
+          resourceType: "Dataset",
+          id: datasetResult.id,
+          name: datasetResult.name,
+          dashboardUrl: datasetLink(promptId, datasetResult.id),
+          apiPath: `/api/prompts/${promptId}/datasets/${String(datasetResult.id)}`
+        });
+        console.log(hints);
       }
-      output.output(datasetResult);
     } catch (error) {
       handleError(error, isJson);
     }
@@ -2104,7 +2308,7 @@ Examples:
       if (isJson) {
         const withLinks = evals.map((e) => ({
           ...e,
-          _links: { view: evaluationLink(promptId, e.id) }
+          _links: evaluationLinks(promptId, e.id)
         }));
         output.output(withLinks);
       } else {
@@ -2167,12 +2371,18 @@ ${chalk4.dim("Get prompt IDs: mutagent prompts list | Get dataset IDs: mutagent
       if (isJson) {
         output.output({
           ...evalResult,
-          _links: { view: evaluationLink(promptId, evalResult.id) }
+          _links: evaluationLinks(promptId, evalResult.id)
         });
       } else {
-        output.success(`Created evaluation: ${evalResult.name}`);
-        output.output(evalResult);
-        output.info(`View: ${evaluationLink(promptId, evalResult.id)}`);
+        output.success(`Created evaluation: ${evalResult.name} (id: ${String(evalResult.id)})`);
+        const hints = formatCreationHints({
+          resourceType: "Evaluation",
+          id: evalResult.id,
+          name: evalResult.name,
+          dashboardUrl: evaluationLink(promptId, evalResult.id),
+          apiPath: `/api/prompts/${promptId}/evaluations/${String(evalResult.id)}`
+        });
+        console.log(hints);
       }
     } catch (error) {
       handleError(error, isJson);
@@ -2215,12 +2425,6 @@ ${chalk4.dim("Monitor progress with: mutagent prompts optimize status <job-id>")
     const output = new OutputFormatter(isJson ? "json" : "table");
     try {
       const client = getSDKClient();
-      try {
-        const promptData = await client.getPrompt(promptId);
-        if (isMissingOutputSchema(promptData)) {
-          output.warn("This prompt has no outputSchema defined. Optimization jobs require an outputSchema to validate outputs. " + "The job may fail at the dataset analysis stage. " + "Add an outputSchema via: mutagent prompts update " + promptId + " --file prompt-with-schema.json");
-        }
-      } catch {}
       const job = await client.startOptimization(promptId, options.dataset, {
         maxIterations: options.maxIterations ? parseInt(options.maxIterations, 10) : undefined,
         targetScore: options.targetScore ? parseFloat(options.targetScore) : undefined,
@@ -2229,11 +2433,22 @@ ${chalk4.dim("Monitor progress with: mutagent prompts optimize status <job-id>")
         evalModel: options.evalModel
       });
       if (isJson) {
-        output.output({ ...job, _links: { optimizer: optimizerLink(job.jobId) } });
+        output.output({
+          ...job,
+          _links: {
+            dashboard: optimizerLink(job.jobId),
+            api: `/api/prompts/${promptId}/optimizations/${job.jobId}`
+          }
+        });
       } else {
         output.success(`Started optimization job: ${job.jobId}`);
-        output.output(job);
-        output.info(`Monitor: ${optimizerLink(job.jobId)}`);
+        const hints = formatCreationHints({
+          resourceType: "Optimization",
+          id: job.jobId,
+          dashboardUrl: optimizerLink(job.jobId),
+          apiPath: `/api/prompts/${promptId}/optimizations/${job.jobId}`
+        });
+        console.log(hints);
       }
     } catch (error) {
       if (error instanceof ApiError) {
@@ -4968,5 +5183,5 @@ program.addCommand(createWorkspacesCommand());
 program.addCommand(createProvidersCommand());
 program.parse();
 
-//# debugId=33AA6EB433FA7E6264756E2164756E21
+//# debugId=EDFE2E68EFA4B20A64756E2164756E21
 //# sourceMappingURL=cli.js.map