clay-server 5.2.0-beta.1 → 5.2.0-beta.10

package/lib/yoke/maintenance.js

@@ -0,0 +1,12 @@
+function cleanup(home) {
+  var registry = require("./vendor-registry").VENDOR_REGISTRY;
+  Object.keys(registry).forEach(function(vendor) {
+    var service = registry[vendor].maintenance;
+    if (service && typeof service.cleanup === "function") service.cleanup(home);
+  });
+}
+function credentialPaths(home) {
+  var registry = require("./vendor-registry").VENDOR_REGISTRY, path = require("path");
+  return Object.keys(registry).flatMap(function(vendor) { return (registry[vendor].credentialDirectories || []).map(function(name) { return path.join(home, name); }); });
+}
+module.exports = { cleanup: cleanup, credentialPaths: credentialPaths };

package/lib/yoke/mcp-proxy.js

@@ -0,0 +1,32 @@
+// Preserve the server's JSON Schema across SDK and stdio projections.
+function validateDefinitions(definitions) {
+  var z = require('zod');
+  var names = new Set();
+  return definitions.map(function (definition) {
+    if (!definition || !/^[a-zA-Z0-9_.-]{1,128}$/.test(definition.name) || names.has(definition.name) || Object.prototype.hasOwnProperty.call(Object.prototype, definition.name)) throw new Error('Unsupported MCP tool catalog.');
+    names.add(definition.name);
+    var parsed = z.fromJSONSchema(definition.inputSchema || { type: 'object', properties: {} });
+    if (!parsed.shape) throw new Error('MCP tools must accept an object.');
+    return parsed;
+  });
+}
+function createProxy(name, definitions, invoke) {
+  var sdk = require('@anthropic-ai/claude-agent-sdk');
+  var schemas = validateDefinitions(definitions);
+  var tools = definitions.map(function (definition, index) {
+    return sdk.tool(definition.name, definition.description || definition.name, schemas[index].shape, function (args) { return invoke(definition.name, args); });
+  });
+  var server = sdk.createSdkMcpServer({ name: name, version: '1.0.0', tools: tools });
+  definitions.forEach(function (definition, index) {
+    var tool = server.instance._registeredTools[definition.name];
+    tool.inputSchema = schemas[index];
+    tool._clayInputSchema = definition.inputSchema || { type: 'object', properties: {} };
+  });
+  server.instance.server.setRequestHandler(require('@modelcontextprotocol/sdk/types.js').ListToolsRequestSchema, function () {
+    return { tools: definitions.map(function (definition) {
+      return { name: definition.name, description: definition.description, inputSchema: definition.inputSchema || { type: 'object', properties: {} } };
+    }) };
+  });
+  return server;
+}
+module.exports = { createProxy: createProxy, validateDefinitions: validateDefinitions };

package/lib/yoke/mcp-source-adapters.js

