@a5c-ai/extensions-adapter 6.0.1-staging.f8aae93c2dbc → 6.0.1

package/dist/installInstructions.js

@@ -0,0 +1,150 @@
+// Unified installation instructions generator for all targets
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveSdkConfig, resolveTargetCliName, resolveTargetNpmPackageName, } from './sdkConfig.js';
+export function generateInstallInstructions(manifest, targetProfile, sourceDir) {
+    // If a README.template.md exists in the source dir, use it
+    if (sourceDir) {
+        const templatePath = path.join(sourceDir, 'README.template.md');
+        if (fs.existsSync(templatePath)) {
+            return renderTemplate(fs.readFileSync(templatePath, 'utf-8'), manifest, targetProfile);
+        }
+    }
+    return renderDefault(manifest, targetProfile);
+}
+function renderTemplate(template, manifest, targetProfile) {
+    const sdk = resolveSdkConfig(manifest);
+    const npmPkg = resolveTargetNpmPackageName(manifest, targetProfile);
+    const cliName = resolveTargetCliName(manifest, targetProfile);
+    const skillNames = manifest.skills
+        ? manifest.skills.map(s => s.name).join(', ')
+        : 'none';
+    const hookNames = manifest.hooks
+        ? Object.keys(manifest.hooks)
+            .filter(h => {
+            const val = manifest.hooks[h];
+            if (val === null)
+                return false;
+            return targetProfile.supportedHooks.has(h);
+        })
+            .join(', ')
+        : 'none';
+    const commandList = getCommandNames(manifest).join(', ') || 'none';
+    const hasBinScripts = targetProfile.distribution === 'npm-cli' || targetProfile.distribution === 'both';
+    const hasExtension = targetProfile.adapterFamily === 'programmatic';
+    let installInstructions;
+    switch (targetProfile.distribution) {
+        case 'marketplace':
+            installInstructions = generateMarketplaceBlock(targetProfile, sdk.cli);
+            break;
+        case 'npm-cli':
+            installInstructions = generateNpmCliBlock(targetProfile, npmPkg, cliName);
+            break;
+        case 'both':
+            installInstructions = `### Option 1: Marketplace (Recommended)\n\n${generateMarketplaceBlock(targetProfile, sdk.cli)}\n\n### Option 2: npm Install\n\n${generateNpmCliBlock(targetProfile, npmPkg, cliName)}`;
+            break;
+    }
+    let verifyCommands = '';
+    if (targetProfile.npmPublishable) {
+        verifyCommands += `npm ls -g ${npmPkg} --depth=0\n`;
+    }
+    verifyCommands += `${sdk.cli} harness:discover --json | grep ${targetProfile.adapterName}`;
+    let result = template;
+    result = result.replace(/\{\{name\}\}/g, manifest.name);
+    result = result.replace(/\{\{description\}\}/g, manifest.description);
+    result = result.replace(/\{\{targetDisplayName\}\}/g, targetProfile.displayName);
+    result = result.replace(/\{\{installInstructions\}\}/g, installInstructions);
+    result = result.replace(/\{\{skillNames\}\}/g, skillNames);
+    result = result.replace(/\{\{hookNames\}\}/g, hookNames);
+    result = result.replace(/\{\{commandList\}\}/g, commandList);
+    result = result.replace(/\{\{verifyCommands\}\}/g, verifyCommands);
+    // Conditional blocks: {{#if flag}}...{{/if}}
+    result = replaceConditional(result, 'hasBinScripts', hasBinScripts);
+    result = replaceConditional(result, 'hasExtension', hasExtension);
+    return result;
+}
+function replaceConditional(text, flag, value) {
+    const pattern = new RegExp(`\\{\\{#if ${flag}\\}\\}([\\s\\S]*?)\\{\\{/if\\}\\}`, 'g');
+    return text.replace(pattern, value ? '$1' : '');
+}
+function getCommandNames(manifest) {
+    if (!manifest.commands)
+        return [];
+    if (typeof manifest.commands === 'string')
+        return ['(directory)'];
+    return manifest.commands.map(c => c.replace(/\.md$/, ''));
+}
+function generateMarketplaceBlock(targetProfile, sdkCli) {
+    return `\`\`\`bash\n${sdkCli} harness:install-plugin ${targetProfile.name}\n\`\`\``;
+}
+function generateNpmCliBlock(targetProfile, npmPkg, cliName) {
+    const lines = [
+        '```bash',
+        `npm install -g ${npmPkg}`,
+        `${cliName} install --global`,
+        '```',
+        '',
+    ];
+    if (targetProfile.packageMetadata?.activationMessage === 'codex-open-plugins') {
+        lines.push('Then open Codex and navigate to `/plugins` to activate the plugin.');
+    }
+    else {
+        lines.push(`Restart ${targetProfile.displayName} to pick up the installed plugin.`);
+    }
+    return lines.join('\n');
+}
+function renderDefault(manifest, targetProfile) {
+    const sdk = resolveSdkConfig(manifest);
+    const npmPkg = resolveTargetNpmPackageName(manifest, targetProfile);
+    const cliName = resolveTargetCliName(manifest, targetProfile);
+    const sections = [];
+    sections.push(`# ${manifest.name} — ${targetProfile.displayName} Plugin`);
+    sections.push('');
+    sections.push(manifest.description);
+    sections.push('');
+    sections.push('## Prerequisites');
+    sections.push('');
+    sections.push('Install the SDK CLI:');
+    sections.push('');
+    sections.push('```bash');
+    sections.push(`npm install -g ${sdk.package}`);
+    sections.push('```');
+    sections.push('');
+    sections.push('## Installation');
+    sections.push('');
+    switch (targetProfile.distribution) {
+        case 'marketplace':
+            sections.push(generateMarketplaceBlock(targetProfile, sdk.cli));
+            break;
+        case 'npm-cli':
+            sections.push(generateNpmCliBlock(targetProfile, npmPkg, cliName));
+            break;
+        case 'both':
+            sections.push('### Option 1: Marketplace (Recommended)');
+            sections.push('');
+            sections.push(generateMarketplaceBlock(targetProfile, sdk.cli));
+            sections.push('');
+            sections.push('### Option 2: npm Install');
+            sections.push('');
+            sections.push(generateNpmCliBlock(targetProfile, npmPkg, cliName));
+            break;
+    }
+    sections.push('');
+    if (targetProfile.npmPublishable) {
+        sections.push('### Workspace Install');
+        sections.push('');
+        sections.push('```bash');
+        sections.push(`npx -y ${npmPkg} install --workspace .`);
+        sections.push('```');
+        sections.push('');
+    }
+    sections.push('## Verification');
+    sections.push('');
+    sections.push('```bash');
+    if (targetProfile.npmPublishable) {
+        sections.push(`npm ls -g ${npmPkg} --depth=0`);
+    }
+    sections.push(`${sdk.cli} harness:discover --json | grep ${targetProfile.adapterName}`);
+    sections.push('```');
+    return sections.join('\n');
+}

