@evalops/maestro 0.10.21 → 0.10.23

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/dist/artifacts.d.ts

@@ -0,0 +1,58 @@
+export type ArtifactsCommand = "create" | "update" | "rewrite" | "get" | "delete" | "logs";
+export type ArtifactCommandErrorCode = "artifact.command_missing" | "artifact.command_unknown" | "artifact.filename_missing" | "artifact.filename_invalid" | "artifact.exists" | "artifact.not_found" | "artifact.update_args_missing" | "artifact.update_empty_old_str" | "artifact.update_old_str_not_found";
+export type ArtifactCommandSuccessCode = "artifact.created" | "artifact.rewritten" | "artifact.updated" | "artifact.read" | "artifact.deleted" | "artifact.logs_requested";
+export type ArtifactCommandResultCode = ArtifactCommandErrorCode | ArtifactCommandSuccessCode;
+export interface ArtifactsArgs {
+    command?: ArtifactsCommand | string;
+    filename?: string;
+    content?: string;
+    old_str?: string;
+    new_str?: string;
+}
+export interface Artifact {
+    filename: string;
+    content: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ArtifactsState {
+    byFilename: Map<string, Artifact>;
+}
+export interface ArtifactCommandResult {
+    state: ArtifactsState;
+    output: string;
+    isError: boolean;
+    code: ArtifactCommandResultCode;
+    mutated: boolean;
+}
+export interface ArtifactReplayDiagnostic {
+    code: ArtifactCommandResultCode;
+    command?: string;
+    filename?: string;
+    isError: boolean;
+    mutated: boolean;
+    output: string;
+}
+export interface ArtifactReplayOptions {
+    onDiagnostic?: (diagnostic: ArtifactReplayDiagnostic) => void;
+}
+export interface ArtifactReplayToolCall {
+    id?: unknown;
+    name?: string;
+    status?: string;
+    toolCallId?: unknown;
+    args?: unknown;
+    result?: unknown;
+}
+export interface ArtifactReplayMessage {
+    content?: unknown;
+    role?: unknown;
+    tools?: ArtifactReplayToolCall[];
+}
+export declare function createEmptyArtifactsState(): ArtifactsState;
+export declare function isValidArtifactFilename(filename: string): boolean;
+export declare function coerceArtifactsArgs(value: unknown): ArtifactsArgs;
+export declare function applyArtifactsCommand(state: ArtifactsState, args: ArtifactsArgs): ArtifactCommandResult;
+export declare function artifactContentsByFilename(state: ArtifactsState): Map<string, string>;
+export declare function reconstructArtifactsFromMessages(messages: ArtifactReplayMessage[], options?: ArtifactReplayOptions): ArtifactsState;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/node_modules/@evalops/contracts/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACzB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,KAAK,GACL,QAAQ,GACR,MAAM,CAAC;AAEV,MAAM,MAAM,wBAAwB,GACjC,0BAA0B,GAC1B,0BAA0B,GAC1B,2BAA2B,GAC3B,2BAA2B,GAC3B,iBAAiB,GACjB,oBAAoB,GACpB,8BAA8B,GAC9B,+BAA+B,GAC/B,mCAAmC,CAAC;AAEvC,MAAM,MAAM,0BAA0B,GACnC,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,yBAAyB,CAAC;AAE7B,MAAM,MAAM,yBAAyB,GAClC,wBAAwB,GACxB,0BAA0B,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACrC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,sBAAsB;IACtC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAWD,wBAAgB,yBAAyB,IAAI,cAAc,CAE1D;AAkBD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQjE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAUjE;AA+BD,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,GACjB,qBAAqB,CAsKvB;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,cAAc,GACnB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrB;AAED,wBAAgB,gCAAgC,CAC/C,QAAQ,EAAE,qBAAqB,EAAE,EACjC,OAAO,GAAE,qBAA0B,GACjC,cAAc,CAgChB"}

package/dist/node_modules/@evalops/contracts/dist/artifacts.js

@@ -0,0 +1,191 @@
+const ARTIFACT_COMMANDS = new Set([
+    "create",
+    "update",
+    "rewrite",
+    "get",
+    "delete",
+    "logs",
+]);
+export function createEmptyArtifactsState() {
+    return { byFilename: new Map() };
+}
+function asString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function isValidArtifactCommand(command) {
+    return typeof command === "string" && ARTIFACT_COMMANDS.has(command);
+}
+function hasControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < 32 || code === 127)
+            return true;
+    }
+    return false;
+}
+export function isValidArtifactFilename(filename) {
+    return (filename.length > 0 &&
+        !filename.includes("..") &&
+        !filename.includes("/") &&
+        !filename.includes("\\") &&
+        !hasControlCharacter(filename));
+}
+export function coerceArtifactsArgs(value) {
+    if (!value || typeof value !== "object")
+        return {};
+    const v = value;
+    return {
+        command: asString(v.command),
+        filename: asString(v.filename),
+        content: asString(v.content),
+        old_str: asString(v.old_str),
+        new_str: asString(v.new_str),
+    };
+}
+function artifactError(state, code, message) {
+    return {
+        state,
+        output: `Error [${code}]: ${message}`,
+        isError: true,
+        code,
+        mutated: false,
+    };
+}
+function artifactSuccess(state, code, output, mutated) {
+    return {
+        state,
+        output,
+        isError: false,
+        code,
+        mutated,
+    };
+}
+export function applyArtifactsCommand(state, args) {
+    const command = args.command;
+    const filename = args.filename?.trim();
+    if (!command) {
+        return artifactError(state, "artifact.command_missing", "missing command");
+    }
+    if (!isValidArtifactCommand(command)) {
+        return artifactError(state, "artifact.command_unknown", `unknown command: ${command}`);
+    }
+    if (!filename) {
+        return artifactError(state, "artifact.filename_missing", "missing filename");
+    }
+    if (!isValidArtifactFilename(filename)) {
+        return artifactError(state, "artifact.filename_invalid", "invalid filename");
+    }
+    const current = state.byFilename.get(filename);
+    switch (command) {
+        case "create": {
+            if (current) {
+                return artifactError(state, "artifact.exists", `${filename} already exists`);
+            }
+            const content = args.content ?? "";
+            const now = Date.now();
+            const next = new Map(state.byFilename);
+            next.set(filename, {
+                filename,
+                content,
+                createdAt: now,
+                updatedAt: now,
+            });
+            return artifactSuccess({ byFilename: next }, "artifact.created", `Created ${filename}`, true);
+        }
+        case "rewrite": {
+            if (!current) {
+                return artifactError(state, "artifact.not_found", `${filename} not found`);
+            }
+            const content = args.content ?? "";
+            const next = new Map(state.byFilename);
+            next.set(filename, { ...current, content, updatedAt: Date.now() });
+            return artifactSuccess({ byFilename: next }, "artifact.rewritten", `Rewrote ${filename}`, true);
+        }
+        case "update": {
+            if (!current) {
+                return artifactError(state, "artifact.not_found", `${filename} not found`);
+            }
+            const oldStr = args.old_str;
+            const newStr = args.new_str;
+            if (oldStr === undefined || newStr === undefined) {
+                return artifactError(state, "artifact.update_args_missing", "update requires old_str and new_str");
+            }
+            if (oldStr.length === 0) {
+                return artifactError(state, "artifact.update_empty_old_str", "update requires non-empty old_str");
+            }
+            if (!current.content.includes(oldStr)) {
+                return artifactError(state, "artifact.update_old_str_not_found", `old_str not found in ${filename}`);
+            }
+            const nextContent = current.content.replace(oldStr, newStr);
+            const next = new Map(state.byFilename);
+            next.set(filename, {
+                ...current,
+                content: nextContent,
+                updatedAt: Date.now(),
+            });
+            return artifactSuccess({ byFilename: next }, "artifact.updated", `Updated ${filename}`, true);
+        }
+        case "get": {
+            if (!current) {
+                return artifactError(state, "artifact.not_found", `${filename} not found`);
+            }
+            return artifactSuccess(state, "artifact.read", current.content, false);
+        }
+        case "delete": {
+            if (!current) {
+                return artifactError(state, "artifact.not_found", `${filename} not found`);
+            }
+            const next = new Map(state.byFilename);
+            next.delete(filename);
+            return artifactSuccess({ byFilename: next }, "artifact.deleted", `Deleted ${filename}`, true);
+        }
+        case "logs": {
+            if (!current) {
+                return artifactError(state, "artifact.not_found", `${filename} not found`);
+            }
+            return artifactSuccess(state, "artifact.logs_requested", `Logs requested for ${filename}`, false);
+        }
+    }
+}
+export function artifactContentsByFilename(state) {
+    return new Map(Array.from(state.byFilename.entries(), ([filename, artifact]) => [
+        filename,
+        artifact.content,
+    ]));
+}
+export function reconstructArtifactsFromMessages(messages, options = {}) {
+    let state = createEmptyArtifactsState();
+    for (const msg of messages) {
+        const toolCalls = msg.tools ?? [];
+        for (const tool of toolCalls) {
+            if (tool.name !== "artifacts")
+                continue;
+            if (tool.status !== "completed")
+                continue;
+            if (tool.result && typeof tool.result === "object") {
+                const maybeErr = tool.result;
+                if (maybeErr.isError)
+                    continue;
+            }
+            const args = coerceArtifactsArgs(tool.args);
+            // Ignore get/logs for reconstruction; they don't change state.
+            if (args.command === "get" || args.command === "logs")
+                continue;
+            const result = applyArtifactsCommand(state, args);
+            if (result.isError || !result.mutated) {
+                options.onDiagnostic?.({
+                    code: result.code,
+                    command: args.command,
+                    filename: args.filename,
+                    isError: result.isError,
+                    mutated: result.mutated,
+                    output: result.output,
+                });
+                continue;
+            }
+            state = result.state;
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/node_modules/@evalops/contracts/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"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","sourcesContent":["export type ArtifactsCommand =\n\t| \"create\"\n\t| \"update\"\n\t| \"rewrite\"\n\t| \"get\"\n\t| \"delete\"\n\t| \"logs\";\n\nexport type ArtifactCommandErrorCode =\n\t| \"artifact.command_missing\"\n\t| \"artifact.command_unknown\"\n\t| \"artifact.filename_missing\"\n\t| \"artifact.filename_invalid\"\n\t| \"artifact.exists\"\n\t| \"artifact.not_found\"\n\t| \"artifact.update_args_missing\"\n\t| \"artifact.update_empty_old_str\"\n\t| \"artifact.update_old_str_not_found\";\n\nexport type ArtifactCommandSuccessCode =\n\t| \"artifact.created\"\n\t| \"artifact.rewritten\"\n\t| \"artifact.updated\"\n\t| \"artifact.read\"\n\t| \"artifact.deleted\"\n\t| \"artifact.logs_requested\";\n\nexport type ArtifactCommandResultCode =\n\t| ArtifactCommandErrorCode\n\t| ArtifactCommandSuccessCode;\n\nexport interface ArtifactsArgs {\n\tcommand?: ArtifactsCommand | string;\n\tfilename?: string;\n\tcontent?: string;\n\told_str?: string;\n\tnew_str?: string;\n}\n\nexport interface Artifact {\n\tfilename: string;\n\tcontent: string;\n\tcreatedAt: number;\n\tupdatedAt: number;\n}\n\nexport interface ArtifactsState {\n\tbyFilename: Map<string, Artifact>;\n}\n\nexport interface ArtifactCommandResult {\n\tstate: ArtifactsState;\n\toutput: string;\n\tisError: boolean;\n\tcode: ArtifactCommandResultCode;\n\tmutated: boolean;\n}\n\nexport interface ArtifactReplayDiagnostic {\n\tcode: ArtifactCommandResultCode;\n\tcommand?: string;\n\tfilename?: string;\n\tisError: boolean;\n\tmutated: boolean;\n\toutput: string;\n}\n\nexport interface ArtifactReplayOptions {\n\tonDiagnostic?: (diagnostic: ArtifactReplayDiagnostic) => void;\n}\n\nexport interface ArtifactReplayToolCall {\n\tid?: unknown;\n\tname?: string;\n\tstatus?: string;\n\ttoolCallId?: unknown;\n\targs?: unknown;\n\tresult?: unknown;\n}\n\nexport interface ArtifactReplayMessage {\n\tcontent?: unknown;\n\trole?: unknown;\n\ttools?: ArtifactReplayToolCall[];\n}\n\nconst ARTIFACT_COMMANDS = new Set<string>([\n\t\"create\",\n\t\"update\",\n\t\"rewrite\",\n\t\"get\",\n\t\"delete\",\n\t\"logs\",\n]);\n\nexport function createEmptyArtifactsState(): ArtifactsState {\n\treturn { byFilename: new Map<string, Artifact>() };\n}\n\nfunction asString(value: unknown): string | undefined {\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nfunction isValidArtifactCommand(command: unknown): command is ArtifactsCommand {\n\treturn typeof command === \"string\" && ARTIFACT_COMMANDS.has(command);\n}\n\nfunction hasControlCharacter(value: string): boolean {\n\tfor (let index = 0; index < value.length; index += 1) {\n\t\tconst code = value.charCodeAt(index);\n\t\tif (code < 32 || code === 127) return true;\n\t}\n\treturn false;\n}\n\nexport function isValidArtifactFilename(filename: string): boolean {\n\treturn (\n\t\tfilename.length > 0 &&\n\t\t!filename.includes(\"..\") &&\n\t\t!filename.includes(\"/\") &&\n\t\t!filename.includes(\"\\\\\") &&\n\t\t!hasControlCharacter(filename)\n\t);\n}\n\nexport function coerceArtifactsArgs(value: unknown): ArtifactsArgs {\n\tif (!value || typeof value !== \"object\") return {};\n\tconst v = value as Record<string, unknown>;\n\treturn {\n\t\tcommand: asString(v.command),\n\t\tfilename: asString(v.filename),\n\t\tcontent: asString(v.content),\n\t\told_str: asString(v.old_str),\n\t\tnew_str: asString(v.new_str),\n\t};\n}\n\nfunction artifactError(\n\tstate: ArtifactsState,\n\tcode: ArtifactCommandErrorCode,\n\tmessage: string,\n): ArtifactCommandResult {\n\treturn {\n\t\tstate,\n\t\toutput: `Error [${code}]: ${message}`,\n\t\tisError: true,\n\t\tcode,\n\t\tmutated: false,\n\t};\n}\n\nfunction artifactSuccess(\n\tstate: ArtifactsState,\n\tcode: ArtifactCommandSuccessCode,\n\toutput: string,\n\tmutated: boolean,\n): ArtifactCommandResult {\n\treturn {\n\t\tstate,\n\t\toutput,\n\t\tisError: false,\n\t\tcode,\n\t\tmutated,\n\t};\n}\n\nexport function applyArtifactsCommand(\n\tstate: ArtifactsState,\n\targs: ArtifactsArgs,\n): ArtifactCommandResult {\n\tconst command = args.command;\n\tconst filename = args.filename?.trim();\n\tif (!command) {\n\t\treturn artifactError(state, \"artifact.command_missing\", \"missing command\");\n\t}\n\tif (!isValidArtifactCommand(command)) {\n\t\treturn artifactError(\n\t\t\tstate,\n\t\t\t\"artifact.command_unknown\",\n\t\t\t`unknown command: ${command}`,\n\t\t);\n\t}\n\tif (!filename) {\n\t\treturn artifactError(\n\t\t\tstate,\n\t\t\t\"artifact.filename_missing\",\n\t\t\t\"missing filename\",\n\t\t);\n\t}\n\tif (!isValidArtifactFilename(filename)) {\n\t\treturn artifactError(\n\t\t\tstate,\n\t\t\t\"artifact.filename_invalid\",\n\t\t\t\"invalid filename\",\n\t\t);\n\t}\n\n\tconst current = state.byFilename.get(filename);\n\n\tswitch (command) {\n\t\tcase \"create\": {\n\t\t\tif (current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.exists\",\n\t\t\t\t\t`${filename} already exists`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst content = args.content ?? \"\";\n\t\t\tconst now = Date.now();\n\t\t\tconst next = new Map(state.byFilename);\n\t\t\tnext.set(filename, {\n\t\t\t\tfilename,\n\t\t\t\tcontent,\n\t\t\t\tcreatedAt: now,\n\t\t\t\tupdatedAt: now,\n\t\t\t});\n\t\t\treturn artifactSuccess(\n\t\t\t\t{ byFilename: next },\n\t\t\t\t\"artifact.created\",\n\t\t\t\t`Created ${filename}`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\n\t\tcase \"rewrite\": {\n\t\t\tif (!current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.not_found\",\n\t\t\t\t\t`${filename} not found`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst content = args.content ?? \"\";\n\t\t\tconst next = new Map(state.byFilename);\n\t\t\tnext.set(filename, { ...current, content, updatedAt: Date.now() });\n\t\t\treturn artifactSuccess(\n\t\t\t\t{ byFilename: next },\n\t\t\t\t\"artifact.rewritten\",\n\t\t\t\t`Rewrote ${filename}`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\n\t\tcase \"update\": {\n\t\t\tif (!current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.not_found\",\n\t\t\t\t\t`${filename} not found`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst oldStr = args.old_str;\n\t\t\tconst newStr = args.new_str;\n\t\t\tif (oldStr === undefined || newStr === undefined) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.update_args_missing\",\n\t\t\t\t\t\"update requires old_str and new_str\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (oldStr.length === 0) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.update_empty_old_str\",\n\t\t\t\t\t\"update requires non-empty old_str\",\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (!current.content.includes(oldStr)) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.update_old_str_not_found\",\n\t\t\t\t\t`old_str not found in ${filename}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst nextContent = current.content.replace(oldStr, newStr);\n\t\t\tconst next = new Map(state.byFilename);\n\t\t\tnext.set(filename, {\n\t\t\t\t...current,\n\t\t\t\tcontent: nextContent,\n\t\t\t\tupdatedAt: Date.now(),\n\t\t\t});\n\t\t\treturn artifactSuccess(\n\t\t\t\t{ byFilename: next },\n\t\t\t\t\"artifact.updated\",\n\t\t\t\t`Updated ${filename}`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\n\t\tcase \"get\": {\n\t\t\tif (!current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.not_found\",\n\t\t\t\t\t`${filename} not found`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn artifactSuccess(state, \"artifact.read\", current.content, false);\n\t\t}\n\n\t\tcase \"delete\": {\n\t\t\tif (!current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.not_found\",\n\t\t\t\t\t`${filename} not found`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst next = new Map(state.byFilename);\n\t\t\tnext.delete(filename);\n\t\t\treturn artifactSuccess(\n\t\t\t\t{ byFilename: next },\n\t\t\t\t\"artifact.deleted\",\n\t\t\t\t`Deleted ${filename}`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\n\t\tcase \"logs\": {\n\t\t\tif (!current) {\n\t\t\t\treturn artifactError(\n\t\t\t\t\tstate,\n\t\t\t\t\t\"artifact.not_found\",\n\t\t\t\t\t`${filename} not found`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn artifactSuccess(\n\t\t\t\tstate,\n\t\t\t\t\"artifact.logs_requested\",\n\t\t\t\t`Logs requested for ${filename}`,\n\t\t\t\tfalse,\n\t\t\t);\n\t\t}\n\t}\n}\n\nexport function artifactContentsByFilename(\n\tstate: ArtifactsState,\n): Map<string, string> {\n\treturn new Map(\n\t\tArray.from(state.byFilename.entries(), ([filename, artifact]) => [\n\t\t\tfilename,\n\t\t\tartifact.content,\n\t\t]),\n\t);\n}\n\nexport function reconstructArtifactsFromMessages(\n\tmessages: ArtifactReplayMessage[],\n\toptions: ArtifactReplayOptions = {},\n): ArtifactsState {\n\tlet state = createEmptyArtifactsState();\n\n\tfor (const msg of messages) {\n\t\tconst toolCalls = msg.tools ?? [];\n\t\tfor (const tool of toolCalls) {\n\t\t\tif (tool.name !== \"artifacts\") continue;\n\t\t\tif (tool.status !== \"completed\") continue;\n\t\t\tif (tool.result && typeof tool.result === \"object\") {\n\t\t\t\tconst maybeErr = tool.result as { isError?: boolean };\n\t\t\t\tif (maybeErr.isError) continue;\n\t\t\t}\n\t\t\tconst args = coerceArtifactsArgs(tool.args);\n\t\t\t// Ignore get/logs for reconstruction; they don't change state.\n\t\t\tif (args.command === \"get\" || args.command === \"logs\") continue;\n\t\t\tconst result = applyArtifactsCommand(state, args);\n\t\t\tif (result.isError || !result.mutated) {\n\t\t\t\toptions.onDiagnostic?.({\n\t\t\t\t\tcode: result.code,\n\t\t\t\t\tcommand: args.command,\n\t\t\t\t\tfilename: args.filename,\n\t\t\t\t\tisError: result.isError,\n\t\t\t\t\tmutated: result.mutated,\n\t\t\t\t\toutput: result.output,\n\t\t\t\t});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tstate = result.state;\n\t\t}\n\t}\n\n\treturn state;\n}\n"]}

package/dist/node_modules/@evalops/contracts/dist/headless-protocol-schemas.generated.d.ts

@@ -452,7 +452,7 @@ export declare const HeadlessServerRequestResolvedMessageSchema: import("@sincla
     request_id: import("@sinclair/typebox").TString;
     request_type: import("@sinclair/typebox").TUnsafe<"approval" | "client_tool" | "mcp_elicitation" | "user_input" | "tool_retry">;
     call_id: import("@sinclair/typebox").TString;
-    resolution: import("@sinclair/typebox").TUnsafe<"approved" | "denied" | "completed" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
+    resolution: import("@sinclair/typebox").TUnsafe<"completed" | "approved" | "denied" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
     reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     resolved_by: import("@sinclair/typebox").TUnsafe<"user" | "policy" | "client" | "runtime">;
     started_at_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
@@ -534,7 +534,7 @@ export declare const HeadlessUtilityFileWatchStartedMessageSchema: import("@sinc
 export declare const HeadlessUtilityFileWatchEventMessageSchema: import("@sinclair/typebox").TObject<{
     type: import("@sinclair/typebox").TLiteral<"utility_file_watch_event">;
     watch_id: import("@sinclair/typebox").TString;
-    change_type: import("@sinclair/typebox").TUnsafe<"create" | "modify" | "delete" | "rename">;
+    change_type: import("@sinclair/typebox").TUnsafe<"create" | "delete" | "modify" | "rename">;
     path: import("@sinclair/typebox").TString;
     relative_path: import("@sinclair/typebox").TString;
     timestamp: import("@sinclair/typebox").TNumber;
@@ -748,7 +748,7 @@ export declare const headlessFromAgentMessageSchemasByType: {
         request_id: import("@sinclair/typebox").TString;
         request_type: import("@sinclair/typebox").TUnsafe<"approval" | "client_tool" | "mcp_elicitation" | "user_input" | "tool_retry">;
         call_id: import("@sinclair/typebox").TString;
-        resolution: import("@sinclair/typebox").TUnsafe<"approved" | "denied" | "completed" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
+        resolution: import("@sinclair/typebox").TUnsafe<"completed" | "approved" | "denied" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
         reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         resolved_by: import("@sinclair/typebox").TUnsafe<"user" | "policy" | "client" | "runtime">;
         started_at_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
@@ -826,7 +826,7 @@ export declare const headlessFromAgentMessageSchemasByType: {
     readonly utility_file_watch_event: import("@sinclair/typebox").TObject<{
         type: import("@sinclair/typebox").TLiteral<"utility_file_watch_event">;
         watch_id: import("@sinclair/typebox").TString;
-        change_type: import("@sinclair/typebox").TUnsafe<"create" | "modify" | "delete" | "rename">;
+        change_type: import("@sinclair/typebox").TUnsafe<"create" | "delete" | "modify" | "rename">;
         path: import("@sinclair/typebox").TString;
         relative_path: import("@sinclair/typebox").TString;
         timestamp: import("@sinclair/typebox").TNumber;
@@ -1132,7 +1132,7 @@ export declare const HeadlessFromAgentMessageSchema: import("@sinclair/typebox")
     request_id: import("@sinclair/typebox").TString;
     request_type: import("@sinclair/typebox").TUnsafe<"approval" | "client_tool" | "mcp_elicitation" | "user_input" | "tool_retry">;
     call_id: import("@sinclair/typebox").TString;
-    resolution: import("@sinclair/typebox").TUnsafe<"approved" | "denied" | "completed" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
+    resolution: import("@sinclair/typebox").TUnsafe<"completed" | "approved" | "denied" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
     reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     resolved_by: import("@sinclair/typebox").TUnsafe<"user" | "policy" | "client" | "runtime">;
     started_at_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
@@ -1201,7 +1201,7 @@ export declare const HeadlessFromAgentMessageSchema: import("@sinclair/typebox")
 }>, import("@sinclair/typebox").TObject<{
     type: import("@sinclair/typebox").TLiteral<"utility_file_watch_event">;
     watch_id: import("@sinclair/typebox").TString;
-    change_type: import("@sinclair/typebox").TUnsafe<"create" | "modify" | "delete" | "rename">;
+    change_type: import("@sinclair/typebox").TUnsafe<"create" | "delete" | "modify" | "rename">;
     path: import("@sinclair/typebox").TString;
     relative_path: import("@sinclair/typebox").TString;
     timestamp: import("@sinclair/typebox").TNumber;
@@ -2051,7 +2051,7 @@ export declare const HeadlessRuntimeEventEnvelopeSchema: import("@sinclair/typeb
         request_id: import("@sinclair/typebox").TString;
         request_type: import("@sinclair/typebox").TUnsafe<"approval" | "client_tool" | "mcp_elicitation" | "user_input" | "tool_retry">;
         call_id: import("@sinclair/typebox").TString;
-        resolution: import("@sinclair/typebox").TUnsafe<"approved" | "denied" | "completed" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
+        resolution: import("@sinclair/typebox").TUnsafe<"completed" | "approved" | "denied" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
         reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         resolved_by: import("@sinclair/typebox").TUnsafe<"user" | "policy" | "client" | "runtime">;
         started_at_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
@@ -2120,7 +2120,7 @@ export declare const HeadlessRuntimeEventEnvelopeSchema: import("@sinclair/typeb
     }>, import("@sinclair/typebox").TObject<{
         type: import("@sinclair/typebox").TLiteral<"utility_file_watch_event">;
         watch_id: import("@sinclair/typebox").TString;
-        change_type: import("@sinclair/typebox").TUnsafe<"create" | "modify" | "delete" | "rename">;
+        change_type: import("@sinclair/typebox").TUnsafe<"create" | "delete" | "modify" | "rename">;
         path: import("@sinclair/typebox").TString;
         relative_path: import("@sinclair/typebox").TString;
         timestamp: import("@sinclair/typebox").TNumber;
@@ -2709,7 +2709,7 @@ export declare const HeadlessRuntimeStreamEnvelopeSchema: import("@sinclair/type
         request_id: import("@sinclair/typebox").TString;
         request_type: import("@sinclair/typebox").TUnsafe<"approval" | "client_tool" | "mcp_elicitation" | "user_input" | "tool_retry">;
         call_id: import("@sinclair/typebox").TString;
-        resolution: import("@sinclair/typebox").TUnsafe<"approved" | "denied" | "completed" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
+        resolution: import("@sinclair/typebox").TUnsafe<"completed" | "approved" | "denied" | "failed" | "answered" | "retried" | "skipped" | "aborted" | "cancelled">;
         reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         resolved_by: import("@sinclair/typebox").TUnsafe<"user" | "policy" | "client" | "runtime">;
         started_at_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
@@ -2778,7 +2778,7 @@ export declare const HeadlessRuntimeStreamEnvelopeSchema: import("@sinclair/type
     }>, import("@sinclair/typebox").TObject<{
         type: import("@sinclair/typebox").TLiteral<"utility_file_watch_event">;
         watch_id: import("@sinclair/typebox").TString;
-        change_type: import("@sinclair/typebox").TUnsafe<"create" | "modify" | "delete" | "rename">;
+        change_type: import("@sinclair/typebox").TUnsafe<"create" | "delete" | "modify" | "rename">;
         path: import("@sinclair/typebox").TString;
         relative_path: import("@sinclair/typebox").TString;
         timestamp: import("@sinclair/typebox").TNumber;

package/dist/node_modules/@evalops/contracts/dist/index.d.ts

@@ -46,6 +46,7 @@ export * from "./headless-protocol-generated.js";
 export * from "./headless-protocol-schemas.generated.js";
 export * as headlessProto from "./proto/maestro/v1/headless_pb.js";
 export * from "./advisor-effort.js";
+export * from "./artifacts.js";
 export * from "./delegation-prompt.js";
 export * from "./guarded-files-settings.js";
 export * from "./key-value-tokens.js";