@sentio/cli 3.4.2-rc.1 → 3.5.0-rc.2

package/lib/index.js

@@ -1220,7 +1220,7 @@ var require_command = __commonJS({
     var childProcess4 = __require("node:child_process");
     var path16 = __require("node:path");
     var fs20 = __require("node:fs");
-    var process24 = __require("node:process");
+    var process25 = __require("node:process");
     var { Argument: Argument7, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
     var { Help: Help2, stripColor } = require_help();
@@ -1267,13 +1267,13 @@ var require_command = __commonJS({
         this._showSuggestionAfterError = true;
         this._savedState = null;
         this._outputConfiguration = {
-          writeOut: (str) => process24.stdout.write(str),
-          writeErr: (str) => process24.stderr.write(str),
+          writeOut: (str) => process25.stdout.write(str),
+          writeErr: (str) => process25.stderr.write(str),
           outputError: (str, write) => write(str),
-          getOutHelpWidth: () => process24.stdout.isTTY ? process24.stdout.columns : void 0,
-          getErrHelpWidth: () => process24.stderr.isTTY ? process24.stderr.columns : void 0,
-          getOutHasColors: () => useColor() ?? (process24.stdout.isTTY && process24.stdout.hasColors?.()),
-          getErrHasColors: () => useColor() ?? (process24.stderr.isTTY && process24.stderr.hasColors?.()),
+          getOutHelpWidth: () => process25.stdout.isTTY ? process25.stdout.columns : void 0,
+          getErrHelpWidth: () => process25.stderr.isTTY ? process25.stderr.columns : void 0,
+          getOutHasColors: () => useColor() ?? (process25.stdout.isTTY && process25.stdout.hasColors?.()),
+          getErrHasColors: () => useColor() ?? (process25.stderr.isTTY && process25.stderr.hasColors?.()),
           stripColor: (str) => stripColor(str)
         };
         this._hidden = false;
@@ -1668,7 +1668,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._exitCallback) {
           this._exitCallback(new CommanderError2(exitCode, code, message));
         }
-        process24.exit(exitCode);
+        process25.exit(exitCode);
       }
       /**
        * Register callback `fn` for the command.
@@ -2068,16 +2068,16 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
         parseOptions = parseOptions || {};
         if (argv === void 0 && parseOptions.from === void 0) {
-          if (process24.versions?.electron) {
+          if (process25.versions?.electron) {
             parseOptions.from = "electron";
           }
-          const execArgv = process24.execArgv ?? [];
+          const execArgv = process25.execArgv ?? [];
           if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
             parseOptions.from = "eval";
           }
         }
         if (argv === void 0) {
-          argv = process24.argv;
+          argv = process25.argv;
         }
         this.rawArgs = argv.slice();
         let userArgs;
@@ -2088,7 +2088,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             userArgs = argv.slice(2);
             break;
           case "electron":
-            if (process24.defaultApp) {
+            if (process25.defaultApp) {
               this._scriptPath = argv[1];
               userArgs = argv.slice(2);
             } else {
@@ -2275,11 +2275,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
         launchWithNode = sourceExt.includes(path16.extname(executableFile));
         let proc;
-        if (process24.platform !== "win32") {
+        if (process25.platform !== "win32") {
           if (launchWithNode) {
             args.unshift(executableFile);
-            args = incrementNodeInspectorPort(process24.execArgv).concat(args);
-            proc = childProcess4.spawn(process24.argv[0], args, { stdio: "inherit" });
+            args = incrementNodeInspectorPort(process25.execArgv).concat(args);
+            proc = childProcess4.spawn(process25.argv[0], args, { stdio: "inherit" });
           } else {
             proc = childProcess4.spawn(executableFile, args, { stdio: "inherit" });
           }
@@ -2290,13 +2290,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
             subcommand._name
           );
           args.unshift(executableFile);
-          args = incrementNodeInspectorPort(process24.execArgv).concat(args);
-          proc = childProcess4.spawn(process24.execPath, args, { stdio: "inherit" });
+          args = incrementNodeInspectorPort(process25.execArgv).concat(args);
+          proc = childProcess4.spawn(process25.execPath, args, { stdio: "inherit" });
         }
         if (!proc.killed) {
           const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
           signals.forEach((signal) => {
-            process24.on(signal, () => {
+            process25.on(signal, () => {
               if (proc.killed === false && proc.exitCode === null) {
                 proc.kill(signal);
               }
@@ -2307,7 +2307,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         proc.on("close", (code) => {
           code = code ?? 1;
           if (!exitCallback) {
-            process24.exit(code);
+            process25.exit(code);
           } else {
             exitCallback(
               new CommanderError2(
@@ -2329,7 +2329,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             throw new Error(`'${executableFile}' not executable`);
           }
           if (!exitCallback) {
-            process24.exit(1);
+            process25.exit(1);
           } else {
             const wrappedError = new CommanderError2(
               1,
@@ -2830,13 +2830,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       _parseOptionsEnv() {
         this.options.forEach((option2) => {
-          if (option2.envVar && option2.envVar in process24.env) {
+          if (option2.envVar && option2.envVar in process25.env) {
             const optionKey = option2.attributeName();
             if (this.getOptionValue(optionKey) === void 0 || ["default", "config", "env"].includes(
               this.getOptionValueSource(optionKey)
             )) {
               if (option2.required || option2.optional) {
-                this.emit(`optionEnv:${option2.name()}`, process24.env[option2.envVar]);
+                this.emit(`optionEnv:${option2.name()}`, process25.env[option2.envVar]);
               } else {
                 this.emit(`optionEnv:${option2.name()}`);
               }
@@ -3360,7 +3360,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       help(contextOptions) {
         this.outputHelp(contextOptions);
-        let exitCode = Number(process24.exitCode ?? 0);
+        let exitCode = Number(process25.exitCode ?? 0);
         if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
           exitCode = 1;
         }
@@ -3450,9 +3450,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
       });
     }
     function useColor() {
-      if (process24.env.NO_COLOR || process24.env.FORCE_COLOR === "0" || process24.env.FORCE_COLOR === "false")
+      if (process25.env.NO_COLOR || process25.env.FORCE_COLOR === "0" || process25.env.FORCE_COLOR === "false")
         return false;
-      if (process24.env.FORCE_COLOR || process24.env.CLICOLOR_FORCE !== void 0)
+      if (process25.env.FORCE_COLOR || process25.env.CLICOLOR_FORCE !== void 0)
         return true;
       return void 0;
     }
@@ -5903,10 +5903,10 @@ var require_directives = __commonJS({
     };
     var escapeTagName = (tn2) => tn2.replace(/[!,[\]{}]/g, (ch) => escapeChars[ch]);
     var Directives = class _Directives {
-      constructor(yaml12, tags) {
+      constructor(yaml13, tags) {
         this.docStart = null;
         this.docEnd = false;
-        this.yaml = Object.assign({}, _Directives.defaultYaml, yaml12);
+        this.yaml = Object.assign({}, _Directives.defaultYaml, yaml13);
         this.tags = Object.assign({}, _Directives.defaultTags, tags);
       }
       clone() {
@@ -41614,15 +41614,15 @@ var require_streams2 = __commonJS({
     var POOL_SIZE2 = 65536;
     if (!globalThis.ReadableStream) {
       try {
-        const process24 = __require("node:process");
-        const { emitWarning } = process24;
+        const process25 = __require("node:process");
+        const { emitWarning } = process25;
         try {
-          process24.emitWarning = () => {
+          process25.emitWarning = () => {
           };
           Object.assign(globalThis, __require("node:stream/web"));
-          process24.emitWarning = emitWarning;
+          process25.emitWarning = emitWarning;
         } catch (error) {
-          process24.emitWarning = emitWarning;
+          process25.emitWarning = emitWarning;
           throw error;
         }
       } catch (error) {
@@ -141911,7 +141911,7 @@ var require_sdk_gen = __commonJS({
       }
     };
     exports.DataService = DataService2;
-    var WebService = class {
+    var WebService2 = class {
       /**
        * List all dashboards in a project
        */
@@ -142094,7 +142094,7 @@ var require_sdk_gen = __commonJS({
         });
       }
     };
-    exports.WebService = WebService;
+    exports.WebService = WebService2;
     var MoveService = class {
       /**
        * Get Aptos transaction call trace
@@ -151941,6 +151941,7 @@ function createProcessorCommand() {
   processorCommand.addCommand(createProcessorPauseCommand());
   processorCommand.addCommand(createProcessorResumeCommand());
   processorCommand.addCommand(createProcessorStopCommand());
+  processorCommand.addCommand(createProcessorLogsCommand());
   return processorCommand;
 }
 function createProcessorStatusCommand() {
@@ -152011,6 +152012,17 @@ function createProcessorStopCommand() {
     }
   });
 }
+function createProcessorLogsCommand() {
+  return withOutputOptions3(
+    withSharedProjectOptions3(withAuthOptions3(new Command("logs").description("View processor logs")))
+  ).showHelpAfterError().argument("[processorId]", "ID of the processor (defaults to active processor)").option("--limit <count>", "Maximum number of log entries to fetch", parseInteger2, 100).option("-f, --follow", "Poll for new log entries continuously").option("--log-type <type>", "Filter by log type (e.g. execution, system)").option("--level <level>", "Filter by log level: DEBUG, INFO, WARNING, ERROR").option("--query <query>", "Free-text filter query").action(async (processorId, options, command) => {
+    try {
+      await runProcessorLogs(processorId, options);
+    } catch (error) {
+      handleProcessorCommandError(error, command);
+    }
+  });
+}
 async function runProcessorStatus(options) {
   const context = createApiContext(options);
   const project = await resolveProjectRef(options, context, { ownerSlug: true });
@@ -152164,6 +152176,101 @@ async function runProcessorStop(processorId, options) {
     ...response
   });
 }
+async function resolveProcessorId(processorId, options) {
+  if (processorId) return processorId;
+  const context = createApiContext(options);
+  const project = await resolveProjectRef(options, context, { ownerSlug: true });
+  const statusResponse = await import_api5.ProcessorService.getProcessorStatusV2({
+    path: { owner: project.owner, slug: project.slug },
+    query: { version: "ACTIVE" },
+    headers: context.headers
+  });
+  const data = unwrapApiResult(statusResponse);
+  const processors = Array.isArray(data.processors) ? data.processors : [];
+  const activeProcessor = processors.find((p7) => asString3(p7.versionState) === "ACTIVE");
+  if (!activeProcessor || !activeProcessor.processorId) {
+    throw new CliError(
+      `No active processor found for project ${project.owner}/${project.slug}. Please specify a processorId.`
+    );
+  }
+  return asString3(activeProcessor.processorId);
+}
+async function runProcessorLogs(processorId, options) {
+  const resolvedProcessorId = await resolveProcessorId(processorId, options);
+  const context = createApiContext(options);
+  if (options.follow && !options.json && !options.yaml) {
+    await followProcessorLogs(resolvedProcessorId, context, options);
+    return;
+  }
+  const response = await postApiJson(
+    `/api/v1/processors/${resolvedProcessorId}/logs`,
+    context,
+    buildLogsRequestBody(resolvedProcessorId, options)
+  );
+  printOutput3(options, response);
+}
+async function followProcessorLogs(processorId, context, options) {
+  let until;
+  let running = true;
+  const seenIds = /* @__PURE__ */ new Set();
+  process19.on("SIGINT", () => {
+    running = false;
+  });
+  while (running) {
+    try {
+      const body = { ...buildLogsRequestBody(processorId, options), until };
+      const response = await postApiJson(`/api/v1/processors/${processorId}/logs`, context, body);
+      const entries2 = Array.isArray(response.logs) ? response.logs : [];
+      for (const entry of entries2) {
+        const e10 = entry;
+        const id = e10.id ?? "";
+        if (id && seenIds.has(id)) continue;
+        if (id) seenIds.add(id);
+        process19.stdout.write(formatLogEntry(e10) + "\n");
+      }
+      if (response.until) {
+        until = response.until;
+      }
+    } catch {
+    }
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+  }
+}
+function buildLogsRequestBody(processorId, options) {
+  const body = { processorId, limit: options.limit };
+  if (options.logType) {
+    body.logTypeFilters = [options.logType];
+  }
+  if (options.level || options.query) {
+    const parts = [];
+    if (options.level) parts.push(options.level.toUpperCase());
+    if (options.query) parts.push(options.query);
+    body.query = parts.join(" ");
+  }
+  return body;
+}
+function formatLogEntry(entry) {
+  const formattedTime = entry.timestamp ? source_default.gray(entry.timestamp.replace("T", " ").replace("Z", "")) : "";
+  const level = (entry.level ?? "INFO").toUpperCase();
+  const logType = entry.logType ? source_default.gray(`[${entry.logType}]`) : "";
+  const coloredLevel = colorSeverity(level);
+  const message = entry.message ?? "";
+  const chain4 = entry.chainId ? source_default.gray(`(chain=${entry.chainId})`) : "";
+  return [formattedTime, coloredLevel, logType, message, chain4].filter(Boolean).join(" ");
+}
+function colorSeverity(severity) {
+  switch (severity) {
+    case "ERROR":
+      return source_default.red(`[${severity}]`);
+    case "WARNING":
+    case "WARN":
+      return source_default.yellow(`[${severity}]`);
+    case "DEBUG":
+      return source_default.gray(`[${severity}]`);
+    default:
+      return source_default.cyan(`[${severity}]`);
+  }
+}
 function withAuthOptions3(command) {
   return command.option("--host <host>", "Override Sentio host").option("--api-key <key>", "Use an explicit API key instead of saved credentials").option("--token <token>", "Use an explicit bearer token instead of saved credentials");
 }
@@ -152207,7 +152314,8 @@ function formatOutput2(data) {
       lines.push(`${group.versionState} (${group.processors.length})`);
       for (const processor of group.processors) {
         const version2 = asNumber(processor.version);
-        const statusState = asString3(processor.processorStatus?.state) ?? "UNKNOWN";
+        const processorStatus = processor.processorStatus;
+        const statusState = asString3(processorStatus?.state) ?? "UNKNOWN";
         const uploadedAt = asString3(processor.uploadedAt);
         lines.push(`- v${version2 ?? "?"} status=${statusState}${uploadedAt ? ` uploaded=${uploadedAt}` : ""}`);
         if (asString3(processor.processorId)) {
@@ -152217,9 +152325,17 @@ function formatOutput2(data) {
         for (const stateEntry of states.slice(0, 5)) {
           const state = stateEntry;
           const chainId = asString3(state.chainId) ?? "?";
-          const chainState = asString3(state.status?.state) ?? "UNKNOWN";
+          const stateStatus = state.status;
+          const chainState = asString3(stateStatus?.state) ?? "UNKNOWN";
           const block = asString3(state.processedBlockNumber) ?? "?";
           lines.push(`  chain ${chainId}: ${chainState} block=${block}`);
+          const errorRecord = stateStatus?.errorRecord;
+          const chainError = asString3(errorRecord?.message);
+          if (chainError) {
+            const createdAt = asString3(errorRecord?.createdAt);
+            const prefix = createdAt ? `[${createdAt}] ` : "";
+            lines.push(`  error: ${prefix}${chainError}`);
+          }
         }
         if (states.length > 5) {
           lines.push(`  ... ${states.length - 5} more chains`);
@@ -152248,6 +152364,14 @@ function formatOutput2(data) {
     const objectData = data;
     return `Processor ${asString3(objectData.processorId)} successfully ${asString3(objectData.action)}.`;
   }
+  if (data && typeof data === "object" && "logs" in data) {
+    const logsData = data;
+    const entries2 = Array.isArray(logsData.logs) ? logsData.logs : [];
+    if (entries2.length === 0) {
+      return "No logs found.";
+    }
+    return entries2.map((entry) => formatLogEntry(entry)).join("\n");
+  }
   return JSON.stringify(data, null, 2);
 }
 function normalizeVersionSelector(value) {
@@ -154143,6 +154267,347 @@ function parseInteger6(value) {
   return parsedValue;
 }
 
+// src/commands/dashboard.ts
+init_cjs_shim();
+var import_api14 = __toESM(require_src5(), 1);
+var import_yaml12 = __toESM(require_dist(), 1);
+import process24 from "process";
+function createDashboardCommand() {
+  const dashboardCommand = new Command("dashboard").description("Manage Sentio dashboards");
+  dashboardCommand.addCommand(createDashboardListCommand());
+  dashboardCommand.addCommand(createDashboardExportCommand());
+  dashboardCommand.addCommand(createDashboardImportCommand());
+  dashboardCommand.addCommand(createDashboardAddPanelCommand());
+  return dashboardCommand;
+}
+function createDashboardListCommand() {
+  return withOutputOptions8(
+    withSharedProjectOptions7(withAuthOptions8(new Command("list").description("List dashboards for a project")))
+  ).showHelpAfterError().action(async (options, command) => {
+    try {
+      await runDashboardList(options);
+    } catch (error) {
+      handleDashboardCommandError(error, command);
+    }
+  });
+}
+function createDashboardExportCommand() {
+  return withOutputOptions8(
+    withSharedProjectOptions7(
+      withAuthOptions8(
+        new Command("export").description("Export a dashboard as JSON").argument("<dashboardId>", "Dashboard ID")
+      )
+    )
+  ).showHelpAfterError().action(async (dashboardId, options, command) => {
+    try {
+      await runDashboardExport(dashboardId, options);
+    } catch (error) {
+      handleDashboardCommandError(error, command);
+    }
+  });
+}
+function createDashboardImportCommand() {
+  return withOutputOptions8(
+    withSharedProjectOptions7(
+      withAuthOptions8(
+        new Command("import").description("Import dashboard data from a JSON file into an existing dashboard").argument("<dashboardId>", "Target dashboard ID to import into")
+      )
+    )
+  ).showHelpAfterError().option("--file <path>", "Read dashboard JSON from file").option("--stdin", "Read dashboard JSON from stdin").option("--override-layouts", "Override the layout of the target dashboard").action(async (dashboardId, options, command) => {
+    try {
+      await runDashboardImport(dashboardId, options);
+    } catch (error) {
+      handleDashboardCommandError(error, command);
+    }
+  });
+}
+function createDashboardAddPanelCommand() {
+  return withOutputOptions8(
+    withSharedProjectOptions7(
+      withAuthOptions8(
+        new Command("add-panel").description("Add a panel to a dashboard (SQL or insights query)").argument("<dashboardId>", "Dashboard ID")
+      )
+    )
+  ).showHelpAfterError().requiredOption("--panel-name <name>", "Panel name").requiredOption("--type <type>", "Chart type: TABLE, LINE, BAR, PIE, QUERY_VALUE, AREA, BAR_GAUGE, SCATTER").option("--sql <query>", "SQL query (plain SQL \u2014 automatically wrapped into the required format)").option("--size <count>", "SQL query result size limit (default: 100)").option("--event <name>", "Event name for an insights panel (mutually exclusive with --sql and --metric)").option("--metric <name>", "Metric name for an insights panel (mutually exclusive with --sql and --event)").option("--alias <alias>", "Alias for the insights query").option("--source-name <name>", "Source name for the insights query").option(
+    "--filter <selector>",
+    "Event filter or metric label selector like field:value or amount>0",
+    collectOption3,
+    []
+  ).option("--group-by <field>", "Group by event property or metric label", collectOption3, []).option("--aggr <aggregation>", "Event: total|unique|AAU|DAU|WAU|MAU. Metric: avg|sum|min|max|count").option("--func <function>", "Function like topk(1), bottomk(1)", collectOption3, []).addHelpText(
+    "after",
+    `
+
+Data source: use exactly one of --sql, --event, or --metric.
+
+SQL panel examples:
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Top Holders" --type TABLE \\
+      --sql "SELECT * FROM CoinBalance ORDER BY balance DESC LIMIT 50"
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Daily Volume" --type LINE \\
+      --sql "SELECT toStartOfDay(timestamp) as date, sum(amount) as volume FROM Transfer GROUP BY date ORDER BY date"
+
+Event insights panel examples:
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Transfer Count" --type LINE \\
+      --event Transfer --aggr total
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Large Transfers" --type TABLE \\
+      --event Transfer --filter amount>1000 --aggr total --group-by meta.address
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Top 5 Senders" --type BAR \\
+      --event Transfer --aggr unique --group-by from --func 'topk(5)'
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "DAU" --type LINE \\
+      --event Transfer --aggr DAU
+
+Metric insights panel examples:
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "ETH Price" --type LINE \\
+      --metric cbETH_price
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Avg Burn by Chain" --type BAR \\
+      --metric burn --filter meta.chain=1 --aggr avg --group-by meta.address
+  $ sentio dashboard add-panel abc123 --project owner/slug \\
+      --panel-name "Burn Rate Delta" --type LINE \\
+      --metric burn --aggr sum 
+`
+  ).action(async (dashboardId, options, command) => {
+    try {
+      await runDashboardAddPanel(dashboardId, options);
+    } catch (error) {
+      handleDashboardCommandError(error, command);
+    }
+  });
+}
+async function runDashboardList(options) {
+  const context = createApiContext(options);
+  const project = await resolveProjectRef(options, context, { ownerSlug: true });
+  const response = await import_api14.WebService.listDashboards2({
+    path: { owner: project.owner, slug: project.slug },
+    headers: context.headers
+  });
+  const data = unwrapApiResult(response);
+  printOutput8(options, data);
+}
+async function runDashboardExport(dashboardId, options) {
+  const context = createApiContext(options);
+  const response = await import_api14.WebService.exportDashboard({
+    path: { dashboardId },
+    headers: context.headers
+  });
+  const data = unwrapApiResult(response);
+  console.log(JSON.stringify(data.dashboardJson ?? data, null, 2));
+}
+async function runDashboardImport(dashboardId, options) {
+  const context = createApiContext(options);
+  const input = loadJsonInput(options);
+  if (!input) {
+    throw new CliError("Provide --file or --stdin with the dashboard JSON to import.");
+  }
+  const dashboardJson = typeof input === "object" ? input : {};
+  const response = await import_api14.WebService.importDashboard({
+    body: {
+      dashboardId,
+      dashboardJson,
+      overrideLayouts: options.overrideLayouts
+    },
+    headers: context.headers
+  });
+  const data = unwrapApiResult(response);
+  printOutput8(options, { message: `Dashboard imported into ${dashboardId}`, dashboard: data.dashboard });
+}
+async function runDashboardAddPanel(dashboardId, options) {
+  const context = createApiContext(options);
+  const selectedSources = [Boolean(options.sql), Boolean(options.event), Boolean(options.metric)].filter(Boolean).length;
+  if (selectedSources === 0) {
+    throw new CliError("Provide exactly one data source: --sql, --event, or --metric.");
+  }
+  if (selectedSources > 1) {
+    throw new CliError("Use exactly one of --sql, --event, or --metric.");
+  }
+  const getResponse = await import_api14.WebService.getDashboard({
+    path: { dashboardId },
+    headers: context.headers
+  });
+  const dashboardData = unwrapApiResult(getResponse);
+  const dashboard = dashboardData.dashboards?.[0];
+  if (!dashboard) {
+    throw new CliError(`Dashboard ${dashboardId} not found.`);
+  }
+  const chartType = normalizeChartType(options.type);
+  const panelId = generatePanelId();
+  const chart = buildPanelChart(chartType, options);
+  const newPanel = {
+    id: panelId,
+    name: options.panelName,
+    dashboardId,
+    chart
+  };
+  const existingLayouts = dashboard.layouts?.responsiveLayouts?.lg?.layouts ?? [];
+  let maxBottom = 0;
+  for (const layout of existingLayouts) {
+    const bottom = (layout.y ?? 0) + (layout.h ?? 0);
+    if (bottom > maxBottom) {
+      maxBottom = bottom;
+    }
+  }
+  const newLayout = {
+    i: panelId,
+    x: 0,
+    y: maxBottom,
+    w: 12,
+    h: 6
+  };
+  const panels = { ...dashboard.panels ?? {} };
+  panels[panelId] = newPanel;
+  const updatedLayouts = [...existingLayouts, newLayout];
+  const dashboardJson = {
+    ...dashboard,
+    panels,
+    layouts: {
+      responsiveLayouts: {
+        ...dashboard.layouts?.responsiveLayouts ?? {},
+        lg: { layouts: updatedLayouts }
+      }
+    }
+  };
+  const importResponse = await import_api14.WebService.importDashboard({
+    body: {
+      dashboardId,
+      dashboardJson,
+      overrideLayouts: true
+    },
+    headers: context.headers
+  });
+  const importData = unwrapApiResult(importResponse);
+  printOutput8(options, {
+    message: `Panel "${options.panelName}" added to dashboard ${dashboardId}`,
+    panelId,
+    dashboard: importData.dashboard
+  });
+}
+function buildPanelChart(chartType, options) {
+  if (options.sql) {
+    const sqlSize = Number.parseInt(String(options.size ?? "100"), 10) || 100;
+    return {
+      type: chartType,
+      datasourceType: "SQL",
+      sqlQuery: JSON.stringify({ sql: options.sql, size: sqlSize })
+    };
+  }
+  if (options.event) {
+    const queryBody = buildEventsInsightQueryBody(options.event, {
+      alias: options.alias,
+      sourceName: options.sourceName,
+      filter: options.filter,
+      groupBy: options.groupBy,
+      aggr: options.aggr,
+      func: options.func
+    });
+    return {
+      type: chartType,
+      datasourceType: "INSIGHTS",
+      insightsQueries: queryBody.queries
+    };
+  }
+  if (options.metric) {
+    const queryBody = buildMetricsInsightQueryBody(options.metric, {
+      alias: options.alias,
+      sourceName: options.sourceName,
+      filter: options.filter,
+      groupBy: options.groupBy,
+      aggr: options.aggr,
+      func: options.func
+    });
+    return {
+      type: chartType,
+      datasourceType: "INSIGHTS",
+      insightsQueries: queryBody.queries
+    };
+  }
+  throw new CliError("Provide exactly one data source: --sql, --event, or --metric.");
+}
+function normalizeChartType(value) {
+  const normalized = value.toUpperCase();
+  const valid = ["LINE", "AREA", "BAR", "BAR_GAUGE", "TABLE", "QUERY_VALUE", "PIE", "NOTE", "SCATTER"];
+  if (valid.includes(normalized)) {
+    return normalized;
+  }
+  throw new CliError(`Invalid chart type "${value}". Use one of: ${valid.join(", ")}`);
+}
+function generatePanelId() {
+  return `panel_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function collectOption3(value, previous = []) {
+  previous.push(value);
+  return previous;
+}
+function withAuthOptions8(command) {
+  return command.option("--host <host>", "Override Sentio host").option("--api-key <key>", "Use an explicit API key instead of saved credentials").option("--token <token>", "Use an explicit bearer token instead of saved credentials");
+}
+function withSharedProjectOptions7(command) {
+  return command.option("--project <project>", "Sentio project as <owner>/<slug> or <slug>").option("--owner <owner>", "Sentio project owner").option("--name <name>", "Sentio project name").option("--project-id <id>", "Sentio project id");
+}
+function withOutputOptions8(command) {
+  return command.option("--json", "Print raw JSON response").option("--yaml", "Print raw YAML response");
+}
+function handleDashboardCommandError(error, command) {
+  if (error instanceof CliError && (error.message.startsWith("Project is required.") || error.message.startsWith("Invalid project ") || error.message.startsWith("Dashboard ") || error.message.startsWith("Provide --file or --stdin") || error.message.startsWith("Provide exactly one data source") || error.message.startsWith("Use exactly one of --sql") || error.message.startsWith("Invalid chart type") || error.message.startsWith("Invalid aggregation") || error.message.startsWith("Invalid metric aggregation") || error.message.startsWith("Invalid filter") || error.message.startsWith("Invalid metric selector"))) {
+    console.error(error.message);
+    if (command) {
+      console.error();
+      command.outputHelp();
+    }
+    process24.exit(1);
+  }
+  handleCommandError(error);
+}
+function printOutput8(options, data) {
+  if (options.json && options.yaml) {
+    throw new CliError("Choose only one structured output format: --json or --yaml.");
+  }
+  if (options.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (options.yaml) {
+    console.log(import_yaml12.default.stringify(data).trimEnd());
+    return;
+  }
+  console.log(formatOutput7(data));
+}
+function formatOutput7(data) {
+  if (data && typeof data === "object" && "message" in data) {
+    return String(data.message ?? "");
+  }
+  if (data && typeof data === "object" && "dashboards" in data) {
+    const dashboards = data.dashboards ?? [];
+    const lines = [`Dashboards (${dashboards.length})`];
+    for (const db of dashboards) {
+      const id = db.id ?? "<id>";
+      const name = db.name ?? "<unnamed>";
+      const panelCount = db.panels ? Object.keys(db.panels).length : 0;
+      const visibility = db.visibility ?? "";
+      const updated = formatTimestamp3(db.updatedAt);
+      lines.push(
+        `- ${id} "${name}" [${panelCount} panels]${visibility ? ` ${visibility}` : ""}${updated ? ` updated ${updated}` : ""}`
+      );
+    }
+    return lines.join("\n");
+  }
+  return JSON.stringify(data, null, 2);
+}
+function formatTimestamp3(value) {
+  if (!value) {
+    return "";
+  }
+  if (/^\d{13}$/.test(value)) {
+    return new Date(Number.parseInt(value, 10)).toISOString();
+  }
+  return value;
+}
+
 // src/index.ts
 var program2 = new Command();
 program2.name("sentio").description("Login & Manage your project files to Sentio.");
@@ -154169,6 +154634,7 @@ program2.addCommand(createAlertCommand());
 program2.addCommand(createPriceCommand());
 program2.addCommand(createSimulationCommand());
 program2.addCommand(createEndpointCommand());
+program2.addCommand(createDashboardCommand());
 program2.parse();
 /*! Bundled license information: