@hashicorp/kits 0.1.0

package/dist/adapters/index.js

@@ -0,0 +1,76 @@
+/**
+ * Adapters module for the Kit Installer.
+ *
+ * This module provides the adapter framework for translating kits
+ * to harness-specific configurations. It includes:
+ *
+ * - KitAdapter interface for harness-specific implementations
+ * - BaseAdapter abstract class with common functionality
+ * - AdapterRegistry for managing and discovering adapters
+ * - Tool templating system for harness-agnostic tool references
+ * - File operation utilities for atomic installation
+ */
+export { CANONICAL_TOOLS, CANONICAL_MODEL_TIERS, } from "./interface.js";
+// Registry
+export { AdapterRegistry, globalRegistry, registerAdapter, getAdapter, listAdapters, detectHarnesses, } from "./registry.js";
+/**
+ * Get the global adapter registry.
+ *
+ * @returns The global adapter registry instance
+ */
+export function getAdapterRegistry() {
+    return globalRegistry;
+}
+// Base adapter
+export { BaseAdapter, NAMESPACE_SEPARATOR } from "./base-adapter.js";
+// Tool templating
+export { processToolTemplates, parseToolTemplate, findToolTemplates, hasToolTemplates, countToolTemplates, getReferencedToolIds, validateToolTemplates, createToolTemplate, isValidCanonicalToolId, DEFAULT_TOOL_MAPPINGS, } from "./tool-templating.js";
+// Model templating
+export { parseModelTemplate, resolveModelTemplate } from "./model-templating.js";
+// Subagent frontmatter
+export { parseSubagentFrontmatter, serializeSubagentFrontmatter, mapSubagentTools, } from "./subagent-frontmatter.js";
+// File operations
+export { expandPath, pathExists, isDirectory, isFile, ensureDirectory, copyFile, copyDirectory, writeTransformed, readFile, backupFile, createSimpleBackup, restoreFromBackup, remove, removeIfEmpty, rollbackOperations, executeFileOperations, deepMerge, getSize, listFiles, } from "./file-operations.js";
+// Claude Code adapter
+export { ClaudeCodeAdapter, createClaudeCodeAdapter, detectClaudeCode, claudeCodeToolMapping, claudeCodeModelMapping, CLAUDE_CODE_PATHS, } from "./claude-code/index.js";
+// Codex adapter
+export { CodexAdapter, createCodexAdapter, detectCodex, codexToolMapping, codexModelMapping, CODEX_PATHS, } from "./codex/index.js";
+// Gemini CLI adapter
+export { GeminiCliAdapter, createGeminiCliAdapter, detectGeminiCli, geminiCliToolMapping, geminiCliModelMapping, GEMINI_CLI_PATHS, } from "./gemini-cli/index.js";
+// GitHub Copilot adapter
+export { GithubCopilotAdapter, createGithubCopilotAdapter, detectGithubCopilot, githubCopilotToolMapping, githubCopilotModelMapping, GITHUB_COPILOT_PATHS, } from "./github-copilot/index.js";
+// OpenCode adapter
+export { OpencodeAdapter, createOpencodeAdapter, detectOpencode, opencodeToolMapping, opencodeModelMapping, OPENCODE_PATHS, } from "./opencode/index.js";
+// Register adapters with global registry
+import { globalRegistry } from "./registry.js";
+import { createClaudeCodeAdapter } from "./claude-code/index.js";
+import { createCodexAdapter } from "./codex/index.js";
+import { createGeminiCliAdapter } from "./gemini-cli/index.js";
+import { createGithubCopilotAdapter } from "./github-copilot/index.js";
+import { createOpencodeAdapter } from "./opencode/index.js";
+/**
+ * Initialize all built-in adapters and register them with the global registry.
+ *
+ * This function should be called during application startup.
+ */
+export function initializeAdapters() {
+    // Only register if not already registered
+    if (!globalRegistry.has("claude-code")) {
+        globalRegistry.register(createClaudeCodeAdapter());
+    }
+    if (!globalRegistry.has("codex")) {
+        globalRegistry.register(createCodexAdapter());
+    }
+    if (!globalRegistry.has("gemini-cli")) {
+        globalRegistry.register(createGeminiCliAdapter());
+    }
+    if (!globalRegistry.has("github-copilot")) {
+        globalRegistry.register(createGithubCopilotAdapter());
+    }
+    if (!globalRegistry.has("opencode")) {
+        globalRegistry.register(createOpencodeAdapter());
+    }
+}
+// Auto-initialize on import
+initializeAdapters();
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"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"}