@@ -0,0 +1,91 @@
+// File-only adapters. Discovery never loads vendor code, plugins, or OAuth stores.
+var path = require('path');
+var toml = require('@iarna/toml');
+var jsonc = require('jsonc-parser');
+var yaml = require('yaml');
+var network = require('../mcp-network');
+var crypto = require('crypto');
+var ADAPTERS = {
+  claude: { user: ['.claude.json'], project: ['.mcp.json'], key: 'mcpServers' },
+  codex: { user: ['.codex/config.toml'], project: ['.codex/config.toml'], key: 'mcp_servers' },
+  kiro: { user: ['.kiro/settings/mcp.json', '.kiro/mcp.json'], project: ['.kiro/settings/mcp.json', '.kiro/mcp.json'], key: 'mcpServers', agents: '.kiro/agents' },
+  opencode: { user: ['.config/opencode/opencode.json', '.config/opencode/opencode.jsonc'], project: ['opencode.json', 'opencode.jsonc'], key: 'mcp' },
+  kimi: { user: ['.kimi-code/mcp.json', '.kimi/mcp.json'], project: ['.kimi-code/mcp.json'], key: 'mcpServers' },
+  copilot: { user: ['.copilot/mcp-config.json'], project: ['.mcp.json', '.github/mcp.json'], key: 'mcpServers' },
+  qwen: { user: ['.qwen/settings.json'], project: ['.qwen/settings.json'], key: 'mcpServers' },
+  junie: { user: ['.junie/mcp/mcp.json'], project: ['.junie/mcp/mcp.json'], key: 'mcpServers' },
+  grok: { user: ['.grok/config.toml'], project: ['.grok/config.toml'], key: 'mcp_servers' },
+  antigravity: { user: ['.gemini/config/mcp_config.json', '.gemini/antigravity-cli/mcp_config.json'], project: ['.agents/mcp_config.json'], key: 'mcpServers', plugins: '.gemini/antigravity-cli/plugins' },
+  acp: { user: [], project: [], key: 'mcpServers' },
+};
+function parse(file, content) {
+  if (file.endsWith('.md')) {
+    var match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
+    if (!match) throw new Error('Agent profile requires YAML frontmatter.');
+    var document = yaml.parseDocument(match[1]);
+    if (document.errors.length) throw new Error('Invalid agent frontmatter.');
+    return document.toJS({ maxAliasCount: 50 });
+  }
+  if (file.endsWith('.toml')) return toml.parse(content);
+  var errors = [], value = jsonc.parse(content, errors, { allowTrailingComma: true });
+  if (errors.length || !value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid MCP source format.');
+  return value;
+}
+function stringMap(value) {
+  if (!value) return {};
+  if (Array.isArray(value)) {
+    var map = {}; value.forEach(function (entry) { if (!entry || typeof entry.name !== 'string' || typeof entry.value !== 'string') throw new Error('Invalid name/value field.'); map[entry.name] = entry.value; });
+    return map;
+  }
+  if (typeof value !== 'object') throw new Error('Invalid environment or headers.');
+  Object.keys(value).forEach(function (name) { if (typeof value[name] !== 'string') throw new Error('Invalid environment or headers.'); });
+  return Object.assign({}, value);
+}
+function normalize(vendor, name, value, source) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid server definition.');
+  ['enabled', 'disabled'].forEach(function (key) { if (value[key] !== undefined && typeof value[key] !== 'boolean') throw new Error('Invalid source enablement: ' + key); });
+  if (value.oauth !== undefined && value.oauth !== true) throw new Error('Vendor OAuth policy requires reviewed Clay-owned authentication setup.');
+  var command = value.command, args = value.args || [];
+  if (vendor === 'opencode' && Array.isArray(command)) { args = command.slice(1); command = command[0]; }
+  var url = value.url || value.httpUrl || value.serverUrl;
+  if (command && url) throw new Error('Conflicting stdio and remote transport definitions.');
+  var type = value.type || value.transport || (url ? vendor === 'qwen' && !value.httpUrl ? 'sse' : 'http' : 'stdio');
+  if (type === 'local') type = 'stdio'; if (type === 'remote' || type === 'streamable-http') type = 'http';
+  if (['stdio', 'http', 'sse'].indexOf(type) < 0) throw new Error('Unsupported transport. Clay supports stdio, HTTP and SSE.');
+  if (value.headersHelper || value.oauth && (value.oauth.clientSecret || value.oauth.clientId)) throw new Error('Vendor authentication helper requires Clay-owned credential setup.');
+  var policy = require('../mcp-tool-policy').normalize(vendor, value);
+  var config = { transport: type, enabled: false, label: name, source: type === 'stdio' ? 'local' : 'url',
+    provenance: source, sourceEnabled: value.enabled === false || value.disabled === true ? false : source.scope.indexOf('plugin') === 0 ? null : true };
+  if (type === 'stdio') {
+    if (typeof command !== 'string' || !command || command.includes('\0') || !Array.isArray(args) || args.some(function (arg) { return typeof arg !== 'string' || arg.includes('\0'); })) throw new Error('Invalid stdio command or arguments.');
+    config.command = command; config.args = args; config.env = stringMap(value.env || value.environment); config.cwd = value.cwd || source.cwd;
+    if (typeof config.cwd !== 'string' || !path.isAbsolute(config.cwd)) throw new Error('Stdio working directory must be absolute.');
+  } else {
+    // Do not expand credential references during inspection.
+    config.url = network.remoteUrl(url).href; config.headers = stringMap(value.headers || value.http_headers);
+    config.envHeaders = stringMap(value.env_http_headers);
+    var bearer = value.bearer_token_env_var || value.bearerTokenEnvVar;
+    if (bearer) { config.bearerTokenEnv = bearer; config.envHeaders.Authorization = bearer; }
+  }
+  config.environmentNames = (value.env_vars || []).concat(Object.keys(config.env || {}));
+  if (value.env_vars !== undefined && !Array.isArray(value.env_vars)) throw new Error('Invalid environment allowlist.');
+  Object.assign(config, policy);
+  if (source.sourceEnabled !== undefined) config.sourceEnabled = config.sourceEnabled === false || source.sourceEnabled === false ? false : source.sourceEnabled;
+  var references = JSON.stringify([config.command, config.args, config.env, config.headers, config.url]).match(/\$\{[A-Za-z_][A-Za-z0-9_]*(?::-[^}]*)?\}|\$[A-Z_][A-Z0-9_]*|\{env:[^}]+\}|\{file:[^}]+\}|\{\{[^}]+\}\}/g) || [];
+  config.references = Array.from(new Set(references.concat(Object.values(config.envHeaders || {})).concat(value.env_vars || [])));
+  // Plugins may reference their own installed directory without reading any credential file.
+  if (source.pluginRoot) {
+    function pluginValue(value) {
+      if (typeof value === 'string') return value.replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, function () { return source.pluginRoot; }).replace(/\$\{CLAUDE_PROJECT_DIR\}/g, function () { return source.cwd; });
+      if (Array.isArray(value)) return value.map(pluginValue);
+      if (value && typeof value === 'object') { var next = {}; Object.keys(value).forEach(function (key) { next[key] = pluginValue(value[key]); }); return next; }
+      return value;
+    }
+    config = pluginValue(config); config.references = config.references.filter(function (ref) { return ref !== source.pluginRoot && ref !== source.cwd; });
+  }
+  return config;
+}
+function signature(config) {
+  return crypto.createHash('sha256').update(JSON.stringify([config.transport, config.url, config.command, config.args, config.env, config.headers, config.envHeaders, config.cwd, config.disabledTools, config.enabledTools, config.toolPatterns, config.toolPrefix, config.references])).digest('hex');
+}
+module.exports = { adapters: ADAPTERS, parse: parse, normalize: normalize, signature: signature };

package/lib/yoke/mcp-source-context.js

