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

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 };

package/lib/yoke/muse-input.js

@@ -0,0 +1,64 @@
+var userInput = require("./user-input");
+function createRouter(runtime, queryOpts, signal) {
+  var pending = new Map();
+  function route(request) {
+    if (pending.has(request.userInputId)) return pending.get(request.userInputId).operation;
+    if (pending.size >= 1000) return Promise.reject(new Error("Muse input request capacity exceeded"));
+    var controller = new AbortController();
+    var entry = { controller: controller, retired: false };
+    function abort() { controller.abort(); }
+    if (signal.aborted) abort(); else signal.addEventListener("abort", abort, { once: true });
+    var operation = Promise.resolve().then(async function() {
+      runtime.check();
+      var input = { id: request.userInputId, questions: (request.questions || []).map(function(question) {
+        return { id: question.id, header: question.header, question: question.question,
+          options: question.options, multiSelect: question.selection && question.selection.mode === "multiple", allowOther: true };
+      }) };
+      if (typeof queryOpts.validateUserInputRequest === "function") {
+        var reason = queryOpts.validateUserInputRequest(input);
+        if (reason) throw new Error(reason);
+      }
+      var result = await runtime.wait(userInput.dispatchUserInput(queryOpts.onUserInputRequest, input,
+        { source: "muse", native: true, provider: "muse", signal: controller.signal }));
+      runtime.check();
+      if (entry.retired) return;
+      if (result.status !== "submitted") return runtime.waitRequest(runtime.connection.command("userInput/cancel", {
+        sessionId: request.sessionId, userInputId: request.userInputId,
+      }));
+      var answers = request.questions.map(function(question) {
+        var values = result.answers[question.id] || [];
+        var selection = question.selection || {};
+        if (values.length < (selection.minSelections || 1) || selection.maxSelections != null && values.length > selection.maxSelections) throw new Error("Muse answer violates selection bounds");
+        var known = values.every(function(value) { return (question.options || []).some(function(option) { return option.label === value; }); });
+        var answer = { questionId: question.id };
+        if (!known || !question.options.length) {
+          var text = values.join(", ");
+          if (text.length > 500) throw new Error("Muse free-text answer exceeds 500 characters");
+          answer.freeText = text;
+        } else if (selection.mode === "multiple") answer.selectedLabels = values;
+        else answer.selectedLabel = values[0];
+        return answer;
+      });
+      return runtime.waitRequest(runtime.connection.command("userInput/answer", {
+        sessionId: request.sessionId, userInputId: request.userInputId, answers: answers,
+      }));
+    });
+    entry.operation = operation.finally(function() { signal.removeEventListener("abort", abort); });
+    pending.set(request.userInputId, entry);
+    return entry.operation;
+  }
+  route.settle = function(id) {
+    var entry = pending.get(id);
+    if (entry) { entry.retired = true; entry.controller.abort(); }
+  };
+  return route;
+}
+function inputParts(text, images) {
+  var parts = [{ type: "text", text: text }];
+  (images || []).forEach(function(image) {
+    if (!image || typeof image.data !== "string" || !image.data || !/^image\/[a-z0-9.+-]+$/i.test(image.mediaType || "") || !/^[A-Za-z0-9+/]+={0,2}$/.test(image.data)) throw new Error("Invalid Muse image attachment");
+    parts.push({ type: "image", mediaType: image.mediaType, base64Data: image.data });
+  });
+  return parts;
+}
+module.exports = { createRouter: createRouter, inputParts: inputParts };

package/lib/yoke/muse-items.js

