@evalops/maestro 0.10.17 → 0.10.20

package/dist/cli/commands/modes.js

@@ -0,0 +1,151 @@
+import chalk from "chalk";
+import { getAllModes, getModeConfig, getModelForMode, getModelForTier, parseMode, resolveSubagentDispatch, } from "../../agent/modes.js";
+import { SUBAGENT_SPECS, } from "../../agent/subagent-specs.js";
+import { recordStagedRolloutSurfaceUsage } from "../../telemetry.js";
+const PROVIDERS = [
+    "anthropic",
+    "openai",
+    "openai-codex",
+    "google",
+];
+function parseProvider(provider) {
+    if (!provider) {
+        return "anthropic";
+    }
+    if (PROVIDERS.includes(provider)) {
+        return provider;
+    }
+    throw new Error(`Unknown provider "${provider}". Supported providers: ${PROVIDERS.join(", ")}`);
+}
+function allSubagentTypes() {
+    return Object.keys(SUBAGENT_SPECS);
+}
+function buildModeDescription(mode, provider) {
+    const config = getModeConfig(mode);
+    return {
+        mode,
+        displayName: config.displayName,
+        description: config.description,
+        visible: config.visible,
+        primary: {
+            tier: config.primaryTier,
+            provider,
+            model: getModelForMode(mode, provider),
+        },
+        fallback: {
+            tier: config.fallbackTier,
+            provider,
+            model: getModelForTier(config.fallbackTier, provider),
+        },
+        reasoningEffort: config.reasoningEffort ?? (config.enableThinking ? "medium" : "low"),
+        thinking: {
+            enabled: config.enableThinking,
+            budget: config.thinkingBudget,
+        },
+        context: {
+            extended: config.useExtendedContext,
+        },
+        retries: config.maxRetries,
+        costMultiplier: config.costMultiplier,
+        speedHint: config.speedHint,
+        subagents: allSubagentTypes().map((type) => {
+            const dispatch = resolveSubagentDispatch(mode, type, provider);
+            const spec = SUBAGENT_SPECS[type];
+            return {
+                ...dispatch,
+                displayName: spec.displayName,
+                description: spec.description,
+            };
+        }),
+    };
+}
+function pad(value, width) {
+    return value.length >= width ? value : value.padEnd(width);
+}
+function renderModeDescription(description) {
+    const visibility = description.visible ? "visible" : "hidden";
+    const lines = [
+        `Mode: ${description.displayName} (${description.mode})`,
+        description.description,
+        "",
+        `Visibility: ${visibility}`,
+        `Primary: ${description.primary.tier} -> ${description.primary.provider}/${description.primary.model}`,
+        `Fallback: ${description.fallback.tier} -> ${description.fallback.provider}/${description.fallback.model}`,
+        `Reasoning: ${description.reasoningEffort}`,
+        `Thinking: ${description.thinking.enabled ? "enabled" : "disabled"} (budget ${description.thinking.budget})`,
+        `Context: ${description.context.extended ? "extended" : "standard"}`,
+        `Retries: ${description.retries}`,
+        "",
+        `Subagent dispatch (provider: ${description.primary.provider})`,
+        `${pad("Type", 12)} ${pad("Source", 8)} ${pad("Provider", 14)} ${pad("Model", 34)} ${pad("Effort", 8)} Tier`,
+        `${"-".repeat(12)} ${"-".repeat(8)} ${"-".repeat(14)} ${"-".repeat(34)} ${"-".repeat(8)} ${"-".repeat(8)}`,
+    ];
+    for (const dispatch of description.subagents) {
+        lines.push([
+            pad(dispatch.type, 12),
+            pad(dispatch.source, 8),
+            pad(dispatch.provider, 14),
+            pad(dispatch.model, 34),
+            pad(dispatch.reasoningEffort, 8),
+            dispatch.modelTier ?? "-",
+        ].join(" "));
+    }
+    return lines.join("\n");
+}
+function renderModesList(includeHidden) {
+    const lines = ["Agent modes:", ""];
+    for (const { mode, config } of getAllModes({ includeHidden })) {
+        const hiddenSuffix = config.visible === false ? " [hidden]" : "";
+        lines.push(`${mode}${hiddenSuffix}`);
+        lines.push(`  ${config.description}`);
+        lines.push(`  describe: maestro modes describe ${mode}`);
+    }
+    return lines.join("\n");
+}
+function usage() {
+    return [
+        "Usage:",
+        "  maestro modes list",
+        "  maestro modes describe <mode> [--provider <provider>] [--json]",
+        "",
+        "Examples:",
+        "  maestro modes describe smart",
+        "  maestro modes describe frontier --provider openai --json",
+    ].join("\n");
+}
+export async function handleModesCommand(subcommand, messages = [], options = {}) {
+    const provider = parseProvider(options.provider);
+    const command = subcommand ?? "list";
+    if (command === "help" || command === "--help" || command === "-h") {
+        console.log(usage());
+        return;
+    }
+    if (command === "list") {
+        console.log(renderModesList(options.includeHidden === true));
+        return;
+    }
+    const modeName = command === "describe" ? messages[0] : command;
+    const mode = modeName ? parseMode(modeName) : null;
+    if (!mode) {
+        const suffix = modeName ? `: ${modeName}` : "";
+        console.error(chalk.red(`Unknown mode${suffix}`));
+        console.log(chalk.dim(usage()));
+        process.exit(1);
+    }
+    const description = buildModeDescription(mode, provider);
+    if (!description.visible) {
+        const config = getModeConfig(mode);
+        await recordStagedRolloutSurfaceUsage("hidden_mode_used", {
+            surfaceId: `mode:${mode}`,
+            surfaceType: "mode",
+            owner: config.rolloutOwner,
+            source: "cli:modes:describe",
+        });
+    }
+    if (options.json) {
+        console.log(JSON.stringify(description, null, 2));
+        return;
+    }
+    console.log(renderModeDescription(description));
+}
+//# sourceMappingURL=modes.js.map

