@evalops/maestro 0.10.21 → 0.10.22

package/dist/mcp/fathom-cua.js

@@ -0,0 +1,158 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { getEnvValue } from "../platform/client.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("mcp:fathom-cua");
+const DISABLED_VALUES = new Set(["0", "false", "no", "off"]);
+const ENABLED_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_ENABLED",
+    "FATHOM_CUA_MCP_ENABLED",
+];
+const NAME_ENV_VARS = ["MAESTRO_FATHOM_CUA_MCP_NAME", "FATHOM_CUA_MCP_NAME"];
+const COMMAND_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_CLIENT_COMMAND",
+    "FATHOM_CUA_CLIENT_COMMAND",
+];
+const ARGS_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_CLIENT_ARGS_JSON",
+    "FATHOM_CUA_CLIENT_ARGS_JSON",
+];
+const REPO_ENV_VARS = ["MAESTRO_FATHOM_CUA_REPO", "FATHOM_CUA_REPO"];
+const CWD_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_CLIENT_CWD",
+    "FATHOM_CUA_CLIENT_CWD",
+];
+const WORKSPACE_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_WORKSPACE_ID",
+    "FATHOM_CUA_WORKSPACE_ID",
+    "MAESTRO_WORKSPACE_ID",
+    "MAESTRO_EVALOPS_WORKSPACE_ID",
+    "EVALOPS_WORKSPACE_ID",
+];
+const HELPER_ENDPOINT_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_HELPER_ENDPOINT",
+    "FATHOM_CUA_HELPER_ENDPOINT",
+];
+const IPC_ROOT_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_IPC_ROOT",
+    "FATHOM_CUA_IPC_ROOT",
+    "FATHOM_IPC_ROOT",
+];
+const SESSION_ID_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_SESSION_ID",
+    "FATHOM_CUA_SESSION_ID",
+    "MAESTRO_SESSION_ID",
+];
+const TURN_ID_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_TURN_ID",
+    "FATHOM_CUA_TURN_ID",
+    "MAESTRO_AGENT_RUN_ID",
+    "MAESTRO_REQUEST_ID",
+];
+const DISABLE_IPC_ENV_VARS = [
+    "MAESTRO_FATHOM_CUA_DISABLE_IPC",
+    "FATHOM_CUA_DISABLE_IPC",
+];
+const DEFAULT_SERVER_NAME = "fathom-cua";
+function envFlagEnabled(names) {
+    const value = getEnvValue(names);
+    if (!value) {
+        return false;
+    }
+    return !DISABLED_VALUES.has(value.trim().toLowerCase());
+}
+function envFlagDisabled(names) {
+    const value = getEnvValue(names);
+    if (!value) {
+        return false;
+    }
+    return DISABLED_VALUES.has(value.trim().toLowerCase());
+}
+function parseArgsJson(raw) {
+    if (!raw) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            throw new Error("expected an array");
+        }
+        return parsed.map((item) => {
+            if (typeof item !== "string") {
+                throw new Error("expected only string arguments");
+            }
+            return item;
+        });
+    }
+    catch (error) {
+        logger.warn("Ignoring invalid Fathom CUA MCP args JSON", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return [];
+    }
+}
+function appendFlag(args, flag, value) {
+    if (value) {
+        args.push(flag, value);
+    }
+}
+function resolveFathomRepo() {
+    const configured = getEnvValue(REPO_ENV_VARS);
+    if (configured) {
+        return configured;
+    }
+    const candidates = [
+        join(process.cwd(), "..", "fathom"),
+        join(process.cwd(), "..", "..", "fathom"),
+        join(process.cwd(), "..", "..", "..", "fathom"),
+    ];
+    return candidates.find((candidate) => existsSync(join(candidate, "cmd", "fathom-client", "main.go")));
+}
+function buildFathomCuaServer() {
+    const repo = resolveFathomRepo();
+    const configuredCommand = getEnvValue(COMMAND_ENV_VARS);
+    const configuredCwd = getEnvValue(CWD_ENV_VARS);
+    const command = configuredCommand ?? (repo ? "go" : "fathom-client");
+    const cwd = configuredCwd ?? (configuredCommand ? undefined : repo);
+    const extraArgs = parseArgsJson(getEnvValue(ARGS_ENV_VARS));
+    const args = configuredCommand
+        ? [...extraArgs]
+        : repo
+            ? ["run", "./cmd/fathom-client", ...extraArgs]
+            : [...extraArgs];
+    const workspaceId = getEnvValue(WORKSPACE_ENV_VARS);
+    const helperEndpoint = getEnvValue(HELPER_ENDPOINT_ENV_VARS);
+    const ipcRoot = getEnvValue(IPC_ROOT_ENV_VARS);
+    const sessionId = getEnvValue(SESSION_ID_ENV_VARS);
+    const turnId = getEnvValue(TURN_ID_ENV_VARS);
+    appendFlag(args, "-workspace-id", workspaceId);
+    appendFlag(args, "-helper-endpoint", helperEndpoint);
+    appendFlag(args, "-ipc-root", ipcRoot);
+    appendFlag(args, "-session-id", sessionId);
+    appendFlag(args, "-turn-id", turnId);
+    if (envFlagEnabled(DISABLE_IPC_ENV_VARS)) {
+        args.push("-disable-ipc");
+    }
+    const env = Object.fromEntries(Object.entries({
+        FATHOM_CALLER_PRODUCT: "maestro",
+        FATHOM_CUA_PRODUCT: "maestro",
+        FATHOM_CUA_WORKSPACE_ID: workspaceId,
+        FATHOM_IPC_ROOT: ipcRoot,
+    }).filter((entry) => Boolean(entry[1])));
+    return {
+        name: getEnvValue(NAME_ENV_VARS) ?? DEFAULT_SERVER_NAME,
+        transport: "stdio",
+        command,
+        args,
+        cwd,
+        env,
+        scope: "plugin",
+    };
+}
+export function getFathomCuaPluginServers() {
+    if (envFlagDisabled(ENABLED_ENV_VARS) || !envFlagEnabled(ENABLED_ENV_VARS)) {
+        return [];
+    }
+    return [buildFathomCuaServer()];
+}
+//# sourceMappingURL=fathom-cua.js.map