@@ -0,0 +1,42 @@
+var path = require('path');
+var crypto = require('crypto');
+var adapters = require('./mcp-source-adapters').adapters;
+var KEYS = ['CODEX_HOME', 'CLAUDE_CONFIG_DIR', 'OPENCODE_CONFIG', 'OPENCODE_CONFIG_DIR', 'OPENCODE_CONFIG_CONTENT', 'XDG_CONFIG_HOME', 'KIMI_CODE_HOME', 'COPILOT_HOME', 'GROK_HOME', 'QWEN_HOME', 'QWEN_CODE_SYSTEM_SETTINGS_PATH', 'QWEN_CODE_SYSTEM_DEFAULTS_PATH'];
+function resolve(ctx, owner, ws, home, identity) {
+  // Only the production runtime resolver may supply mapped-user overrides.
+  var env = ctx.runtimeEnv ? ctx.runtimeEnv(owner, ws) : identity ? {} : ctx.home ? {} : process.env;
+  var selected = {};
+  KEYS.forEach(function (key) { if (env[key] !== undefined) selected[key] = env[key]; });
+  function qwenRoot(value) { if (!value) return path.join(home, '.qwen'); return path.resolve(ctx.cwd, value.replace(/^~(?=\/|$)/, home)); }
+  var roots = { copilot: path.resolve(home, env.COPILOT_HOME || '.copilot'), grok: path.resolve(home, env.GROK_HOME || '.grok'), qwen: qwenRoot(env.QWEN_HOME), codex: path.resolve(home, env.CODEX_HOME || '.codex'), claude: path.resolve(home, env.CLAUDE_CONFIG_DIR || '.claude'),
+    opencode: path.resolve(home, env.XDG_CONFIG_HOME || '.config', 'opencode'), kimi: path.resolve(home, env.KIMI_CODE_HOME || '.kimi-code') };
+  var sources = [];
+  function add(vendor, file, scope, extra) { sources.push(Object.assign({ vendor: vendor, file: file, scope: scope, cwd: ctx.cwd }, extra)); }
+  Object.keys(adapters).forEach(function (vendor) {
+    var files = adapters[vendor].user;
+    if (vendor === 'codex') files = [path.join(roots.codex, 'config.toml')];
+    if (vendor === 'claude') files = [env.CLAUDE_CONFIG_DIR ? path.join(roots.claude, '.claude.json') : path.join(home, '.claude.json')];
+    if (vendor === 'opencode') files = ['opencode.json', 'opencode.jsonc'].map(function (file) { return path.join(roots.opencode, file); });
+    if (vendor === 'copilot') files = [path.join(roots.copilot, 'mcp-config.json')];
+    if (vendor === 'grok') files = [path.join(roots.grok, 'config.toml')];
+    if (vendor === 'qwen') files = [path.join(roots.qwen, 'settings.json')];
+    if (vendor === 'kimi' && env.KIMI_CODE_HOME) files = [path.join(roots.kimi, 'mcp.json')];
+    files.forEach(function (file) { add(vendor, path.resolve(home, file), 'user'); });
+    adapters[vendor].project.forEach(function (file) { add(vendor, path.join(ctx.cwd, file), 'project'); });
+  });
+  ['opencode.json', 'opencode.jsonc'].forEach(function (file) { add('opencode', path.join(ctx.cwd, '.opencode', file), 'runtime', { configDirectory: true }); });
+  if (env.OPENCODE_CONFIG) add('opencode', path.resolve(ctx.cwd, env.OPENCODE_CONFIG), 'runtime');
+  if (env.OPENCODE_CONFIG_DIR) ['opencode.json', 'opencode.jsonc'].forEach(function (file) { add('opencode', path.resolve(ctx.cwd, env.OPENCODE_CONFIG_DIR, file), 'runtime', { configDirectory: true }); });
+  if (env.OPENCODE_CONFIG_CONTENT) add('opencode', 'runtime:OPENCODE_CONFIG_CONTENT', 'runtime-inline', { inline: env.OPENCODE_CONFIG_CONTENT });
+  return { roots: roots, policyPaths: { qwenSettings: env.QWEN_CODE_SYSTEM_SETTINGS_PATH && path.resolve(ctx.cwd, env.QWEN_CODE_SYSTEM_SETTINGS_PATH), qwenDefaults: env.QWEN_CODE_SYSTEM_DEFAULTS_PATH && path.resolve(ctx.cwd, env.QWEN_CODE_SYSTEM_DEFAULTS_PATH) }, sources: sources, fingerprint: crypto.createHash('sha256').update(JSON.stringify(selected)).digest('hex') };
+}
+function priority(source) {
+  if (source.scope === 'runtime-inline') return 80;
+  if (source.scope === 'configured') return 70;
+  if (source.scope === 'runtime') return source.configDirectory ? 65 : 30;
+  if (source.scope === 'local') return 60;
+  if (source.scope === 'project') return 50 + (source.vendor === 'copilot' && path.basename(source.file) === '.mcp.json' ? 1 : 0);
+  if (source.scope === 'project-ancestor') return 40 + source.file.split(path.sep).length * 0.01 + (path.basename(source.file) === '.mcp.json' ? 0.001 : 0);
+  return source.scope.indexOf('plugin') === 0 ? 10 : 20;
+}
+module.exports = { resolve: resolve, priority: priority };

package/lib/yoke/mcp-source-discovery.js