package/dist/cli/commands/modes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.js","sourceRoot":"","sources":["../../../src/cli/commands/modes.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from \"chalk\";\nimport {\n\ttype AgentMode,\n\ttype ModelProvider,\n\ttype ResolvedSubagentDispatch,\n\tgetAllModes,\n\tgetModeConfig,\n\tgetModelForMode,\n\tgetModelForTier,\n\tparseMode,\n\tresolveSubagentDispatch,\n} from \"../../agent/modes.js\";\nimport {\n\tSUBAGENT_SPECS,\n\ttype SubagentType,\n} from \"../../agent/subagent-specs.js\";\nimport { recordStagedRolloutSurfaceUsage } from \"../../telemetry.js\";\n\nconst PROVIDERS: ModelProvider[] = [\n\t\"anthropic\",\n\t\"openai\",\n\t\"openai-codex\",\n\t\"google\",\n];\n\ntype ModeCommandOptions = {\n\tprovider?: string;\n\tjson?: boolean;\n\tincludeHidden?: boolean;\n};\n\ntype ModeDescription = {\n\tmode: AgentMode;\n\tdisplayName: string;\n\tdescription: string;\n\tvisible: boolean;\n\tprimary: {\n\t\ttier: string;\n\t\tprovider: ModelProvider;\n\t\tmodel: string;\n\t};\n\tfallback: {\n\t\ttier: string;\n\t\tprovider: ModelProvider;\n\t\tmodel: string;\n\t};\n\treasoningEffort: string;\n\tthinking: {\n\t\tenabled: boolean;\n\t\tbudget: number;\n\t};\n\tcontext: {\n\t\textended: boolean;\n\t};\n\tretries: number;\n\tcostMultiplier: number;\n\tspeedHint: number;\n\tsubagents: Array<\n\t\tResolvedSubagentDispatch & {\n\t\t\tdisplayName: string;\n\t\t\tdescription: string;\n\t\t}\n\t>;\n};\n\nfunction parseProvider(provider: string | undefined): ModelProvider {\n\tif (!provider) {\n\t\treturn \"anthropic\";\n\t}\n\tif (PROVIDERS.includes(provider as ModelProvider)) {\n\t\treturn provider as ModelProvider;\n\t}\n\tthrow new Error(\n\t\t`Unknown provider \"${provider}\". Supported providers: ${PROVIDERS.join(\", \")}`,\n\t);\n}\n\nfunction allSubagentTypes(): SubagentType[] {\n\treturn Object.keys(SUBAGENT_SPECS) as SubagentType[];\n}\n\nfunction buildModeDescription(\n\tmode: AgentMode,\n\tprovider: ModelProvider,\n): ModeDescription {\n\tconst config = getModeConfig(mode);\n\treturn {\n\t\tmode,\n\t\tdisplayName: config.displayName,\n\t\tdescription: config.description,\n\t\tvisible: config.visible,\n\t\tprimary: {\n\t\t\ttier: config.primaryTier,\n\t\t\tprovider,\n\t\t\tmodel: getModelForMode(mode, provider),\n\t\t},\n\t\tfallback: {\n\t\t\ttier: config.fallbackTier,\n\t\t\tprovider,\n\t\t\tmodel: getModelForTier(config.fallbackTier, provider),\n\t\t},\n\t\treasoningEffort:\n\t\t\tconfig.reasoningEffort ?? (config.enableThinking ? \"medium\" : \"low\"),\n\t\tthinking: {\n\t\t\tenabled: config.enableThinking,\n\t\t\tbudget: config.thinkingBudget,\n\t\t},\n\t\tcontext: {\n\t\t\textended: config.useExtendedContext,\n\t\t},\n\t\tretries: config.maxRetries,\n\t\tcostMultiplier: config.costMultiplier,\n\t\tspeedHint: config.speedHint,\n\t\tsubagents: allSubagentTypes().map((type) => {\n\t\t\tconst dispatch = resolveSubagentDispatch(mode, type, provider);\n\t\t\tconst spec = SUBAGENT_SPECS[type];\n\t\t\treturn {\n\t\t\t\t...dispatch,\n\t\t\t\tdisplayName: spec.displayName,\n\t\t\t\tdescription: spec.description,\n\t\t\t};\n\t\t}),\n\t};\n}\n\nfunction pad(value: string, width: number): string {\n\treturn value.length >= width ? value : value.padEnd(width);\n}\n\nfunction renderModeDescription(description: ModeDescription): string {\n\tconst visibility = description.visible ? \"visible\" : \"hidden\";\n\tconst lines = [\n\t\t`Mode: ${description.displayName} (${description.mode})`,\n\t\tdescription.description,\n\t\t\"\",\n\t\t`Visibility: ${visibility}`,\n\t\t`Primary: ${description.primary.tier} -> ${description.primary.provider}/${description.primary.model}`,\n\t\t`Fallback: ${description.fallback.tier} -> ${description.fallback.provider}/${description.fallback.model}`,\n\t\t`Reasoning: ${description.reasoningEffort}`,\n\t\t`Thinking: ${description.thinking.enabled ? \"enabled\" : \"disabled\"} (budget ${description.thinking.budget})`,\n\t\t`Context: ${description.context.extended ? \"extended\" : \"standard\"}`,\n\t\t`Retries: ${description.retries}`,\n\t\t\"\",\n\t\t`Subagent dispatch (provider: ${description.primary.provider})`,\n\t\t`${pad(\"Type\", 12)} ${pad(\"Source\", 8)} ${pad(\"Provider\", 14)} ${pad(\"Model\", 34)} ${pad(\"Effort\", 8)} Tier`,\n\t\t`${\"-\".repeat(12)} ${\"-\".repeat(8)} ${\"-\".repeat(14)} ${\"-\".repeat(34)} ${\"-\".repeat(8)} ${\"-\".repeat(8)}`,\n\t];\n\n\tfor (const dispatch of description.subagents) {\n\t\tlines.push(\n\t\t\t[\n\t\t\t\tpad(dispatch.type, 12),\n\t\t\t\tpad(dispatch.source, 8),\n\t\t\t\tpad(dispatch.provider, 14),\n\t\t\t\tpad(dispatch.model, 34),\n\t\t\t\tpad(dispatch.reasoningEffort, 8),\n\t\t\t\tdispatch.modelTier ?? \"-\",\n\t\t\t].join(\" \"),\n\t\t);\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n\nfunction renderModesList(includeHidden: boolean): string {\n\tconst lines = [\"Agent modes:\", \"\"];\n\tfor (const { mode, config } of getAllModes({ includeHidden })) {\n\t\tconst hiddenSuffix = config.visible === false ? \" [hidden]\" : \"\";\n\t\tlines.push(`${mode}${hiddenSuffix}`);\n\t\tlines.push(`  ${config.description}`);\n\t\tlines.push(`  describe: maestro modes describe ${mode}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nfunction usage(): string {\n\treturn [\n\t\t\"Usage:\",\n\t\t\"  maestro modes list\",\n\t\t\"  maestro modes describe <mode> [--provider <provider>] [--json]\",\n\t\t\"\",\n\t\t\"Examples:\",\n\t\t\"  maestro modes describe smart\",\n\t\t\"  maestro modes describe frontier --provider openai --json\",\n\t].join(\"\\n\");\n}\n\nexport async function handleModesCommand(\n\tsubcommand: string | undefined,\n\tmessages: string[] = [],\n\toptions: ModeCommandOptions = {},\n): Promise<void> {\n\tconst provider = parseProvider(options.provider);\n\tconst command = subcommand ?? \"list\";\n\n\tif (command === \"help\" || command === \"--help\" || command === \"-h\") {\n\t\tconsole.log(usage());\n\t\treturn;\n\t}\n\n\tif (command === \"list\") {\n\t\tconsole.log(renderModesList(options.includeHidden === true));\n\t\treturn;\n\t}\n\n\tconst modeName = command === \"describe\" ? messages[0] : command;\n\tconst mode = modeName ? parseMode(modeName) : null;\n\tif (!mode) {\n\t\tconst suffix = modeName ? `: ${modeName}` : \"\";\n\t\tconsole.error(chalk.red(`Unknown mode${suffix}`));\n\t\tconsole.log(chalk.dim(usage()));\n\t\tprocess.exit(1);\n\t}\n\n\tconst description = buildModeDescription(mode, provider);\n\tif (!description.visible) {\n\t\tconst config = getModeConfig(mode);\n\t\tawait recordStagedRolloutSurfaceUsage(\"hidden_mode_used\", {\n\t\t\tsurfaceId: `mode:${mode}`,\n\t\t\tsurfaceType: \"mode\",\n\t\t\towner: config.rolloutOwner,\n\t\t\tsource: \"cli:modes:describe\",\n\t\t});\n\t}\n\n\tif (options.json) {\n\t\tconsole.log(JSON.stringify(description, null, 2));\n\t\treturn;\n\t}\n\n\tconsole.log(renderModeDescription(description));\n}\n"]}