package/dist/mcp/fathom-cua.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fathom-cua.js","sourceRoot":"","sources":["../../src/mcp/fathom-cua.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { getEnvValue } from \"../platform/client.js\";\nimport { createLogger } from \"../utils/logger.js\";\nimport type { McpServerConfig } from \"./types.js\";\n\nconst logger = createLogger(\"mcp:fathom-cua\");\n\nconst DISABLED_VALUES = new Set([\"0\", \"false\", \"no\", \"off\"]);\nconst ENABLED_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_ENABLED\",\n\t\"FATHOM_CUA_MCP_ENABLED\",\n] as const;\nconst NAME_ENV_VARS = [\"MAESTRO_FATHOM_CUA_MCP_NAME\", \"FATHOM_CUA_MCP_NAME\"];\nconst COMMAND_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_CLIENT_COMMAND\",\n\t\"FATHOM_CUA_CLIENT_COMMAND\",\n] as const;\nconst ARGS_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_CLIENT_ARGS_JSON\",\n\t\"FATHOM_CUA_CLIENT_ARGS_JSON\",\n] as const;\nconst REPO_ENV_VARS = [\"MAESTRO_FATHOM_CUA_REPO\", \"FATHOM_CUA_REPO\"] as const;\nconst CWD_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_CLIENT_CWD\",\n\t\"FATHOM_CUA_CLIENT_CWD\",\n] as const;\nconst WORKSPACE_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_WORKSPACE_ID\",\n\t\"FATHOM_CUA_WORKSPACE_ID\",\n\t\"MAESTRO_WORKSPACE_ID\",\n\t\"MAESTRO_EVALOPS_WORKSPACE_ID\",\n\t\"EVALOPS_WORKSPACE_ID\",\n] as const;\nconst HELPER_ENDPOINT_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_HELPER_ENDPOINT\",\n\t\"FATHOM_CUA_HELPER_ENDPOINT\",\n] as const;\nconst IPC_ROOT_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_IPC_ROOT\",\n\t\"FATHOM_CUA_IPC_ROOT\",\n\t\"FATHOM_IPC_ROOT\",\n] as const;\nconst SESSION_ID_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_SESSION_ID\",\n\t\"FATHOM_CUA_SESSION_ID\",\n\t\"MAESTRO_SESSION_ID\",\n] as const;\nconst TURN_ID_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_TURN_ID\",\n\t\"FATHOM_CUA_TURN_ID\",\n\t\"MAESTRO_AGENT_RUN_ID\",\n\t\"MAESTRO_REQUEST_ID\",\n] as const;\nconst DISABLE_IPC_ENV_VARS = [\n\t\"MAESTRO_FATHOM_CUA_DISABLE_IPC\",\n\t\"FATHOM_CUA_DISABLE_IPC\",\n] as const;\nconst DEFAULT_SERVER_NAME = \"fathom-cua\";\n\nfunction envFlagEnabled(names: readonly string[]): boolean {\n\tconst value = getEnvValue(names);\n\tif (!value) {\n\t\treturn false;\n\t}\n\treturn !DISABLED_VALUES.has(value.trim().toLowerCase());\n}\n\nfunction envFlagDisabled(names: readonly string[]): boolean {\n\tconst value = getEnvValue(names);\n\tif (!value) {\n\t\treturn false;\n\t}\n\treturn DISABLED_VALUES.has(value.trim().toLowerCase());\n}\n\nfunction parseArgsJson(raw: string | undefined): string[] {\n\tif (!raw) {\n\t\treturn [];\n\t}\n\ttry {\n\t\tconst parsed = JSON.parse(raw) as unknown;\n\t\tif (!Array.isArray(parsed)) {\n\t\t\tthrow new Error(\"expected an array\");\n\t\t}\n\t\treturn parsed.map((item) => {\n\t\t\tif (typeof item !== \"string\") {\n\t\t\t\tthrow new Error(\"expected only string arguments\");\n\t\t\t}\n\t\t\treturn item;\n\t\t});\n\t} catch (error) {\n\t\tlogger.warn(\"Ignoring invalid Fathom CUA MCP args JSON\", {\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t});\n\t\treturn [];\n\t}\n}\n\nfunction appendFlag(\n\targs: string[],\n\tflag: string,\n\tvalue: string | undefined,\n): void {\n\tif (value) {\n\t\targs.push(flag, value);\n\t}\n}\n\nfunction resolveFathomRepo(): string | undefined {\n\tconst configured = getEnvValue(REPO_ENV_VARS);\n\tif (configured) {\n\t\treturn configured;\n\t}\n\n\tconst candidates = [\n\t\tjoin(process.cwd(), \"..\", \"fathom\"),\n\t\tjoin(process.cwd(), \"..\", \"..\", \"fathom\"),\n\t\tjoin(process.cwd(), \"..\", \"..\", \"..\", \"fathom\"),\n\t];\n\treturn candidates.find((candidate) =>\n\t\texistsSync(join(candidate, \"cmd\", \"fathom-client\", \"main.go\")),\n\t);\n}\n\nfunction buildFathomCuaServer(): McpServerConfig {\n\tconst repo = resolveFathomRepo();\n\tconst configuredCommand = getEnvValue(COMMAND_ENV_VARS);\n\tconst configuredCwd = getEnvValue(CWD_ENV_VARS);\n\tconst command = configuredCommand ?? (repo ? \"go\" : \"fathom-client\");\n\tconst cwd = configuredCwd ?? (configuredCommand ? undefined : repo);\n\tconst extraArgs = parseArgsJson(getEnvValue(ARGS_ENV_VARS));\n\tconst args = configuredCommand\n\t\t? [...extraArgs]\n\t\t: repo\n\t\t\t? [\"run\", \"./cmd/fathom-client\", ...extraArgs]\n\t\t\t: [...extraArgs];\n\tconst workspaceId = getEnvValue(WORKSPACE_ENV_VARS);\n\tconst helperEndpoint = getEnvValue(HELPER_ENDPOINT_ENV_VARS);\n\tconst ipcRoot = getEnvValue(IPC_ROOT_ENV_VARS);\n\tconst sessionId = getEnvValue(SESSION_ID_ENV_VARS);\n\tconst turnId = getEnvValue(TURN_ID_ENV_VARS);\n\n\tappendFlag(args, \"-workspace-id\", workspaceId);\n\tappendFlag(args, \"-helper-endpoint\", helperEndpoint);\n\tappendFlag(args, \"-ipc-root\", ipcRoot);\n\tappendFlag(args, \"-session-id\", sessionId);\n\tappendFlag(args, \"-turn-id\", turnId);\n\tif (envFlagEnabled(DISABLE_IPC_ENV_VARS)) {\n\t\targs.push(\"-disable-ipc\");\n\t}\n\n\tconst env = Object.fromEntries(\n\t\tObject.entries({\n\t\t\tFATHOM_CALLER_PRODUCT: \"maestro\",\n\t\t\tFATHOM_CUA_PRODUCT: \"maestro\",\n\t\t\tFATHOM_CUA_WORKSPACE_ID: workspaceId,\n\t\t\tFATHOM_IPC_ROOT: ipcRoot,\n\t\t}).filter((entry): entry is [string, string] => Boolean(entry[1])),\n\t);\n\n\treturn {\n\t\tname: getEnvValue(NAME_ENV_VARS) ?? DEFAULT_SERVER_NAME,\n\t\ttransport: \"stdio\",\n\t\tcommand,\n\t\targs,\n\t\tcwd,\n\t\tenv,\n\t\tscope: \"plugin\",\n\t};\n}\n\nexport function getFathomCuaPluginServers(): McpServerConfig[] {\n\tif (envFlagDisabled(ENABLED_ENV_VARS) || !envFlagEnabled(ENABLED_ENV_VARS)) {\n\t\treturn [];\n\t}\n\treturn [buildFathomCuaServer()];\n}\n"]}