@@ -0,0 +1,169 @@
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+var crypto = require('crypto');
+var adapters = require('./mcp-source-adapters');
+var sourceContext = require('./mcp-source-context');
+var restrictions = require('./mcp-source-restrictions');
+var fsAsUser = require('../os-users').fsAsUser;
+function createDiscovery(ctx) {
+  var scans = new Map(), publicScans = new Map();
+  function read(file, identity) {
+    if (identity) {
+      var stat = fsAsUser('stat', { file: file }, identity);
+      if (stat.size > 2 * 1024 * 1024 || stat.isDir) throw new Error('Source exceeds size limit.');
+      return fsAsUser('read', { file: file, readContent: true }, identity).content;
+    }
+    var info = fs.statSync(file);
+    if (!info.isFile() || info.size > 2 * 1024 * 1024) throw new Error('Source exceeds size limit.');
+    return fs.readFileSync(file, 'utf8');
+  }
+  function list(directory, identity) {
+    try { return identity ? fsAsUser('list', { dir: directory }, identity) : fs.readdirSync(directory, { withFileTypes: true }).map(function (entry) { return { name: entry.name, isDir: entry.isDirectory() }; }); }
+    catch (error) { return []; }
+  }
+  function scan(owner, ws, explicit) {
+    ctx.authorize(owner, ws);
+    var identity = ctx.identity(ws), home = identity ? identity.home : ctx.home || os.homedir();
+    var context = sourceContext.resolve(ctx, owner, ws, home, identity);
+    var rows = [], diagnostics = [], sources = context.sources, files = new Map(), directories = new Map();
+    function listing(directory) { var entries = list(directory, identity); directories.set(directory, JSON.stringify(entries.slice().sort(function (left, right) { return left.name.localeCompare(right.name); }))); return entries; }
+    function source(vendor, file, scope, pluginRoot, extra) { sources.push(Object.assign({ vendor: vendor, file: file, scope: scope, cwd: ctx.cwd, pluginRoot: pluginRoot }, extra)); }
+    Object.keys(adapters.adapters).forEach(function (vendor) {
+      var adapter = adapters.adapters[vendor];
+      if (adapter.agents) [home, ctx.cwd].forEach(function (base) {
+        var directory = path.join(base, adapter.agents);
+        listing(directory).slice(0, 100).forEach(function (entry) { if (!entry.isDir && /\.(json|md)$/.test(entry.name)) source(vendor, path.join(directory, entry.name), 'agent'); });
+      });
+      if (adapter.plugins) {
+        var directory = path.join(home, adapter.plugins);
+        listing(directory).slice(0, 100).forEach(function (entry) { if (entry.isDir) source(vendor, path.join(directory, entry.name, 'mcp_config.json'), 'plugin', path.join(directory, entry.name), { blocked: 'This plugin has no locally resolved activation registry. Review its active configuration before importing.' }); });
+      }
+    });
+    // Copilot reads nearer project definitions before ancestors up to the Git root.
+    var parents = [], repository = false;
+    var currentDirectory = ctx.cwd;
+    while (true) {
+      try { if (identity) fsAsUser('stat', { file: path.join(currentDirectory, '.git') }, identity); else fs.statSync(path.join(currentDirectory, '.git')); repository = true; break; } catch (error) {}
+      var parent = path.dirname(currentDirectory);
+      if (parent === currentDirectory) break;
+      parents.push(parent); currentDirectory = parent;
+    }
+    if (repository) parents.forEach(function (directory) {
+      source('copilot', path.join(directory, '.mcp.json'), 'project-ancestor');
+      source('copilot', path.join(directory, '.github/mcp.json'), 'project-ancestor');
+    });
+    diagnostics.push({ vendor: 'all', scope: 'plugins', message: 'Remote bundles are not downloaded. Unresolved installed plugin activation and local managed policies block import; credentials and vendor OAuth stores are never inspected.' });
+    if (explicit) {
+      if (!adapters.adapters[explicit.vendor] || typeof explicit.file !== 'string' || !path.isAbsolute(explicit.file)) throw new Error('Choose a supported format and an absolute source file path.');
+      source(explicit.vendor, explicit.file, 'configured');
+    }
+    function load(file) {
+      if (files.has(file)) { var cached = files.get(file); if (cached.error) throw cached.error; return cached.value; }
+      try {
+        var content = read(file, identity), value = adapters.parse(file, content);
+        files.set(file, { value: value, digest: crypto.createHash('sha256').update(content).digest('hex') }); return value;
+      } catch (error) { files.set(file, { error: error, digest: null }); throw error; }
+    }
+    require('./mcp-source-plugins').discover({ load: load, source: source, list: listing, roots: context.roots, cwd: ctx.cwd, diagnostics: diagnostics });
+    var blockedVendors = restrictions.inspect({ load: load, roots: context.roots, policyPaths: context.policyPaths, cwd: ctx.cwd, home: home, username: identity ? identity.username : process.env.USER });
+    var openCodeTools = {}, openCodeDefinitions = {};
+    function collect(source, definitions, root) {
+      if (!definitions || typeof definitions !== 'object') return;
+      var names = Array.isArray(definitions) ? definitions.map(function (definition) { return definition.name; }) : Object.keys(definitions);
+      names.slice(0, 100).forEach(function (name, index) {
+        if (typeof name !== 'string' || !name || name.length > 100) return;
+        try {
+          var definition = Array.isArray(definitions) ? definitions[index] : definitions[name];
+          if (source.vendor === 'opencode') {
+            definition = Object.assign({}, openCodeDefinitions[name] || {}, definition);
+            openCodeDefinitions[name] = definition;
+          }
+          if (source.overrides && source.overrides[name]) definition = Object.assign({}, definition, source.overrides[name]);
+          var provenance = Object.assign({}, source); delete provenance.inline; delete provenance.overrides;
+          var config = adapters.normalize(source.vendor, name, definition, provenance);
+          var blocked = source.blocked || blockedVendors[source.vendor];
+          if (root && Object.keys(root).some(function (key) { return restrictions.securityKey(key); })) blocked = 'This source contains runtime or agent restrictions Clay cannot resolve. Review its effective policy before importing.';
+          if (root && root.tools !== undefined && source.vendor !== 'opencode') blocked = 'This source contains runtime tool restrictions Clay cannot resolve. Review its effective policy before importing.';
+          var known = ['type', 'transport', 'command', 'args', 'env', 'environment', 'cwd', 'url', 'httpUrl', 'serverUrl', 'headers', 'http_headers', 'env_http_headers', 'bearer_token_env_var', 'bearerTokenEnvVar', 'includeTools', 'excludeTools', 'env_vars', 'enabled', 'disabled', 'autoApprove', 'disabledTools', 'disabled_tools', 'enabledTools', 'enabled_tools', 'timeout', 'startup_timeout_sec', 'tool_timeout_sec', 'oauth', 'oauthScopes', 'trust', 'name', 'description', 'tools', 'startupTimeoutMs'];
+          var unknown = Object.keys(definition).filter(function (key) { return known.indexOf(key) < 0; });
+          if (unknown.length) blocked = 'Unrecognized server fields require deliberate review in a direct Clay connection: ' + unknown.slice(0, 10).join(', ');
+          if (unknown.length) diagnostics.push({ vendor: source.vendor, scope: source.scope, name: name, message: 'Unrecognized fields are not imported: ' + unknown.slice(0, 10).join(', ') });
+          var hash = adapters.signature(config);
+          rows.push({ id: crypto.randomUUID(), name: name, config: config, signature: hash, blocked: blocked });
+        } catch (error) { diagnostics.push({ vendor: source.vendor, scope: source.scope, name: name, message: error.message }); }
+      });
+    }
+    if (sources.length > 500) diagnostics.push({ vendor: 'all', scope: 'discovery', message: 'Source limit reached; inspect additional files individually.' });
+    sources.sort(function (left, right) { return sourceContext.priority(left) - sourceContext.priority(right); });
+    sources.slice(0, 500).forEach(function (source) {
+      try {
+        var value = source.inline ? adapters.parse('inline.json', source.inline) : load(source.file), adapter = adapters.adapters[source.vendor];
+        if (Object.keys(value).some(function (key) { return restrictions.securityKey(key); })) blockedVendors[source.vendor] = 'A configuration layer contains unresolved security restrictions. Review the effective vendor policy before importing.';
+        if (source.vendor === 'opencode' && value.agent && Object.keys(value.agent).some(function (name) { return Object.keys(value.agent[name] || {}).some(function (key) { return restrictions.securityKey(key) || key === 'tools'; }); })) blockedVendors.opencode = 'OpenCode agent-specific restrictions require review. Configure a direct Clay connection with the intended restrictions.';
+        collect(source, source.scope === 'plugin-inline' ? value.mcpServers : value[adapter.key] || (source.vendor === 'codex' && !source.file.endsWith('.toml') ? value.mcpServers || value : source.vendor === 'copilot' || source.scope === 'plugin' ? value : null), value);
+        if (source.vendor === 'opencode' && value.tools !== undefined) {
+          if (!value.tools || typeof value.tools !== 'object' || Array.isArray(value.tools) || Object.values(value.tools).some(function (enabled) { return typeof enabled !== 'boolean'; })) blockedVendors.opencode = 'Invalid OpenCode tool policy. Review the runtime configuration before importing.';
+          else Object.assign(openCodeTools, value.tools);
+        }
+        if (source.vendor === 'claude' && source.scope === 'user' && value.projects && value.projects[ctx.cwd]) collect(Object.assign({}, source, { scope: 'local' }), value.projects[ctx.cwd].mcpServers, value.projects[ctx.cwd]);
+      } catch (error) {
+        if (error.code !== 'ENOENT' && !(identity && /ENOENT|no such file/i.test(error.message))) diagnostics.push({ vendor: source.vendor, scope: source.scope, message: 'Could not read or parse source; check permissions and format.' });
+      }
+    });
+    rows.forEach(function (row) {
+      var source = row.config.provenance;
+      row.blocked = row.blocked || blockedVendors[source.vendor];
+      if (source.vendor === 'opencode') {
+        row.config.toolPrefix = row.name + '_';
+        row.config.toolPatterns = Object.keys(openCodeTools).filter(function (pattern) { return openCodeTools[pattern] === false; });
+        row.signature = adapters.signature(row.config);
+      }
+      var effective = rows.filter(function (other) { return other.name === row.name && other.config.provenance.vendor === source.vendor && other.config.provenance.scope !== 'agent' && other.config.provenance.scope.indexOf('plugin') !== 0; }).pop();
+      if (source.scope !== 'agent' && source.scope.indexOf('plugin') !== 0 && effective && effective !== row) row.blocked = 'Shadowed by the effective ' + effective.config.provenance.scope + ' source. Import that definition instead.';
+    });
+    var current = ctx.snapshot(owner);
+    rows.forEach(function (row) {
+      var same = rows.filter(function (other) { return other !== row && (other.name === row.name || row.config.url && other.config.url === row.config.url); });
+      row.duplicate = rows.some(function (other) { return other !== row && other.signature === row.signature; });
+      row.conflict = same.some(function (other) { return other.signature !== row.signature; });
+      row.imported = current.records.some(function (saved) { return saved.importSignature === row.signature || row.config.url && saved.url === row.config.url; });
+    });
+    var scanId = crypto.randomUUID();
+    scans.set(owner, { id: scanId, ws: ws, rows: rows, files: files, directories: directories, identity: identity, revision: current.revision, context: context.fingerprint, home: home, created: Date.now() });
+    var publicScan = { scanId: scanId, candidates: rows.map(function (row) {
+      return { id: row.id, name: row.name, vendor: row.config.provenance.vendor, scope: row.config.provenance.scope, file: row.config.provenance.file,
+        blocked: row.blocked || null, pluginName: row.config.provenance.pluginName, pluginVersion: row.config.provenance.pluginVersion, transport: row.config.transport, dependency: row.config.command ? (/^[a-zA-Z0-9_./\\-]+$/.test(row.config.command) ? path.basename(row.config.command) : 'Configured executable') : new URL(row.config.url).hostname,
+        references: require('../mcp-import-credentials').requiredNames(row.config), environmentNames: row.config.environmentNames, sourceEnabled: row.config.sourceEnabled,
+        duplicate: row.duplicate, conflict: row.conflict, imported: row.imported };
+    }), diagnostics: diagnostics };
+    publicScans.set(owner, publicScan); return publicScan;
+  }
+  function selected(owner, ws, msg) {
+    ctx.authorize(owner, ws);
+    var scan = scans.get(owner);
+    if (!scan || scan.ws !== ws || scan.id !== msg.scanId || Date.now() - scan.created > 10 * 60 * 1000) throw new Error('Discovery expired. Scan again.');
+    if (JSON.stringify(ctx.identity(ws)) !== JSON.stringify(scan.identity)) throw new Error('OS identity changed. Scan again.');
+    if (sourceContext.resolve(ctx, owner, ws, scan.home, scan.identity).fingerprint !== scan.context) throw new Error('Runtime configuration changed. Scan again.');
+    scan.directories.forEach(function (state, directory) {
+      var entries = list(directory, scan.identity).slice().sort(function (left, right) { return left.name.localeCompare(right.name); });
+      if (JSON.stringify(entries) !== state) throw new Error('Installed source selection changed. Scan again.');
+    });
+    scan.files.forEach(function (state, file) {
+      var hash = null;
+      try { hash = crypto.createHash('sha256').update(read(file, scan.identity)).digest('hex'); } catch (error) {
+        if (!state.error || (error.code || error.message) !== (state.error.code || state.error.message)) throw new Error('Vendor configuration changed. Scan again.');
+      }
+      if (hash !== state.digest) throw new Error('Vendor configuration changed. Scan again.');
+    });
+    var row = scan.rows.find(function (candidate) { return candidate.id === msg.candidateId; });
+    if (row && row.blocked) throw new Error(row.blocked);
+    if (!row || row.imported) throw new Error('Source is unavailable or already imported.');
+    return { config: JSON.parse(JSON.stringify(row.config)), signature: row.signature, revision: scan.revision };
+  }
+  return { scan: scan, selected: selected, candidate: function (owner, subject, args) {
+    selected(owner, subject, args);
+    return publicScans.get(owner).candidates.find(function (row) { return row.id === args.candidateId; });
+  }, destroy: function () { scans.clear(); publicScans.clear(); } };
+}
+module.exports = { createDiscovery: createDiscovery };