package/dist/cli/commands/operating-plane.d.ts

@@ -0,0 +1,14 @@
+import { type OperatingPlaneInspection, type OperatingPlaneRunQuery } from "../../platform/operating-plane-client.js";
+export interface ParsedOperatingPlaneArgs {
+    subcommand: string;
+    query: OperatingPlaneRunQuery;
+    json: boolean;
+    help: boolean;
+}
+export interface HandleOperatingPlaneCommandOptions {
+    inspect?: (query: OperatingPlaneRunQuery) => Promise<OperatingPlaneInspection>;
+    write?: (line: string) => void;
+}
+export declare function handleOperatingPlaneCommand(args: string[], options?: HandleOperatingPlaneCommandOptions): Promise<void>;
+export declare function parseOperatingPlaneArgs(args: string[]): ParsedOperatingPlaneArgs;
+//# sourceMappingURL=operating-plane.d.ts.map

package/dist/cli/commands/operating-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operating-plane.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAE3B,MAAM,0CAA0C,CAAC;AAMlD,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,CACT,KAAK,EAAE,sBAAsB,KACzB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAqBD,wBAAsB,2BAA2B,CAChD,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,MAAM,EAAE,GACZ,wBAAwB,CA8C1B"}

package/dist/cli/commands/operating-plane.js