@@ -0,0 +1,157 @@
+function itemInput(item) {
+  if (!item || typeof item.args !== "string") return {};
+  try {
+    return JSON.parse(item.args);
+  } catch (e) {
+    return {
+      rawArgs: item.args
+    };
+  }
+}
+
+function toolName(item) {
+  var name = String(item && (item.tool || item.toolName) || "Tool").toLowerCase();
+  if (name.indexOf("shell") !== -1 || name.indexOf("command") !== -1) return "Bash";
+  if (name.indexOf("read") !== -1) return "Read";
+  if (name.indexOf("write") !== -1 || name.indexOf("create") !== -1) return "Write";
+  if (name.indexOf("edit") !== -1 || name.indexOf("delete") !== -1) return "Edit";
+  if (name.indexOf("search") !== -1 || name.indexOf("grep") !== -1) return "Grep";
+  return item && (item.tool || item.toolName) || "Tool";
+}
+
+function createRenderer(state, push) {
+  var streamedItems = {};
+  var openBlocks = {};
+  var notices = {};
+  function closeBlocks(turnId) {
+    Object.keys(openBlocks).forEach(function(id) {
+      if (turnId && openBlocks[id] !== turnId) return;
+      push({
+        yokeType: "block_stop",
+        blockId: id
+      });
+      delete openBlocks[id];
+    });
+    if (!turnId) { state.thinkingBlocks = {}; state.textBlocks = {}; state.toolBlocks = {}; }
+  }
+  function emitNotice(item, id) {
+    if (item.status === "inProgress" || item.kind === "userMessage") return;
+    var failed = ["failed", "rejected", "timedOut"].includes(item.status)
+      || (item.kind === "compaction" && item.outcome === "failed")
+      || (item.kind === "hookRun" && ["failed", "blocked", "timedOut"].includes(item.runStatus))
+      || (item.kind === "subagent" && item.result && item.result.errorKind);
+    var text = "";
+    if (failed) {
+      var labels = { reminderChild: "A background task", hookRun: "A hook", compaction: "Context maintenance", sideChat: "A side conversation", subagent: "A task", workflow: "A workflow", userShell: "A command", webSearch: "A search" };
+      var label = labels[item.kind] || "A Muse operation";
+      // Unknown kinds have no established human-facing fields. Do not dump them.
+      var detail = labels[item.kind] ? (item.failureReason || item.reason || item.message || "") : "";
+      if (item.kind === "subagent" && !detail && item.result) detail = item.result.summary || "";
+      text = label + " failed" + (detail ? ": " + detail : ".");
+    } else if (item.status === "completed") {
+      // Only documented action results belong in chat. Reminder/hook/compaction/
+      // side-chat bookkeeping and unknown protocol fallback text stay silent.
+      if (item.kind === "subagent" && item.result) text = item.result.text || item.result.summary || "";
+      else if (item.kind === "workflow") text = item.finalSummary || item.message || "";
+      else if (item.kind === "userShell") text = item.visibleOutput || "";
+      else if (item.kind === "webSearch") text = item.fallbackText || "";
+    }
+    var key = id + (failed ? ":failure" : ":summary");
+    if (typeof text !== "string" || !text.trim() || notices[key]) return;
+    notices[key] = true;
+    push({ yokeType: "informational", level: failed ? "warning" : "info", content: text });
+  }
+  function emitItem(item) {
+    if (!item || state.stopped) return;
+    var id = item.itemId || "muse-item";
+    if (item.kind === "agentMessage" || item.kind === "reasoning") {
+      var previous = state.textBlocks[id] || "";
+      var value = item.kind === "reasoning" && Array.isArray(item.summary) ? item.summary.join("\n") : item.text || "";
+      var blockId = state.thinkingBlocks[id] || id;
+      if (item.kind === "reasoning") state.thinkingBlocks[id] = blockId;
+      if (!previous && value) {
+        openBlocks[blockId] = item.turnId;
+        push({
+          yokeType: item.kind === "reasoning" ? "thinking_start" : "text_start",
+          blockId: blockId
+        });
+      }
+      if (value.length > previous.length) push({
+        yokeType: item.kind === "reasoning" ? "thinking_delta" : "text_delta",
+        blockId: blockId,
+        text: value.substring(previous.length)
+      });
+      if (value.length >= previous.length) state.textBlocks[id] = value;
+      if (item.status !== "inProgress" && openBlocks[blockId]) {
+        push({
+          yokeType: "block_stop",
+          blockId: blockId
+        });
+        delete openBlocks[blockId];
+      }
+      return;
+    }
+    if (item.kind === "toolCall") {
+      if (!state.toolBlocks[id]) {
+        state.toolBlocks[id] = true;
+        push({
+          yokeType: "tool_start",
+          blockId: id,
+          toolId: id,
+          toolName: toolName(item)
+        });
+        push({
+          yokeType: "tool_executing",
+          blockId: id,
+          toolId: id,
+          toolName: toolName(item),
+          input: itemInput(item)
+        });
+      }
+      if (item.status && item.status !== "inProgress" && state.toolBlocks[id] !== "completed") {
+        state.toolBlocks[id] = "completed";
+        push({
+          yokeType: "tool_result",
+          blockId: id,
+          toolId: id,
+          content: item.visibleOutput || item.message || item.failureReason || "",
+          isError: item.status !== "completed"
+        });
+      }
+      return;
+    }
+    emitNotice(item, id);
+  }
+  function renderFrame(frame) {
+    var params = frame.params || {};
+    var item = params.item;
+    var owner = item && item.turnId || streamedItems[params.itemId] && streamedItems[params.itemId].turnId;
+    if (!(state.liveTurnIds && state.liveTurnIds.has(owner) || state.activeTurn && owner === state.activeTurn.turnId)) return false;
+    if (item) streamedItems[item.itemId] = Object.assign({}, item); else if (frame.method === "item/delta") {
+      item = streamedItems[params.itemId];
+      if (item) {
+        var field = params.field || "text";
+        if (field.indexOf("summary.") === 0) {
+          var index = Number(field.split(".")[1]);
+          item.summary = (item.summary || []).slice();
+          item.summary[index] = (item.summary[index] || "") + params.delta;
+        } else if (field === "text") item.text = (item.text || "") + params.delta; else if (field === "output") item.visibleOutput = (item.visibleOutput || "") + params.delta;
+      }
+    }
+    if (item) emitItem(item);
+    return true;
+  }
+  return {
+    emitItem: emitItem,
+    renderFrame: renderFrame,
+    closeBlocks: closeBlocks,
+    hasItem: function(id) {
+      return !!streamedItems[id];
+    }
+  };
+}
+
+module.exports = {
+  createRenderer: createRenderer,
+  itemInput: itemInput
+};