package/dist/mcp/index.d.ts

@@ -5,6 +5,7 @@ export { buildMcpToolName, isMcpTool, parseMcpToolName } from "./names.js";
 export { defaultEnvValidators, evaluateEnvValidators, type EnvValidator, type EnvValidatorResult, } from "./env-limits.js";
 export { getMcpRemoteHost, getOfficialMcpRegistryUrls, getOfficialMcpRegistryEntries, getOfficialMcpRegistryMatch, normalizeMcpRemoteUrl, officialMcpRegistryEntryMatchesUrl, prefetchOfficialMcpRegistry, resetOfficialMcpRegistryCacheForTesting, resolveOfficialMcpRegistryEntry, searchOfficialMcpRegistry, setOfficialMcpRegistryCacheForTesting, buildSuggestedMcpServerName, } from "./official-registry.js";
 export { buildProjectMcpServerFingerprint, getProjectMcpServerApprovalStatus, setProjectMcpServerApprovalDecision, } from "./project-approvals.js";
+export { getFathomCuaPluginServers } from "./fathom-cua.js";
 export { getPlatformMcpPluginServers } from "./platform-plugin.js";
 export type { McpAuthPresetConfig, McpAuthPresetStatus, McpConfig, McpOfficialRegistryEntry, McpOfficialRegistryInfo, McpOfficialRegistryUrlOption, McpProjectApprovalDecision, McpProjectApprovalStatus, McpServerConfig, McpServerStatus, McpManagerStatus, McpRemoteTrust, McpTransport, McpScope, } from "./types.js";
 export type { McpAuthPresetInput, McpServerInput } from "./schema.js";

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,uCAAuC,EACvC,+BAA+B,EAC/B,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACN,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,uCAAuC,EACvC,+BAA+B,EAC/B,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,QAAQ,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp/index.js

