frontmcp 0.3.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,448 @@
+<div align="center">
+
+<picture>
+  <source width="400" media="(prefers-color-scheme: dark)" srcset="docs/assets/logo/frontmcp.dark.svg">
+  <source width="400" media="(prefers-color-scheme: light)" srcset="docs/assets/logo/frontmcp.light.svg">
+  <img width="400" alt="FrontMCP Logo" src="docs/assets/logo/frontmcp.light.svg">
+</picture>
+<hr>
+
+<strong>The TypeScript way to build MCP servers with decorators, DI, and Streamable HTTP.</strong>
+
+_Made with ❤️ for TypeScript developers_
+
+[![NPM - @frontmcp/sdk](https://img.shields.io/npm/v/@frontmcp/sdk.svg?v=2)](https://www.npmjs.com/package/@frontmcp/sdk)
+[![Node](https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white)](https://nodejs.org)
+[![License](https://img.shields.io/github/license/agentfront/frontmcp.svg?v=1)](https://github.com/agentfront/frontmcp/blob/main/LICENSE)
+
+</div>
+
+---
+
+FrontMCP is a **TypeScript-first framework** for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
+You write clean, typed code; FrontMCP handles the protocol, transport, DI, session/auth, and execution flow.
+
+```ts
+// src/main.ts
+import 'reflect-metadata';
+import { FrontMcp, LogLevel } from '@frontmcp/sdk';
+import HelloApp from './hello.app';
+
+@FrontMcp({
+  info: { name: 'Demo 🚀', version: '0.1.0' },
+  apps: [HelloApp],
+  http: { port: 3000 },
+  logging: { level: LogLevel.Info },
+})
+export default class Server {}
+```
+
+---
+
+<!-- omit in toc -->
+
+## Table of Contents
+
+- [Why FrontMCP?](#why-frontmcp)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+  - [1) Create Your FrontMCP Server](#1-create-your-frontmcp-server)
+  - [2) Define an App](#2-define-an-app)
+  - [3) Add Your First Tool](#3-add-your-first-tool)
+  - [4) Run It](#4-run-it)
+  - [Function and Class Tools](#function-and-class-tools)
+  - [Scripts & tsconfig](#scripts--tsconfig)
+  - [Inspector](#inspector)
+- [Core Concepts](#core-concepts)
+  - [Servers](#servers)
+  - [Apps](#apps)
+  - [Tools](#tools)
+  - [Resources](#resources)
+  - [Prompts](#prompts)
+  - [Providers / Adapters / Plugins](#providers--adapters--plugins)
+- [Authentication](#authentication)
+  - [Remote OAuth](#remote-oauth)
+  - [Local OAuth](#local-oauth)
+- [Sessions & Transport](#sessions--transport)
+- [Deployment](#deployment)
+  - [Local Dev](#local-dev)
+  - [Production](#production)
+- [Version Alignment](#version-alignment)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+## Why FrontMCP?
+
+- **TypeScript-native DX** — decorators, Zod, and strong typing end-to-end
+- **Scoped invoker + DI** — secure, composable execution with hooks
+- **Adapters & Plugins** — extend your server without boilerplate
+- **Spec-aligned transport** — Streamable HTTP for modern MCP clients
+
+---
+
+## Installation
+
+**Prereqs:** Node.js ≥ 22, npm ≥ 10. ([Installation - FrontMCP][1])
+
+### Option A — New project (recommended)
+
+```bash
+npx frontmcp create my-app
+```
+
+This scaffolds a FrontMCP project, writes a modern ESM `tsconfig.json` for decorators, adds helpful package scripts, and
+installs required dev deps. ([Installation - FrontMCP][1])
+
+### Option B — Add to an existing project
+
+```bash
+npm i -D frontmcp @types/node@^20
+npx frontmcp init
+```
+
+`init` adds scripts, verifies your `tsconfig.json`, and checks layout. No need to install `@frontmcp/sdk` directly—the
+CLI bundles a compatible SDK for you. ([Installation - FrontMCP][1])
+
+---
+
+## Quickstart
+
+If you haven’t installed FrontMCP yet, follow the [installation guide][1] first.
+
+### 1) Create Your FrontMCP Server
+
+```ts
+// src/main.ts
+import { FrontMcp, LogLevel } from '@frontmcp/sdk';
+import HelloApp from './hello.app';
+
+@FrontMcp({
+  info: { name: 'Hello MCP', version: '0.1.0' },
+  apps: [HelloApp],
+  http: { port: 3000 },
+  logging: { level: LogLevel.INFO },
+})
+export default class HelloServer {}
+```
+
+### 2) Define an App
+
+```ts
+// src/hello.app.ts
+import { App } from '@frontmcp/sdk';
+import GreetTool from './tools/greet.tool';
+
+@App({
+  id: 'hello',
+  name: 'Hello App',
+  tools: [GreetTool],
+})
+export default class HelloApp {}
+```
+
+### 3) Add Your First Tool
+
+```ts
+// src/tools/greet.tool.ts
+import { Tool } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+@Tool({
+  name: 'greet',
+  description: 'Greets a user by name',
+  inputSchema: { name: z.string() },
+})
+export default class GreetTool {
+  async execute({ name }: { name: string }) {
+    return `Hello, ${name}!`;
+  }
+}
+```
+
+### 4) Run It
+
+Add scripts (if you didn't use `frontmcp create`):
+
+```json
+{
+  "scripts": {
+    "dev": "frontmcp dev",
+    "build": "frontmcp build",
+    "start": "node dist/main.js"
+  }
+}
+```
+
+Then:
+
+```bash
+npm run dev
+# Server listening on http://localhost:3000
+```
+
+> **Tip:** FrontMCP speaks **MCP Streamable HTTP**. Connect any MCP-capable client and call `greet` with
+> `{"name": "Ada"}`. ([Quickstart - FrontMCP][2])
+
+### Function and Class Tools
+
+Tools are typed actions with Zod schemas. Implement them as classes with `@Tool({...})` or inline via `tool()`. Pass
+**Zod fields directly** (no `z.object({...})`). ([Tools - FrontMCP][4])
+
+**Function tool**
+
+```ts
+import { tool } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+export default tool({
+  name: 'greet',
+  description: 'Greets a user by name',
+  inputSchema: { name: z.string() }, // shape, not z.object
+})(({ name }) => `Hello, ${name}!`);
+```
+
+**Class tool**
+
+```ts
+import { Tool } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+@Tool({
+  name: 'add',
+  description: 'Add two numbers',
+  inputSchema: { a: z.number(), b: z.number() },
+})
+export default class AddTool {
+  async execute({ a, b }: { a: number; b: number }) {
+    return a + b;
+  }
+}
+```
+
+### Scripts & tsconfig
+
+After `create` or `init`, you’ll have:
+
+```json
+{
+  "scripts": {
+    "dev": "frontmcp dev",
+    "build": "frontmcp build",
+    "inspect": "frontmcp inspector",
+    "doctor": "frontmcp doctor"
+  }
+}
+```
+
+These map to dev watch, production build, zero‑setup Inspector launch, and environment checks. ([Installation -
+FrontMCP][1])
+
+**Recommended `tsconfig.json` (ESM + decorators)**
+
+```json
+{
+  "compilerOptions": {
+    "target": "es2021",
+    "module": "esnext",
+    "lib": ["es2021"],
+    "moduleResolution": "bundler",
+    "rootDir": "src",
+    "outDir": "dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["**/*.test.ts", "**/__tests__/**"]
+}
+```
+
+This mirrors what `init` writes for you. ([Local Dev Server - FrontMCP][3])
+
+**Optional `tsconfig.build.json`**
+
+```json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "sourceMap": false
+  },
+  "exclude": ["**/*.test.ts", "**/__tests__/**", "src/**/*.dev.ts"]
+}
+```
+
+### Inspector
+
+Run a browser UI to exercise tools and messages:
+
+```bash
+npm run inspect
+```
+
+This launches the MCP Inspector; point it at your local server (e.g., `http://localhost:3000`). ([Local Dev Server -
+FrontMCP][3])
+
+---
+
+## Core Concepts
+
+### Servers
+
+`@FrontMcp({...})` defines **info**, **apps**, **http**, **logging**, **session**, and optional **auth**. Keep it
+minimal or scale up with providers and plugins. ([The FrontMCP Server - FrontMCP][5])
+
+### Apps
+
+Use `@App` to group **tools**, **resources**, **prompts**, plus **providers**, **adapters**, and **plugins**. With
+`splitByApp: true`, each app gets its own scope/base path and, if needed, its own auth surface. ([Apps - FrontMCP][6])
+
+### Tools
+
+Typed actions with schemas (class `@Tool` or inline `tool({...})(handler)`). Use the Zod‑field **shape** style for
+`inputSchema`. ([Tools - FrontMCP][4])
+
+### Resources
+
+Readable data by URI or RFC6570 template (see `@Resource` / `@ResourceTemplate`). ([Resources - FrontMCP][7])
+
+### Prompts
+
+Reusable templates returning MCP `GetPromptResult`, with typed arguments. ([Prompts - FrontMCP][8])
+
+### Providers / Adapters / Plugins
+
+Inject shared services, generate tools from OpenAPI, and add cross‑cutting behavior like caching and hooks. ([Add
+OpenAPI Adapter - FrontMCP][9])
+
+---
+
+## Authentication
+
+Configure auth at the **server** (shared) or **per app** (isolated). With `splitByApp: true`, define auth **per app**
+(server‑level `auth` is disallowed). ([Authentication - FrontMCP][10])
+
+### Remote OAuth
+
+```ts
+auth: {
+  type: 'remote',
+  name: 'frontegg',
+  baseUrl: 'https://idp.example.com',
+  dcrEnabled?: boolean,
+  clientId?: string | ((info: { clientId: string }) => string),
+  mode?: 'orchestrated' | 'transparent',
+  allowAnonymous?: boolean,
+  consent?: boolean,
+  scopes?: string[],
+  grantTypes?: ('authorization_code' | 'refresh_token')[],
+  authEndpoint?: string,
+  tokenEndpoint?: string,
+  registrationEndpoint?: string,
+  userInfoEndpoint?: string,
+  jwks?: JSONWebKeySet,
+  jwksUri?: string
+}
+```
+
+See **Authentication → Remote OAuth** for full details and DCR vs non‑DCR. ([Remote OAuth - FrontMCP][11])
+
+### Local OAuth
+
+```ts
+auth: {
+  type: 'local',
+  id: 'local',
+  name: 'Local Auth',
+  scopes?: string[],
+  grantTypes?: ('authorization_code' | 'refresh_token')[],
+  allowAnonymous?: boolean, // default true
+  consent?: boolean,
+  jwks?: JSONWebKeySet,
+  signKey?: JWK | Uint8Array
+}
+```
+
+Use per‑app when isolating scopes. ([Local OAuth - FrontMCP][12])
+
+---
+
+## Sessions & Transport
+
+```ts
+session: {
+  sessionMode?: 'stateful' | 'stateless' | ((issuer) => ...), // default 'stateless'
+  transportIdMode?: 'uuid' | 'jwt' | ((issuer) => ...),       // default 'uuid'
+}
+```
+
+- **Stateful**: server‑side store (e.g., Redis); supports refresh; best for short‑lived upstream tokens.
+- **Stateless**: embeds session in JWT; simpler but no silent refresh.
+- **Transport IDs**: `uuid` (per node) or `jwt` (signed; distributed setups). ([The FrontMCP Server - FrontMCP][5])
+
+---
+
+## Deployment
+
+### Local Dev
+
+```bash
+npm run dev
+```
+
+- Default HTTP port: `3000` unless configured
+- `npm run doctor` checks Node/npm versions, `tsconfig`, and scripts. ([Local Dev Server - FrontMCP][3])
+
+### Production
+
+```bash
+npm run build
+NODE_ENV=production PORT=8080 npm start
+```
+
+Builds to `dist/` (uses `tsconfig.build.json`). Consider a process manager and reverse proxy; align all `@frontmcp/*`
+versions. ([Production Build - FrontMCP][13])
+
+---
+
+## Version Alignment
+
+If versions drift, the runtime will throw a clear **“version mismatch”** at boot. Keep `@frontmcp/*` versions aligned.
+([Production Build - FrontMCP][13])
+
+---
+
+## Contributing
+
+- PRs welcome! Read the full [CONTRIBUTING.md](./CONTRIBUTING.md) for workflow details, coding standards, and the PR
+  checklist.
+- Keep changes focused, add/adjust Jest specs, and update docs/snippets when behavior changes.
+- Before opening a PR run `yarn nx run-many -t lint,test,build`, `npx frontmcp doctor`, and verify the demo/Inspector
+  flows relevant to your change.
+- Align `@frontmcp/*` versions in examples to avoid runtime version mismatches.
+
+---
+
+## License
+
+See [LICENSE](./LICENSE).
+
+[1]: https://docs.agentfront.dev/docs/getting-started/installation 'Installation - FrontMCP'
+[2]: https://docs.agentfront.dev/docs/getting-started/quickstart 'Quickstart - FrontMCP'
+[3]: https://docs.agentfront.dev/docs/deployment/local-dev-server 'Local Dev Server - FrontMCP'
+[4]: https://docs.agentfront.dev/docs/servers/tools 'Tools - FrontMCP'
+[5]: https://docs.agentfront.dev/docs/servers/server 'The FrontMCP Server - FrontMCP'
+[6]: https://docs.agentfront.dev/docs/servers/apps 'Apps - FrontMCP'
+[7]: https://docs.agentfront.dev/docs/servers/resources 'Resources - FrontMCP'
+[8]: https://docs.agentfront.dev/docs/servers/prompts 'Prompts - FrontMCP'
+[9]: https://docs.agentfront.dev/docs/guides/add-openapi-adapter 'Add OpenAPI Adapter - FrontMCP'
+[10]: https://docs.agentfront.dev/docs/servers/authentication/overview 'Authentication - FrontMCP'
+[11]: https://docs.agentfront.dev/docs/servers/authentication/remote 'Remote OAuth - FrontMCP'
+[12]: https://docs.agentfront.dev/docs/servers/authentication/local 'Local OAuth - FrontMCP'
+[13]: https://docs.agentfront.dev/docs/deployment/production-build 'Production Build - FrontMCP'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -25,9 +25,9 @@
     "frontmcp": "./src/cli.js"
   },
   "dependencies": {
-    "@frontmcp/sdk": "^0.3.0",
-    "@frontmcp/plugins": "^0.3.0",
-    "@frontmcp/adapters": "^0.3.0"
+    "@frontmcp/sdk": "^0.4.0",
+    "@frontmcp/plugins": "^0.4.0",
+    "@frontmcp/adapters": "^0.4.0"
   },
   "devDependencies": {
     "typescript": "^5.5.3",

package/src/args.d.ts

@@ -0,0 +1,8 @@
+export type Command = 'dev' | 'build' | 'init' | 'doctor' | 'inspector' | 'create' | 'help' | 'template' | 'version';
+export interface ParsedArgs {
+    _: string[];
+    outDir?: string;
+    entry?: string;
+    help?: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;

package/src/args.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+function parseArgs(argv) {
+    const out = { _: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--out-dir' || a === '-o')
+            out.outDir = argv[++i];
+        else if (a === '--entry' || a === '-e')
+            out.entry = argv[++i];
+        else if (a === '--help' || a === '-h')
+            out.help = true;
+        else
+            out._.push(a);
+    }
+    return out;
+}
+//# sourceMappingURL=args.js.map