package/lib/yoke/mcp-source-plugins.js

@@ -0,0 +1,68 @@
+var path = require('path');
+function discover(ctx) {
+  var load = ctx.load, source = ctx.source, list = ctx.list, roots = ctx.roots;
+  function optional(file) { try { return load(file); } catch (error) { return {}; } }
+  var enabled = {};
+  var settingsFiles = [path.join(roots.claude, 'settings.json'), path.join(ctx.cwd, '.claude/settings.json'), path.join(ctx.cwd, '.claude/settings.local.json')];
+  settingsFiles.forEach(function (file) { Object.assign(enabled, optional(file).enabledPlugins || {}); });
+  var installed = optional(path.join(roots.claude, 'plugins/installed_plugins.json'));
+  Object.keys(installed.plugins || {}).slice(0, 100).forEach(function (name) {
+    var entries = (installed.plugins[name] || []).filter(function (entry) { return entry.installPath && (!entry.projectPath || path.resolve(entry.projectPath) === path.resolve(ctx.cwd)); });
+    var scoped = entries.filter(function (entry) { return entry.scope === 'local' || entry.scope === 'project'; });
+    if (scoped.length) entries = scoped;
+    var local = entries.filter(function (entry) { return entry.scope === 'local'; }); if (local.length) entries = local;
+    // The registry is authoritative only when it selects one installation.
+    entries.forEach(function (entry) {
+      var extra = { pluginName: name, pluginVersion: entry.version || null, sourceEnabled: enabled[name] === true ? true : enabled[name] === false ? false : null,
+        blocked: entries.length > 1 ? 'Claude registry selects multiple installations. Resolve the active plugin installation before importing.' : typeof enabled[name] !== 'boolean' ? 'Claude plugin enablement is unknown. Enable or disable it explicitly in vendor settings and scan again.' : null };
+      var root = entry.installPath;
+      source('claude', path.join(root, '.mcp.json'), 'plugin', root, extra);
+      var manifest = optional(path.join(root, '.claude-plugin/plugin.json'));
+      var definitions = Array.isArray(manifest.mcpServers) ? manifest.mcpServers : [manifest.mcpServers];
+      definitions.forEach(function (definition) {
+        if (typeof definition === 'string' && definition.endsWith('.json') && !definition.includes('://')) source('claude', path.resolve(root, definition), 'plugin', root, extra);
+        else if (definition && typeof definition === 'object') source('claude', path.join(root, '.claude-plugin/plugin.json'), 'plugin-inline', root, extra);
+        else if (definition) ctx.diagnostics.push({ vendor: 'claude', scope: 'plugin', message: 'Remote plugin bundles are not downloaded. Install and resolve the local plugin before scanning.' });
+      });
+    });
+  });
+  var codex = {};
+  [path.join(roots.codex, 'config.toml'), path.join(ctx.cwd, '.codex/config.toml')].forEach(function (file) {
+    var plugins = optional(file).plugins || {};
+    Object.keys(plugins).forEach(function (name) {
+      var previous = codex[name] || {}, next = plugins[name] || {};
+      codex[name] = Object.assign({}, previous, next, { mcp_servers: Object.assign({}, previous.mcp_servers || {}, next.mcp_servers || {}) });
+    });
+  });
+  var cache = path.join(roots.codex, 'plugins/cache');
+  list(cache).slice(0, 50).forEach(function (market) {
+    if (!market.isDir) return;
+    list(path.join(cache, market.name)).slice(0, 50).forEach(function (plugin) {
+      if (!plugin.isDir) return;
+      var name = plugin.name + '@' + market.name, configured = codex[name] || {};
+      var versions = list(path.join(cache, market.name, plugin.name)).filter(function (entry) { return entry.isDir; });
+      // Codex core-plugin-common/installed.rs selects local first, otherwise the greatest installed version.
+      versions = versions.filter(function (entry) { return /^[A-Za-z0-9._+-]+$/.test(entry.name); }).sort(function (left, right) {
+        var semver = require('semver');
+        return semver.valid(left.name) && semver.valid(right.name) ? semver.compareBuild(left.name, right.name) : left.name < right.name ? -1 : left.name > right.name ? 1 : 0;
+      });
+      var active = versions.find(function (entry) { return entry.name === 'local'; }) || versions[versions.length - 1];
+      versions = active ? [active] : [];
+      versions.slice(0, 50).forEach(function (version) {
+        var root = path.join(cache, market.name, plugin.name, version.name);
+        var extra = { pluginName: name, pluginVersion: version.name, overrides: configured.mcp_servers,
+          sourceEnabled: Object.prototype.hasOwnProperty.call(codex, name) ? configured.enabled !== false : false,
+          blocked: configured.enabled !== undefined && typeof configured.enabled !== 'boolean' ? 'Invalid Codex plugin enabled state. Review its vendor configuration before importing.' : null };
+        var portable = optional(path.join(root, 'plugin.json'));
+        var manifest = portable.extensions && portable.extensions['com.openai'] || optional(path.join(root, '.codex-plugin/plugin.json'));
+        if (portable.name) source('codex', path.join(root, 'mcp.json'), 'plugin', root, extra);
+        else {
+          source('codex', path.join(root, '.mcp.json'), 'plugin', root, extra);
+          source('codex', path.join(root, 'mcp.json'), 'plugin', root, extra);
+        }
+        if (typeof manifest.mcpServers === 'string' && !manifest.mcpServers.includes('://')) source('codex', path.resolve(root, manifest.mcpServers), 'plugin', root, extra);
+      });
+    });
+  });
+}
+module.exports = { discover: discover };