@@ -5,5 +5,6 @@ export { buildMcpToolName, isMcpTool, parseMcpToolName } from "./names.js";
 export { defaultEnvValidators, evaluateEnvValidators, } from "./env-limits.js";
 export { getMcpRemoteHost, getOfficialMcpRegistryUrls, getOfficialMcpRegistryEntries, getOfficialMcpRegistryMatch, normalizeMcpRemoteUrl, officialMcpRegistryEntryMatchesUrl, prefetchOfficialMcpRegistry, resetOfficialMcpRegistryCacheForTesting, resolveOfficialMcpRegistryEntry, searchOfficialMcpRegistry, setOfficialMcpRegistryCacheForTesting, buildSuggestedMcpServerName, } from "./official-registry.js";
 export { buildProjectMcpServerFingerprint, getProjectMcpServerApprovalStatus, setProjectMcpServerApprovalDecision, } from "./project-approvals.js";
+export { getFathomCuaPluginServers } from "./fathom-cua.js";
 export { getPlatformMcpPluginServers } from "./platform-plugin.js";
 //# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACN,oBAAoB,EACpB,qBAAqB,GAGrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,uCAAuC,EACvC,+BAA+B,EAC/B,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export {\n\taddMcpAuthPresetToConfig,\n\taddMcpServerToConfig,\n\tgetConfigPaths,\n\tgetWritableMcpConfigPath,\n\tinferRemoteMcpTransport,\n\tloadMcpConfig,\n\tremoveMcpAuthPresetFromConfig,\n\tremoveMcpServerFromConfig,\n\tupdateMcpAuthPresetInConfig,\n\tupdateMcpServerInConfig,\n\ttype WritableMcpScope,\n} from \"./config.js\";\nexport { mcpManager, McpClientManager } from \"./manager.js\";\nexport {\n\tcreateMcpToolWrapper,\n\tgetAllMcpTools,\n\tgetMcpToolMap,\n} from \"./tool-bridge.js\";\nexport { buildMcpToolName, isMcpTool, parseMcpToolName } from \"./names.js\";\nexport {\n\tdefaultEnvValidators,\n\tevaluateEnvValidators,\n\ttype EnvValidator,\n\ttype EnvValidatorResult,\n} from \"./env-limits.js\";\nexport {\n\tgetMcpRemoteHost,\n\tgetOfficialMcpRegistryUrls,\n\tgetOfficialMcpRegistryEntries,\n\tgetOfficialMcpRegistryMatch,\n\tnormalizeMcpRemoteUrl,\n\tofficialMcpRegistryEntryMatchesUrl,\n\tprefetchOfficialMcpRegistry,\n\tresetOfficialMcpRegistryCacheForTesting,\n\tresolveOfficialMcpRegistryEntry,\n\tsearchOfficialMcpRegistry,\n\tsetOfficialMcpRegistryCacheForTesting,\n\tbuildSuggestedMcpServerName,\n} from \"./official-registry.js\";\nexport {\n\tbuildProjectMcpServerFingerprint,\n\tgetProjectMcpServerApprovalStatus,\n\tsetProjectMcpServerApprovalDecision,\n} from \"./project-approvals.js\";\nexport { getPlatformMcpPluginServers } from \"./platform-plugin.js\";\nexport type {\n\tMcpAuthPresetConfig,\n\tMcpAuthPresetStatus,\n\tMcpConfig,\n\tMcpOfficialRegistryEntry,\n\tMcpOfficialRegistryInfo,\n\tMcpOfficialRegistryUrlOption,\n\tMcpProjectApprovalDecision,\n\tMcpProjectApprovalStatus,\n\tMcpServerConfig,\n\tMcpServerStatus,\n\tMcpManagerStatus,\n\tMcpRemoteTrust,\n\tMcpTransport,\n\tMcpScope,\n} from \"./types.js\";\nexport type { McpAuthPresetInput, McpServerInput } from \"./schema.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,6BAA6B,EAC7B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EACN,oBAAoB,EACpB,qBAAqB,GAGrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,uCAAuC,EACvC,+BAA+B,EAC/B,yBAAyB,EACzB,qCAAqC,EACrC,2BAA2B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,gCAAgC,EAChC,iCAAiC,EACjC,mCAAmC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export {\n\taddMcpAuthPresetToConfig,\n\taddMcpServerToConfig,\n\tgetConfigPaths,\n\tgetWritableMcpConfigPath,\n\tinferRemoteMcpTransport,\n\tloadMcpConfig,\n\tremoveMcpAuthPresetFromConfig,\n\tremoveMcpServerFromConfig,\n\tupdateMcpAuthPresetInConfig,\n\tupdateMcpServerInConfig,\n\ttype WritableMcpScope,\n} from \"./config.js\";\nexport { mcpManager, McpClientManager } from \"./manager.js\";\nexport {\n\tcreateMcpToolWrapper,\n\tgetAllMcpTools,\n\tgetMcpToolMap,\n} from \"./tool-bridge.js\";\nexport { buildMcpToolName, isMcpTool, parseMcpToolName } from \"./names.js\";\nexport {\n\tdefaultEnvValidators,\n\tevaluateEnvValidators,\n\ttype EnvValidator,\n\ttype EnvValidatorResult,\n} from \"./env-limits.js\";\nexport {\n\tgetMcpRemoteHost,\n\tgetOfficialMcpRegistryUrls,\n\tgetOfficialMcpRegistryEntries,\n\tgetOfficialMcpRegistryMatch,\n\tnormalizeMcpRemoteUrl,\n\tofficialMcpRegistryEntryMatchesUrl,\n\tprefetchOfficialMcpRegistry,\n\tresetOfficialMcpRegistryCacheForTesting,\n\tresolveOfficialMcpRegistryEntry,\n\tsearchOfficialMcpRegistry,\n\tsetOfficialMcpRegistryCacheForTesting,\n\tbuildSuggestedMcpServerName,\n} from \"./official-registry.js\";\nexport {\n\tbuildProjectMcpServerFingerprint,\n\tgetProjectMcpServerApprovalStatus,\n\tsetProjectMcpServerApprovalDecision,\n} from \"./project-approvals.js\";\nexport { getFathomCuaPluginServers } from \"./fathom-cua.js\";\nexport { getPlatformMcpPluginServers } from \"./platform-plugin.js\";\nexport type {\n\tMcpAuthPresetConfig,\n\tMcpAuthPresetStatus,\n\tMcpConfig,\n\tMcpOfficialRegistryEntry,\n\tMcpOfficialRegistryInfo,\n\tMcpOfficialRegistryUrlOption,\n\tMcpProjectApprovalDecision,\n\tMcpProjectApprovalStatus,\n\tMcpServerConfig,\n\tMcpServerStatus,\n\tMcpManagerStatus,\n\tMcpRemoteTrust,\n\tMcpTransport,\n\tMcpScope,\n} from \"./types.js\";\nexport type { McpAuthPresetInput, McpServerInput } from \"./schema.js\";\n"]}

