nexus-agents 2.75.0 → 2.76.0

package/dist/init-opencode-Z7OQ5RCB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/init-opencode.ts"],"sourcesContent":["/**\n * `nexus-agents init --opencode <path>` setup helper (#2504, child 4 of #2500).\n *\n * Injects the nexus-agents MCP block + recommended environment into an\n * existing `opencode.json` without overwriting other operator-set keys.\n * Pairs with the existing `init --portable --mcp-config` (which targets\n * Claude Code's `.mcp.json`). Different harness, same merge-not-overwrite\n * pattern.\n *\n * Behaviour:\n *   - File exists → merge `mcp.nexus-agents` into the existing JSON.\n *     Preserve every other key the operator has set (provider config,\n *     model lists, theme, …). Idempotent: re-running produces the same\n *     final file.\n *   - File missing → write a minimal template with the nexus-agents MCP\n *     block + a stubbed `providers.openai-compat` shell the operator\n *     fills in (placeholder baseURL + `{env:WORKSPACE_PROXY_KEY}`).\n *   - `--dry-run` → print the diff (proposed vs existing) without writing.\n *   - `--validate` → after merge (or alongside dry-run), probe\n *     `providers.openai-compat.options.baseURL/v1/models` with the\n *     resolved apiKey, exit non-zero if unreachable.\n *\n * @module cli/init-opencode\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport { createLogger } from '../core/index.js';\nimport { readOpencodeGateway } from '../config/opencode-bridge.js';\nimport { discoverModels } from '../adapters/openai-compat-adapter.js';\n\nconst logger = createLogger({ component: 'init-opencode' });\n\nexport interface InitOpencodeOptions {\n  /** Absolute or relative path to opencode.json. */\n  readonly path: string;\n  /** Path to the nexus-agents CLI binary that the MCP block will spawn. */\n  readonly cliPath: string;\n  /** Sandbox flavor written to NEXUS_SANDBOX in the MCP environment. */\n  readonly sandboxFlavor?: string;\n  /** Print the diff without writing. */\n  readonly dryRun?: boolean;\n}\n\nexport interface InitOpencodeResult {\n  readonly path: string;\n  readonly action: 'created' | 'updated' | 'unchanged' | 'dry-run';\n  readonly diff: string;\n}\n\ninterface OpencodeMcpBlock {\n  type: 'local';\n  command: string[];\n  enabled: boolean;\n  environment: Record<string, string>;\n}\n\ninterface OpencodeFile {\n  $schema?: string;\n  providers?: Record<string, unknown>;\n  mcp?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\n/**\n * Build the canonical nexus-agents MCP block. Mirrors what\n * `Dockerfile.sandbox` writes today plus the env vars from #2501 + #2503.\n */\nexport function buildNexusMcpBlock(opts: {\n  readonly cliPath: string;\n  readonly sandboxFlavor?: string;\n  readonly opencodeConfigPath: string;\n}): OpencodeMcpBlock {\n  const env: Record<string, string> = {\n    NEXUS_DATA_DIR: '{env:NEXUS_DATA_DIR}',\n    NEXUS_OPENCODE_CONFIG: opts.opencodeConfigPath,\n  };\n  if (opts.sandboxFlavor !== undefined && opts.sandboxFlavor !== '') {\n    env['NEXUS_SANDBOX'] = opts.sandboxFlavor;\n  }\n  return {\n    type: 'local',\n    command: ['node', opts.cliPath, '--mode=server'],\n    enabled: true,\n    environment: env,\n  };\n}\n\n/**\n * Execute the merge. Pure with respect to `opts.dryRun: true` — no fs\n * writes. Returns the final-or-proposed JSON + a diff string suitable\n * for printing.\n */\nexport function runInitOpencode(opts: InitOpencodeOptions): InitOpencodeResult {\n  const existing = readExisting(opts.path);\n  const merged = mergeNexusBlock(existing, opts);\n  const before = existing === null ? '' : `${JSON.stringify(existing, null, 2)}\\n`;\n  const after = `${JSON.stringify(merged, null, 2)}\\n`;\n  const diff = simpleDiff(before, after);\n\n  if (opts.dryRun === true) {\n    return { path: opts.path, action: 'dry-run', diff };\n  }\n\n  if (existing !== null && before === after) {\n    return { path: opts.path, action: 'unchanged', diff };\n  }\n\n  writeFileSync(opts.path, after, 'utf8');\n  return { path: opts.path, action: existing === null ? 'created' : 'updated', diff };\n}\n\nfunction readExisting(path: string): OpencodeFile | null {\n  if (!existsSync(path)) return null;\n  try {\n    const raw = readFileSync(path, 'utf8');\n    const parsed = JSON.parse(raw) as unknown;\n    if (typeof parsed !== 'object' || parsed === null) {\n      throw new Error('opencode.json root must be an object');\n    }\n    return parsed as OpencodeFile;\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Failed to parse opencode.json at ${path}: ${msg}`);\n  }\n}\n\nfunction mergeNexusBlock(existing: OpencodeFile | null, opts: InitOpencodeOptions): OpencodeFile {\n  const block = buildNexusMcpBlock({\n    cliPath: opts.cliPath,\n    ...(opts.sandboxFlavor !== undefined && { sandboxFlavor: opts.sandboxFlavor }),\n    opencodeConfigPath: opts.path,\n  });\n\n  if (existing === null) {\n    return {\n      $schema: 'https://opencode.ai/config.json',\n      providers: { 'openai-compat': stubOpenaiCompatProvider() },\n      mcp: { 'nexus-agents': block },\n    };\n  }\n\n  // Idempotent merge: preserve user-customised fields if they exist on the\n  // current MCP block (e.g. `enabled: false`). Update anything else.\n  const existingMcp: Record<string, unknown> = existing.mcp ?? {};\n  const rawNexus = existingMcp['nexus-agents'];\n  const existingNexus: Partial<OpencodeMcpBlock> =\n    typeof rawNexus === 'object' && rawNexus !== null ? rawNexus : {};\n  const mergedBlock: OpencodeMcpBlock = {\n    type: 'local',\n    command: block.command,\n    enabled: existingNexus.enabled ?? block.enabled,\n    environment: { ...block.environment, ...(existingNexus.environment ?? {}) },\n  };\n\n  return {\n    ...existing,\n    mcp: { ...existingMcp, 'nexus-agents': mergedBlock },\n  };\n}\n\n/**\n * Stub for `providers.openai-compat`. Operators replace the placeholder\n * baseURL + key with their workspace-proxy values. Empty by design — we\n * never overwrite an existing provider block (see `mergeNexusBlock`).\n */\nfunction stubOpenaiCompatProvider(): Record<string, unknown> {\n  return {\n    npm: '@ai-sdk/openai-compatible',\n    options: {\n      baseURL: '<replace with workspace proxy URL>',\n      apiKey: '{env:WORKSPACE_PROXY_KEY}',\n    },\n  };\n}\n\n/**\n * Cheap line-based diff. Three-line context, +/- prefixes. Good enough\n * for an operator preview; not a unified-diff replacement.\n */\nfunction simpleDiff(before: string, after: string): string {\n  if (before === after) return '(no changes)';\n  const beforeLines = before.split('\\n');\n  const afterLines = after.split('\\n');\n  const out: string[] = [];\n  const max = Math.max(beforeLines.length, afterLines.length);\n  for (let i = 0; i < max; i += 1) {\n    const b = beforeLines[i];\n    const a = afterLines[i];\n    if (b === a) {\n      out.push(`  ${b ?? ''}`);\n    } else {\n      if (b !== undefined) out.push(`- ${b}`);\n      if (a !== undefined) out.push(`+ ${a}`);\n    }\n  }\n  return out.join('\\n');\n}\n\nexport function ensureOpencodeDirExists(path: string): void {\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    throw new Error(\n      `Parent directory does not exist: ${dir}. Create it first or pass a path under an existing dir.`\n    );\n  }\n  logger.debug('opencode.json target directory exists', { dir });\n}\n\n/**\n * --validate flow for `init --opencode` (follow-up to #2504).\n *\n * After the merge step writes the file, optionally probe the gateway it\n * points at. Reuses the same opencode-bridge loader (#2503) that the\n * runtime uses, so what we validate is exactly what the server will see\n * at boot.\n *\n * Returns:\n *   - `{ ok: true, models }` when the gateway is reachable and returns ≥1 model\n *   - `{ ok: false, reason }` for every failure path (config missing,\n *     probe failed, zero models)\n *\n * Caller (cli-commands-handlers) maps to exit codes + stderr / stdout.\n * The API key never reaches the returned object — only model IDs +\n * baseURL appear in the success payload.\n */\nexport interface OpencodeValidateResult {\n  readonly ok: boolean;\n  readonly baseURL?: string;\n  readonly models?: readonly string[];\n  readonly reason?: string;\n}\n\nexport async function runOpencodeValidate(opencodePath: string): Promise<OpencodeValidateResult> {\n  const config = readOpencodeGateway(opencodePath);\n  if (config === null) {\n    return {\n      ok: false,\n      reason:\n        'opencode.json does not resolve a usable gateway. Check that providers.openai-compat.options.{baseURL, apiKey} are set and that any {env:VAR} interpolation references are exported.',\n    };\n  }\n  const result = await discoverModels({ baseUrl: config.baseURL, apiKey: config.apiKey });\n  if (!result.ok) {\n    return { ok: false, baseURL: config.baseURL, reason: result.error.message };\n  }\n  if (result.value.length === 0) {\n    return {\n      ok: false,\n      baseURL: config.baseURL,\n      reason: 'gateway returned 0 models. Check upstream provider quotas / list filters.',\n    };\n  }\n  return {\n    ok: true,\n    baseURL: config.baseURL,\n    models: result.value.map((m) => m.id),\n  };\n}\n"],"mappings":"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","names":[]}