package/lib/yoke/mcp-source-restrictions.js

@@ -0,0 +1,47 @@
+var path = require('path');
+var SECURITY = /permission|policy|security|sandbox|registry|disabledMcp|restrict|approval|allowed|denied|managedMcp|strictPlugin|includeTools|excludeTools/i;
+function inspect(ctx) {
+  var blocked = {}, files = [];
+  function add(vendor, file, exclusive) { files.push({ vendor: vendor, file: file, exclusive: exclusive }); }
+  var claudeManaged = process.platform === 'darwin' ? '/Library/Application Support/ClaudeCode' : process.platform === 'win32' ? path.join(process.env.ProgramFiles || 'C:\\Program Files', 'ClaudeCode') : '/etc/claude-code';
+  ['managed-mcp.json', 'managed-settings.json'].forEach(function (file) { add('claude', path.join(claudeManaged, file), true); });
+  add('claude', path.join(claudeManaged, 'managed-settings.d'), true);
+  if (process.platform === 'darwin') {
+    add('claude', '/Library/Managed Preferences/com.anthropic.claudecode.plist', true);
+    if (ctx.username) add('claude', path.join('/Library/Managed Preferences', ctx.username, 'com.anthropic.claudecode.plist'), true);
+  }
+  [path.join(ctx.roots.claude, 'settings.json'), path.join(ctx.cwd, '.claude/settings.json'), path.join(ctx.cwd, '.claude/settings.local.json')].forEach(function (file) { add('claude', file); });
+  [path.join(ctx.roots.codex, 'requirements.toml'), '/etc/codex/requirements.toml', '/etc/codex/managed_config.toml', path.join(ctx.roots.codex, 'managed_config.toml')].forEach(function (file) { add('codex', file, true); });
+  var openCodeManaged = process.platform === 'darwin' ? '/Library/Application Support/opencode' : process.platform === 'win32' ? path.join(process.env.ProgramData || 'C:\\ProgramData', 'opencode') : '/etc/opencode';
+  ['opencode.json', 'opencode.jsonc'].forEach(function (file) { add('opencode', path.join(openCodeManaged, file), true); });
+  if (process.platform === 'darwin') {
+    add('opencode', '/Library/Managed Preferences/ai.opencode.managed.plist', true);
+    if (ctx.username) add('opencode', path.join('/Library/Managed Preferences', ctx.username, 'ai.opencode.managed.plist'), true);
+  }
+  ['settings.json', 'permissions-config.json'].forEach(function (file) { add('copilot', path.join(ctx.roots.copilot, file)); });
+  ['settings.json', 'settings.local.json'].forEach(function (file) { add('copilot', path.join(ctx.cwd, '.github/copilot', file)); });
+  var copilotManaged = process.platform === 'darwin' ? '/Library/Application Support/GitHubCopilot/managed-settings.json' : process.platform === 'win32' ? path.join(process.env.ProgramFiles || 'C:\\Program Files', 'GitHubCopilot/managed-settings.json') : '/etc/github-copilot/managed-settings.json';
+  add('copilot', copilotManaged, true);
+  if (process.platform === 'darwin') {
+    add('copilot', '/Library/Managed Preferences/com.github.copilot.plist', true);
+    if (ctx.username) add('copilot', path.join('/Library/Managed Preferences', ctx.username, 'com.github.copilot.plist'), true);
+  }
+  add('kimi', path.join(ctx.roots.kimi, 'config.toml'));
+  var qwenSystem = process.platform === 'darwin' ? '/Library/Application Support/QwenCode' : process.platform === 'win32' ? 'C:\\ProgramData\\qwen-code' : '/etc/qwen-code';
+  add('qwen', ctx.policyPaths.qwenSettings || path.join(qwenSystem, 'settings.json'), true);
+  add('qwen', ctx.policyPaths.qwenDefaults || path.join(qwenSystem, 'system-defaults.json'), true);
+  add('grok', '/etc/grok/requirements.toml', true);
+  add('grok', '/etc/grok/managed_config.toml', true);
+  add('grok', path.join(ctx.roots.grok, 'requirements.toml'), true);
+  add('grok', path.join(ctx.roots.grok, 'managed_config.toml'), true);
+  files.forEach(function (entry) {
+    try {
+      var value = ctx.load(entry.file);
+      if (entry.exclusive || path.basename(entry.file) === 'permissions-config.json' && Object.keys(value).length || Object.keys(value).some(function (key) { return SECURITY.test(key); })) blocked[entry.vendor] = 'Local vendor security or managed policy is present. Clay cannot resolve its effective restrictions. Review that policy and configure an explicitly authorized Clay connection; vendor import is blocked.';
+    } catch (error) {
+      if (error.code !== 'ENOENT' && !/ENOENT|no such file/i.test(error.message)) blocked[entry.vendor] = 'Could not resolve a local vendor policy source. Check permissions and format before importing.';
+    }
+  });
+  return blocked;
+}
+module.exports = { inspect: inspect, securityKey: function (key) { return SECURITY.test(key); } };

