mastra 1.9.2-alpha.2 → 1.9.2

package/dist/index.js

@@ -1,8 +1,8 @@
 #! /usr/bin/env node
-import { package_default, create, init, logger, createLogger, listOrgsAction, resolveCurrentOrg, switchOrgAction } from './chunk-7P7J7HCD.js';
-export { create } from './chunk-7P7J7HCD.js';
-import { PosthogAnalytics, setAnalytics, COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, parseSkills, checkForPkgJson, getVersionTag, isGitInitialized, checkAndInstallCoreDeps, interactivePrompt, FileService, shouldSkipDotenvLoading, getAnalytics, DepsService } from './chunk-X3CD6TSG.js';
-export { PosthogAnalytics } from './chunk-X3CD6TSG.js';
+import { package_default, create, init, logger, createLogger, listOrgsAction, resolveCurrentOrg, switchOrgAction } from './chunk-LZZOW7IH.js';
+export { create } from './chunk-LZZOW7IH.js';
+import { PosthogAnalytics, setAnalytics, COMPONENTS, parseComponents, LLMProvider, parseLlmProvider, parseMcp, parseSkills, checkForPkgJson, getVersionTag, isGitInitialized, checkAndInstallCoreDeps, interactivePrompt, FileService, shouldSkipDotenvLoading, getAnalytics, DepsService } from './chunk-MVHERJCK.js';
+export { PosthogAnalytics } from './chunk-MVHERJCK.js';
 import { fetchOrgs } from './chunk-4Z57PBTZ.js';
 import { getToken, getCurrentOrgId, validateOrgAccess, loadCredentials, verifyToken, tryRefreshToken, login, clearCredentials } from './chunk-EXG3XKBK.js';
 import { platformFetch, MASTRA_PLATFORM_API_URL, authHeaders, throwApiError, MASTRA_STUDIO_URL, createApiClient, extractApiErrorDetail } from './chunk-L2SGSIJI.js';
