specrun 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pavlo Piga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,319 @@
+<h1 >
+  SpecRun
+</h1>
+An MCP server that turns OpenAPI specifications into MCP tools. Scans a folder for OpenAPI spec files and automatically generate corresponding tools. These tools can then be used in any MCP client to interact with the APIs defined by the specs, with built-in support for authentication and server URL management via a simple `.env` file.
+
+Built with [FastMCP](https://www.npmjs.com/package/fastmcp) for TypeScript.
+
+## ✨ Features
+
+- **Zero Configuration**: Filesystem is the interface - just drop OpenAPI specs in a folder
+- **Supports OpenAPI 3.0 and 2.0**: Works with both OpenAPI 3.x and Swagger 2.0 specs
+- **Namespace Isolation**: Multiple APIs coexist cleanly
+- **Full OpenAPI Support**: Handles parameters, request bodies, authentication, and responses
+- **Run Any Tool to Interact with APIs**: For example, `cars_addCar` to call `POST /cars` from `cars.json` spec to create a new car, or `github_get_user_repos` to call `GET /user/repos` from `github.yaml` spec to list repos.
+- **Run Any Tool with Custom Inputs**: Pass structured JSON inputs for parameters and request bodies
+- **Run Any Tool to see Spec Details**: Get the original OpenAPI spec details for any tool, including parameters, request body schema, and response schema
+- **Run Any Tool to get API responses as resources**: Each tool call returns a JSON resource containing request URL, request body, and response
+- **Run Any Tool in Batch**: One `specrun_batch` tool can execute any tool with multiple inputs and returns a consolidated JSON resource
+- **Auto Authentication**: Simple `.env` file with `{API_NAME}_API_KEY` pattern
+- **Auto .env Placeholders**: Adds `{API_NAME}_SERVER_URL` and `{API_NAME}_BEARER_TOKEN` entries when missing
+- **Multiple Transports**: Support for stdio and HTTP streaming
+- **Built-in Debugging**: List command to see loaded specs and tools
+- **MCP Prompts**: Built-in prompts for listing tools, generating inputs, and explaining schemas
+
+## Quick Start
+
+### Requirements
+
+- Node.js 22 or newer
+
+### 1️⃣ Install (optional)
+
+```bash
+npm install -g specrun
+```
+
+### 2️⃣ Create a specs folder where the server can read OpenAPI spec files. For example:
+
+```bash
+mkdir ~/specs
+```
+
+### 3️⃣ Add OpenAPI specs
+
+Drop any `.json`, `.yaml`, or `.yml` OpenAPI specification files into your specs folder
+
+### 4️⃣ Configure authentication (optional)
+
+Create a `.env` file in your specs folder:
+
+```bash
+# ~/specs/.env
+CARS_API_KEY=your_api_key_here
+```
+
+SpecRun will also ensure `{API_NAME}_SERVER_URL` and `{API_NAME}_BEARER_TOKEN` entries exist for each spec, adding empty placeholders when missing.
+When `{API_NAME}_SERVER_URL` has a value, SpecRun updates the spec file on load:
+
+- OpenAPI 3.0: updates the first `servers` entry.
+- OpenAPI 2.0 (formerly Swagger 2.0): updates `host`, `schemes`, and `basePath` (no `servers` section in OpenAPI 2.0).
+
+SpecRun also watches the `.env` file and refreshes server URLs and auth config automatically after changes.
+
+### 5️⃣ Add to MCP client configuration
+
+For Claude Desktop or Cursor, add to your MCP configuration:
+
+If installed on your machine:
+
+```json
+{
+  "mcpServers": {
+    "specrun": {
+      "command": "specrun",
+      "args": ["--specs", "/path/to/your/specs/folder"]
+    }
+  }
+}
+```
+
+Otherwise:
+
+```json
+{
+  "mcpServers": {
+    "specrun": {
+      "command": "npx",
+      "args": ["-y", "specrun", "--specs", "/absolute/path/to/your/specs"]
+    }
+  }
+}
+```
+
+## 💻 CLI Usage
+
+### 🚀 Start the server
+
+```bash
+# Default: stdio transport, current directory
+specrun
+
+# Custom specs folder
+specrun --specs ~/specs
+
+# HTTP transport mode
+specrun --transport httpStream --port 8080
+```
+
+### 📋 List loaded specs and tools
+
+```bash
+# List all loaded specifications and their tools
+specrun list
+
+# List specs from custom folder
+specrun list --specs ~/specs
+
+```
+
+## 🔑 Authentication Patterns
+
+The server automatically detects authentication from environment variables using these patterns:
+
+| Pattern                                       | Auth Type       | Usage                           |
+| --------------------------------------------- | --------------- | ------------------------------- |
+| `{API_NAME}_API_KEY`                          | 🗝️ API Key      | `X-API-Key` header              |
+| `{API_NAME}_TOKEN`                            | 🎫 Bearer Token | `Authorization: Bearer {token}` |
+| `{API_NAME}_BEARER_TOKEN`                     | 🎫 Bearer Token | `Authorization: Bearer {token}` |
+| `{API_NAME}_USERNAME` + `{API_NAME}_PASSWORD` | 👤 Basic Auth   | `Authorization: Basic {base64}` |
+
+SpecRun also creates `.env` placeholders for:
+
+| Pattern                   | Purpose                      |
+| ------------------------- | ---------------------------- |
+| `{API_NAME}_SERVER_URL`   | Base URL for the API         |
+| `{API_NAME}_BEARER_TOKEN` | Token placeholder if missing |
+
+If `{API_NAME}_SERVER_URL` is set, SpecRun writes that value into the spec before generating tools:
+
+- OpenAPI 3.0: writes the first `servers` entry.
+- OpenAPI 2.0 (formerly Swagger 2.0): writes `host`, `schemes`, and `basePath`.
+
+Updates to `.env` are applied automatically without restarting the MCP server.
+
+The `{API_NAME}` is derived from the filename of your OpenAPI spec:
+
+- `cars.json` → `CARS_API_KEY`
+- `github-api.yaml` → `GITHUB_TOKEN`
+- `my_custom_api.yml` → `MY_CUSTOM_API_KEY`
+
+## 🏷️ Tool Naming
+
+Tools are automatically named using this pattern:
+
+- **With operationId**: `{api_name}_{operationId}`
+- **Without operationId**: `{api_name}_{method}_{path_segments}`
+
+Specs:
+
+- `cars_getCarById` (from operationId)
+- `github_get_user_repos` (generated from `GET /user/repos`)
+
+Use the shared batch tool to run any tool with an array of inputs:
+
+```json
+{
+  "toolName": "cars_getCarById",
+  "items": [{ "id": "123" }, { "id": "456" }],
+  "failFast": false
+}
+```
+
+Batch responses return a consolidated JSON resource with per-item outputs.
+
+For batches over 200 items, SpecRun requires explicit confirmation. This is to prevent accidental large runs that could cause performance issues or unintended consequences. The server will return a message asking for confirmation, and you can retry with `confirmLargeBatch: true` and the provided `confirmLargeBatchToken` to proceed.
+
+## 📦 Resource Outputs
+
+Tool responses are returned as MCP resources with `application/json` content. Each resource includes:
+
+1. Request URL
+2. Request body
+3. Response status and body
+
+Example resource payload:
+
+```json
+{
+  "requestUrl": "https://api.example.com/v1/users/123",
+  "requestBody": null,
+  "response": {
+    "status": 200,
+    "body": {
+      "id": "123",
+      "name": "Jane Doe"
+    }
+  }
+}
+```
+
+Batch runs return a single consolidated resource containing all item results.
+
+## 📁 File Structure
+
+```
+your-project/
+── specs/           # Your OpenAPI specs folder
+   ├── .env            # Authentication credentials
+   └── custom-api.yml  # Your OpenAPI spec files
+```
+
+## 🧭 MCP Prompts
+
+SpecRun exposes MCP prompts for common workflows:
+
+- `list_apis`: List loaded APIs/tools and ask the user to choose an endpoint
+- `generate_api_call`: Generate a ready-to-run JSON input payload for a tool
+- `explain_api_schema`: Explain parameters and request body schema with examples
+
+## 📄 Example OpenAPI Spec
+
+Here's a minimal example that creates two tools:
+
+```yaml
+# ~/specs/example.yaml
+openapi: 3.0.0
+info:
+  title: Example API
+  version: 1.0.0
+servers:
+  - url: https://api-server.placeholder
+paths:
+  /users/{id}:
+    get:
+      operationId: getUser
+      summary: Get user by ID
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: User found
+  /users:
+    post:
+      operationId: createUser
+      summary: Create a new user
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                email:
+                  type: string
+      responses:
+        "201":
+          description: User created
+```
+
+This creates tools named:
+
+- `example_getUser`
+- `example_createUser`
+
+## 🔧 Troubleshooting
+
+### ❌ No tools appearing?
+
+1. Check that your OpenAPI specs are valid:
+
+   ```bash
+   specrun list --specs /path/to/specs
+   ```
+
+2. Ensure files have correct extensions (`.json`, `.yaml`, `.yml`)
+
+3. Check the server logs for parsing errors
+
+> **⚠️ Note:** SpecRun works best when you use absolute paths (with no spaces) for the `--specs` argument and other file paths. Relative paths or paths containing spaces may cause issues on some platforms or with some MCP clients.
+
+### 🔐 Authentication not working?
+
+1. Verify your `.env` file is in the specs directory
+2. Check the naming pattern matches your spec filename
+3. Use the list command to verify auth configuration:
+   ```bash
+   specrun list
+   ```
+
+### 🔄 Tools not updating after spec changes?
+
+1. Restart the MCP server to reload the specs
+2. Check file permissions
+3. Restart the MCP client if needed
+
+## 🛠️ Development
+
+```bash
+# Clone and install
+git clone git@github.com:Pavel-Piha/specrun.git
+cd specrun
+npm install
+
+# Build
+npm run build
+
+# Test locally
+npm run dev -- --specs ./specs
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit issues and pull requests.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path_1 = __importDefault(require("path"));
+const server_1 = require("./server");
+const program = new commander_1.Command();
+program
+    .name("specrun")
+    .description("Converts OpenAPI specifications to MCP tools - automatically generates tools from OpenAPI specs")
+    .version("1.0.0")
+    .option("--specs <path>", "Path to directory containing OpenAPI spec files", process.cwd())
+    .option("--port <number>", "Port number for HTTP transport (enables HTTP mode)", (val) => parseInt(val, 10))
+    .option("--transport <type>", "Transport type: stdio or httpStream", "stdio")
+    .action(async (options) => {
+    try {
+        // Debug: log raw options without breaking JSON protocol
+        const globalOptions = program.opts();
+        const specsPath = path_1.default.resolve(options.specs || globalOptions.specs || process.cwd());
+        const config = {
+            specsPath,
+            port: options.port,
+            transportType: options.transport,
+        };
+        // Validate transport configuration
+        if (config.transportType === "httpStream" && !config.port) {
+            console.error("Error: --port is required when using httpStream transport");
+            process.exit(1);
+        }
+        const server = new server_1.OpenApiMcpServer(config);
+        // Handle graceful shutdown
+        const shutdown = async () => {
+            console.log("\nShutting down...");
+            await server.stop();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+        // Start the server
+        await server.start();
+    }
+    catch (error) {
+        console.error("Failed to start server:", error);
+        process.exit(1);
+    }
+});
+// Add a command to list loaded specs (useful for debugging)
+program
+    .command("list")
+    .description("List all loaded OpenAPI specifications and their tools")
+    .option("--specs <path>", "Path to directory containing OpenAPI spec files")
+    .action(async (options) => {
+    try {
+        // Debug: log raw options without breaking JSON protocol
+        const globalOptions = program.opts();
+        const specsPath = path_1.default.resolve(globalOptions.specs || options.specs || process.cwd());
+        const config = {
+            specsPath,
+        };
+        const server = new server_1.OpenApiMcpServer(config);
+        await server.loadSpecs();
+        const specs = server.getLoadedSpecs();
+        const authConfig = server.getAuthConfig();
+        console.log("\n=== SpecRun Status ===\n");
+        console.log(`Specs Directory: ${config.specsPath}`);
+        console.log(`Loaded Specifications: ${specs.length}`);
+        if (specs.length === 0) {
+            console.log("\nNo OpenAPI specifications found.");
+            console.log("Add .json, .yaml, or .yml files to the specs directory.");
+        }
+        else {
+            for (const spec of specs) {
+                console.log(`\n📋 ${spec.apiName.toUpperCase()}`);
+                console.log(`   File: ${path_1.default.basename(spec.filePath)}`);
+                console.log(`   Base URL: ${spec.tools[0]?.baseUrl || "N/A"}`);
+                console.log(`   Tools: ${spec.tools.length}`);
+                if (authConfig[spec.apiName]) {
+                    const auth = authConfig[spec.apiName];
+                    console.log(`   Auth: ${auth.type} ${auth.type === "apiKey" ? `(${auth.headerName})` : ""}`);
+                }
+                else {
+                    console.log(`   Auth: None configured`);
+                }
+                if (spec.tools.length > 0) {
+                    console.log("   Available tools:");
+                    for (const tool of spec.tools.slice(0, 5)) {
+                        // Show first 5 tools
+                        console.log(`     • ${tool.name} - ${tool.description}`);
+                    }
+                    if (spec.tools.length > 5) {
+                        console.log(`     ... and ${spec.tools.length - 5} more`);
+                    }
+                }
+            }
+        }
+        console.log("\n=== Global Tools ===\n");
+        console.log("• specrun_batch - Run any SpecRun tool in batch");
+        console.log("\n=== Authentication Configuration ===\n");
+        const authKeys = Object.keys(authConfig);
+        if (authKeys.length === 0) {
+            console.log("No authentication configured.");
+            console.log("Add a .env file with credentials like:");
+        }
+        else {
+            for (const apiName of authKeys) {
+                const auth = authConfig[apiName];
+                console.log(`🔐 ${apiName.toUpperCase()}: ${auth.type}`);
+            }
+        }
+        await server.stop();
+    }
+    catch (error) {
+        console.error("Failed to list specs:", error);
+        process.exit(1);
+    }
+});
+if (require.main === module) {
+    program.parse();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { OpenApiMcpServer } from "./server";
+export * from "./types";
+export { loadAuthConfig, applyAuthentication, getApiNameFromFile, } from "./utils/auth";
+export { parseOpenApiSpec, isOpenAPIFile } from "./utils/openapi-parser";
+export { HttpClient } from "./utils/http-client";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = exports.isOpenAPIFile = exports.parseOpenApiSpec = exports.getApiNameFromFile = exports.applyAuthentication = exports.loadAuthConfig = exports.OpenApiMcpServer = void 0;
+var server_1 = require("./server");
+Object.defineProperty(exports, "OpenApiMcpServer", { enumerable: true, get: function () { return server_1.OpenApiMcpServer; } });
+__exportStar(require("./types"), exports);
+var auth_1 = require("./utils/auth");
+Object.defineProperty(exports, "loadAuthConfig", { enumerable: true, get: function () { return auth_1.loadAuthConfig; } });
+Object.defineProperty(exports, "applyAuthentication", { enumerable: true, get: function () { return auth_1.applyAuthentication; } });
+Object.defineProperty(exports, "getApiNameFromFile", { enumerable: true, get: function () { return auth_1.getApiNameFromFile; } });
+var openapi_parser_1 = require("./utils/openapi-parser");
+Object.defineProperty(exports, "parseOpenApiSpec", { enumerable: true, get: function () { return openapi_parser_1.parseOpenApiSpec; } });
+Object.defineProperty(exports, "isOpenAPIFile", { enumerable: true, get: function () { return openapi_parser_1.isOpenAPIFile; } });
+var http_client_1 = require("./utils/http-client");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_client_1.HttpClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AACzB,0CAAwB;AACxB,qCAIsB;AAHpB,sGAAA,cAAc,OAAA;AACd,2GAAA,mBAAmB,OAAA;AACnB,0GAAA,kBAAkB,OAAA;AAEpB,yDAAyE;AAAhE,kHAAA,gBAAgB,OAAA;AAAE,+GAAA,aAAa,OAAA;AACxC,mDAAiD;AAAxC,yGAAA,UAAU,OAAA"}

package/dist/prompts.d.ts

@@ -0,0 +1,38 @@
+import { FastMCP } from "fastmcp";
+import { z } from "zod";
+import { ParsedSpec, GeneratedTool } from "./types";
+type ToolRegistryEntry = {
+    spec: ParsedSpec;
+    tool: GeneratedTool;
+    schema: z.ZodObject<any>;
+};
+type ToolRegistry = Map<string, ToolRegistryEntry>;
+export declare class PromptRegistrar {
+    private fastMCP;
+    private toolRegistry;
+    constructor(options: {
+        fastMCP: FastMCP;
+        toolRegistry: ToolRegistry;
+    });
+    registerPrompts(): void;
+    private parseMaxResults;
+    private parseFilter;
+    private parseCursor;
+    private parseListApisArgs;
+    private parseToolNameArg;
+    private normalizeToolName;
+    private encodeCursor;
+    private decodeCursor;
+    private sanitizePromptText;
+    private getToolEntries;
+    private buildToolListPromptText;
+    private completeToolNames;
+    private buildRequiredOptionalSummary;
+    private buildExamplePayload;
+    private buildSchemaExplanation;
+    private describeSchemaType;
+    private createExampleValue;
+    private getRequestBodySchema;
+}
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAC1B,CAAC;AAEF,KAAK,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEnD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE;IAKrE,eAAe,IAAI,IAAI;IAqMvB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,iBAAiB;IA8DzB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,uBAAuB;IAoD/B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,4BAA4B;IA4BpC,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,sBAAsB;IA4C9B,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,kBAAkB;IAqF1B,OAAO,CAAC,oBAAoB;CAoB7B"}