package/dist/adapters/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Adapter interface re-exports.
+ *
+ * This module provides the primary exports for the KitAdapter interface
+ * and related types used by harness-specific adapter implementations.
+ */
+export type { KitAdapter, InstallationPaths, ConfigLocations, DetectionResult, CompatibilityResult, InstallOptions, InstallProgress, InstallResult, UninstallOptions, UninstallResult, InstalledKitInfo, PrimitiveInstallStatus, FileOperationResult, TransformResult, HookInstallation, FileOperation, ValidationResult, ValidationError, ToolMapping, ModelMapping, ModelTier, TemplateProcessingResult, ResolvedTool, UnresolvedTool, } from "./types.js";
+export { CANONICAL_TOOLS, CANONICAL_MODEL_TIERS, type CanonicalToolId, } from "./types.js";
+//# sourceMappingURL=interface.d.ts.map

package/dist/adapters/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/adapters/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,SAAS,EACT,wBAAwB,EACxB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/adapters/interface.js

@@ -0,0 +1,8 @@
+/**
+ * Adapter interface re-exports.
+ *
+ * This module provides the primary exports for the KitAdapter interface
+ * and related types used by harness-specific adapter implementations.
+ */
+export { CANONICAL_TOOLS, CANONICAL_MODEL_TIERS, } from "./types.js";
+//# sourceMappingURL=interface.js.map

package/dist/adapters/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/adapters/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,YAAY,CAAC"}

package/dist/adapters/model-templating.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Model template parsing and resolution helpers.
+ */
+import type { ModelMapping, ModelTier } from "./types.js";
+export interface ParsedModelTemplate {
+    tier: ModelTier;
+}
+export declare function parseModelTemplate(value: string): ParsedModelTemplate | null;
+/**
+ * Resolve model templates in frontmatter using the provided mapping.
+ *
+ * - If the tier maps to a model string, replace the model field.
+ * - If the tier maps to null/undefined/empty, remove the model field.
+ */
+export declare function resolveModelTemplate(frontmatter: Record<string, unknown>, modelMapping: ModelMapping): Record<string, unknown>;
+//# sourceMappingURL=model-templating.d.ts.map

package/dist/adapters/model-templating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-templating.d.ts","sourceRoot":"","sources":["../../src/adapters/model-templating.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI1D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAe5E;AAUD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,YAAY,EAAE,YAAY,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB"}

package/dist/adapters/model-templating.js

@@ -0,0 +1,52 @@
+/**
+ * Model template parsing and resolution helpers.
+ */
+const MODEL_TEMPLATE_REGEX = /\{\{\s*model:([a-z-]+)\s*\}\}/;
+export function parseModelTemplate(value) {
+    const match = MODEL_TEMPLATE_REGEX.exec(value);
+    if (!match) {
+        return null;
+    }
+    const tier = match[1];
+    if (!tier) {
+        return null;
+    }
+    if (!isModelTier(tier)) {
+        return null;
+    }
+    return { tier };
+}
+function isModelTier(value) {
+    return value === "fast" ||
+        value === "standard" ||
+        value === "power" ||
+        value === "auto" ||
+        value === "inherit";
+}
+/**
+ * Resolve model templates in frontmatter using the provided mapping.
+ *
+ * - If the tier maps to a model string, replace the model field.
+ * - If the tier maps to null/undefined/empty, remove the model field.
+ */
+export function resolveModelTemplate(frontmatter, modelMapping) {
+    const rawModel = frontmatter["model"];
+    if (typeof rawModel !== "string") {
+        return frontmatter;
+    }
+    const parsed = parseModelTemplate(rawModel);
+    if (!parsed) {
+        return frontmatter;
+    }
+    const mapped = modelMapping[parsed.tier];
+    if (mapped === undefined || mapped === null || mapped.length === 0) {
+        const { model: _model, ...rest } = frontmatter;
+        void _model;
+        return rest;
+    }
+    return {
+        ...frontmatter,
+        model: mapped,
+    };
+}
+//# sourceMappingURL=model-templating.js.map

package/dist/adapters/model-templating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-templating.js","sourceRoot":"","sources":["../../src/adapters/model-templating.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAM7D,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,KAAK,MAAM;QACrB,KAAK,KAAK,UAAU;QACpB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,SAAS,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAoC,EACpC,YAA0B;IAE1B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;QAC/C,KAAK,MAAM,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,GAAG,WAAW;QACd,KAAK,EAAE,MAAM;KACd,CAAC;AACJ,CAAC"}