package/dist/installSharedGenerator.d.ts

@@ -0,0 +1,3 @@
+import type { A5cPluginManifest, TargetProfile } from './types.js';
+export declare function generateInstallShared(manifest: A5cPluginManifest, targetProfile: TargetProfile, sourceDir?: string): string;
+//# sourceMappingURL=installSharedGenerator.d.ts.map

package/dist/installSharedGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installSharedGenerator.d.ts","sourceRoot":"","sources":["../src/installSharedGenerator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4BnE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CA4MR"}

package/dist/installSharedGenerator.js

@@ -0,0 +1,229 @@
+// Generator for install-shared — generic plugin installation infrastructure.
+// Only contains utilities any plugin would need: file ops, marketplace
+// management, per-harness plugin paths.
+// SDK-specific concepts (global state dirs, CLI resolution, process libraries)
+// are provided by the plugin author via the manifest's `installSurface` field.
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveSdkConfig } from './sdkConfig.js';
+import { resolveHarnessInstallSurfaceExports } from './transformHelpers.js';
+function getHomeDirCode(targetProfile, stateDir) {
+    const harnessHomeRelative = targetProfile.installLayout?.harnessHomeRelative;
+    if (!harnessHomeRelative) {
+        return `path.join(os.homedir(), '${stateDir}')`;
+    }
+    return `path.join(os.homedir(), ${JSON.stringify(harnessHomeRelative)})`;
+}
+function getPluginsDirCode(targetProfile) {
+    const pluginsDirRelative = targetProfile.installLayout?.pluginsDirRelative;
+    if (!pluginsDirRelative) {
+        return `path.join(getHarnessHome(), 'plugins')`;
+    }
+    return `path.join(os.homedir(), ${JSON.stringify(pluginsDirRelative)})`;
+}
+function getMarketplacePathCode(targetProfile) {
+    const marketplacePathRelative = targetProfile.installLayout?.marketplacePathRelative;
+    if (!marketplacePathRelative) {
+        return `path.join(getHarnessHome(), 'plugins', 'marketplace.json')`;
+    }
+    return `path.join(os.homedir(), ${JSON.stringify(marketplacePathRelative)})`;
+}
+export function generateInstallShared(manifest, targetProfile, sourceDir) {
+    const pluginName = manifest.name;
+    const sdk = resolveSdkConfig(manifest);
+    const authorName = typeof manifest.author === 'string' ? manifest.author : manifest.author.name;
+    const homeDirCode = getHomeDirCode(targetProfile, sdk.stateDir);
+    const pluginsDirCode = getPluginsDirCode(targetProfile);
+    const marketplacePathCode = getMarketplacePathCode(targetProfile);
+    const base = `'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PLUGIN_NAME = ${JSON.stringify(pluginName)};
+const PLUGIN_CATEGORY = 'Coding';
+
+function getUserHome() {
+  return os.homedir();
+}
+
+function getHarnessHome() {
+  return ${homeDirCode};
+}
+
+function getHomePluginRoot(scope) {
+  if (scope === 'workspace') return path.join(process.cwd(), '${sdk.stateDir}', 'plugins', PLUGIN_NAME);
+  return path.join(${pluginsDirCode}, PLUGIN_NAME);
+}
+
+function getHomeMarketplacePath() {
+  return ${marketplacePathCode};
+}
+
+function writeFileIfChanged(filePath, contents) {
+  try {
+    const existing = fs.readFileSync(filePath, 'utf8');
+    if (existing === contents) return false;
+  } catch (e) { process.stderr.write('[extensions-adapter] file read failed for ' + filePath + ', overwriting: ' + (e instanceof Error ? e.message : String(e)) + '\\n'); }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, contents);
+  return true;
+}
+
+function copyRecursive(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (entry.name === 'node_modules' || entry.name === '.git') continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyRecursive(s, d);
+    } else {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+function copyPluginBundle(packageRoot, pluginRoot) {
+  const bundleEntries = fs.readdirSync(packageRoot).filter(
+    e => !['node_modules', '.git', 'test', 'dist'].includes(e)
+  );
+  fs.mkdirSync(pluginRoot, { recursive: true });
+  for (const entry of bundleEntries) {
+    const src = path.join(packageRoot, entry);
+    const dest = path.join(pluginRoot, entry);
+    const stat = fs.statSync(src);
+    if (stat.isDirectory()) {
+      copyRecursive(src, dest);
+    } else {
+      fs.copyFileSync(src, dest);
+    }
+  }
+}
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeJson(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(value, null, 2) + '\\n');
+}
+
+function ensureExecutable(filePath) {
+  try {
+    fs.chmodSync(filePath, 0o755);
+  } catch (e) { process.stderr.write('[extensions-adapter] chmod failed for ' + filePath + ': ' + (e instanceof Error ? e.message : String(e)) + '\\n'); }
+}
+
+function normalizeMarketplaceSourcePath(source, marketplacePath) {
+  if (typeof source === 'string') {
+    return path.relative(path.dirname(marketplacePath), source).replace(/\\\\/g, '/');
+  }
+  return source;
+}
+
+function ensureMarketplaceEntry(marketplacePath, pluginRoot) {
+  let marketplace = readJson(marketplacePath) || {
+    name: ${JSON.stringify(authorName)},
+    plugins: [],
+  };
+  if (!Array.isArray(marketplace.plugins)) marketplace.plugins = [];
+  const idx = marketplace.plugins.findIndex(p => p.name === PLUGIN_NAME);
+  const relSource = './' + normalizeMarketplaceSourcePath(pluginRoot, marketplacePath);
+  const entry = {
+    name: PLUGIN_NAME,
+    source: relSource,
+    description: ${JSON.stringify(manifest.description)},
+    version: ${JSON.stringify(manifest.version)},
+    author: { name: ${JSON.stringify(authorName)} },
+  };
+  if (idx >= 0) marketplace.plugins[idx] = entry;
+  else marketplace.plugins.push(entry);
+  writeJson(marketplacePath, marketplace);
+}
+
+function removeMarketplaceEntry(marketplacePath) {
+  const marketplace = readJson(marketplacePath);
+  if (!marketplace || !Array.isArray(marketplace.plugins)) return;
+  marketplace.plugins = marketplace.plugins.filter(p => p.name !== PLUGIN_NAME);
+  writeJson(marketplacePath, marketplace);
+}
+
+function warnWindowsHooks() {
+  if (process.platform === 'win32') {
+    console.warn('[' + PLUGIN_NAME + '] Windows detected — shell hooks (.sh) require Git Bash or WSL.');
+  }
+}
+
+function runPostInstall(pluginRoot) {
+  const postInstall = path.join(pluginRoot, 'scripts', 'post-install.js');
+  if (fs.existsSync(postInstall)) {
+    spawnSync(process.execPath, [postInstall], {
+      cwd: pluginRoot, stdio: 'inherit',
+      env: { ...process.env, PLUGIN_ROOT: pluginRoot, CLAUDE_PLUGIN_ROOT: pluginRoot },
+    });
+  }
+}
+`;
+    const baseExports = [
+        'PLUGIN_NAME',
+        'PLUGIN_CATEGORY',
+        'getUserHome',
+        'getHarnessHome',
+        'getHomePluginRoot',
+        'getHomeMarketplacePath',
+        'writeFileIfChanged',
+        'copyRecursive',
+        'copyPluginBundle',
+        'readJson',
+        'writeJson',
+        'ensureExecutable',
+        'normalizeMarketplaceSourcePath',
+        'ensureMarketplaceEntry',
+        'removeMarketplaceEntry',
+        'warnWindowsHooks',
+        'runPostInstall',
+    ];
+    // Read plugin-specific surface (SDK concepts: global state, CLI resolution, etc.)
+    let sdkSurface = '';
+    const surfaceExports = [];
+    if (sourceDir && manifest.installSurface) {
+        const surfacePath = path.join(sourceDir, manifest.installSurface);
+        if (fs.existsSync(surfacePath)) {
+            sdkSurface = fs.readFileSync(surfacePath, 'utf-8');
+        }
+        if (manifest.installSurfaceExports) {
+            surfaceExports.push(...manifest.installSurfaceExports);
+        }
+    }
+    // Read per-harness surface (harness-specific installation logic)
+    let harnessSurface = '';
+    const harnessSurfaceExports = resolveHarnessInstallSurfaceExports(manifest, targetProfile);
+    const override = manifest.targets?.[targetProfile.name];
+    if (sourceDir && override?.harnessInstallSurface) {
+        const surfacePath = path.join(sourceDir, override.harnessInstallSurface);
+        if (fs.existsSync(surfacePath)) {
+            harnessSurface = fs.readFileSync(surfacePath, 'utf-8');
+        }
+    }
+    // Deduplicate: per-harness exports override base/SDK exports of the same name
+    const overrideSet = new Set([...surfaceExports, ...harnessSurfaceExports]);
+    const dedupedBase = baseExports.filter(e => !overrideSet.has(e));
+    const allExports = [...dedupedBase, ...surfaceExports, ...harnessSurfaceExports];
+    const exportsBlock = `\nmodule.exports = {\n  ${allExports.join(',\n  ')},\n};\n`;
+    let result = base;
+    if (sdkSurface) {
+        result += '\n' + sdkSurface + '\n';
+    }
+    if (harnessSurface) {
+        result += '\n' + harnessSurface + '\n';
+    }
+    return result + exportsBlock;
+}

