@mutagent/cli 0.1.50 → 0.1.52

package/dist/bin/cli.js

@@ -455,7 +455,7 @@ class SDKClientWrapper {
   workspaceId;
   organizationId;
   constructor(opts) {
-    this.apiKey = opts.bearerAuth;
+    this.apiKey = opts.apiKey;
     this.endpoint = opts.serverURL ?? "http://localhost:3003";
     this.workspaceId = opts.workspaceId;
     this.organizationId = opts.organizationId;
@@ -605,9 +605,13 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
-  async deletePrompt(id) {
+  async deletePrompt(id, options) {
     try {
-      await this.sdk.prompt.deletePrompt({ id: parseInt(id, 10) });
+      if (options?.force) {
+        await this.request(`/api/prompts/${id}?force=true`, { method: "DELETE" });
+      } else {
+        await this.sdk.prompt.deletePrompt({ id: parseInt(id, 10) });
+      }
     } catch (error) {
       this.handleError(error);
     }
@@ -677,9 +681,10 @@ class SDKClientWrapper {
       this.handleError(error);
     }
   }
-  async deleteDataset(_promptId, datasetId) {
+  async deleteDataset(_promptId, datasetId, options) {
     try {
-      await this.request(`/api/prompts/datasets/${datasetId}`, { method: "DELETE" });
+      const query = options?.force ? "?force=true" : "";
+      await this.request(`/api/prompts/datasets/${datasetId}${query}`, { method: "DELETE" });
     } catch (error) {
       this.handleError(error);
     }
@@ -1007,7 +1012,7 @@ function getSDKClient() {
     }
     const config = loadConfig();
     sdkClient = new SDKClientWrapper({
-      bearerAuth: apiKey,
+      apiKey,
       serverURL: config.endpoint,
       workspaceId: config.defaultWorkspace,
       organizationId: config.defaultOrganization
@@ -1020,7 +1025,7 @@ function resetSDKClient() {
 }
 async function validateApiKey(apiKey, endpoint) {
   try {
-    const response = await fetch(`${endpoint}/api/organizations`, {
+    const response = await fetch(`${endpoint}/api/providers`, {
       headers: { "x-api-key": apiKey }
     });
     return response.ok;
@@ -2339,6 +2344,9 @@ Examples:
         output.success(`Integration: ${contextSummary.integrated.join(", ")} (active)`);
       }
     }
+    if (!isValid) {
+      process.exit(1);
+    }
   });
   auth.command("logout").description("Clear stored credentials").addHelpText("after", `
 Examples:
@@ -3161,7 +3169,7 @@ ${chalk6.dim("Tip: Combine --with-datasets and --with-evals to fetch all nested
       handleError(error, isJson);
     }
   });
-  prompts.command("create").description("Create a new prompt").option("-n, --name <name>", "Prompt name").option("--description <text>", "Prompt description (shown in dashboard)").option("-c, --content <content>", "Prompt content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--output-schema <json>", "Output schema as JSON string (required for optimization)").addHelpText("after", `
+  prompts.command("create").description("Create a new prompt").option("-n, --name <name>", "Prompt name").option("--description <text>", "Prompt description (shown in dashboard)").option("-c, --content <content>", "Prompt content (rawPrompt) [DEPRECATED: use --raw]").option("-r, --raw <text>", "Raw prompt text (single prompt)").option("--system <text>", "System prompt (use with --human)").option("--human <text>", "Human prompt (use with --system)").option("--messages <json>", `Messages array as JSON (e.g., '[{"role":"system","content":"..."}]')`).option("--output-schema <json>", "Output schema as JSON string (required for optimization)").option("--input-schema <json>", "Input variable schema as JSON string").addHelpText("after", `
 Examples:
   ${chalk6.dim("$")} mutagent prompts create --name "my-prompt" --description "Greeting prompt for customers" --system "You are helpful" --human "{input}" --output-schema '{"type":"object","properties":{"result":{"type":"string","description":"The result"}}}'
   ${chalk6.dim("$")} mutagent prompts create --name "raw-prompt" --raw "Summarize: {text}" --output-schema '{"type":"object","properties":{"summary":{"type":"string","description":"Summary"}}}'
@@ -3237,14 +3245,12 @@ Use --raw, --system/--human, or --messages to specify prompt content`);
         throw new MutagentError("MISSING_ARGUMENTS", "--name is required. Use --name with --system/--human, --raw, or --messages", `Run: mutagent prompts create --help
 Provide --name with --system/--human, --raw, or --messages to specify prompt content`);
       }
-      if (options.outputSchema) {
-        try {
-          data.outputSchema = JSON.parse(options.outputSchema);
-        } catch {
-          throw new MutagentError("INVALID_JSON", "Invalid JSON in --output-schema flag", `Run: mutagent prompts create --help
-Provide a valid JSON Schema, e.g., '{"type":"object","properties":{"result":{"type":"string"}}}'`);
-        }
-      }
+      const parsedOutputSchema = parseSchemaOption(options.outputSchema, undefined, "output-schema", "mutagent prompts create --help");
+      if (parsedOutputSchema)
+        data.outputSchema = parsedOutputSchema;
+      const parsedInputSchema = parseSchemaOption(options.inputSchema, undefined, "input-schema", "mutagent prompts create --help");
+      if (parsedInputSchema)
+        data.inputSchema = parsedInputSchema;
       if (isSchemaEmpty(data.outputSchema)) {
         throw new MutagentError("MISSING_ARGUMENTS", "outputSchema is required for prompt creation", `Run: mutagent prompts create --help
 Use --output-schema '{"type":"object","properties":{...}}'`);
@@ -3384,7 +3390,7 @@ ${chalk6.dim("Note: --force is required. The CLI is non-interactive — confirm
       }
       const client = getSDKClient();
       try {
-        await client.deletePrompt(id);
+        await client.deletePrompt(id, { force: true });
       } catch (deleteError) {
         if (deleteError instanceof ApiError && deleteError.statusCode === 404) {
           if (isJson) {
@@ -3564,7 +3570,7 @@ Examples:
       }
       const client = getSDKClient();
       try {
-        await client.deleteDataset(promptId, datasetId);
+        await client.deleteDataset(promptId, datasetId, { force: true });
       } catch (deleteError) {
         if (deleteError instanceof ApiError && deleteError.statusCode === 404) {
           if (isJson) {
@@ -5967,69 +5973,30 @@ version: 2.0.0
 - MUTAGENT_ENDPOINT: ${config.endpoint}
 - API Connection: Verified
 
-> **Note**: LangGraph is built on LangChain. The same \`MutagentCallbackHandler\` from
-> \`@mutagent/langchain\` works for both LangChain and LangGraph — no separate package needed.
-
 ## Installation
 
 \`\`\`bash
-bun add @mutagent/langchain @mutagent/sdk
+bun add @mutagent/langgraph @mutagent/sdk
 # or
-npm install @mutagent/langchain @mutagent/sdk
+npm install @mutagent/langgraph @mutagent/sdk
 \`\`\`
 
-> **Deprecation Notice**: The \`@mutagent/langgraph\` package is deprecated.
-> Use \`@mutagent/langchain\` instead — it supports both LangChain and LangGraph.
-
 ## Integration
 
 \`\`\`typescript
-import { MutagentCallbackHandler } from '@mutagent/langchain';
+import { MutagentCallbackHandler } from '@mutagent/langgraph';
 import { initTracing } from '@mutagent/sdk/tracing';
 
-// Initialize tracing (once at app startup)
-initTracing({ apiKey: process.env.MUTAGENT_API_KEY! });
-
-// Create the handler
-const handler = new MutagentCallbackHandler({
-  sessionId: 'my-session',  // optional
-  userId: 'user-123',       // optional
-});
-
-// Pass to any LangGraph invoke/stream call
-const result = await graph.invoke(input, { callbacks: [handler] });
-\`\`\`
-
-## Full Graph Example
-
-\`\`\`typescript
-import { StateGraph, Annotation } from '@langchain/langgraph';
-import { ChatOpenAI } from '@langchain/openai';
-import { MutagentCallbackHandler } from '@mutagent/langchain';
-import { initTracing } from '@mutagent/sdk/tracing';
-
-// Initialize tracing (once at app startup)
+// Initialize MutagenT tracing
 initTracing({ apiKey: process.env.MUTAGENT_API_KEY! });
 
+// Create callback handler (no constructor args)
 const handler = new MutagentCallbackHandler();
 
-// Define your graph as usual
-const StateAnnotation = Annotation.Root({
-  input: Annotation<string>,
-  output: Annotation<string>,
+// Pass as callback to your LangGraph execution
+const result = await graph.invoke(input, {
+  callbacks: [handler],
 });
-
-const graph = new StateGraph(StateAnnotation)
-  .addNode('agent', agentNode)
-  .addNode('tools', toolNode)
-  .addEdge('__start__', 'agent')
-  .compile();
-
-// All nodes, edges, and LLM calls are automatically traced
-const result = await graph.invoke(
-  { input: 'Hello' },
-  { callbacks: [handler] },
-);
 \`\`\`
 
 ## Streaming
@@ -6099,83 +6066,63 @@ version: 2.0.0
 ## Installation
 
 \`\`\`bash
-bun add @mutagent/vercel-ai @mutagent/sdk
+bun add @mutagent/vercel-ai @mutagent/sdk @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base
 # or
-npm install @mutagent/vercel-ai @mutagent/sdk
-
-# For Option A (OTel SpanExporter), also install:
-bun add @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base
+npm install @mutagent/vercel-ai @mutagent/sdk @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base
 \`\`\`
 
----
-
-## Option A (Recommended): OTel SpanExporter
+## Option A: OpenTelemetry (Recommended)
 
-Uses Vercel AI SDK's built-in \`experimental_telemetry\` with an OpenTelemetry exporter
-that sends spans directly to MutagenT.
+Follows the same pattern as Langfuse, Braintrust, SigNoz, and other major observability providers.
+Uses \`MutagentSpanExporter\` as a standard OTel SpanProcessor — no model wrapping required.
 
 \`\`\`typescript
+import { generateText } from 'ai';
+import { openai } from '@ai-sdk/openai';
 import { MutagentSpanExporter } from '@mutagent/vercel-ai';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
 import { SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';
-import { initTracing } from '@mutagent/sdk/tracing';
-import { generateText } from 'ai';
-import { openai } from '@ai-sdk/openai';
 
-// Initialize MutagenT tracing
-initTracing({ apiKey: process.env.MUTAGENT_API_KEY! });
-
-// Set up OTel with MutagenT exporter
+// Set up OTel provider with MutagenT exporter (once at app startup)
 const provider = new NodeTracerProvider();
 provider.addSpanProcessor(
   new SimpleSpanProcessor(new MutagentSpanExporter())
 );
 provider.register();
 
-// Use Vercel AI SDK normally with telemetry enabled
+// Enable telemetry on AI SDK calls — all calls are automatically traced
 const result = await generateText({
-  model: openai('gpt-4'),
+  model: openai('gpt-4o'),
   prompt: 'Hello!',
   experimental_telemetry: { isEnabled: true },
 });
 \`\`\`
 
----
-
-## Option B (Alternative): Middleware
-
-Uses the Vercel AI SDK \`wrapLanguageModel\` middleware pattern.
+### Streaming with OTel
 
 \`\`\`typescript
 // app/api/chat/route.ts
-import { streamText, wrapLanguageModel } from 'ai';
+import { streamText } from 'ai';
 import { openai } from '@ai-sdk/openai';
-import { createMutagentMiddleware } from '@mutagent/vercel-ai';
-import { initTracing } from '@mutagent/sdk/tracing';
-
-// Initialize tracing (once at app startup)
-initTracing({ apiKey: process.env.MUTAGENT_API_KEY! });
-
-// Create middleware
-const middleware = createMutagentMiddleware();
-
-// Wrap your model with MutagenT middleware
-const model = wrapLanguageModel({
-  model: openai('gpt-4o'),
-  middleware,
-});
 
 export async function POST(req: Request) {
   const { messages } = await req.json();
 
-  // All calls are automatically traced
-  const result = streamText({ model, messages });
+  // OTel provider registered at startup — just enable telemetry
+  const result = streamText({
+    model: openai('gpt-4o'),
+    messages,
+    experimental_telemetry: { isEnabled: true },
+  });
 
   return result.toDataStreamResponse();
 }
 \`\`\`
 
-## Non-Streaming Usage
+## Option B: Middleware (Alternative — Simple / Legacy)
+
+Works without OTel setup. Good for quick prototyping or environments where
+installing OTel dependencies is not practical.
 
 \`\`\`typescript
 import { generateText, wrapLanguageModel } from 'ai';
@@ -6191,6 +6138,26 @@ const { text } = await generateText({
 });
 \`\`\`
 
+### Streaming with Middleware
+
+\`\`\`typescript
+// app/api/chat/route.ts
+import { streamText, wrapLanguageModel } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { createMutagentMiddleware } from '@mutagent/vercel-ai';
+
+const middleware = createMutagentMiddleware();
+const model = wrapLanguageModel({ model: openai('gpt-4o'), middleware });
+
+export async function POST(req: Request) {
+  const { messages } = await req.json();
+
+  const result = streamText({ model, messages });
+
+  return result.toDataStreamResponse();
+}
+\`\`\`
+
 ## Verification
 
 \`\`\`bash
@@ -6253,31 +6220,26 @@ npm install @mutagent/openai @mutagent/sdk
 ## Integration
 
 \`\`\`typescript
-import OpenAI from 'openai';
 import { observeOpenAI } from '@mutagent/openai';
 import { initTracing } from '@mutagent/sdk/tracing';
 
-// Initialize tracing (once at app startup)
+// Initialize MutagenT tracing
 initTracing({ apiKey: process.env.MUTAGENT_API_KEY! });
 
-// Wrap the OpenAI client — ALL methods are automatically traced
-const openai = observeOpenAI(new OpenAI(), {
-  sessionId: 'my-session',  // optional
-  userId: 'user-123',       // optional
-});
+// Wrap your OpenAI client with observeOpenAI for automatic tracing
+const openai = observeOpenAI(new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY,
+}));
 
-// Use exactly as normal — chat, embeddings, images, audio all work
-const completion = await openai.chat.completions.create({
+// All calls are automatically traced
+const response = await openai.chat.completions.create({
   model: 'gpt-4o',
   messages: [{ role: 'user', content: 'Hello!' }],
 });
 
-console.log(completion.choices[0].message.content);
+console.log(response.choices[0].message.content);
 \`\`\`
 
-ALL OpenAI SDK methods are preserved and traced automatically.
-No API changes — just wrap your client and everything is observed.
-
 ## Streaming
 
 Streaming works out of the box with no extra configuration:
@@ -8601,5 +8563,5 @@ program.addCommand(createUsageCommand());
 program.addCommand(createHooksCommand());
 program.parse();
 
-//# debugId=9DE14F18C9B5C35264756E2164756E21
+//# debugId=DC3AE5F1F511B4AF64756E2164756E21
 //# sourceMappingURL=cli.js.map