wormajs 0.0.2-beta.1 → 0.0.2-beta.2

package/README.md

@@ -1,8 +1,6 @@
-# worma - A Universal OpenAPI Code Generator
+# worma - The OpenAPI Generator for human and AI
 
-<p align="center">
-<img width="200px" src="https://alova.js.org/img/logo-text-vertical.svg" />
-</p>
+![](https://worma.js.org/img/banner.png)
 
 <p align="center"><b>One OpenAPI spec. Code for developers, knowledge for AI.<br />Generate API calling functions, TypeScript types, documentation, and AI Skills in a single command.</b></p>
 

package/dist/plugins/presets/aiDoc.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.aiDoc = aiDoc;
+exports.parseAgentList = parseAgentList;
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_module_1 = require("node:module");
@@ -67,34 +68,60 @@ function aiDoc(config) {
                 },
             });
             if (installSkillEnabled) {
-                const { agent } = resolveAgent(projectPath);
-                installSkill(aidocsDir, agent, projectPath);
+                const { agents } = resolveAgents(projectPath);
+                for (const agent of agents) {
+                    installSkill(aidocsDir, agent, projectPath);
+                }
             }
         },
     };
 }
 /**
- * Resolve the target coding agent from `.env.local` in the project root.
+ * Resolve the target coding agents from `.env.local` in the project root.
+ *
+ * Multiple agents can be configured as a comma-separated list, e.g.
+ * `agent=cursor, claude-code, windsurf`. Both commas and surrounding
+ * whitespace are tolerated.
  *
  * If the file does not exist, it will be created and `.gitignore` will be
  * updated to ignore `*.local` files. An error is then thrown asking the user
- * to set `agent=<coding-agent>`.
+ * to set `agent=<coding-agent>` (optionally multiple, comma-separated).
  *
- * If `agent` is missing, an error is thrown with guidance.
+ * If `agent` is missing or empty, an error is thrown with guidance.
  */
-function resolveAgent(projectPath) {
+function resolveAgents(projectPath) {
     const envFilePath = node_path_1.default.join(projectPath, '.env.local');
     if (!node_fs_1.default.existsSync(envFilePath)) {
         createEnvLocalFile(envFilePath);
         ensureGitIgnoreLocal(projectPath);
-        throw logger_1.logger.throwError(`${prefix}Created .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`);
+        throw logger_1.logger.throwError(`${prefix}Created .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor or multiple agents comma-separated: agent=cursor,claude-code. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`);
     }
     const content = node_fs_1.default.readFileSync(envFilePath, 'utf-8');
-    const agent = parseEnvValue(content, 'agent');
-    if (!agent) {
-        throw logger_1.logger.throwError(`${prefix}Missing "agent" in .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`);
+    const raw = parseEnvValue(content, 'agent') ?? '';
+    const agents = parseAgentList(raw);
+    if (agents.length === 0) {
+        throw logger_1.logger.throwError(`${prefix}Missing "agent" in .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor or multiple agents comma-separated: agent=cursor,claude-code. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`);
+    }
+    return { agents };
+}
+/**
+ * Parse an agent string into a deduplicated list of trimmed agent names.
+ *
+ * Agents may be separated by either an English comma (`,`) or a Chinese
+ * comma (`，`), with any amount of whitespace (including none) allowed on
+ * either side. Empty entries are ignored.
+ */
+function parseAgentList(raw) {
+    const seen = new Set();
+    const result = [];
+    for (const part of raw.split(/[,，]/)) {
+        const agent = part.trim();
+        if (!agent || seen.has(agent))
+            continue;
+        seen.add(agent);
+        result.push(agent);
     }
-    return { agent };
+    return result;
 }
 /**
  * Resolve the absolute path to the `skills` CLI installed alongside this package.
@@ -130,7 +157,8 @@ function installSkill(skillPath, agent, projectPath) {
 }
 function createEnvLocalFile(envFilePath) {
     const content = `# Worma aiDoc skill installer configuration
-# Please set the coding agent you are using (e.g. cursor, claude-code, windsurf).
+# Please set the coding agent(s) you are using (e.g. cursor, claude-code, windsurf).
+# You can configure multiple agents comma-separated, e.g. agent=cursor,claude-code.
 # Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}
 agent=
 `;

package/dist/template/presets/ai-doc/SKILL.md.handlebars

@@ -1,5 +1,5 @@
 ---
-name: {{{title}}}-api-reference
+name: apis-{{{title}}}
 description: >-
   API reference documentation for {{{serverName}}} ({{{title}}} v{{{version}}}).
   Contains specifications for all REST API endpoints, including HTTP request methods,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wormajs",
-  "version": "0.0.2-beta.1",
+  "version": "0.0.2-beta.2",
   "description": "A modern OpenAPI code generator - Generate type-safe API clients from OpenAPI specs",
   "author": "worma",
   "license": "MIT",

package/typings/plugins.d.ts

@@ -426,6 +426,14 @@ export interface AiDocConfig {
 	installSkill?: boolean;
 }
 export declare function aiDoc(config?: AiDocConfig): ApiPlugin;
+/**
+ * Parse an agent string into a deduplicated list of trimmed agent names.
+ *
+ * Agents may be separated by either an English comma (`,`) or a Chinese
+ * comma (`，`), with any amount of whitespace (including none) allowed on
+ * either side. Empty entries are ignored.
+ */
+export declare function parseAgentList(raw: string): string[];
 export type ScopeType = "ALL" | "SELECTED_ENDPOINTS" | "SELECTED_TAGS" | "SELECTED_FOLDERS";
 export interface APIFoxBody {
 	scope?: {