package/dist/node_modules/@evalops/contracts/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@evalops/contracts",
-	"version": "0.10.21",
+	"version": "0.10.22",
 	"description": "Shared Maestro contracts for frontend/backend integration",
 	"type": "module",
 	"main": "./dist/index.js",

package/dist/node_modules/@evalops/tui/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@evalops/tui",
-	"version": "0.10.21",
+	"version": "0.10.22",
 	"description": "Terminal UI library with differential rendering for Maestro",
 	"type": "module",
 	"main": "./dist/index.js",

package/dist/platform/a2a-cockpit.d.ts

@@ -0,0 +1,90 @@
+import { type A2AFleetSummary } from "./a2a-fleet.js";
+import { type A2AOwnershipScope } from "./a2a-ownership.js";
+import { type A2ATaskLedgerFile } from "./a2a-task-ledger.js";
+import type { A2AWorkGraphMetadata } from "./a2a-work-graph.js";
+export type A2ACockpitTaskStatus = "waiting" | "running" | "completed" | "failed" | "unknown";
+export type A2ACockpitNextActionSeverity = "info" | "warning" | "critical";
+export interface A2ACockpitOptions {
+    registryPath?: string;
+    tasksPath?: string;
+    timeoutMs?: number;
+    peer?: string;
+    limit?: number;
+    ownershipScope?: A2AOwnershipScope;
+}
+export interface A2ACockpitSummary {
+    generatedAt: string;
+    registryPath: string;
+    tasksPath: string;
+    peer?: string;
+    counts: A2ACockpitCounts;
+    peers: A2ACockpitPeerSummary[];
+    tasks: A2ACockpitTaskSummary[];
+    nextActions: A2ACockpitNextAction[];
+}
+export interface A2ACockpitCounts {
+    peers: number;
+    onlinePeers: number;
+    unreachablePeers: number;
+    tasks: number;
+    runningTasks: number;
+    actionRequiredTasks: number;
+    failedTasks: number;
+    completedTasks: number;
+}
+export interface A2ACockpitPeerSummary {
+    name: string;
+    displayName?: string;
+    url: string;
+    status: "online" | "unreachable";
+    error?: string;
+    auth?: string;
+    model?: string;
+    cwd?: string;
+    taskCounts: Pick<A2ACockpitCounts, "tasks" | "runningTasks" | "actionRequiredTasks" | "failedTasks" | "completedTasks">;
+    lastTask?: {
+        id: string;
+        state: string;
+        status: A2ACockpitTaskStatus;
+        updatedAt: string;
+        text: string;
+    };
+}
+export interface A2ACockpitTaskSummary {
+    ledgerId: string;
+    peer: string;
+    peerDisplayName?: string;
+    orphanedPeer?: boolean;
+    taskId: string;
+    state: string;
+    status: A2ACockpitTaskStatus;
+    requiresInput: boolean;
+    terminal: boolean;
+    final: boolean;
+    text: string;
+    responseText?: string;
+    updatedAt: string;
+    completedAt?: string;
+    workGraph?: A2AWorkGraphMetadata;
+    nextCommand?: string;
+}
+export interface A2ACockpitNextAction {
+    id: string;
+    label: string;
+    command: string;
+    severity: A2ACockpitNextActionSeverity;
+    peer: string;
+    taskId?: string;
+    reason: string;
+}
+export interface SummarizeA2ACockpitInput {
+    fleet: A2AFleetSummary;
+    ledger: A2ATaskLedgerFile;
+    peer?: string;
+    limit?: number;
+    generatedAt?: string;
+    ownershipScope?: A2AOwnershipScope;
+}
+export declare function buildA2ACockpit(options?: A2ACockpitOptions): Promise<A2ACockpitSummary>;
+export declare function summarizeA2ACockpit(input: SummarizeA2ACockpitInput): A2ACockpitSummary;
+//# sourceMappingURL=a2a-cockpit.d.ts.map