package/lib/yoke/mcp-tool-policy-normalize.js

@@ -0,0 +1,28 @@
+// Restrictive policies are intersected; an empty allowlist means no tools.
+var ALLOW = ['enabled_tools', 'enabledTools', 'includeTools'];
+var DENY = ['disabled_tools', 'disabledTools', 'excludeTools'];
+function list(value, key) {
+  if (!Array.isArray(value) || value.some(function (item) { return typeof item !== 'string' || !item || item.indexOf('\0') >= 0; })) throw new Error('Invalid tool policy: ' + key + '. Review the vendor configuration before importing.');
+  return Array.from(new Set(value));
+}
+function normalize(vendor, value) {
+  var allow = null, deny = [], keys = ALLOW.slice();
+  if (vendor === 'copilot') keys.push('tools');
+  keys.forEach(function (key) {
+    if (!Object.prototype.hasOwnProperty.call(value, key)) return;
+    var next = list(value[key], key);
+    if (vendor === 'copilot' && key === 'tools' && next.indexOf('*') >= 0) next = null;
+    if (next !== null) allow = allow === null ? next : allow.filter(function (name) { return next.indexOf(name) >= 0; });
+  });
+  DENY.forEach(function (key) { if (Object.prototype.hasOwnProperty.call(value, key)) deny = deny.concat(list(value[key], key)); });
+  var unsupported = Object.keys(value).filter(function (key) {
+    if (ALLOW.concat(DENY, vendor === 'copilot' ? ['tools'] : [], ['autoApprove', 'trust', 'oauth', 'oauthScopes']).indexOf(key) >= 0) return false;
+    return /tool|permission|policy|security|authProvider|allowed|denied|restrict|approval/i.test(key) && ['tool_timeout_sec'].indexOf(key) < 0;
+  });
+  if (unsupported.length) throw new Error('Unsupported restriction or security configuration: ' + unsupported.join(', ') + '. Configure and review a direct Clay connection instead.');
+  if (value.autoApprove !== undefined && (!Array.isArray(value.autoApprove) || value.autoApprove.some(function (item) { return typeof item !== 'string'; }))) throw new Error('Invalid autoApprove policy.');
+  if (value.trust !== undefined && typeof value.trust !== 'boolean') throw new Error('Invalid trust policy.');
+  return { enabledTools: allow, disabledTools: Array.from(new Set(deny)) };
+}
+
+module.exports = { normalize: normalize };

