agent-inspect 5.3.0 → 6.0.0

package/packages/cli/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, enrichSessionRunRecord, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, extractMetadata, filterTraces, truncateName, getTraceFilePath, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, openTrace, TraceReadError, filterMetasBySessionScope, runTraceChecks, aggregateSessionCheckResults, createBaselineRegressionRule, resolveBundleRunIds, aggregateBundleSafeStatus, bundleFailsOnSafety, buildPlaceholderArtifact, buildBundleMetadata, buildBundleSummaryMarkdown, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, Redactor, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, normalizeBundleOutputPath, defaultBundleOutputPath, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, escapeMarkdown, escapeHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, resolveRedactionProfile, applyProfileMetadataCaps, flattenTree, safeString, compactAttributes, stableJson, truncateStringForProfile } from './chunk-4LKKB4Z5.mjs';
+import { createSafetyRawContentRule, createSafetyRedactionRule, createSafetySecretPatternRule, createSafetyOversizedAttributeRule, resolveTraceDir, parseDuration, buildSessionIndex, enrichSessionRunRecord, TraceDirectory, loadTraceMetadataList, loadSessionRunRecords, extractMetadata, filterTraces, truncateName, getTraceFilePath, buildRunSummary, formatDuration, formatTimestamp, isAgentInspectTrace, openTrace, TraceReadError, filterMetasBySessionScope, runTraceChecks, aggregateSessionCheckResults, createBaselineRegressionRule, resolveBundleRunIds, aggregateBundleSafeStatus, bundleFailsOnSafety, buildPlaceholderArtifact, buildBundleMetadata, buildBundleSummaryMarkdown, buildRunTimeline, renderTimeline, buildTraceStats, renderTraceStats, parseDurationFilter, searchTraces, buildActivitySummary, renderActivitySummaryHuman, buildRunWhatSummary, renderRunWhat, buildLocalExplanation, resolveSuiteTemplate, defaultSuiteConfigTemplate, loadSuiteConfig, validateSuiteConfig, runSuite, renderSuiteReport, analyzeCohort, renderCohortReport, gateHasThresholds, runGate, renderGateReport, persistedInspectEventsToTraceEvents, renderStepLine, renderErrorLine, getIndent, Redactor, TreeBuilder, zeroKinds, validateEvent, traceEventToPersistedInspectEvent, isPersistedInspectEvent, createRunStatusRule, createStructureOrphanRule, createStructureCycleRule, createRunDurationRule, createMaxStepDurationRule, createRequireCompletedRule, createStallDetectionRule, createObservedOutcomeRule, createRunDepthRule, createToolUsageRule, createLlmUsageRule, createStructureRelationshipRule, createStructureParallelWidthRule, normalizeBundleOutputPath, defaultBundleOutputPath, summarizeObservedOutcomes, extractOutcomesFromTraceEvents, renderObservedOutcomesMarkdown, renderObservedOutcomesHtml, escapeMarkdown, escapeHtml, DEFAULT_SUITE_ARTIFACTS_DIR, parseCohortMetricList, COHORT_METRIC_IDS, parseGateList, nanoid, resolveRedactionProfile, applyProfileMetadataCaps, flattenTree, safeString, compactAttributes, stableJson, truncateStringForProfile } from './chunk-YS2I722C.mjs';
 import { realpathSync, constants as constants$1 } from 'fs';
 import path14 from 'path';
 import { fileURLToPath, pathToFileURL } from 'url';
@@ -11,7 +11,7 @@ import { createServer } from 'http';
 import { createRequire } from 'module';
 
 // package.json
-var version = "5.3.0";
+var version = "6.0.0";
 
 // packages/cli/src/trace-dir-scale.ts
 var TRACE_COUNT_WARN = 1e3;