package/dist/platform/a2a-cockpit.d.ts.map

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

package/dist/platform/a2a-cockpit.js

@@ -0,0 +1,302 @@
+import { inspectA2AFleet } from "./a2a-fleet.js";
+import { hasA2AOwnershipRecordMarkers, hasA2AOwnershipScope, matchesA2AOwnershipScope, } from "./a2a-ownership.js";
+import { isActionRequiredA2AState, isFinalA2AState, isTerminalA2AState, listA2ATaskEntries, loadA2ATaskLedger, } from "./a2a-task-ledger.js";
+export async function buildA2ACockpit(options = {}) {
+    if (!hasA2AOwnershipScope(options.ownershipScope)) {
+        return buildA2ACockpitUnscoped(options);
+    }
+    const ledger = await loadA2ATaskLedger({ path: options.tasksPath });
+    const fleet = await inspectA2AFleet({
+        registryPath: options.registryPath,
+        tasksPath: options.tasksPath,
+        timeoutMs: options.timeoutMs,
+        ownershipScope: options.ownershipScope,
+        includePeerNames: scopedLedgerPeerNames(ledger, options.ownershipScope),
+    });
+    return summarizeA2ACockpit({
+        fleet,
+        ledger,
+        peer: options.peer,
+        limit: options.limit,
+        ownershipScope: options.ownershipScope,
+    });
+}
+async function buildA2ACockpitUnscoped(options) {
+    const [fleet, ledger] = await Promise.all([
+        inspectA2AFleet({
+            registryPath: options.registryPath,
+            tasksPath: options.tasksPath,
+            timeoutMs: options.timeoutMs,
+        }),
+        loadA2ATaskLedger({ path: options.tasksPath }),
+    ]);
+    return summarizeA2ACockpit({
+        fleet,
+        ledger,
+        peer: options.peer,
+        limit: options.limit,
+    });
+}
+export function summarizeA2ACockpit(input) {
+    const peerFilter = cleanPeer(input.peer);
+    const limit = normalizeLimit(input.limit);
+    const hasOwnershipScope = hasA2AOwnershipScope(input.ownershipScope);
+    const scopedOwnedPeerNames = new Set(hasOwnershipScope
+        ? input.fleet.peers
+            .filter((peer) => matchesA2AOwnershipScope(peer, input.ownershipScope))
+            .map((peer) => peer.name)
+        : []);
+    const scopedLedger = filterLedgerForOwnership(input.ledger, input.ownershipScope, scopedOwnedPeerNames);
+    const scopedTaskPeerNames = new Set(scopedLedger.tasks.map((task) => task.peer));
+    const peers = input.fleet.peers
+        .filter((peer) => !hasOwnershipScope ||
+        scopedOwnedPeerNames.has(peer.name) ||
+        scopedTaskPeerNames.has(peer.name))
+        .filter((peer) => !peerFilter || peer.name === peerFilter)
+        .map((peer) => summarizePeer(peer, scopedLedger));
+    const registeredPeerNames = new Set(peers.map((peer) => peer.name));
+    const tasks = listA2ATaskEntries(scopedLedger, { peer: peerFilter })
+        .map((task) => summarizeTask(task, registeredPeerNames))
+        .sort(compareTasksForCockpit);
+    const limitedTasks = tasks.slice(0, limit);
+    const counts = summarizeCounts(peers, tasks);
+    return {
+        generatedAt: input.generatedAt ?? input.fleet.generatedAt,
+        registryPath: input.fleet.registryPath,
+        tasksPath: input.fleet.tasksPath,
+        ...(peerFilter ? { peer: peerFilter } : {}),
+        counts,
+        peers,
+        tasks: limitedTasks,
+        nextActions: summarizeNextActions(peers, tasks, limit),
+    };
+}
+function filterLedgerForOwnership(ledger, scope, ownedPeerNames = new Set()) {
+    if (!hasA2AOwnershipScope(scope)) {
+        return ledger;
+    }
+    return {
+        tasks: ledger.tasks.filter((entry) => hasA2AOwnershipRecordMarkers(entry)
+            ? matchesA2AOwnershipScope(entry, scope)
+            : ownedPeerNames.has(entry.peer)),
+    };
+}
+function scopedLedgerPeerNames(ledger, scope) {
+    return [
+        ...new Set(ledger.tasks
+            .filter((entry) => hasA2AOwnershipRecordMarkers(entry) &&
+            matchesA2AOwnershipScope(entry, scope))
+            .map((entry) => entry.peer)),
+    ];
+}
+function summarizePeer(peer, ledger) {
+    const tasks = listA2ATaskEntries(ledger, { peer: peer.name }).map((task) => summarizeTask(task));
+    const lastTask = tasks[0];
+    return {
+        name: peer.name,
+        ...(peer.displayName ? { displayName: peer.displayName } : {}),
+        url: peer.url,
+        status: peer.status,
+        ...(peer.error ? { error: peer.error } : {}),
+        ...(peer.auth ? { auth: peer.auth } : {}),
+        ...(peer.model ? { model: peer.model } : {}),
+        ...(peer.cwd ? { cwd: peer.cwd } : {}),
+        taskCounts: {
+            tasks: tasks.length,
+            runningTasks: tasks.filter((task) => task.status === "running").length,
+            actionRequiredTasks: tasks.filter((task) => task.status === "waiting")
+                .length,
+            failedTasks: tasks.filter((task) => task.status === "failed").length,
+            completedTasks: tasks.filter((task) => task.status === "completed")
+                .length,
+        },
+        ...(lastTask
+            ? {
+                lastTask: {
+                    id: lastTask.taskId,
+                    state: lastTask.state,
+                    status: lastTask.status,
+                    updatedAt: lastTask.updatedAt,
+                    text: lastTask.text,
+                },
+            }
+            : {}),
+    };
+}
+function summarizeTask(entry, registeredPeerNames) {
+    const status = classifyTaskState(entry.state);
+    const requiresInput = isActionRequiredA2AState(entry.state);
+    const terminal = isTerminalA2AState(entry.state);
+    const final = isFinalA2AState(entry.state);
+    const orphanedPeer = registeredPeerNames !== undefined && !registeredPeerNames.has(entry.peer);
+    const nextCommand = orphanedPeer ? undefined : taskCommand(entry, status);
+    return {
+        ledgerId: entry.id,
+        peer: entry.peer,
+        ...(entry.peerDisplayName
+            ? { peerDisplayName: entry.peerDisplayName }
+            : {}),
+        ...(orphanedPeer ? { orphanedPeer: true } : {}),
+        taskId: entry.taskId,
+        state: entry.state,
+        status,
+        requiresInput,
+        terminal,
+        final,
+        text: entry.text,
+        ...(entry.responseText ? { responseText: entry.responseText } : {}),
+        updatedAt: entry.updatedAt,
+        ...(entry.completedAt ? { completedAt: entry.completedAt } : {}),
+        ...(entry.workGraph ? { workGraph: entry.workGraph } : {}),
+        ...(nextCommand ? { nextCommand } : {}),
+    };
+}
+function summarizeCounts(peers, tasks) {
+    return {
+        peers: peers.length,
+        onlinePeers: peers.filter((peer) => peer.status === "online").length,
+        unreachablePeers: peers.filter((peer) => peer.status === "unreachable")
+            .length,
+        tasks: tasks.length,
+        runningTasks: tasks.filter((task) => task.status === "running").length,
+        actionRequiredTasks: tasks.filter((task) => task.status === "waiting")
+            .length,
+        failedTasks: tasks.filter((task) => task.status === "failed").length,
+        completedTasks: tasks.filter((task) => task.status === "completed").length,
+    };
+}
+function summarizeNextActions(peers, tasks, limit) {
+    const actions = tasks
+        .map((task) => nextActionForTask(task))
+        .filter((action) => Boolean(action))
+        .slice(0, limit);
+    if (actions.length > 0) {
+        return actions;
+    }
+    return peers
+        .filter((peer) => peer.status === "online" && peer.taskCounts.runningTasks === 0)
+        .slice(0, limit)
+        .map((peer) => ({
+        id: `delegate:${peer.name}`,
+        label: `Delegate fresh work to ${peer.name}`,
+        command: `maestro a2a delegate ${shellQuote(peer.name)} <objective> --wait --work-graph`,
+        severity: "info",
+        peer: peer.name,
+        reason: "Peer is reachable and has no active local A2A task in the ledger.",
+    }));
+}
+function nextActionForTask(task) {
+    if (task.orphanedPeer) {
+        return undefined;
+    }
+    if (task.status === "waiting") {
+        return {
+            id: `reply:${task.peer}:${task.taskId}`,
+            label: `Reply to ${task.peer} task ${task.taskId}`,
+            command: `maestro a2a reply ${shellQuote(task.peer)} ${shellQuote(task.taskId)} <response> --wait --work-graph`,
+            severity: "critical",
+            peer: task.peer,
+            taskId: task.taskId,
+            reason: "Peer returned an input-required or auth-required A2A state.",
+        };
+    }
+    if (task.status === "running") {
+        return {
+            id: `wait:${task.peer}:${task.taskId}`,
+            label: `Wait for ${task.peer} task ${task.taskId}`,
+            command: task.nextCommand ??
+                `maestro a2a wait ${shellQuote(task.peer)} ${shellQuote(task.taskId)} --work-graph`,
+            severity: "info",
+            peer: task.peer,
+            taskId: task.taskId,
+            reason: "Task is still non-terminal in the local A2A ledger.",
+        };
+    }
+    if (task.status === "failed") {
+        return {
+            id: `refresh:${task.peer}:${task.taskId}`,
+            label: `Refresh failed ${task.peer} task ${task.taskId}`,
+            command: `maestro a2a tasks ${shellQuote(task.peer)} --refresh --work-graph`,
+            severity: "warning",
+            peer: task.peer,
+            taskId: task.taskId,
+            reason: "Task reached a failed, rejected, or canceled final state.",
+        };
+    }
+    return undefined;
+}
+function taskCommand(entry, status) {
+    if (status === "waiting") {
+        return `maestro a2a reply ${shellQuote(entry.peer)} ${shellQuote(entry.taskId)} <response> --wait --work-graph`;
+    }
+    if (status === "running") {
+        return `maestro a2a wait ${shellQuote(entry.peer)} ${shellQuote(entry.taskId)} --work-graph`;
+    }
+    return undefined;
+}
+function classifyTaskState(state) {
+    const normalized = normalizeState(state);
+    if (!normalized) {
+        return "unknown";
+    }
+    if (isActionRequiredA2AState(normalized)) {
+        return "waiting";
+    }
+    if (normalized.includes("COMPLETED")) {
+        return "completed";
+    }
+    if (normalized.includes("FAILED") ||
+        normalized.includes("REJECTED") ||
+        normalized.includes("CANCELED") ||
+        normalized.includes("CANCELLED")) {
+        return "failed";
+    }
+    if (!isFinalA2AState(normalized)) {
+        return "running";
+    }
+    return "unknown";
+}
+function compareTasksForCockpit(left, right) {
+    const urgency = taskUrgency(right.status) - taskUrgency(left.status);
+    if (urgency !== 0) {
+        return urgency;
+    }
+    return right.updatedAt.localeCompare(left.updatedAt);
+}
+function taskUrgency(status) {
+    switch (status) {
+        case "waiting":
+            return 4;
+        case "failed":
+            return 3;
+        case "running":
+            return 2;
+        case "unknown":
+            return 1;
+        case "completed":
+            return 0;
+    }
+}
+function normalizeLimit(limit) {
+    if (limit === undefined) {
+        return 8;
+    }
+    if (!Number.isFinite(limit) || limit <= 0) {
+        return 8;
+    }
+    return Math.min(Math.floor(limit), 50);
+}
+function cleanPeer(peer) {
+    const trimmed = peer?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function normalizeState(state) {
+    return state.toUpperCase().replace(/[\s-]+/gu, "_");
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:-]+$/u.test(value)) {
+        return value;
+    }
+    return `'${value.replace(/'/gu, "'\\''")}'`;
+}
+//# sourceMappingURL=a2a-cockpit.js.map