package/dist/manifestGenerators.d.ts

@@ -0,0 +1,10 @@
+export { generateClaudeCodeManifest } from './targets/adapters/claude-code.js';
+export { generateCodexManifest } from './targets/adapters/codex.js';
+export { generateCursorManifest } from './targets/adapters/cursor.js';
+export { generateGeminiManifest } from './targets/adapters/gemini.js';
+export { generateGithubCopilotManifest } from './targets/adapters/github-copilot.js';
+export { generatePiManifest } from './targets/adapters/pi.js';
+export { generateOhMyPiManifest } from './targets/adapters/oh-my-pi.js';
+export { generateOpenCodeManifest } from './targets/adapters/opencode.js';
+export { generateOpenClawPackageManifest, generateOpenClawManifest } from './targets/adapters/openclaw.js';
+//# sourceMappingURL=manifestGenerators.d.ts.map

package/dist/manifestGenerators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestGenerators.d.ts","sourceRoot":"","sources":["../src/manifestGenerators.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/manifestGenerators.js

@@ -0,0 +1,11 @@
+// Manifest generators for all targets
+// This is a thin re-export shell — actual implementations live in targets/adapters/
+export { generateClaudeCodeManifest } from './targets/adapters/claude-code.js';
+export { generateCodexManifest } from './targets/adapters/codex.js';
+export { generateCursorManifest } from './targets/adapters/cursor.js';
+export { generateGeminiManifest } from './targets/adapters/gemini.js';
+export { generateGithubCopilotManifest } from './targets/adapters/github-copilot.js';
+export { generatePiManifest } from './targets/adapters/pi.js';
+export { generateOhMyPiManifest } from './targets/adapters/oh-my-pi.js';
+export { generateOpenCodeManifest } from './targets/adapters/opencode.js';
+export { generateOpenClawPackageManifest, generateOpenClawManifest } from './targets/adapters/openclaw.js';