@@ -3782,7 +3782,7 @@ async function newestTraceMtimeMs(traceDir) {
 }
 async function loadSessionRuns(traceDir) {
   try {
-    const mod = await import('./src-4SGS3Q2D.mjs');
+    const mod = await import('./src-FVNE44UA.mjs');
     const dbPath = mod.resolveIndexDbPath(traceDir);
     const status = mod.indexStatus(dbPath);
     if (!status.healthy) {
@@ -7075,6 +7075,63 @@ async function serveCommand(options = {}) {
   });
 }
 
+// packages/cli/src/studio-cmd.ts
+var PACKAGE = "@agent-inspect/studio";
+function isModuleNotFound3(e) {
+  return e !== null && typeof e === "object" && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "MODULE_NOT_FOUND");
+}
+async function loadStudio() {
+  try {
+    return await import('@agent-inspect/studio');
+  } catch (e) {
+    if (isModuleNotFound3(e)) {
+      console.error(
+        `The optional Studio analyzer is not installed. Run: npm install ${PACKAGE}`
+      );
+      process.exitCode = 1;
+      return null;
+    }
+    const msg = e instanceof Error ? e.message : String(e);
+    console.error(`[AgentInspect] failed to load ${PACKAGE}: ${msg}`);
+    process.exitCode = 1;
+    return null;
+  }
+}
+function parsePort2(value) {
+  if (value === void 0) return void 0;
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed <= 0 || parsed > 65535) {
+    throw new Error("--port must be an integer between 1 and 65535.");
+  }
+  return parsed;
+}
+async function studioCommand(options = {}) {
+  const mod = await loadStudio();
+  if (!mod) return;
+  const port = parsePort2(options.port);
+  const host = options.host?.trim();
+  const info = await mod.startStudioServer({
+    ...host !== void 0 && host.length > 0 ? { host } : {},
+    ...port !== void 0 ? { port } : {},
+    ...options.workspace !== void 0 ? { workspacePath: options.workspace } : {},
+    ...options.db !== void 0 ? { dbPath: options.db } : {},
+    ...options.server === true ? { server: true } : {},
+    ...options.cwd !== void 0 ? { cwd: options.cwd } : {},
+    ...options.auth === "basic" ? { auth: "basic" } : {},
+    ...options.passwordEnv !== void 0 ? { passwordEnv: options.passwordEnv } : {}
+  });
+  console.log(`AgentInspect studio (read-only): ${info.url}`);
+  if (options.open === true && info.host !== "127.0.0.1" && info.host !== "localhost") {
+    console.warn("Skipping browser open for non-local host binding.");
+  } else if (options.open === true) {
+    const openMod = await import('child_process');
+    openMod.exec(`open ${info.url}`, () => {
+    });
+  }
+  await new Promise(() => {
+  });
+}
+
 // packages/eval/src/index.ts
 function isTraceReadResult(value) {
   return value !== null && typeof value === "object" && "runs" in value && "events" in value && "format" in value;
@@ -9869,23 +9926,23 @@ async function indexCleanCommand(options = {}) {
     process.exitCode = 1;
   }
 }
