akm-cli/dist/setup/harness-config-import.js

akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cur

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
/**
 * Pluggable registry of LLM config importers for supported agent harnesses.
 *
 * Each importer detects whether a harness is installed (filesystem only,
 * no network) and, if so, reads its config to extract LLM connection details.
 * API key VALUES are never stored — only the env var names that hold them.
 *
 * To add a new harness: implement {@link HarnessConfigImporter} and append it
 * to {@link HARNESS_CONFIG_IMPORTERS}.
 *
 * NOTE: The `detect()` method in each importer overlaps intentionally with
 * `detectAgentPlatforms()` in `detect.ts`. That function scans for harness
 * presence to display installed platforms to the user; these importers go
 * further by reading and parsing the harness config. They serve different
 * purposes and should not be deduplicated.
 */
import { claudeCodeImporter } from "../integrations/harnesses/claude/config-import.js";
import { openCodeImporter } from "../integrations/harnesses/opencode/config-import.js";
// The Claude Code importer was migrated to its harness directory in #563
// (`harnesses/claude/config-import.ts`) and the OpenCode importer in #564
// (`harnesses/opencode/config-import.ts`). Both are imported back into
// HARNESS_CONFIG_IMPORTERS below so detection order is unchanged.
// ── Registry ─────────────────────────────────────────────────────────────────
/**
 * Registry of all supported harness config importers.
 * To add a new harness: implement {@link HarnessConfigImporter} and append here.
 */
export const HARNESS_CONFIG_IMPORTERS = [claudeCodeImporter, openCodeImporter];
/**
 * Run all importers whose `detect()` returns `true` and collect their configs.
 *
 * Pure function — filesystem reads only, no network, no side effects.
 * Individual importer failures are swallowed so one broken harness never
 * blocks the setup wizard.
 *
 * @returns List of detected harness configs (may be empty).
 */
export function detectHarnessConfigs() {
    const results = [];
    for (const importer of HARNESS_CONFIG_IMPORTERS) {
        try {
            if (!importer.detect())
                continue;
            const config = importer.importConfig();
            if (config)
                results.push(config);
        }
        catch {
            // Never let one importer crash the whole detection
        }
    }
    return results;
}