package/dist/marketplaceGenerator.d.ts

@@ -0,0 +1,3 @@
+import type { A5cPluginManifest, TargetProfile } from './types.js';
+export declare function generateMarketplaceJson(manifest: A5cPluginManifest, targetProfile: TargetProfile, pluginOutputDir: string, outputBaseDir: string): string;
+//# sourceMappingURL=marketplaceGenerator.d.ts.map

package/dist/marketplaceGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceGenerator.d.ts","sourceRoot":"","sources":["../src/marketplaceGenerator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,MAAM,CA6CR"}

package/dist/marketplaceGenerator.js

@@ -0,0 +1,47 @@
+// Marketplace file generator
+// Generates marketplace.json for targets that use marketplace distribution
+import * as path from 'path';
+export function generateMarketplaceJson(manifest, targetProfile, pluginOutputDir, outputBaseDir) {
+    const authorName = typeof manifest.author === 'string'
+        ? manifest.author
+        : manifest.author.name;
+    const relativePluginPath = path.relative(outputBaseDir, pluginOutputDir).replace(/\\/g, '/');
+    const pluginSourcePath = relativePluginPath.startsWith('.')
+        ? relativePluginPath
+        : `./${relativePluginPath}`;
+    if (targetProfile.packageMetadata?.activationMessage === 'codex-open-plugins') {
+        return JSON.stringify({
+            name: `${manifest.name}-local`,
+            interface: {
+                displayName: `${manifest.name.charAt(0).toUpperCase() + manifest.name.slice(1)} Local`,
+            },
+            plugins: [{
+                    name: manifest.name,
+                    source: {
+                        source: 'local',
+                        path: pluginSourcePath,
+                    },
+                    version: manifest.version,
+                    policy: {
+                        installation: 'AVAILABLE',
+                        authentication: 'ON_INSTALL',
+                    },
+                    category: 'Coding',
+                }],
+        }, null, 2) + '\n';
+    }
+    return JSON.stringify({
+        name: authorName,
+        owner: {
+            name: authorName,
+            email: `support@${authorName}`,
+        },
+        plugins: [{
+                name: manifest.name,
+                source: pluginSourcePath,
+                description: manifest.description,
+                version: manifest.version,
+                author: { name: authorName },
+            }],
+    }, null, 2) + '\n';
+}