-var PACKAGE = "@agent-inspect/index-sqlite";
-function isModuleNotFound3(e) {
+var PACKAGE2 = "@agent-inspect/index-sqlite";
+function isModuleNotFound4(e) {
   return e !== null && typeof e === "object" && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "MODULE_NOT_FOUND");
 }
 async function loadIndexSqlite() {
   try {
-    return await import('./src-4SGS3Q2D.mjs');
+    return await import('./src-FVNE44UA.mjs');
   } catch (e) {
-    if (isModuleNotFound3(e)) {
+    if (isModuleNotFound4(e)) {
       console.error(
-        `The optional SQLite index is not installed. Run: npm install ${PACKAGE}`
+        `The optional SQLite index is not installed. Run: npm install ${PACKAGE2}`
       );
       process.exitCode = 1;
       return null;
     }
     const msg = e instanceof Error ? e.message : String(e);
-    console.error(`[AgentInspect] failed to load ${PACKAGE}: ${msg}`);
+    console.error(`[AgentInspect] failed to load ${PACKAGE2}: ${msg}`);
     process.exitCode = 1;
     return null;
   }
@@ -10162,30 +10219,39 @@ function resolveCwd(options) {
 async function suiteInitCommand(options = {}) {
   const cwd = resolveCwd(options);
   const configPath = path14.join(cwd, DEFAULT_CONFIG_FILENAME);
-  const template = defaultSuiteConfigTemplate();
+  const template = options.template?.trim();
+  const suiteConfig = template !== void 0 && template !== "" ? resolveSuiteTemplate(template) : defaultSuiteConfigTemplate();
   if (options.dryRun) {
     if (options.json) {
       printJson5({
         ok: true,
         dryRun: true,
         wouldWrite: [DEFAULT_CONFIG_FILENAME],
-        config: template
+        config: suiteConfig,
+        ...template ? { template } : {}
       });
       return;
     }
     console.log("Dry run \u2014 would create:");
     console.log(`- ${DEFAULT_CONFIG_FILENAME}`);
+    if (template) console.log(`  template: ${template}`);
     return;
   }
   try {
-    await writeFile(configPath, `${JSON.stringify(template, null, 2)}
+    await writeFile(configPath, `${JSON.stringify(suiteConfig, null, 2)}
 `, "utf-8");
     if (options.json) {
-      printJson5({ ok: true, created: [DEFAULT_CONFIG_FILENAME], configPath });
+      printJson5({
+        ok: true,
+        created: [DEFAULT_CONFIG_FILENAME],
+        configPath,
+        ...template ? { template } : {}
+      });
       return;
     }
     console.log("Created suite config:");
     console.log(`- ${DEFAULT_CONFIG_FILENAME}`);
+    if (template) console.log(`  template: ${template}`);
     console.log("\nNext:");
     console.log("  npx agent-inspect suite validate");
     console.log("  npx agent-inspect suite run --json");
@@ -10715,6 +10781,11 @@ function createCliProgram() {
   program.command("viewer").description("Start localhost read-only viewer (traces, suite, or workspace) (v5.3+)").option("--dir <path>", "trace directory (trace mode)").option("--suite", "suite evidence mode").option("--workspace", "workspace mode").option("--config <path>", "suite config path (suite mode)").option("--host <host>", "bind host (default 127.0.0.1)", "127.0.0.1").option("--port <number>", "bind port (default 7337)", "7337").option("--open", "open browser locally when host is localhost").action((opts) => {
     runCommand(() => serveCommand(opts));
   });
+  program.command("studio").description(
+    "Start self-hosted read-only Studio analyzer (requires @agent-inspect/studio) (v6.0+)"
+  ).option("--workspace <path>", "studio registry manifest path").option("--db <path>", "studio database path (sqlite file or postgres URL)").option("--host <host>", "bind host (default 127.0.0.1)", "127.0.0.1").option("--port <number>", "bind port (default 7340)", "7340").option("--server", "bind for network access (0.0.0.0; requires explicit opt-in)").option("--auth <mode>", "auth mode: none or basic", "none").option("--password-env <name>", "env var for basic-auth password").option("--open", "open browser locally when host is localhost").action((opts) => {
+    runCommand(() => studioCommand(opts));
+  });
   program.command("eval").description("Run deterministic local evals against a trace").argument("<trace-path-or-run-id>", "trace file, directory, stdin -, or run id").option("--dir <path>", "trace directory for run-id lookup").addOption(
     new Option("--format <format>", "trace input format").choices([
       "agent-inspect-jsonl",
@@ -10986,7 +11057,7 @@ function createCliProgram() {
     runCommand(() => workspacePathCommand(opts));
   });
   const suiteCmd = program.command("suite").description("Define and run local trace suites for CI (v5.0+)");
-  suiteCmd.command("init").description("Create a starter agent-inspect.suite.json").option("--dry-run", "show planned files without writing").option("--json", "print deterministic JSON result").action((opts) => {
+  suiteCmd.command("init").description("Create a starter agent-inspect.suite.json").option("--template <name>", "PM/QA template id (v5.4+)").option("--dry-run", "show planned files without writing").option("--json", "print deterministic JSON result").action((opts) => {
     runCommand(() => suiteInitCommand(opts));
   });
   suiteCmd.command("validate").description("Validate suite config shape and trace paths").option("--config <path>", "suite config path").option("--json", "print deterministic JSON result").action((opts) => {