@@ -0,0 +1,160 @@
+import { inspectOperatingPlaneRuns, } from "../../platform/operating-plane-client.js";
+import { formatOperatingPlaneStatusReport, summarizeOperatingPlaneInspection, } from "../../platform/operating-plane-summary.js";
+const VALUE_FLAGS = new Set([
+    "--agent-id",
+    "--audience",
+    "--auth-subject",
+    "--autonomy-session-id",
+    "--channel-thread-id",
+    "--evidence-id",
+    "--gateway-authenticated-subject",
+    "--limit",
+    "--run-id",
+    "--session-id",
+    "--thread-id",
+    "--trace-id",
+    "--work-envelope-id",
+    "--workspace-id",
+]);
+const BOOLEAN_FLAGS = new Set(["--help", "--include-gates", "--json"]);
+export async function handleOperatingPlaneCommand(args, options = {}) {
+    const parsed = parseOperatingPlaneArgs(args);
+    const write = options.write ?? ((line) => console.log(line));
+    if (parsed.help || parsed.subcommand === "help") {
+        write(operatingPlaneHelpText());
+        return;
+    }
+    if (parsed.subcommand !== "status" && parsed.subcommand !== "inspect") {
+        throw new Error(`Unknown operating-plane command: ${parsed.subcommand}`);
+    }
+    const inspect = options.inspect ?? inspectOperatingPlaneRuns;
+    const inspection = await inspect(parsed.query);
+    const report = summarizeOperatingPlaneInspection(inspection);
+    write(parsed.json
+        ? JSON.stringify(report, null, 2)
+        : formatOperatingPlaneStatusReport(report));
+}
+export function parseOperatingPlaneArgs(args) {
+    const positionals = [];
+    const flags = new Map();
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === "--") {
+            positionals.push(...args.slice(index + 1));
+            break;
+        }
+        if (!arg.startsWith("--")) {
+            positionals.push(arg);
+            continue;
+        }
+        const [flag, inlineValue] = arg.split("=", 2);
+        if (!flag) {
+            continue;
+        }
+        if (!VALUE_FLAGS.has(flag) && !BOOLEAN_FLAGS.has(flag)) {
+            throw new Error(`Unknown operating-plane option: ${flag}`);
+        }
+        if (inlineValue !== undefined) {
+            flags.set(flag, inlineValue);
+            continue;
+        }
+        if (BOOLEAN_FLAGS.has(flag)) {
+            flags.set(flag, true);
+            continue;
+        }
+        const next = args[index + 1];
+        if (!next || next === "--" || next.startsWith("--")) {
+            throw new Error(`${flag} requires a value`);
+        }
+        flags.set(flag, next);
+        index++;
+    }
+    return {
+        subcommand: positionals.shift()?.toLowerCase() ?? "status",
+        query: queryFromFlags(flags),
+        json: flagBoolean(flags, "--json") === true,
+        help: flagBoolean(flags, "--help") === true,
+    };
+}
+function queryFromFlags(flags) {
+    return stripUndefined({
+        workspaceId: flagString(flags, "--workspace-id"),
+        runId: flagString(flags, "--run-id"),
+        workEnvelopeId: flagString(flags, "--work-envelope-id"),
+        autonomySessionId: flagString(flags, "--autonomy-session-id"),
+        agentId: flagString(flags, "--agent-id"),
+        threadId: flagString(flags, "--thread-id"),
+        channelThreadId: flagString(flags, "--channel-thread-id"),
+        traceId: flagString(flags, "--trace-id"),
+        sessionId: flagString(flags, "--session-id"),
+        evidenceId: flagString(flags, "--evidence-id"),
+        gatewayAuthenticatedSubject: flagString(flags, "--gateway-authenticated-subject") ??
+            flagString(flags, "--auth-subject"),
+        audience: flagString(flags, "--audience"),
+        includeGates: flagBoolean(flags, "--include-gates"),
+        limit: flagNonNegativeInt(flags, "--limit"),
+    });
+}
+function flagString(flags, name) {
+    const value = flags.get(name);
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function flagBoolean(flags, name) {
+    const value = flags.get(name);
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "boolean") {
+        return value;
+    }
+    switch (value.trim().toLowerCase()) {
+        case "1":
+        case "true":
+        case "yes":
+            return true;
+        case "0":
+        case "false":
+        case "no":
+            return false;
+        default:
+            throw new Error(`${name} must be true or false`);
+    }
+}
+function flagNonNegativeInt(flags, name) {
+    const value = flagString(flags, name);
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value) {
+        throw new Error(`${name} must be a non-negative integer`);
+    }
+    return parsed;
+}
+function stripUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function operatingPlaneHelpText() {
+    return `Usage: maestro operating-plane status [filters]
+
+Filters:
+  --thread-id <id>                  Slack/channel thread id
+  --evidence-id <id>                Evidence ref id
+  --auth-subject <subject>          Gateway-authenticated subject
+  --trace-id <id>                   Trace id
+  --session-id <id>                 Maestro/session id
+  --run-id <id>                     Agent runtime run id
+  --workspace-id <id>               Workspace id
+  --audience <audience>             agent, channel, audit, system, ...
+  --include-gates=<true|false>      Include release/replay gates
+  --limit <n>                       Maximum runs
+  --json                            Emit safe summary JSON`;
+}
+//# sourceMappingURL=operating-plane.js.map