package/dist/mcpConfig.d.ts

@@ -0,0 +1,69 @@
+import type { A5cPluginManifest, McpServerSpec, TransformedFile } from './types.js';
+/** Default Atlas MCP server URL (SPEC §4.2 / spec.json mcp.url). */
+export declare const DEFAULT_ATLAS_MCP_URL = "https://atlas-staging.a5c.ai/api/mcp";
+/**
+ * Emission-time URL for a server spec: the literal `spec.url`, falling back to
+ * the default Atlas URL when unset.
+ */
+export declare function resolveMcpUrl(spec: McpServerSpec): string;
+/**
+ * The env-override default token emitted verbatim into command/args for the
+ * JSON + TOML targets, e.g. `${ATLAS_MCP_URL:-https://atlas-staging.a5c.ai/api/mcp}`.
+ * Falls back to the literal default URL when no env var is declared.
+ */
+export declare function buildEnvOverrideUrl(spec: McpServerSpec): string;
+/**
+ * The `mcp-remote` bridge args carrying the env-override default token:
+ *   ["-y", "mcp-remote", "${ATLAS_MCP_URL:-<default>}"]
+ */
+export declare function buildRemoteCommandArgs(spec: McpServerSpec): string[];
+/**
+ * (A) JSON `mcpServers` map: { "mcpServers": { "<name>": { command, args } } }.
+ * Used by claude-code, cursor, github-copilot, antigravity, pi, oh-my-pi,
+ * openclaw, genty. Each server emits the `mcp-remote` bridge form.
+ */
+export declare function buildJsonMcpServers(servers: Record<string, McpServerSpec>): {
+    mcpServers: Record<string, {
+        command: string;
+        args: string[];
+    }>;
+};
+/**
+ * (B) opencode merge fragment: { "mcp": { "<name>": { type:"local",
+ * command:[...array...], enabled:true } } }. opencode uses `mcp` (not
+ * `mcpServers`) and the command is an array.
+ */
+export declare function buildOpencodeMcp(servers: Record<string, McpServerSpec>): {
+    mcp: Record<string, {
+        type: string;
+        command: string[];
+        enabled: boolean;
+    }>;
+};
+/**
+ * (B) codex TOML merge fragment: a `[mcp_servers.<name>]` table with
+ * command="npx" and args carrying the env-override token. Folded into
+ * ~/.codex/config.toml by the install surface.
+ */
+export declare function buildCodexMcpToml(servers: Record<string, McpServerSpec>): string;
+/**
+ * (B) gemini extension manifest fragment: { "mcpServers": { "<name>": {
+ * httpUrl:"<default>", command:"npx", args:[...token...] } } }. gemini
+ * extensions declare MCP in the extension manifest; prefer `httpUrl` for the
+ * remote URL while still carrying the `mcp-remote` command/args.
+ */
+export declare function buildGeminiMcpServers(servers: Record<string, McpServerSpec>): {
+    mcpServers: Record<string, {
+        httpUrl: string;
+        command: string;
+        args: string[];
+    }>;
+};
+/** Serialize a JSON object as the file content (trailing newline, like siblings). */
+export declare function toJsonContent(value: unknown): string;
+/**
+ * Shared emitter for the (A) JSON `mcpServers` map targets. Returns the native
+ * MCP config file at `path`, or null when the manifest declares no MCP servers.
+ */
+export declare function emitJsonMcpConfig(manifest: A5cPluginManifest, path: string): TransformedFile | null;
+//# sourceMappingURL=mcpConfig.d.ts.map