@@ -757,6 +757,14 @@ var buildProject = async (args) => {
 var origin3 = process.env.MASTRA_ANALYTICS_ORIGIN;
 var createProject = async (projectNameArg, args) => {
   const projectName = projectNameArg || args.projectName;
+  if (args.observability !== void 0) {
+    analytics.trackEvent("cli_observability_selected", {
+      command: "create",
+      enabled: args.observability,
+      answer: args.observability ? "yes" : "no",
+      selection_method: "cli_args"
+    });
+  }
   await analytics.trackCommandExecution({
     command: "create",
     args: { ...args, projectName },
@@ -799,6 +807,14 @@ var createProject = async (projectNameArg, args) => {
 // src/commands/actions/init-project.ts
 var origin4 = process.env.MASTRA_ANALYTICS_ORIGIN;
 var initProject = async (args) => {
+  if (args.observability !== void 0) {
+    analytics.trackEvent("cli_observability_selected", {
+      command: "init",
+      enabled: args.observability,
+      answer: args.observability ? "yes" : "no",
+      selection_method: "cli_args"
+    });
+  }
   await analytics.trackCommandExecution({
     command: "init",
     args: { ...args },
@@ -808,7 +824,13 @@ var initProject = async (args) => {
       const skipGitInit = await isGitInitialized({ cwd: process.cwd() });
       await checkAndInstallCoreDeps(Boolean(args?.example || args?.default), versionTag);
       if (!Object.keys(args).length) {
-        const result = await interactivePrompt({ skip: { gitInit: skipGitInit } });
+        const result = await interactivePrompt({
+          options: {
+            command: "init",
+            onObservabilitySelected: (event) => analytics.trackEvent("cli_observability_selected", event)
+          },
+          skip: { gitInit: skipGitInit }
+        });
         await init({
           ...result,
           llmApiKey: result?.llmApiKey,
@@ -1525,7 +1547,16 @@ async function resolveProject(token, orgId, projectConfig, flagProject, defaultN
   }
   if (flagProject) {
     const projects2 = await fetchProjects(token, orgId);
-    const match = projects2.find((proj) => proj.slug === flagProject || proj.id === flagProject);
+    const byId = projects2.find((proj) => proj.id === flagProject);
+    const bySlug = projects2.find((proj) => proj.slug === flagProject);
+    const byName = projects2.filter((proj) => proj.name === flagProject);
+    if (!byId && !bySlug && byName.length > 1) {
+      p5.cancel(
+        `Multiple projects are named "${flagProject}". Pass --project with the project id or slug to disambiguate.`
+      );
+      process.exit(1);
+    }
+    const match = byId ?? bySlug ?? (byName.length === 1 ? byName[0] : void 0);
     if (match) {
       return { existing: true, projectId: match.id, projectName: match.name, projectSlug: match.slug ?? match.name };
     }
@@ -5386,6 +5417,59 @@ var API_ROUTE_METADATA = {
       "paginationProperty": "pagination"
     }
   },
+  "GET /observability/traces/light": {
+    "method": "GET",
+    "path": "/observability/traces/light",
+    "pathParams": [],
+    "queryParams": [
+      "dateRange",
+      "direction",
+      "endedAt",
+      "entityId",
+      "entityName",
+      "entityType",
+      "entityVersionId",
+      "environment",
+      "experimentId",
+      "field",
+      "hasChildError",
+      "metadata",
+      "name",
+      "organizationId",
+      "page",
+      "parentEntityId",
+      "parentEntityName",
+      "parentEntityType",
+      "parentEntityVersionId",
+      "perPage",
+      "requestId",
+      "resourceId",
+      "rootEntityId",
+      "rootEntityName",
+      "rootEntityType",
+      "rootEntityVersionId",
+      "runId",
+      "scope",
+      "serviceName",
+      "sessionId",
+      "source",
+      "spanType",
+      "startedAt",
+      "status",
+      "tags",
+      "threadId",
+      "traceId",
+      "userId"
+    ],
+    "bodyParams": [],
+    "hasQuery": true,
+    "hasBody": false,
+    "responseShape": {
+      "kind": "object-property",
+      "listProperty": "spans",
+      "paginationProperty": "pagination"
+    }
+  },
   "GET /observability/branches": {
     "method": "GET",
     "path": "/observability/branches",
@@ -9353,7 +9437,15 @@ function registerApiCommand(program2) {
     ]
   });
   const trace = api.command("trace").description("Inspect observability traces");
-  addAction(trace, "list", "GET /observability/traces", { description: "List observability traces", list: true });
+  addAction(trace, "list", "GET /observability/traces/light", {
+    description: "List observability traces",
+    list: true,
+    verboseRouteKey: "GET /observability/traces",
+    examples: [
+      { description: "List lightweight traces", command: `mastra api trace list '{"page":0,"perPage":20}'` },
+      { description: "List full traces", command: `mastra api trace list '{"page":0,"perPage":20}' --verbose` }
+    ]
+  });
   addAction(trace, "get", "GET /observability/traces/:traceId/light", {
     description: "Get trace details",
     verboseRouteKey: "GET /observability/traces/:traceId",
@@ -9625,6 +9717,9 @@ function parseCommandName(name) {
 function isUnauthorizedError(error) {
   return error instanceof ApiCliError && error.code === "HTTP_ERROR" && error.details.status === 401;
 }
+function isNotFoundError(error) {
+  return error instanceof ApiCliError && error.code === "HTTP_ERROR" && (error.details.status === 404 || error.details.status === 405);
+}
 async function shutdownApiAnalytics(analytics2) {
   if (!analytics2) {
     return;
@@ -9658,14 +9753,33 @@ async function executeDescriptor(descriptor, positionalValues, inputText, option
       input: requestInput
     };
     let response;
+    let effectiveDescriptor = requestDescriptor;
     try {
       response = await requestApi(requestOptions);
     } catch (error) {
-      if (!target.fallbackHeaders || !isUnauthorizedError(error)) throw error;
-      response = await requestApi({ ...requestOptions, headers: target.fallbackHeaders });
+      if (target.fallbackHeaders && isUnauthorizedError(error)) {
+        response = await requestApi({ ...requestOptions, headers: target.fallbackHeaders });
+      } else if (!options.verbose && descriptor.verbose && isNotFoundError(error)) {
+        const verboseDescriptor = { ...descriptor, ...descriptor.verbose };
+        const verboseInput = parseInput(verboseDescriptor, inputText);
+        const verbosePathParams = resolvePathParams(verboseDescriptor, positionalValues, verboseInput);
+        const verboseRequestInput = stripPathParamsFromInput(verboseInput, verbosePathParams);
+        response = await requestApi({
+          ...requestOptions,
+          descriptor: verboseDescriptor,
+          pathParams: verbosePathParams,
+          input: verboseRequestInput
+        });
+        effectiveDescriptor = verboseDescriptor;
+      } else {
+        throw error;
+      }
     }
-    const normalized = normalizeData(requestDescriptor, normalizeResponse(response));
-    writeJson(normalizeSuccess(normalized, requestDescriptor.list, requestDescriptor.responseShape), options.pretty);
+    const normalized = normalizeData(effectiveDescriptor, normalizeResponse(response));
+    writeJson(
+      normalizeSuccess(normalized, effectiveDescriptor.list, effectiveDescriptor.responseShape),
+      options.pretty
+    );
   } catch (error) {
     const apiError = error instanceof ApiCliError ? error : toApiCliError(error);
     writeJson(errorEnvelope(apiError), options.pretty, process.stderr);
@@ -9956,11 +10070,31 @@ async function resolveProject2(token, orgId, projectConfig, flagProject, default
   }
   if (flagProject) {
     const projects = await fetchServerProjects(token, orgId);
-    const match = projects.find((proj) => proj.slug === flagProject || proj.id === flagProject);
+    const byId = projects.find((proj) => proj.id === flagProject);
+    const bySlug = projects.find((proj) => proj.slug === flagProject);
+    const byName = projects.filter((proj) => proj.name === flagProject);
+    if (!byId && !bySlug && byName.length > 1) {
+      p5.cancel(
+        `Multiple projects are named "${flagProject}". Pass --project with the project id or slug to disambiguate.`
+      );
+      process.exit(1);
+    }
+    const match = byId ?? bySlug ?? (byName.length === 1 ? byName[0] : void 0);
     if (match) {
       return { projectId: match.id, projectName: match.name, projectSlug: match.slug ?? match.name };
     }
-    return { projectId: flagProject, projectName: flagProject, projectSlug: flagProject };
+    if (!autoAccept) {
+      const confirmed = await p5.confirm({
+        message: `No project named "${flagProject}" found. Create it?`
+      });
+      if (p5.isCancel(confirmed) || !confirmed) {
+        p5.cancel("Deploy cancelled.");
+        process.exit(0);
+      }
+    }
+    const created = await createServerProject(token, orgId, flagProject);
+    p5.log.success(`Created project "${created.name}"`);
+    return { projectId: created.id, projectName: created.name, projectSlug: created.slug ?? created.name };
   }
   if (projectConfig?.projectId && projectConfig.organizationId === orgId) {
     return {
@@ -10940,7 +11074,7 @@ program.command("start").description("Start your built Mastra application").opti
   "Comma-separated list of custom arguments to pass to the Node.js process. IE: --require=newrelic"
 ).action(startProject);
 var studioCommand = program.command("studio").description("Manage Mastra Studio").option("-p, --port <port>", "Port to run the studio on (default: 3000)").option("-e, --env <env>", "Custom env file to include in the studio").option("-h, --server-host <serverHost>", "Host of the Mastra API server (default: localhost)").option("-s, --server-port <serverPort>", "Port of the Mastra API server (default: 4111)").option("-x, --server-protocol <serverProtocol>", "Protocol of the Mastra API server (default: http)").option("--server-api-prefix <serverApiPrefix>", "API route prefix of the Mastra server (default: /api)").option("--request-context-presets <file>", "Path to request context presets JSON file").action(startStudio);
-var deployCommand = studioCommand.command("deploy [dir]").description("Deploy studio").option("--org <id>", "Organization ID").option("--project <id>", "Project ID").option("-y, --yes", "Auto-accept defaults without confirmation").option("-c, --config <file>", "Project config file path (default: .mastra-project.json)").option("--env-file <file>", "Env file to deploy (for example: .env.production)").option("--skip-build", "Skip the build step and use existing .mastra/output").option("--skip-preflight", "Skip the pre-deploy build/env validation").option("--debug", "Enable debug logs", false).action(wrapAction(deployAction));
+var deployCommand = studioCommand.command("deploy [dir]").description("Deploy studio").option("--org <id>", "Organization ID").option("--project <id>", "Project ID, slug, or name (creates new project if not found)").option("-y, --yes", "Auto-accept defaults without confirmation").option("-c, --config <file>", "Project config file path (default: .mastra-project.json)").option("--env-file <file>", "Env file to deploy (for example: .env.production)").option("--skip-build", "Skip the build step and use existing .mastra/output").option("--skip-preflight", "Skip the pre-deploy build/env validation").option("--debug", "Enable debug logs", false).action(wrapAction(deployAction));
 deployCommand.command("list").description("List deployed studios").action(wrapAction(deploysAction));
 deployCommand.command("status <deploy-id>").description("Show deploy status").option("-w, --watch", "Watch for status changes").action(wrapAction(statusAction));
 deployCommand.command("logs <deploy-id>").description("Show deploy logs").option("-f, --follow", "Stream logs in real time").option("--tail <n>", "Number of recent log lines").action(wrapAction(logsAction));
@@ -10963,7 +11097,7 @@ var authTokens = authCommand.command("tokens").description("Manage API tokens").
 authTokens.command("create <name>").description("Create a new API token").action(wrapAction(createTokenAction));
 authTokens.command("revoke <token-id>").description("Revoke an API token").action(wrapAction(revokeTokenAction));
 var serverCommand = program.command("server").description("Manage Mastra Server deployments");
-var serverDeployCommand = serverCommand.command("deploy [dir]").description("Deploy to Mastra Server").option("--org <id>", "Organization ID").option("--project <id>", "Project ID").option("-y, --yes", "Auto-accept defaults without confirmation").option("-c, --config <file>", "Project config file path (default: .mastra-project.json)").option("--env-file <file>", "Env file to deploy (for example: .env.production)").option("--skip-build", "Skip the build step and deploy the existing .mastra/output directory").option("--skip-preflight", "Skip the pre-deploy build/env validation").option("--debug", "Enable debug logs", false).action(wrapAction(serverDeployAction));
+var serverDeployCommand = serverCommand.command("deploy [dir]").description("Deploy to Mastra Server").option("--org <id>", "Organization ID").option("--project <id>", "Project ID, slug, or name (creates new project if not found)").option("-y, --yes", "Auto-accept defaults without confirmation").option("-c, --config <file>", "Project config file path (default: .mastra-project.json)").option("--env-file <file>", "Env file to deploy (for example: .env.production)").option("--skip-build", "Skip the build step and deploy the existing .mastra/output directory").option("--skip-preflight", "Skip the pre-deploy build/env validation").option("--debug", "Enable debug logs", false).action(wrapAction(serverDeployAction));
 if (coreFeatures.has("deploy-diagnosis")) {
   serverDeployCommand.command("suggestions [deploy-id]").description("Show deploy suggestions for a failed deploy").option("--org <id>", "Organization ID").action(wrapAction(serverSuggestionsAction));
 }