package/dist/adapters/opencode/detection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * OpenCode harness detection.
+ *
+ * Detects OpenCode installation by checking for:
+ * - opencode binary in PATH
+ * - ~/.config/opencode/opencode.json configuration file
+ * - Installation directories (~/.config/opencode/commands/, ~/.config/opencode/skills/, etc.)
+ */
+import type { DetectionResult, InstallationPaths } from "../types.js";
+/**
+ * OpenCode configuration file paths.
+ */
+export declare const OPENCODE_PATHS: {
+    readonly configJson: "~/.config/opencode/opencode.json";
+    readonly commands: "~/.config/opencode/commands/";
+    readonly skills: "~/.config/opencode/skills/";
+    readonly agents: "~/.config/opencode/agents/";
+    readonly plugins: "~/.config/opencode/plugins/";
+};
+/**
+ * Check if the opencode binary is available in PATH.
+ */
+export declare function checkOpencodeBinary(): Promise<boolean>;
+/**
+ * Get the OpenCode version from the CLI.
+ */
+export declare function getOpencodeVersion(): Promise<string | undefined>;
+/**
+ * Check if the OpenCode config file exists.
+ */
+export declare function checkConfigJson(): boolean;
+/**
+ * Check if installation directories exist.
+ */
+export declare function checkInstallationPaths(): {
+    commands: boolean;
+    skills: boolean;
+    subagents: boolean;
+    hooks: boolean;
+};
+/**
+ * Get version from opencode.json if available.
+ */
+export declare function getVersionFromConfig(): Promise<string | undefined>;
+/**
+ * Detect OpenCode installation.
+ *
+ * Detection is considered successful if:
+ * - The opencode binary is in PATH, OR
+ * - The ~/.config/opencode/opencode.json file exists
+ */
+export declare function detectOpencode(): Promise<DetectionResult>;
+/**
+ * Get OpenCode installation paths.
+ */
+export declare function getOpencodeInstallationPaths(): InstallationPaths;
+//# sourceMappingURL=detection.d.ts.map

package/dist/adapters/opencode/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../src/adapters/opencode/detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKtE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO5D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAStE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAOA;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAaxE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CA6C/D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,iBAAiB,CAOhE"}

package/dist/adapters/opencode/detection.js

