Merge pull request #12 from hyperweb-io/fix/starship-gen-tool

Fix generateStarshipConfig tool

Author: marslavish

docs/features.mdx

@@ -36,7 +36,7 @@ Our MCP server, easily runnable with `npx -y @hyperweb/mcp-server@latest`, provi
 
 - **Starship (`setupStarship`, `generateStarshipConfig`, `verifyStarshipConfig`)**
   - Provides guidance on setting up Starship, a unified development and testing environment for Cosmos chains.
-  - Features a powerful configuration generator (`generateStarshipConfig`) that creates detailed `config.yaml` files based on user inputs for chains, relayers, explorers, and more.
+  - Features a powerful configuration helper (`generateStarshipConfig`) that provides comprehensive documentation and type definitions to assist in creating detailed `config.yaml` files.
   - Includes a validation tool (`verifyStarshipConfig`) to parse and check Starship YAML configurations against the official schema, ensuring correctness before deployment.
 
 ---

docs/references.mdx

@@ -65,57 +65,16 @@ Tools for interacting with Starship, the unified development and testing environ
 
 ### `generateStarshipConfig`
 
-- **Description**: Generates a Starship configuration file in YAML format based on detailed input options then creates the file (e.g., `starship/config.yaml`) in the workspace.
+- **Description**: This tool helps generate Starship configuration files by providing comprehensive documentation and type definitions.
 - **Source**: `src/starship/tools/starship-config-gen.ts`
-- **Parameters (StarshipConfigInput)**:
-  - `configFilePath` (string, required): The absolute path to the Starship configuration file (e.g., `<current_working_directory>/starship/config.yaml`).
-  - `configName` (string, optional, default: "starship"): Top-level configuration name.
-  - `configVersion` (string, optional, default: "1.6.0"): Top-level configuration version.
-  - `chains` (array of ChainConfig, required, min: 1): List of chain configurations. Each `ChainConfig` includes:
-    - `id` (string, required): Unique identifier for the chain.
-    - `name` (string, required): Type of chain (e.g., 'osmosis', 'custom').
-    - `numValidators` (integer, required, positive): Number of validators.
-    - `image` (string, optional): Override default Docker image.
-    - `home` (string, optional): Home directory path (for `name: 'custom'`).
-    - `binary` (string, optional): Binary name (for `name: 'custom'`).
-    - `prefix` (string, optional): Address prefix (for `name: 'custom'`).
-    - `denom` (string, optional): Primary denomination (for `name: 'custom'`).
-    - `coins` (string, optional): Genesis coins.
-    - `hdPath` (string, optional): HD path.
-    - `coinType` (integer, optional): Coin type.
-    - `repo` (string URL, optional): Git repository URL.
-    - `ports` (object, optional): Port forwarding (`rest`, `rpc`, `grpc`, `faucet`, `exposer`).
-    - `resources` (object, optional): CPU/memory allocation (`cpu`, `memory`).
-    - `faucet` (object, optional): Faucet config (`enabled`, `type`, `image`, `concurrency`, `resources`).
-    - `build` (object, optional): On-the-fly build config (`enabled`, `source`).
-    - `upgrade` (object, optional): Upgrade prep config (`enabled`, `type`, `genesis`, `upgrades` array).
-    - `genesis` (object, optional): `genesis.json` patches (`app_state`).
-    - `scripts` (object, optional): Override setup scripts.
-    - `cometmock` (object, optional): CometMock config (`enabled`, `image`).
-    - `env` (array of EnvVar, optional): Custom environment variables (`name`, `value`).
-    - `ics` (object, optional): ICS config for consumer chains (`enabled`, `provider`).
-    - `balances` (array of BalanceEntry, optional): Initial balances (`address`, `amount`).
-    - `readinessProbe` (object, optional): Custom readiness probe.
-    - `config` (object, optional): Ethereum-specific config (if `name` is 'ethereum').
-  - `relayers` (array of RelayerConfig, optional): List of relayer configurations. Each `RelayerConfig` includes:
-    - `name` (string, required): Name for the relayer instance.
-    - `type` (enum: `hermes` | `ts-relayer` | `go-relayer` | `neutron-query-relayer`, required): Type of relayer.
-    - `image` (string, optional): Override default Docker image.
-    - `replicas` (integer, optional, default: 1): Number of replicas (currently 1).
-    - `chains` (array of string, required, min: 2): Chain IDs to connect.
-    - `config` (object, optional): Hermes specific `config.toml` overrides.
-    - `ports` (object, optional): Hermes specific port forwarding (`rest`, `exposer`).
-    - `ics` (object, optional): Hermes specific ICS setup.
-  - `explorer` (ExplorerConfig, optional): Explorer configuration (`enabled`, `type`, `ports`, `resources`, `image`).
-  - `registry` (RegistryConfig, optional): Registry service configuration (`enabled`, `localhost`, `ports`, `resources`, `image`).
-- **Output**: Text confirmation with the generated YAML content and writes the file to the specified `configFilePath`.
+- **Parameters**: None.
+- **Output**: Provides text content containing a comprehensive guide for generating a Starship configuration file.
 
 ### `verifyStarshipConfig`
 
 - **Description**: Parses and validates a Starship configuration YAML string against the known schema.
-- **Source**: `src/starship/tools/starship-config-gen.ts`
-- **Parameters (VerifyStarshipConfigInput)**:
-  - `configFilePath` (string, required): The absolute path to the Starship configuration file.
+- **Source**: `src/starship/tools/starship-config-verify.ts`
+- **Parameters**:
   - `yamlContent` (string, required): The Starship configuration content in YAML format as a string.
 - **Output**: Text indicating if the configuration is valid or invalid, with error details if invalid.
 

package.json

@@ -4,9 +4,10 @@
   "description": "Model Context Protocol Hyperweb products",
   "main": "build/index.js",
   "scripts": {
-    "build": "tsc && npm run copy-prompts && chmod 755 build/index.js",
-    "copy-prompts": "./scripts/copy-prompts.sh",
+    "build": "rm -rf build && tsc && npm run copy-assets && chmod 755 build/index.js",
+    "copy-assets": "./scripts/copy-assets.sh",
     "categorize-snippets": "tsx src/interchainjs/scripts/categorize-snippets.ts",
+    "fetch-config-docs": "tsx src/starship/scripts/fetch-config-docs.ts",
     "clean": "rimraf build",
     "test": "vitest",
     "test:watch": "vitest --watch",
@@ -26,6 +27,7 @@
     "@biomejs/biome": "1.9.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.13.10",
+    "@types/node-fetch": "^2.6.12",
     "rimraf": "^6.0.1",
     "tsx": "^4.19.3",
     "typescript": "^5.8.2",
@@ -44,6 +46,7 @@
     "@modelcontextprotocol/sdk": "^1.7.0",
     "dotenv": "^16.4.7",
     "js-yaml": "^4.1.0",
+    "node-fetch": "^3.3.2",
     "zod": "^3.24.2"
   }
 }