package/lib/yoke/model-preferences.js

@@ -0,0 +1,6 @@
+function families() {
+  var registry = require("./vendor-registry").VENDOR_REGISTRY, result = {};
+  Object.keys(registry).forEach(function(vendor) { if (registry[vendor].preferredModelFamilies) result[vendor] = registry[vendor].preferredModelFamilies.slice(); });
+  return result;
+}
+module.exports = { families: families };

package/lib/yoke/muse-artifacts.js

@@ -0,0 +1,36 @@
+// Read only explicit image output references; never open provider paths/URIs.
+var MAX_BYTES = 6 * 1024 * 1024;
+var MEDIA_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+function create(getRuntime, push) {
+  var seen = new Set();
+  return async function(item) {
+    var ref = item && item.outputRef;
+    if (!item || item.status !== "completed" || !ref || MEDIA_TYPES.indexOf(ref.mediaType) < 0) return;
+    var key = JSON.stringify([item.itemId, ref.id]);
+    if (seen.has(key)) return;
+    seen.add(key);
+    var runtime = getRuntime();
+    runtime.check();
+    var event = { yokeType: "generated_image", toolId: item.itemId + ":image", blockId: item.itemId,
+      mediaType: ref.mediaType, prompt: "", savedPath: null, transparentBackground: null,
+      status: "completed", isError: false, data: "" };
+    try {
+      if (ref.availability !== "available" || typeof ref.id !== "string" || !ref.id || !Number.isSafeInteger(ref.byteLen) || ref.byteLen <= 0 || ref.byteLen > MAX_BYTES) throw new Error("Muse image artifact is unavailable or exceeds the 6 MiB output limit");
+      var result = await runtime.waitRequest(runtime.connection.request("item/readOutput", {
+        sessionId: runtime.session.sessionId, itemId: item.itemId, outputRef: ref.id, offsetBytes: 0, lengthBytes: MAX_BYTES,
+      }));
+      runtime.check();
+      if (result.encoding !== "base64" || result.mediaType !== ref.mediaType || result.offsetBytes !== 0 || result.eof !== true || result.byteLen !== ref.byteLen || typeof result.content !== "string" || result.content.length > Math.ceil(MAX_BYTES / 3) * 4 || !/^[A-Za-z0-9+/]+={0,2}$/.test(result.content)) throw new Error("Muse returned an incomplete or invalid image artifact");
+      var bytes = Buffer.from(result.content, "base64");
+      if (bytes.length !== ref.byteLen || bytes.toString("base64") !== result.content) throw new Error("Muse image artifact byte length does not match its reference");
+      event.data = result.content;
+    } catch (error) {
+      runtime.check();
+      event.isError = true;
+      event.status = "failed";
+      push({ yokeType: "informational", level: "warning", content: error.message || "Muse image artifact could not be read" });
+    }
+    push(event);
+  };
+}
+module.exports = { create: create };

package/lib/yoke/muse-controls.js

@@ -0,0 +1,50 @@
+function create(ctx) {
+  var state = ctx.state, assertLive = ctx.assertLive, selectModel = ctx.selectModel, validateEffort = ctx.validateEffort;
+  return {
+    setModel: async function(model) {
+      assertLive();
+      if (typeof model !== "string" || !model) throw new Error("Muse model selection requires a model id");
+      if (!state.session) {
+        state.model = model;
+        return;
+      }
+      var selection = await selectModel(model);
+      await ctx.runtime().waitRequest(state.connection.command("session/setModel", {
+        sessionId: state.sessionId,
+        model: selection
+      }));
+      state.model = model;
+    },
+    setEffort: async function(effort) {
+      assertLive();
+      if (state.session && !effort && state.effort) throw new Error("Muse cannot reset session effort without an explicit supported level");
+      if (effort) validateEffort(effort);
+      if (state.session && effort) await ctx.runtime().waitRequest(state.connection.command("session/setReasoningEffort", {
+        sessionId: state.sessionId,
+        reasoningEffort: effort
+      }));
+      assertLive();
+      state.effort = effort || null;
+    },
+    listTasks: async function() {
+      assertLive();
+      if (!state.session) throw new Error("Muse tasks require an opened session");
+      return ctx.runtime().waitRequest(state.connection.request("task/list", { sessionId: state.sessionId }));
+    },
+    compact: async function() {
+      assertLive();
+      if (!state.session) throw new Error("Muse compaction requires an opened session");
+      return ctx.runtime().waitRequest(state.connection.command("session/compact", { sessionId: state.sessionId }));
+    },
+    listSkills: function() { return ctx.skills.listNative(); },
+    invokeSkill: async function(selector, args) {
+      assertLive();
+      var catalog = await ctx.handle.listSkills();
+      assertLive();
+      if (!(catalog.skills || []).some(function(skill) { return skill.selector === selector; })) throw new Error("Muse skill is not in the live session catalog");
+      return ctx.handle.pushMessage("", [], { selector: selector, arguments: String(args || "") });
+    },
+    rollback: function() { return Promise.reject(new Error("Muse SDK 1.4.7 has no rollback method")); },
+  };
+}
+module.exports = { create: create };