@@ -0,0 +1,140 @@
+/**
+ * OpenCode harness detection.
+ *
+ * Detects OpenCode installation by checking for:
+ * - opencode binary in PATH
+ * - ~/.config/opencode/opencode.json configuration file
+ * - Installation directories (~/.config/opencode/commands/, ~/.config/opencode/skills/, etc.)
+ */
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { expandPath, pathExists, readFile } from "../file-operations.js";
+const execAsync = promisify(exec);
+/**
+ * OpenCode configuration file paths.
+ */
+export const OPENCODE_PATHS = {
+    configJson: "~/.config/opencode/opencode.json",
+    commands: "~/.config/opencode/commands/",
+    skills: "~/.config/opencode/skills/",
+    agents: "~/.config/opencode/agents/",
+    plugins: "~/.config/opencode/plugins/",
+};
+/**
+ * Check if the opencode binary is available in PATH.
+ */
+export async function checkOpencodeBinary() {
+    try {
+        await execAsync("which opencode");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the OpenCode version from the CLI.
+ */
+export async function getOpencodeVersion() {
+    try {
+        const { stdout } = await execAsync("opencode --version");
+        // Parse version from output (e.g., "opencode 1.0.0" or just "1.0.0")
+        const match = stdout.trim().match(/(\d+\.\d+\.\d+)/);
+        return match ? match[1] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if the OpenCode config file exists.
+ */
+export function checkConfigJson() {
+    return pathExists(OPENCODE_PATHS.configJson);
+}
+/**
+ * Check if installation directories exist.
+ */
+export function checkInstallationPaths() {
+    return {
+        commands: pathExists(OPENCODE_PATHS.commands),
+        skills: pathExists(OPENCODE_PATHS.skills),
+        subagents: pathExists(OPENCODE_PATHS.agents),
+        hooks: pathExists(OPENCODE_PATHS.plugins),
+    };
+}
+/**
+ * Get version from opencode.json if available.
+ */
+export async function getVersionFromConfig() {
+    try {
+        if (!checkConfigJson()) {
+            return undefined;
+        }
+        const content = await readFile(OPENCODE_PATHS.configJson);
+        const parsed = JSON.parse(content);
+        const version = parsed["version"];
+        return typeof version === "string" ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Detect OpenCode installation.
+ *
+ * Detection is considered successful if:
+ * - The opencode binary is in PATH, OR
+ * - The ~/.config/opencode/opencode.json file exists
+ */
+export async function detectOpencode() {
+    const [hasBinary, hasConfig] = await Promise.all([
+        checkOpencodeBinary(),
+        Promise.resolve(checkConfigJson()),
+    ]);
+    const detected = hasBinary || hasConfig;
+    if (!detected) {
+        return {
+            detected: false,
+            globalConfigExists: false,
+            installationPathsExist: {
+                commands: false,
+                skills: false,
+                subagents: false,
+                hooks: false,
+            },
+        };
+    }
+    // Get version
+    let version;
+    if (hasBinary) {
+        version = await getOpencodeVersion();
+    }
+    if (!version && hasConfig) {
+        version = await getVersionFromConfig();
+    }
+    const installationPathsExist = checkInstallationPaths();
+    const configPath = expandPath(OPENCODE_PATHS.configJson);
+    const result = {
+        detected: true,
+        configPath,
+        globalConfigExists: hasConfig,
+        installationPathsExist,
+    };
+    if (version !== undefined) {
+        result.version = version;
+    }
+    return result;
+}
+/**
+ * Get OpenCode installation paths.
+ */
+export function getOpencodeInstallationPaths() {
+    return {
+        commands: OPENCODE_PATHS.commands,
+        skills: OPENCODE_PATHS.skills,
+        subagents: OPENCODE_PATHS.agents,
+        hooks: OPENCODE_PATHS.plugins,
+    };
+}
+//# sourceMappingURL=detection.js.map

package/dist/adapters/opencode/detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../../src/adapters/opencode/detection.ts"],"names":[],"mappings":"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"}

package/dist/adapters/opencode/index.d.ts

@@ -0,0 +1,168 @@
+/**
+ * OpenCode adapter implementation.
+ *
+ * OpenCode is an open-source AI coding assistant with full support for:
+ * - Commands: ~/.config/opencode/commands/{kit}.{name}.md (argumentHint stripped)
+ * - Skills: ~/.config/opencode/skills/{kit}.{name}/
+ * - Subagents: ~/.config/opencode/agents/{kit}.{name}.md
+ * - MCP Servers: ~/.config/opencode/opencode.json (mcp key)
+ * - Hooks: ~/.config/opencode/plugins/{instance}.js
+ *
+ * Note: OpenCode commands have the argumentHint field stripped from frontmatter.
+ */
+import type { PrimitiveType, KitManifest, ResolvedPrimitive, InstallationScope, ResolvedEnvVar, ResolvedHeader, EnvVarOutput, HeaderOutput, EnvVarResolutionResult } from "../../core/types.js";
+import type { CommandMetadata, SkillMetadata, SubagentMetadata, McpServerConfig } from "../../core/types.js";
+import type { InstallationPaths, ConfigLocations, DetectionResult, TransformResult, HookInstallation, HookInstallationInput, ToolMapping, ModelMapping, FileOperationResult } from "../types.js";
+import { BaseAdapter } from "../base-adapter.js";
+import type { CompletedOperation } from "../file-operations.js";
+/**
+ * Project-scope paths for OpenCode.
+ */
+export declare const OPENCODE_PROJECT_PATHS: {
+    readonly configJson: ".opencode/opencode.json";
+    readonly commands: ".opencode/commands/";
+    readonly skills: ".opencode/skills/";
+    readonly agents: ".opencode/agents/";
+    readonly plugins: ".opencode/plugins/";
+    readonly opencodeJson: "opencode.json";
+};
+/**
+ * OpenCode adapter.
+ *
+ * Provides full support for all primitive types.
+ */
+export declare class OpencodeAdapter extends BaseAdapter {
+    readonly name = "opencode";
+    readonly displayName = "OpenCode";
+    readonly version = "1.0.0";
+    readonly supportedHarnessVersions = ">=1.0.0";
+    /**
+     * Get supported installation scopes.
+     *
+     * OpenCode supports both global and project scopes.
+     */
+    getSupportedScopes(): InstallationScope[];
+    /**
+     * Get supported primitive types at the given scope.
+     *
+     * OpenCode supports all primitive types at both scopes.
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getSupportedPrimitives(_scope?: InstallationScope): PrimitiveType[];
+    /**
+     * Get installation paths for file-based primitives.
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getInstallationPaths(scope?: InstallationScope): InstallationPaths;
+    /**
+     * Get configuration file locations.
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getConfigLocations(scope?: InstallationScope): ConfigLocations;
+    /**
+     * Get the tool mapping for OpenCode.
+     */
+    getToolMapping(): ToolMapping;
+    /**
+     * Get the model mapping for OpenCode.
+     */
+    getModelMapping(): ModelMapping;
+    /**
+     * Detect OpenCode installation.
+     */
+    detect(): Promise<DetectionResult>;
+    /**
+     * Transform a command for OpenCode.
+     *
+     * OpenCode uses native Markdown format with YAML frontmatter.
+     * The `argumentHint` field is stripped as OpenCode does not support it.
+     * The `description` field is preserved.
+     */
+    transformCommand(content: string, _metadata: CommandMetadata): TransformResult;
+    /**
+     * Transform a skill for OpenCode.
+     *
+     * OpenCode uses native Markdown format for skills.
+     */
+    transformSkill(_skillDir: string, _metadata: SkillMetadata): TransformResult;
+    /**
+     * OpenCode supports a limited frontmatter set for skills.
+     */
+    protected filterSkillFrontmatter(frontmatter: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * OpenCode subagents do not support hooks in frontmatter.
+     */
+    protected filterSubagentFrontmatter(frontmatter: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Transform a subagent for OpenCode.
+     *
+     * OpenCode uses native Markdown format for subagents.
+     */
+    transformSubagent(content: string, _metadata: SubagentMetadata): TransformResult;
+    /**
+     * Transform an MCP server configuration for OpenCode.
+     */
+    transformMcpServer(config: McpServerConfig): Record<string, unknown>;
+    /**
+     * Transform a hook for OpenCode.
+     */
+    transformHook(hook: HookInstallationInput): HookInstallation;
+    /**
+     * Transform resolved environment variables to OpenCode format.
+     *
+     * OpenCode uses ${VAR} syntax for passthrough, direct values otherwise.
+     * See PRD-001 FR-20.7.
+     */
+    transformEnvVars(resolved: ResolvedEnvVar[]): EnvVarOutput;
+    /**
+     * Transform resolved headers to OpenCode format.
+     *
+     * OpenCode uses ${VAR} syntax for passthrough, direct values otherwise.
+     * See PRD-001 FR-21.6.
+     */
+    transformHeaders(resolved: ResolvedHeader[]): HeaderOutput;
+    /**
+     * Override installPrimitive to handle hook plugin filenames.
+     */
+    protected installPrimitive(kitName: string, primitive: ResolvedPrimitive, resolvedPrimitives: ResolvedPrimitive[], paths: InstallationPaths, dryRun: boolean, completedOps: CompletedOperation[], scope?: InstallationScope, projectRoot?: string): Promise<{
+        destination: string;
+        existed: boolean;
+        operations: FileOperationResult[];
+    }>;
+    /**
+     * Update harness configuration for MCP servers and hooks.
+     *
+     * @param kit - Kit manifest
+     * @param resolvedPrimitives - Resolved primitives to install
+     * @param dryRun - If true, don't actually write files
+     * @param completedOps - Array to track completed operations for rollback
+     * @param scope - Installation scope
+     * @param projectRoot - Project root for project scope
+     */
+    protected updateConfiguration(kit: KitManifest, resolvedPrimitives: ResolvedPrimitive[], dryRun: boolean, completedOps: CompletedOperation[], scope?: InstallationScope, projectRoot?: string, envResolutions?: EnvVarResolutionResult[]): Promise<{
+        operations: FileOperationResult[];
+    }>;
+    private resolveConfigPath;
+    /**
+     * Install MCP servers to configuration.
+     */
+    private installMcpServers;
+    removeMcpServers(instanceNames: string[], scope?: InstallationScope, projectRoot?: string): Promise<string[]>;
+    removeHooks(instanceNames: string[], scope?: InstallationScope, projectRoot?: string): Promise<string[]>;
+    /**
+     * Install hooks as OpenCode plugins.
+     */
+    private installHooks;
+}
+/**
+ * Create an OpenCode adapter instance.
+ */
+export declare function createOpencodeAdapter(): OpencodeAdapter;
+export { detectOpencode, OPENCODE_PATHS } from "./detection.js";
+export { opencodeToolMapping } from "./tool-mapping.js";
+export { opencodeModelMapping } from "./model-mapping.js";
+export * from "./installer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/opencode/index.ts"],"names":[],"mappings":"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"}