package/dist/cli/commands/operating-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operating-plane.js","sourceRoot":"","sources":["../../../src/cli/commands/operating-plane.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype OperatingPlaneInspection,\n\ttype OperatingPlaneRunQuery,\n\tinspectOperatingPlaneRuns,\n} from \"../../platform/operating-plane-client.js\";\nimport {\n\tformatOperatingPlaneStatusReport,\n\tsummarizeOperatingPlaneInspection,\n} from \"../../platform/operating-plane-summary.js\";\n\nexport interface ParsedOperatingPlaneArgs {\n\tsubcommand: string;\n\tquery: OperatingPlaneRunQuery;\n\tjson: boolean;\n\thelp: boolean;\n}\n\nexport interface HandleOperatingPlaneCommandOptions {\n\tinspect?: (\n\t\tquery: OperatingPlaneRunQuery,\n\t) => Promise<OperatingPlaneInspection>;\n\twrite?: (line: string) => void;\n}\n\nconst VALUE_FLAGS = new Set([\n\t\"--agent-id\",\n\t\"--audience\",\n\t\"--auth-subject\",\n\t\"--autonomy-session-id\",\n\t\"--channel-thread-id\",\n\t\"--evidence-id\",\n\t\"--gateway-authenticated-subject\",\n\t\"--limit\",\n\t\"--run-id\",\n\t\"--session-id\",\n\t\"--thread-id\",\n\t\"--trace-id\",\n\t\"--work-envelope-id\",\n\t\"--workspace-id\",\n]);\n\nconst BOOLEAN_FLAGS = new Set([\"--help\", \"--include-gates\", \"--json\"]);\n\nexport async function handleOperatingPlaneCommand(\n\targs: string[],\n\toptions: HandleOperatingPlaneCommandOptions = {},\n): Promise<void> {\n\tconst parsed = parseOperatingPlaneArgs(args);\n\tconst write = options.write ?? ((line: string) => console.log(line));\n\tif (parsed.help || parsed.subcommand === \"help\") {\n\t\twrite(operatingPlaneHelpText());\n\t\treturn;\n\t}\n\tif (parsed.subcommand !== \"status\" && parsed.subcommand !== \"inspect\") {\n\t\tthrow new Error(`Unknown operating-plane command: ${parsed.subcommand}`);\n\t}\n\n\tconst inspect = options.inspect ?? inspectOperatingPlaneRuns;\n\tconst inspection = await inspect(parsed.query);\n\tconst report = summarizeOperatingPlaneInspection(inspection);\n\twrite(\n\t\tparsed.json\n\t\t\t? JSON.stringify(report, null, 2)\n\t\t\t: formatOperatingPlaneStatusReport(report),\n\t);\n}\n\nexport function parseOperatingPlaneArgs(\n\targs: string[],\n): ParsedOperatingPlaneArgs {\n\tconst positionals: string[] = [];\n\tconst flags = new Map<string, string | boolean>();\n\tfor (let index = 0; index < args.length; index++) {\n\t\tconst arg = args[index];\n\t\tif (!arg) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--\") {\n\t\t\tpositionals.push(...args.slice(index + 1));\n\t\t\tbreak;\n\t\t}\n\t\tif (!arg.startsWith(\"--\")) {\n\t\t\tpositionals.push(arg);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst [flag, inlineValue] = arg.split(\"=\", 2);\n\t\tif (!flag) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (!VALUE_FLAGS.has(flag) && !BOOLEAN_FLAGS.has(flag)) {\n\t\t\tthrow new Error(`Unknown operating-plane option: ${flag}`);\n\t\t}\n\t\tif (inlineValue !== undefined) {\n\t\t\tflags.set(flag, inlineValue);\n\t\t\tcontinue;\n\t\t}\n\t\tif (BOOLEAN_FLAGS.has(flag)) {\n\t\t\tflags.set(flag, true);\n\t\t\tcontinue;\n\t\t}\n\t\tconst next = args[index + 1];\n\t\tif (!next || next === \"--\" || next.startsWith(\"--\")) {\n\t\t\tthrow new Error(`${flag} requires a value`);\n\t\t}\n\t\tflags.set(flag, next);\n\t\tindex++;\n\t}\n\n\treturn {\n\t\tsubcommand: positionals.shift()?.toLowerCase() ?? \"status\",\n\t\tquery: queryFromFlags(flags),\n\t\tjson: flagBoolean(flags, \"--json\") === true,\n\t\thelp: flagBoolean(flags, \"--help\") === true,\n\t};\n}\n\nfunction queryFromFlags(\n\tflags: Map<string, string | boolean>,\n): OperatingPlaneRunQuery {\n\treturn stripUndefined({\n\t\tworkspaceId: flagString(flags, \"--workspace-id\"),\n\t\trunId: flagString(flags, \"--run-id\"),\n\t\tworkEnvelopeId: flagString(flags, \"--work-envelope-id\"),\n\t\tautonomySessionId: flagString(flags, \"--autonomy-session-id\"),\n\t\tagentId: flagString(flags, \"--agent-id\"),\n\t\tthreadId: flagString(flags, \"--thread-id\"),\n\t\tchannelThreadId: flagString(flags, \"--channel-thread-id\"),\n\t\ttraceId: flagString(flags, \"--trace-id\"),\n\t\tsessionId: flagString(flags, \"--session-id\"),\n\t\tevidenceId: flagString(flags, \"--evidence-id\"),\n\t\tgatewayAuthenticatedSubject:\n\t\t\tflagString(flags, \"--gateway-authenticated-subject\") ??\n\t\t\tflagString(flags, \"--auth-subject\"),\n\t\taudience: flagString(flags, \"--audience\") as\n\t\t\t| OperatingPlaneRunQuery[\"audience\"]\n\t\t\t| undefined,\n\t\tincludeGates: flagBoolean(flags, \"--include-gates\"),\n\t\tlimit: flagNonNegativeInt(flags, \"--limit\"),\n\t});\n}\n\nfunction flagString(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): string | undefined {\n\tconst value = flags.get(name);\n\tif (typeof value !== \"string\") {\n\t\treturn undefined;\n\t}\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction flagBoolean(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): boolean | undefined {\n\tconst value = flags.get(name);\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tswitch (value.trim().toLowerCase()) {\n\t\tcase \"1\":\n\t\tcase \"true\":\n\t\tcase \"yes\":\n\t\t\treturn true;\n\t\tcase \"0\":\n\t\tcase \"false\":\n\t\tcase \"no\":\n\t\t\treturn false;\n\t\tdefault:\n\t\t\tthrow new Error(`${name} must be true or false`);\n\t}\n}\n\nfunction flagNonNegativeInt(\n\tflags: Map<string, string | boolean>,\n\tname: string,\n): number | undefined {\n\tconst value = flagString(flags, name);\n\tif (!value) {\n\t\treturn undefined;\n\t}\n\tconst parsed = Number.parseInt(value, 10);\n\tif (!Number.isFinite(parsed) || parsed < 0 || String(parsed) !== value) {\n\t\tthrow new Error(`${name} must be a non-negative integer`);\n\t}\n\treturn parsed;\n}\n\nfunction stripUndefined<T extends Record<string, unknown>>(value: T): T {\n\treturn Object.fromEntries(\n\t\tObject.entries(value).filter(([, entry]) => entry !== undefined),\n\t) as T;\n}\n\nfunction operatingPlaneHelpText(): string {\n\treturn `Usage: maestro operating-plane status [filters]\n\nFilters:\n  --thread-id <id>                  Slack/channel thread id\n  --evidence-id <id>                Evidence ref id\n  --auth-subject <subject>          Gateway-authenticated subject\n  --trace-id <id>                   Trace id\n  --session-id <id>                 Maestro/session id\n  --run-id <id>                     Agent runtime run id\n  --workspace-id <id>               Workspace id\n  --audience <audience>             agent, channel, audit, system, ...\n  --include-gates=<true|false>      Include release/replay gates\n  --limit <n>                       Maximum runs\n  --json                            Emit safe summary JSON`;\n}\n"]}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,87 @@
+import { type AgentRuntimeLedgerReport } from "../../server/agent-runtime-ledger.js";
+import { type AgentTrajectoryInspectionReport } from "../../server/agent-trajectory-inspection.js";
+import { type AgentTrajectoryReplayReport } from "../../server/agent-trajectory-replay.js";
+import { type AgentTrajectoryScoreReport } from "../../server/agent-trajectory-scorers.js";
+import { type AgentTrajectoryReport } from "../../server/agent-trajectory.js";
+import { buildComposerRunTimeline } from "../../server/session-timeline.js";
+declare const RUN_RECONSTRUCTION_SCHEMA = "evalops.maestro.run-reconstruction.v1";
+type ComposerRunTimeline = ReturnType<typeof buildComposerRunTimeline>;
+interface RunInspectOptions {
+    json?: boolean;
+    sessionDir?: string;
+}
+interface ReconstructionCountSummary {
+    timelineItems: number;
+    byType: Record<string, number>;
+    byStatus: Record<string, number>;
+    byVisibility: Record<string, number>;
+}
+interface ReconstructionCoverage {
+    promptInputs: boolean;
+    assistantResponses: boolean;
+    toolRequests: boolean;
+    toolResults: boolean;
+    contextManifest: boolean;
+    contextDiagnostics: boolean;
+    fileChanges: boolean;
+    artifacts: boolean;
+    policyDecisions: boolean;
+    diagnostics: boolean;
+    compactions: boolean;
+    pendingRequests: boolean;
+    mcpContext: boolean;
+}
+interface PromptContextSummary {
+    entries: number;
+    projectDocs: number;
+    mcpServers: number;
+}
+interface ContextManifestSummary {
+    protocolVersion?: string;
+    version?: number;
+    cwd?: string;
+    entries: number;
+    projectDocs: number;
+    mcpServers: number;
+    mcpResources: number;
+    mcpPrompts: number;
+    diagnostics: number;
+    byKind: Record<string, number>;
+    bySource: Record<string, number>;
+    byStatus: Record<string, number>;
+    projectDocBytesRead?: number;
+    projectDocMaxBytes?: number;
+}
+interface RunReconstructionReport {
+    schemaVersion: typeof RUN_RECONSTRUCTION_SCHEMA;
+    session: {
+        id: string;
+        title?: string;
+        summary?: string;
+        createdAt: string;
+        updatedAt: string;
+        messageCount: number;
+        sessionFile: string;
+        cwd?: string;
+        model?: string;
+    };
+    counts: ReconstructionCountSummary;
+    coverage: ReconstructionCoverage;
+    promptContext: PromptContextSummary;
+    contextManifest: ContextManifestSummary;
+    timeline: ComposerRunTimeline;
+    trajectory: AgentTrajectoryReport;
+    trajectoryReplay: AgentTrajectoryReplayReport;
+    trajectoryScore: AgentTrajectoryScoreReport;
+    trajectoryInspection: AgentTrajectoryInspectionReport;
+    agentRuntimeLedger: AgentRuntimeLedgerReport;
+}
+declare function buildRunReconstructionReport(sessionId: string, options?: RunInspectOptions): Promise<RunReconstructionReport | null>;
+declare function renderRunReconstruction(report: RunReconstructionReport): string;
+export declare function handleRunCommand(subcommand?: string, args?: string[], options?: RunInspectOptions): Promise<void>;
+export declare const testing: {
+    buildRunReconstructionReport: typeof buildRunReconstructionReport;
+    renderRunReconstruction: typeof renderRunReconstruction;
+};
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"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"}