package/dist/mcpConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpConfig.d.ts","sourceRoot":"","sources":["../src/mcpConfig.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACrC;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,CASrE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACrC;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAAE,CAUhF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,CAShF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACrC;IACD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAClF,CAUA;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,IAAI,CAKxB"}

package/dist/mcpConfig.js

@@ -0,0 +1,115 @@
+// Shared MCP-config builders for the per-harness emit step.
+//
+// A new top-level `mcpServers` field on the unified plugin.json declares native
+// MCP servers to wire into every target in its native config format. These
+// helpers translate an McpServerSpec into the two canonical shapes:
+//   (A) JSON `mcpServers` map  — claude-code, cursor, github-copilot,
+//       antigravity, pi, oh-my-pi, openclaw, genty
+//   (B) harness merge fragment — opencode (`mcp` array form), codex (TOML
+//       `mcp_servers`), gemini (`mcpServers` with `httpUrl`)
+//
+// The env-override happens at the harness' runtime via the `mcp-remote` bridge,
+// mirroring the repo root `.mcp.json` shape:
+//   command: "npx", args: ["-y","mcp-remote","${ATLAS_MCP_URL:-<default>}"]
+/** Default Atlas MCP server URL (SPEC §4.2 / spec.json mcp.url). */
+export const DEFAULT_ATLAS_MCP_URL = 'https://atlas-staging.a5c.ai/api/mcp';
+/**
+ * Emission-time URL for a server spec: the literal `spec.url`, falling back to
+ * the default Atlas URL when unset.
+ */
+export function resolveMcpUrl(spec) {
+    return spec.url ?? DEFAULT_ATLAS_MCP_URL;
+}
+/**
+ * The env-override default token emitted verbatim into command/args for the
+ * JSON + TOML targets, e.g. `${ATLAS_MCP_URL:-https://atlas-staging.a5c.ai/api/mcp}`.
+ * Falls back to the literal default URL when no env var is declared.
+ */
+export function buildEnvOverrideUrl(spec) {
+    const url = resolveMcpUrl(spec);
+    return spec.urlEnvVar ? `\${${spec.urlEnvVar}:-${url}}` : url;
+}
+/**
+ * The `mcp-remote` bridge args carrying the env-override default token:
+ *   ["-y", "mcp-remote", "${ATLAS_MCP_URL:-<default>}"]
+ */
+export function buildRemoteCommandArgs(spec) {
+    return ['-y', 'mcp-remote', buildEnvOverrideUrl(spec)];
+}
+/**
+ * (A) JSON `mcpServers` map: { "mcpServers": { "<name>": { command, args } } }.
+ * Used by claude-code, cursor, github-copilot, antigravity, pi, oh-my-pi,
+ * openclaw, genty. Each server emits the `mcp-remote` bridge form.
+ */
+export function buildJsonMcpServers(servers) {
+    const mcpServers = {};
+    for (const [name, spec] of Object.entries(servers)) {
+        mcpServers[name] = {
+            command: 'npx',
+            args: buildRemoteCommandArgs(spec),
+        };
+    }
+    return { mcpServers };
+}
+/**
+ * (B) opencode merge fragment: { "mcp": { "<name>": { type:"local",
+ * command:[...array...], enabled:true } } }. opencode uses `mcp` (not
+ * `mcpServers`) and the command is an array.
+ */
+export function buildOpencodeMcp(servers) {
+    const mcp = {};
+    for (const [name, spec] of Object.entries(servers)) {
+        mcp[name] = {
+            type: 'local',
+            command: ['npx', ...buildRemoteCommandArgs(spec)],
+            enabled: true,
+        };
+    }
+    return { mcp };
+}
+/**
+ * (B) codex TOML merge fragment: a `[mcp_servers.<name>]` table with
+ * command="npx" and args carrying the env-override token. Folded into
+ * ~/.codex/config.toml by the install surface.
+ */
+export function buildCodexMcpToml(servers) {
+    const blocks = [];
+    for (const [name, spec] of Object.entries(servers)) {
+        const args = buildRemoteCommandArgs(spec)
+            .map((a) => JSON.stringify(a))
+            .join(', ');
+        blocks.push(`[mcp_servers.${name}]\ncommand = "npx"\nargs = [${args}]\n`);
+    }
+    return blocks.join('\n');
+}
+/**
+ * (B) gemini extension manifest fragment: { "mcpServers": { "<name>": {
+ * httpUrl:"<default>", command:"npx", args:[...token...] } } }. gemini
+ * extensions declare MCP in the extension manifest; prefer `httpUrl` for the
+ * remote URL while still carrying the `mcp-remote` command/args.
+ */
+export function buildGeminiMcpServers(servers) {
+    const mcpServers = {};
+    for (const [name, spec] of Object.entries(servers)) {
+        mcpServers[name] = {
+            httpUrl: resolveMcpUrl(spec),
+            command: 'npx',
+            args: buildRemoteCommandArgs(spec),
+        };
+    }
+    return { mcpServers };
+}
+/** Serialize a JSON object as the file content (trailing newline, like siblings). */
+export function toJsonContent(value) {
+    return JSON.stringify(value, null, 2) + '\n';
+}
+/**
+ * Shared emitter for the (A) JSON `mcpServers` map targets. Returns the native
+ * MCP config file at `path`, or null when the manifest declares no MCP servers.
+ */
+export function emitJsonMcpConfig(manifest, path) {
+    if (!manifest.mcpServers || Object.keys(manifest.mcpServers).length === 0) {
+        return null;
+    }
+    return { path, content: toJsonContent(buildJsonMcpServers(manifest.mcpServers)) };
+}

package/dist/proxiedHookTemplates.d.ts

@@ -0,0 +1,10 @@
+import type { TargetProfile } from './types.js';
+export declare function generateProgrammaticExtension(manifest: {
+    name: string;
+    skills?: Array<{
+        name: string;
+    }>;
+    commands?: string[] | string;
+    hooks?: Record<string, string | boolean | null>;
+}, targetProfile: TargetProfile, commandPaths?: string[]): string;
+//# sourceMappingURL=proxiedHookTemplates.d.ts.map