@hashicorp/kits 0.1.0

package/dist/adapters/codex/index.js

@@ -0,0 +1,344 @@
+/**
+ * Codex adapter implementation.
+ *
+ * Codex is an AI coding assistant with support for:
+ * - Commands: ~/.codex/prompts/{kit}.{name}.md
+ * - Skills: ~/.codex/skills/{kit}.{name}/
+ * - MCP Servers: ~/.codex/mcp.json
+ *
+ * Codex does NOT support:
+ * - Subagents
+ * - Hooks
+ */
+import { BaseAdapter } from "../base-adapter.js";
+import { expandPath, pathExists, readFile } from "../file-operations.js";
+import { filterFrontmatterAllowlist, toKebabCaseSkillFrontmatter } from "../skill-frontmatter.js";
+import { renameFrontmatterField } from "../command-parser.js";
+import { detectCodex, getCodexInstallationPaths, CODEX_PATHS } from "./detection.js";
+import { codexToolMapping } from "./tool-mapping.js";
+import { codexModelMapping } from "./model-mapping.js";
+import { transformMcpServerConfig, transformEnvVars as installerTransformEnvVars, transformHeaders as installerTransformHeaders, readMcpConfig, writeMcpConfig, } from "./installer.js";
+/**
+ * Project-scope paths for Codex.
+ *
+ * Note: Codex only supports skills at project scope.
+ * Commands and MCP are global-only.
+ */
+export const CODEX_PROJECT_PATHS = {
+    configToml: ".codex/config.toml",
+    skills: ".codex/skills/",
+};
+/**
+ * Codex adapter.
+ *
+ * Provides support for commands, skills, and MCP servers.
+ * Does not support subagents or hooks.
+ *
+ * IMPORTANT: At project scope, Codex only supports skills.
+ * Commands and MCP servers are global-only.
+ */
+export class CodexAdapter extends BaseAdapter {
+    name = "codex";
+    displayName = "Codex";
+    version = "1.0.0";
+    supportedHarnessVersions = ">=1.0.0";
+    /**
+     * Get supported installation scopes.
+     *
+     * Codex supports both global and project scopes,
+     * but with different primitive support at each scope.
+     */
+    getSupportedScopes() {
+        return ["global", "project"];
+    }
+    /**
+     * Get supported primitive types at the given scope.
+     *
+     * Codex supports:
+     * - Global: commands, skills, mcp
+     * - Project: skills only (commands and mcp are global-only)
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getSupportedPrimitives(scope) {
+        if (scope === "project") {
+            // Codex only supports skills at project scope
+            return ["skills"];
+        }
+        return ["commands", "skills", "mcp"];
+    }
+    /**
+     * Get installation paths for file-based primitives.
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getInstallationPaths(scope) {
+        if (scope === "project") {
+            return {
+                commands: "", // Not supported at project scope
+                skills: CODEX_PROJECT_PATHS.skills,
+                // Codex does not support subagents or hooks
+            };
+        }
+        return getCodexInstallationPaths();
+    }
+    /**
+     * Get configuration file locations.
+     *
+     * @param scope - Installation scope (defaults to "global")
+     */
+    getConfigLocations(scope) {
+        if (scope === "project") {
+            return {
+                primary: CODEX_PROJECT_PATHS.configToml,
+                // No MCP at project scope
+                format: "toml",
+            };
+        }
+        return {
+            primary: CODEX_PATHS.configToml,
+            mcp: CODEX_PATHS.mcp,
+            format: "toml",
+        };
+    }
+    /**
+     * Get the tool mapping for Codex.
+     */
+    getToolMapping() {
+        return codexToolMapping;
+    }
+    /**
+     * Get the model mapping for Codex.
+     */
+    getModelMapping() {
+        return codexModelMapping;
+    }
+    /**
+     * Detect Codex installation.
+     */
+    async detect() {
+        return detectCodex();
+    }
+    /**
+     * Transform a command for Codex.
+     *
+     * Codex uses native Markdown format, so no transformation is needed.
+     * Tool templates are processed separately by the base adapter.
+     */
+    transformCommand(content, _metadata) {
+        const transformedContent = renameFrontmatterField(content, "argumentHint", "argument-hint");
+        return {
+            content: transformedContent,
+            format: "markdown",
+        };
+    }
+    /**
+     * Transform a skill for Codex.
+     *
+     * Codex uses native Markdown format for skills.
+     */
+    transformSkill(_skillDir, _metadata) {
+        // Skills are directories, content is the SKILL.md file path
+        return {
+            content: "",
+            format: "markdown",
+        };
+    }
+    /**
+     * Codex skills only recognize a minimal set of frontmatter fields.
+     */
+    filterSkillFrontmatter(frontmatter) {
+        const normalized = toKebabCaseSkillFrontmatter(frontmatter);
+        return filterFrontmatterAllowlist(normalized, new Set(["name", "description", "allowed-tools", "metadata"]));
+    }
+    /**
+     * Transform a subagent for Codex.
+     *
+     * Codex does not support subagents. This method throws an error.
+     */
+    transformSubagent(_content, _metadata) {
+        throw new Error("codex does not support subagents");
+    }
+    /**
+     * Transform an MCP server configuration for Codex.
+     */
+    transformMcpServer(config) {
+        return transformMcpServerConfig(config);
+    }
+    /**
+     * Transform a hook for Codex.
+     *
+     * Codex does not support hooks. This method throws an error.
+     */
+    transformHook(_hook) {
+        throw new Error("codex does not support hooks");
+    }
+    /**
+     * Transform resolved environment variables to Codex format.
+     *
+     * Codex uses two distinct mechanisms:
+     * - env_vars array for passthrough
+     * - env table for direct values
+     *
+     * See PRD-001 FR-20.4.
+     */
+    transformEnvVars(resolved) {
+        return installerTransformEnvVars(resolved);
+    }
+    /**
+     * Transform resolved headers to Codex format.
+     *
+     * Codex uses specialized fields:
+     * - bearer_token_env_var for Authorization headers
+     * - env_http_headers for other env var headers
+     * - http_headers for static values
+     *
+     * See PRD-001 FR-21.3.
+     */
+    transformHeaders(resolved) {
+        return installerTransformHeaders(resolved);
+    }
+    /**
+     * Update harness configuration for MCP servers.
+     *
+     * Codex only needs MCP configuration updates (no hooks support).
+     * MCP is only supported at global scope.
+     *
+     * @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
+     */
+    async updateConfiguration(kit, resolvedPrimitives, dryRun, completedOps, scope = "global", _projectRoot, envResolutions) {
+        const operations = [];
+        // MCP is only supported at global scope for Codex
+        if (scope === "project") {
+            return { operations };
+        }
+        // Filter MCP primitives
+        const mcpPrimitives = resolvedPrimitives.filter((p) => p.type === "mcp");
+        // Handle MCP servers (global scope only)
+        if (mcpPrimitives.length > 0 && !dryRun) {
+            const mcpResult = await this.installMcpServers(kit.name, mcpPrimitives, completedOps, envResolutions);
+            operations.push(...mcpResult);
+        }
+        return { operations };
+    }
+    /**
+     * Install MCP servers to configuration.
+     */
+    async installMcpServers(_kitName, primitives, completedOps, envResolutions) {
+        const operations = [];
+        const mcpConfigPath = expandPath(CODEX_PATHS.mcp);
+        // Read existing config and back it up
+        const existingConfig = await readMcpConfig();
+        const configExisted = pathExists(mcpConfigPath);
+        // Prepare updated config
+        const updatedConfig = { ...existingConfig };
+        if (!updatedConfig.servers) {
+            updatedConfig.servers = {};
+        }
+        for (const primitive of primitives) {
+            try {
+                // Read MCP config from source file
+                const content = await readFile(primitive.sourcePath);
+                const mcpConfig = JSON.parse(content);
+                const instanceName = primitive.instanceName ?? mcpConfig.name;
+                if (!instanceName) {
+                    throw new Error(`MCP config missing name; path=${primitive.sourcePath}`);
+                }
+                // Transform and add to config
+                const transformedConfig = transformMcpServerConfig(mcpConfig);
+                // Apply resolved env vars if available (Codex uses env_vars array and env table)
+                const resolution = envResolutions?.find((r) => r.mcpServer === instanceName);
+                if (resolution && resolution.resolved.length > 0) {
+                    const transformedEnv = installerTransformEnvVars(resolution.resolved);
+                    // Codex format: env_vars for passthrough, env for direct values
+                    if (transformedEnv.env_vars && transformedEnv.env_vars.length > 0) {
+                        transformedConfig.env_vars = transformedEnv.env_vars;
+                    }
+                    if (transformedEnv.env && Object.keys(transformedEnv.env).length > 0) {
+                        transformedConfig.env = transformedEnv.env;
+                    }
+                }
+                // Apply resolved headers if available (for HTTP transport)
+                if (resolution && resolution.resolvedHeaders && resolution.resolvedHeaders.length > 0) {
+                    const transformedHeaders = installerTransformHeaders(resolution.resolvedHeaders);
+                    if (transformedConfig.url) {
+                        if (transformedHeaders.bearer_token_env_var) {
+                            transformedConfig.bearer_token_env_var = transformedHeaders.bearer_token_env_var;
+                        }
+                        if (transformedHeaders.env_http_headers && Object.keys(transformedHeaders.env_http_headers).length > 0) {
+                            transformedConfig.env_http_headers = transformedHeaders.env_http_headers;
+                        }
+                        if (transformedHeaders.http_headers && Object.keys(transformedHeaders.http_headers).length > 0) {
+                            transformedConfig.http_headers = transformedHeaders.http_headers;
+                        }
+                    }
+                }
+                updatedConfig.servers[instanceName] = transformedConfig;
+                operations.push({
+                    operation: "merge",
+                    source: primitive.sourcePath,
+                    destination: mcpConfigPath,
+                    success: true,
+                });
+            }
+            catch (error) {
+                operations.push({
+                    operation: "merge",
+                    source: primitive.sourcePath,
+                    destination: mcpConfigPath,
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        // Write updated config
+        await writeMcpConfig(updatedConfig);
+        const mcpCompletedOp = {
+            type: "file",
+            path: mcpConfigPath,
+            createdNew: !configExisted,
+        };
+        if (configExisted) {
+            mcpCompletedOp.previousContent = JSON.stringify(existingConfig, null, 2);
+        }
+        completedOps.push(mcpCompletedOp);
+        return operations;
+    }
+    async removeMcpServers(instanceNames, scope = "global") {
+        if (scope === "project" || instanceNames.length === 0) {
+            return [];
+        }
+        const mcpConfig = await readMcpConfig();
+        if (!mcpConfig.servers) {
+            return [];
+        }
+        const removed = [];
+        for (const name of instanceNames) {
+            if (mcpConfig.servers[name]) {
+                delete mcpConfig.servers[name];
+                removed.push(name);
+            }
+        }
+        if (removed.length > 0) {
+            await writeMcpConfig(mcpConfig);
+        }
+        return removed;
+    }
+}
+/**
+ * Create a Codex adapter instance.
+ */
+export function createCodexAdapter() {
+    return new CodexAdapter();
+}
+// Re-export types and utilities
+export { detectCodex, CODEX_PATHS } from "./detection.js";
+export { codexToolMapping } from "./tool-mapping.js";
+export { codexModelMapping } from "./model-mapping.js";
+export * from "./installer.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/codex/index.js.map

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

package/dist/adapters/codex/installer.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Codex installation helpers.
+ *
+ * Provides utilities for installing primitives to Codex:
+ * - MCP server configuration in ~/.codex/mcp.json
+ * - Environment variable substitution
+ *
+ * Codex does not support subagents or hooks.
+ */
+import type { McpServerConfig, ResolvedEnvVar, ResolvedHeader } from "../../core/types.js";
+import type { FileOperationResult } from "../types.js";
+/**
+ * Codex MCP configuration structure.
+ */
+export interface CodexMcpConfig {
+    servers?: Record<string, CodexMcpServerEntry>;
+}
+/**
+ * MCP server entry in Codex config.
+ *
+ * Codex uses a slightly different format than Claude Code,
+ * storing config as TOML-style objects.
+ */
+export interface CodexMcpServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    env_vars?: string[];
+    url?: string;
+    bearer_token_env_var?: string;
+    env_http_headers?: Record<string, string>;
+    http_headers?: Record<string, string>;
+}
+/**
+ * Read the MCP configuration file.
+ */
+export declare function readMcpConfig(): Promise<CodexMcpConfig>;
+/**
+ * Write the MCP configuration file.
+ */
+export declare function writeMcpConfig(config: CodexMcpConfig): Promise<void>;
+/**
+ * Process environment variable values.
+ *
+ * Codex uses ${VAR} syntax for environment variable references.
+ */
+export declare function processEnvValue(value: string): string;
+/**
+ * Transform an MCP server configuration for Codex.
+ *
+ * Codex MCP configuration format:
+ * ```json
+ * {
+ *   "servers": {
+ *     "server-name": {
+ *       "command": "executable",
+ *       "args": ["arg1", "arg2"],
+ *       "env": {
+ *         "VAR": "${VAR}"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * Note: Full environment variable transformation with sensitivity handling
+ * (env_vars array vs env table) is implemented in transformEnvVars (Phase 7).
+ * This function provides basic passthrough for all env vars using ${VAR} syntax.
+ */
+export declare function transformMcpServerConfig(config: McpServerConfig): CodexMcpServerEntry;
+/**
+ * Codex environment variable transformation result.
+ * Includes index signature for compatibility with EnvVarOutput base type.
+ */
+export interface CodexEnvVarOutput {
+    env_vars: string[];
+    env: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Codex header transformation result.
+ * Includes index signature for compatibility with HeaderOutput base type.
+ */
+export interface CodexHeaderOutput {
+    bearer_token_env_var: string | undefined;
+    env_http_headers: Record<string, string>;
+    http_headers: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Transform resolved environment variables to Codex format.
+ *
+ * Codex uses two distinct mechanisms:
+ * - `env_vars` array: Variables passed through from shell environment (passthrough)
+ * - `env` table: Variables with direct values
+ *
+ * Rules (per FR-20.4):
+ * - usePassthrough: true → Add to env_vars array
+ * - usePassthrough: false (has value) → Add to env table
+ */
+export declare function transformEnvVars(resolved: ResolvedEnvVar[]): CodexEnvVarOutput;
+/**
+ * Transform resolved headers to Codex format.
+ *
+ * Codex uses specialized fields for HTTP authentication:
+ * - `bearer_token_env_var`: Environment variable containing bearer token (for Authorization headers)
+ * - `env_http_headers`: Table of additional headers with env var references
+ * - `http_headers`: Table of static header values
+ *
+ * Bearer Token Detection:
+ * The adapter detects bearer token patterns in Authorization headers:
+ * 1. Header name is "Authorization" (case-insensitive)
+ * 2. Header is marked sensitive: true
+ * 3. Uses envVar for the token value
+ *
+ * Rules (per FR-21.3):
+ * - Authorization + sensitive + envVar → bearer_token_env_var = "VAR"
+ * - Other headers with envVar → env_http_headers.Header = "$VAR"
+ * - Headers with static value → http_headers.Header = "value"
+ */
+export declare function transformHeaders(resolved: ResolvedHeader[]): CodexHeaderOutput;
+/**
+ * Add an MCP server to the configuration.
+ *
+ * @param namespacedName - The namespaced server name (e.g., "kit.server")
+ * @param config - The MCP server configuration
+ */
+export declare function addMcpServer(namespacedName: string, config: McpServerConfig): Promise<FileOperationResult>;
+/**
+ * Remove an MCP server from the configuration.
+ *
+ * @param namespacedName - The namespaced server name to remove
+ */
+export declare function removeMcpServer(namespacedName: string): Promise<boolean>;
+/**
+ * Get all installed MCP servers for a specific kit.
+ *
+ * @param kitName - The kit name prefix to filter by
+ */
+export declare function getKitMcpServers(kitName: string): Promise<string[]>;
+/**
+ * Remove all MCP servers for a specific kit.
+ *
+ * @param kitName - The kit name prefix to remove
+ */
+export declare function removeKitMcpServers(kitName: string): Promise<string[]>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/adapters/codex/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex/installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAa7D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAwBrF;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,iBAAiB,CAa9E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,iBAAiB,CAiB9E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU9E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWzE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqB5E"}