codex-octopus 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Xiaolai Li
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/xiaolai/codex-octopus/main/assets/codex-octopus.svg" alt="Codex Octopus" width="200" />
+</p>
+
+# Codex Octopus
+
+One brain, many arms.
+
+An MCP server that wraps the [OpenAI Codex SDK](https://www.npmjs.com/package/@openai/codex-sdk), letting you run multiple specialized Codex agents — each with its own model, sandbox, effort, and personality — from any MCP client.
+
+## Why
+
+Codex is powerful. But one instance does everything the same way. Sometimes you want a **strict code reviewer** in read-only sandbox. A **test writer** with workspace-write access. A **cheap quick helper** on minimal effort. A **deep thinker** on xhigh.
+
+Codex Octopus lets you spin up as many of these as you need. Same binary, different configurations. Each one shows up as a separate tool in your MCP client.
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **Codex CLI** — the [Codex SDK](https://www.npmjs.com/package/@openai/codex-sdk) spawns the Codex CLI under the hood, so you need it installed (`@openai/codex`)
+- **OpenAI API key** (`CODEX_API_KEY` env var) or inherited from parent process
+
+## Install
+
+```bash
+npm install codex-octopus
+```
+
+Or use `npx` directly in your `.mcp.json` (see Quick Start below).
+
+## Quick Start
+
+Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "codex": {
+      "command": "npx",
+      "args": ["codex-octopus"],
+      "env": {
+        "CODEX_SANDBOX_MODE": "workspace-write",
+        "CODEX_APPROVAL_POLICY": "never"
+      }
+    }
+  }
+}
+```
+
+This gives you two tools: `codex` and `codex_reply`. That's it — you have Codex as a tool.
+
+## Multiple Agents
+
+The real power is running several instances with different configurations:
+
+```json
+{
+  "mcpServers": {
+    "code-reviewer": {
+      "command": "npx",
+      "args": ["codex-octopus"],
+      "env": {
+        "CODEX_TOOL_NAME": "code_reviewer",
+        "CODEX_SERVER_NAME": "code-reviewer",
+        "CODEX_DESCRIPTION": "Strict code reviewer. Read-only sandbox.",
+        "CODEX_MODEL": "o3",
+        "CODEX_SANDBOX_MODE": "read-only",
+        "CODEX_APPEND_INSTRUCTIONS": "You are a strict code reviewer. Report real bugs, not style preferences.",
+        "CODEX_EFFORT": "high"
+      }
+    },
+    "test-writer": {
+      "command": "npx",
+      "args": ["codex-octopus"],
+      "env": {
+        "CODEX_TOOL_NAME": "test_writer",
+        "CODEX_SERVER_NAME": "test-writer",
+        "CODEX_DESCRIPTION": "Writes thorough tests with edge case coverage.",
+        "CODEX_MODEL": "gpt-5-codex",
+        "CODEX_SANDBOX_MODE": "workspace-write",
+        "CODEX_APPEND_INSTRUCTIONS": "Write tests first. Cover edge cases. TDD."
+      }
+    },
+    "quick-qa": {
+      "command": "npx",
+      "args": ["codex-octopus"],
+      "env": {
+        "CODEX_TOOL_NAME": "quick_qa",
+        "CODEX_SERVER_NAME": "quick-qa",
+        "CODEX_DESCRIPTION": "Fast answers to quick coding questions.",
+        "CODEX_EFFORT": "minimal"
+      }
+    }
+  }
+}
+```
+
+Your MCP client now sees three distinct tools — `code_reviewer`, `test_writer`, `quick_qa` — each purpose-built.
+
+## Agent Factory
+
+Don't want to write configs by hand? Add a factory instance:
+
+```json
+{
+  "mcpServers": {
+    "agent-factory": {
+      "command": "npx",
+      "args": ["codex-octopus"],
+      "env": {
+        "CODEX_FACTORY_ONLY": "true",
+        "CODEX_SERVER_NAME": "agent-factory"
+      }
+    }
+  }
+}
+```
+
+This exposes a single `create_codex_mcp` tool — an interactive wizard. Tell it what you want ("a strict code reviewer with read-only sandbox") and it generates the `.mcp.json` entry for you.
+
+## Tools
+
+Each non-factory instance exposes:
+
+| Tool           | Purpose                                                |
+| -------------- | ------------------------------------------------------ |
+| `<name>`       | Send a task to the agent, get a response + `thread_id` |
+| `<name>_reply` | Continue a previous conversation by `thread_id`        |
+
+Per-invocation parameters (override server defaults):
+
+| Parameter        | Description                                        |
+| ---------------- | -------------------------------------------------- |
+| `prompt`         | The task or question (required)                    |
+| `cwd`            | Working directory override                         |
+| `model`          | Model override                                     |
+| `additionalDirs` | Extra directories the agent can access             |
+| `effort`         | Reasoning effort (`minimal` to `xhigh`)            |
+| `sandboxMode`    | Sandbox override (can only tighten, never loosen)  |
+| `approvalPolicy` | Approval override (can only tighten, never loosen) |
+| `networkAccess`  | Enable network access from sandbox                 |
+| `webSearchMode`  | Web search: `disabled`, `cached`, `live`           |
+| `instructions`   | Additional instructions (prepended to prompt)      |
+
+## Configuration
+
+All configuration is via environment variables in `.mcp.json`. Every env var is optional.
+
+### Identity
+
+| Env Var              | Description                                   | Default          |
+| -------------------- | --------------------------------------------- | ---------------- |
+| `CODEX_TOOL_NAME`    | Tool name prefix (`<name>` and `<name>_reply`) | `codex`         |
+| `CODEX_DESCRIPTION`  | Tool description shown to the host AI         | generic          |
+| `CODEX_SERVER_NAME`  | MCP server name in protocol handshake         | `codex-octopus`  |
+| `CODEX_FACTORY_ONLY` | Only expose the factory wizard tool           | `false`          |
+
+### Agent
+
+| Env Var                    | Description                                           | Default       |
+| -------------------------- | ----------------------------------------------------- | ------------- |
+| `CODEX_MODEL`              | Model (`gpt-5-codex`, `o3`, `codex-1`, etc.)         | SDK default   |
+| `CODEX_CWD`                | Working directory                                     | `process.cwd()` |
+| `CODEX_SANDBOX_MODE`       | `read-only`, `workspace-write`, `danger-full-access`  | `read-only`   |
+| `CODEX_APPROVAL_POLICY`    | `never`, `on-failure`, `on-request`, `untrusted`      | `on-failure`  |
+| `CODEX_EFFORT`             | `minimal`, `low`, `medium`, `high`, `xhigh`           | SDK default   |
+| `CODEX_ADDITIONAL_DIRS`    | Extra directories (comma-separated)                   | none          |
+| `CODEX_NETWORK_ACCESS`     | Allow network from sandbox                            | `false`       |
+| `CODEX_WEB_SEARCH`         | `disabled`, `cached`, `live`                          | `disabled`    |
+
+### Instructions
+
+| Env Var                      | Description                                              |
+| ---------------------------- | -------------------------------------------------------- |
+| `CODEX_INSTRUCTIONS`         | Replaces the default instructions                        |
+| `CODEX_APPEND_INSTRUCTIONS`  | Appended to the default (usually what you want)          |
+
+### Advanced
+
+| Env Var                | Description                                              |
+| ---------------------- | -------------------------------------------------------- |
+| `CODEX_PERSIST_SESSION`| `true`/`false` — enable session resume (default: `true`) |
+
+### Authentication
+
+| Env Var         | Description                    | Default               |
+| --------------- | ------------------------------ | --------------------- |
+| `CODEX_API_KEY` | OpenAI API key for this agent  | inherited from parent |
+
+## Security
+
+- **Sandbox defaults to `read-only`** — the agent can't write files unless you explicitly set `workspace-write` or `danger-full-access`.
+- **`cwd` overrides preserve agent knowledge** — when the host overrides `cwd`, the agent's configured base directory is automatically added to `additionalDirectories`.
+- **Security overrides narrow, never widen** — per-invocation `sandboxMode` and `approvalPolicy` can only tighten (e.g., `workspace-write` → `read-only`), never loosen.
+- **`_reply` tool respects persistence** — not registered when `CODEX_PERSIST_SESSION=false`.
+- **API keys are redacted** — the factory wizard never exposes `CODEX_API_KEY` in generated configs.
+
+## Architecture
+
+```
+┌─────────────────────────────────┐
+│  MCP Client                     │
+│  (Claude Desktop, Cursor, etc.) │
+│                                 │
+│  Sees: code_reviewer,           │
+│        test_writer, quick_qa    │
+└──────────┬──────────────────────┘
+           │ JSON-RPC / stdio
+┌──────────▼──────────────────────┐
+│  Codex Octopus (per instance)   │
+│                                 │
+│  Env: CODEX_MODEL=o3            │
+│       CODEX_SANDBOX_MODE=...    │
+│       CODEX_APPEND_INSTRUCTIONS │
+│                                 │
+│  Calls: Codex SDK thread.run()  │
+└──────────┬──────────────────────┘
+           │ in-process
+┌──────────▼──────────────────────┐
+│  Codex SDK → Codex CLI          │
+│  Runs autonomously: reads files,│
+│  writes code, runs commands     │
+│  Returns result + thread_id     │
+└─────────────────────────────────┘
+```
+
+## Known Limitations
+
+- **`minimal` effort + web_search**: OpenAI does not allow `web_search` tools with `minimal` reasoning effort. Use `low` or higher if web search is needed.
+
+## Development
+
+```bash
+pnpm install
+pnpm build       # compile TypeScript
+pnpm test        # run tests (vitest)
+pnpm test:coverage  # coverage report
+```
+
+## License
+
+[ISC](https://github.com/xiaolai/codex-octopus/blob/main/LICENSE) - Xiaolai Li

package/assets/codex-octopus.svg

@@ -0,0 +1,48 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32" shape-rendering="crispEdges">
+<rect x="7" y="6" width="18" height="1" fill="#606060"/>
+<rect x="7" y="7" width="18" height="1" fill="#606060"/>
+<rect x="7" y="8" width="18" height="1" fill="#606060"/>
+<rect x="7" y="9" width="18" height="1" fill="#606060"/>
+<rect x="7" y="10" width="4" height="1" fill="#606060"/>
+<rect x="13" y="10" width="6" height="1" fill="#606060"/>
+<rect x="21" y="10" width="4" height="1" fill="#606060"/>
+<rect x="7" y="11" width="4" height="1" fill="#606060"/>
+<rect x="13" y="11" width="6" height="1" fill="#606060"/>
+<rect x="21" y="11" width="4" height="1" fill="#606060"/>
+<rect x="5" y="12" width="22" height="1" fill="#606060"/>
+<rect x="5" y="13" width="22" height="1" fill="#606060"/>
+<rect x="3" y="14" width="26" height="1" fill="#606060"/>
+<rect x="3" y="15" width="26" height="1" fill="#606060"/>
+<rect x="3" y="16" width="26" height="1" fill="#606060"/>
+<rect x="3" y="17" width="26" height="1" fill="#606060"/>
+<rect x="3" y="18" width="22" height="1" fill="#606060"/>
+<rect x="27" y="18" width="2" height="1" fill="#606060"/>
+<rect x="3" y="19" width="22" height="1" fill="#606060"/>
+<rect x="27" y="19" width="2" height="1" fill="#606060"/>
+<rect x="3" y="20" width="2" height="1" fill="#606060"/>
+<rect x="7" y="20" width="18" height="1" fill="#606060"/>
+<rect x="27" y="20" width="2" height="1" fill="#606060"/>
+<rect x="3" y="21" width="2" height="1" fill="#606060"/>
+<rect x="7" y="21" width="18" height="1" fill="#606060"/>
+<rect x="27" y="21" width="2" height="1" fill="#606060"/>
+<rect x="7" y="22" width="2" height="1" fill="#606060"/>
+<rect x="11" y="22" width="2" height="1" fill="#606060"/>
+<rect x="15" y="22" width="2" height="1" fill="#606060"/>
+<rect x="19" y="22" width="2" height="1" fill="#606060"/>
+<rect x="23" y="22" width="2" height="1" fill="#606060"/>
+<rect x="7" y="23" width="2" height="1" fill="#606060"/>
+<rect x="11" y="23" width="2" height="1" fill="#606060"/>
+<rect x="15" y="23" width="2" height="1" fill="#606060"/>
+<rect x="19" y="23" width="2" height="1" fill="#606060"/>
+<rect x="23" y="23" width="2" height="1" fill="#606060"/>
+<rect x="7" y="24" width="2" height="1" fill="#606060"/>
+<rect x="11" y="24" width="2" height="1" fill="#606060"/>
+<rect x="15" y="24" width="2" height="1" fill="#606060"/>
+<rect x="19" y="24" width="2" height="1" fill="#606060"/>
+<rect x="23" y="24" width="2" height="1" fill="#606060"/>
+<rect x="7" y="25" width="2" height="1" fill="#606060"/>
+<rect x="11" y="25" width="2" height="1" fill="#606060"/>
+<rect x="15" y="25" width="2" height="1" fill="#606060"/>
+<rect x="19" y="25" width="2" height="1" fill="#606060"/>
+<rect x="23" y="25" width="2" height="1" fill="#606060"/>
+</svg>

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import type { ThreadConfig } from "./types.js";
+export declare function buildBaseConfig(): ThreadConfig;

package/dist/config.js

@@ -0,0 +1,47 @@
+import { envStr, envList, envBool, validateSandboxMode, validateApprovalPolicy, validateEffort, } from "./lib.js";
+export function buildBaseConfig() {
+    const config = {
+        cwd: envStr("CODEX_CWD") || process.cwd(),
+        persistSession: envBool("CODEX_PERSIST_SESSION", true),
+    };
+    const model = envStr("CODEX_MODEL");
+    if (model)
+        config.model = model;
+    const rawSandbox = envStr("CODEX_SANDBOX_MODE") || "read-only";
+    const sandbox = validateSandboxMode(rawSandbox);
+    if (rawSandbox !== sandbox) {
+        console.error(`codex-octopus: invalid CODEX_SANDBOX_MODE "${rawSandbox}", using "read-only"`);
+    }
+    config.sandboxMode = sandbox;
+    const rawApproval = envStr("CODEX_APPROVAL_POLICY") || "on-failure";
+    const approval = validateApprovalPolicy(rawApproval);
+    if (rawApproval !== approval) {
+        console.error(`codex-octopus: invalid CODEX_APPROVAL_POLICY "${rawApproval}", using "on-failure"`);
+    }
+    config.approvalPolicy = approval;
+    const effort = envStr("CODEX_EFFORT");
+    if (effort) {
+        const validated = validateEffort(effort);
+        if (effort !== validated) {
+            console.error(`codex-octopus: invalid CODEX_EFFORT "${effort}", using "medium"`);
+        }
+        config.effort = validated;
+    }
+    const dirs = envList("CODEX_ADDITIONAL_DIRS");
+    if (dirs)
+        config.additionalDirectories = dirs;
+    const networkAccess = envStr("CODEX_NETWORK_ACCESS");
+    if (networkAccess !== undefined) {
+        config.networkAccess = networkAccess === "true" || networkAccess === "1";
+    }
+    const webSearch = envStr("CODEX_WEB_SEARCH");
+    if (webSearch)
+        config.webSearchMode = webSearch;
+    const instructions = envStr("CODEX_INSTRUCTIONS");
+    if (instructions)
+        config.instructions = instructions;
+    const appendInstructions = envStr("CODEX_APPEND_INSTRUCTIONS");
+    if (appendInstructions)
+        config.appendInstructions = appendInstructions;
+    return config;
+}

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+import type { OptionCatalogEntry } from "./types.js";
+export declare const OPTION_CATALOG: OptionCatalogEntry[];

package/dist/constants.js

@@ -0,0 +1,86 @@
+export const OPTION_CATALOG = [
+    {
+        key: "model",
+        envVar: "CODEX_MODEL",
+        label: "Model",
+        hint: "Which model to use",
+        example: '"gpt-5-codex", "o3", "codex-1"',
+    },
+    {
+        key: "appendInstructions",
+        envVar: "CODEX_APPEND_INSTRUCTIONS",
+        label: "Behavior instructions",
+        hint: "Instructions appended to the default system prompt",
+        example: '"Always explain your reasoning step by step."',
+    },
+    {
+        key: "instructions",
+        envVar: "CODEX_INSTRUCTIONS",
+        label: "Full instructions",
+        hint: "Completely replaces the default instructions",
+        example: '"You are a security auditor..."',
+    },
+    {
+        key: "sandboxMode",
+        envVar: "CODEX_SANDBOX_MODE",
+        label: "Sandbox mode",
+        hint: "How file system access is restricted",
+        example: '"read-only", "workspace-write", "danger-full-access"',
+    },
+    {
+        key: "approvalPolicy",
+        envVar: "CODEX_APPROVAL_POLICY",
+        label: "Approval policy",
+        hint: "When to prompt for command approval",
+        example: '"never" (auto-approve), "on-failure", "on-request", "untrusted"',
+    },
+    {
+        key: "cwd",
+        envVar: "CODEX_CWD",
+        label: "Working directory",
+        hint: "Default directory the agent operates in",
+        example: '"/home/user/project"',
+    },
+    {
+        key: "additionalDirs",
+        envVar: "CODEX_ADDITIONAL_DIRS",
+        label: "Additional directories",
+        hint: "Extra directories the agent can access (comma-separated)",
+        example: '"/shared/libs,/data"',
+    },
+    {
+        key: "effort",
+        envVar: "CODEX_EFFORT",
+        label: "Reasoning effort",
+        hint: "How hard the agent thinks",
+        example: '"minimal" (fastest), "low", "medium", "high", "xhigh" (deepest)',
+    },
+    {
+        key: "networkAccess",
+        envVar: "CODEX_NETWORK_ACCESS",
+        label: "Network access",
+        hint: "Allow network access from sandbox",
+        example: '"true" or "false" (default)',
+    },
+    {
+        key: "webSearchMode",
+        envVar: "CODEX_WEB_SEARCH",
+        label: "Web search",
+        hint: "Web search mode",
+        example: '"disabled" (default), "cached", "live"',
+    },
+    {
+        key: "persistSession",
+        envVar: "CODEX_PERSIST_SESSION",
+        label: "Persist sessions",
+        hint: "Save sessions for later resume via _reply tool",
+        example: '"true" (default) or "false"',
+    },
+    {
+        key: "apiKey",
+        envVar: "CODEX_API_KEY",
+        label: "API key",
+        hint: "OpenAI API key for this agent (overrides inherited auth)",
+        example: '"sk-..." — leave unset to inherit from parent',
+    },
+];

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Codex Octopus — one brain, many arms.
+ *
+ * Wraps the OpenAI Codex SDK as MCP servers, letting you spawn multiple
+ * specialized Codex agents — each with its own model, sandbox, effort,
+ * and personality.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * Codex Octopus — one brain, many arms.
+ *
+ * Wraps the OpenAI Codex SDK as MCP servers, letting you spawn multiple
+ * specialized Codex agents — each with its own model, sandbox, effort,
+ * and personality.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createRequire } from "node:module";
+import { envStr, envBool, sanitizeToolName } from "./lib.js";
+import { buildBaseConfig } from "./config.js";
+import { registerQueryTools } from "./tools/query.js";
+import { registerFactoryTool } from "./tools/factory.js";
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require("../package.json");
+// ── Configuration ──────────────────────────────────────────────────
+const BASE_CONFIG = buildBaseConfig();
+const API_KEY = envStr("CODEX_API_KEY");
+const TOOL_NAME = sanitizeToolName(envStr("CODEX_TOOL_NAME") || "codex");
+const REPLY_TOOL_NAME = `${TOOL_NAME}_reply`;
+const SERVER_NAME = envStr("CODEX_SERVER_NAME") || "codex-octopus";
+const FACTORY_ONLY = envBool("CODEX_FACTORY_ONLY", false);
+const DEFAULT_DESCRIPTION = [
+    "Send a task to an autonomous Codex agent.",
+    "It reads/writes files, runs shell commands, searches codebases,",
+    "and handles complex software engineering tasks end-to-end.",
+    `Returns the result text plus a thread_id for follow-ups via ${REPLY_TOOL_NAME}.`,
+].join(" ");
+const TOOL_DESCRIPTION = envStr("CODEX_DESCRIPTION") || DEFAULT_DESCRIPTION;
+// ── Server ─────────────────────────────────────────────────────────
+const server = new McpServer({ name: SERVER_NAME, version: PKG_VERSION });
+if (!FACTORY_ONLY) {
+    registerQueryTools(server, BASE_CONFIG, TOOL_NAME, TOOL_DESCRIPTION, API_KEY);
+}
+if (FACTORY_ONLY) {
+    registerFactoryTool(server);
+}
+// ── Start ──────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    const toolList = FACTORY_ONLY
+        ? ["create_codex_mcp"]
+        : BASE_CONFIG.persistSession !== false
+            ? [TOOL_NAME, REPLY_TOOL_NAME]
+            : [TOOL_NAME];
+    console.error(`${SERVER_NAME}: running on stdio (tools: ${toolList.join(", ")})`);
+}
+main().catch((error) => {
+    console.error(`${SERVER_NAME}: fatal:`, error);
+    process.exit(1);
+});

package/dist/lib.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pure, testable logic extracted from index.ts.
+ */
+export declare function envStr(key: string, env?: Record<string, string | undefined>): string | undefined;
+export declare function envList(key: string, env?: Record<string, string | undefined>): string[] | undefined;
+export declare function envNum(key: string, env?: Record<string, string | undefined>): number | undefined;
+export declare function envBool(key: string, fallback: boolean, env?: Record<string, string | undefined>): boolean;
+export declare const MAX_TOOL_NAME_LEN: number;
+export declare function sanitizeToolName(raw: string): string;
+export declare function isDescendantPath(requested: string, baseCwd: string): boolean;
+export declare const VALID_SANDBOX_MODES: Set<string>;
+export declare function validateSandboxMode(mode: string): string;
+/**
+ * Narrow sandbox mode: returns the stricter of base and override.
+ * Callers can tighten but never loosen.
+ */
+export declare function narrowSandboxMode(base: string, override: string): string;
+export declare const VALID_APPROVAL_POLICIES: Set<string>;
+export declare function validateApprovalPolicy(policy: string): string;
+/**
+ * Narrow approval policy: returns the stricter of base and override.
+ * Callers can tighten but never loosen.
+ */
+export declare function narrowApprovalPolicy(base: string, override: string): string;
+export declare const VALID_EFFORTS: Set<string>;
+export declare function validateEffort(effort: string): string;
+export declare function deriveServerName(description: string): string;
+export declare function deriveToolName(name: string): string;
+export declare function serializeArrayEnv(val: unknown[]): string;
+export declare function formatErrorMessage(error: unknown): string;