@frontmcp/sdk 0.6.0 → 0.6.2

package/README.md

@@ -1,460 +0,0 @@
-<div align="center">
-
-<picture>
-  <source width="400" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/agentfront/frontmcp/refs/heads/main/docs/live/assets/logo/frontmcp.dark.svg">
-  <source width="400" media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/agentfront/frontmcp/refs/heads/main/docs/live/assets/logo/frontmcp.light.svg">
-  <img width="400" alt="FrontMCP Logo" src="https://raw.githubusercontent.com/agentfront/frontmcp/refs/heads/main/docs/live/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
-
-**Prerequisites:**
-
-- **Node.js**: Minimum version 22 (LTS) | Recommended version 24 (Active LTS)
-  - _This framework is developed and tested on Node.js 24_
-- **npm**: ≥ 10 (or pnpm/yarn equivalent)
-
-For detailed setup instructions, see the [Installation Guide][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@^22
-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
-
-The FrontMCP server is defined with a single decorator: `@FrontMcp({...})`. It configures **info**, **apps**, **http**,
-**logging**, **session**, and optional **auth**. Start minimal and scale up with providers and plugins.
-([The FrontMCP Server - FrontMCP][5])
-
-### Apps
-
-Apps are the **organizational units** for capabilities. Each app groups related **tools**, **resources**, and **prompts**
-into a cohesive domain, along with **providers**, **adapters**, and **plugins**. With `splitByApp: true`, apps get
-isolated scopes and auth surfaces. ([Apps - FrontMCP][6])
-
-### Tools
-
-Tools are **typed actions** that execute operations with side effects. They're the primary way to enable an AI model to
-interact with external systems—calling APIs, modifying data, performing calculations, or triggering workflows. Use the
-class `@Tool` decorator or inline `tool({...})(handler)` with Zod schemas. ([Tools - FrontMCP][4])
-
-### Resources
-
-Resources expose **readable data** to an AI model's context. Unlike tools that execute actions with side effects,
-resources are designed for read-only data retrieval—configuration files, user profiles, documents, or any content
-the model needs to reference. ([Resources - FrontMCP][7])
-
-### Prompts
-
-Prompts provide **reusable message templates** for AI interactions. They return MCP `GetPromptResult` with typed
-arguments, enabling consistent conversation patterns. ([Prompts - FrontMCP][8])
-
-### Providers / Adapters / Plugins
-
-Inject shared services, generate tools from OpenAPI specs, 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/authentication/overview 'Authentication - FrontMCP'
-[11]: https://docs.agentfront.dev/docs/authentication/remote 'Remote OAuth - FrontMCP'
-[12]: https://docs.agentfront.dev/docs/authentication/local 'Local OAuth - FrontMCP'
-[13]: https://docs.agentfront.dev/docs/deployment/production-build 'Production Build - FrontMCP'

package/src/adapter/adapter.instance.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdapterInstance = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("../common");
-const tool_registry_1 = tslib_1.__importDefault(require("../tool/tool.registry"));
-class AdapterInstance extends common_1.AdapterEntry {
-    deps;
-    globalProviders;
-    tools;
-    resources;
-    prompts;
-    constructor(record, deps, globalProviders) {
-        super(record);
-        this.deps = deps;
-        this.globalProviders = globalProviders;
-        this.ready = this.initialize();
-    }
-    async initialize() {
-        const depsTokens = [...this.deps];
-        const depsInstances = await Promise.all(depsTokens.map((t) => this.globalProviders.resolveBootstrapDep(t)));
-        const rec = this.record;
-        let adapter;
-        if (rec.kind === common_1.AdapterKind.CLASS) {
-            const klass = rec.useClass;
-            adapter = new klass(...depsInstances);
-        }
-        else if (rec.kind === common_1.AdapterKind.CLASS_TOKEN) {
-            const klass = rec.provide;
-            adapter = new klass(...depsInstances);
-        }
-        else if (rec.kind === common_1.AdapterKind.FACTORY) {
-            const deps = [...rec.inject()];
-            const args = [];
-            for (const d of deps)
-                args.push(await this.globalProviders.resolveBootstrapDep(d));
-            adapter = rec.useFactory(...args);
-        }
-        else if (rec.kind === common_1.AdapterKind.VALUE) {
-            adapter = rec.useValue;
-        }
-        else {
-            throw Error('Invalid adapter kind');
-        }
-        // Inject logger if adapter supports it
-        if (typeof adapter.setLogger === 'function') {
-            const logger = this.globalProviders.get(common_1.FrontMcpLogger);
-            adapter.setLogger(logger.child(`adapter:${adapter.options.name}`));
-        }
-        const result = await adapter.fetch();
-        this.tools = new tool_registry_1.default(this.globalProviders, result.tools ?? [], {
-            kind: 'adapter',
-            id: `${adapter.options.name}`,
-            ref: rec.provide,
-        });
-        // this.resources = new ResourceRegistry(this.globalProviders, result.resources ?? [], {
-        //   kind: 'adapter',
-        //   id: rec.metadata.id ?? rec.metadata.name,
-        //   ref: rec.provide,
-        // });
-        // this.prompts = new PromptRegistry(this.globalProviders, result.prompts ?? [], {
-        //   kind: 'adapter',
-        //   id: rec.metadata.id ?? rec.metadata.name,
-        //   ref: rec.provide,
-        // });
-        await this.tools.ready;
-    }
-}
-exports.AdapterInstance = AdapterInstance;
-//# sourceMappingURL=adapter.instance.js.map

package/src/adapter/adapter.instance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.instance.js","sourceRoot":"","sources":["../../../src/adapter/adapter.instance.ts"],"names":[],"mappings":"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","sourcesContent":["import { AdapterEntry, AdapterInterface, AdapterKind, AdapterRecord, Ctor, Reference, FrontMcpLogger } from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport ToolRegistry from '../tool/tool.registry';\nimport ResourceRegistry from '../resource/resource.registry';\nimport PromptRegistry from '../prompt/prompt.registry';\n\nexport class AdapterInstance extends AdapterEntry {\n  readonly deps: Set<Reference>;\n  readonly globalProviders: ProviderRegistry;\n\n  private tools: ToolRegistry;\n  private resources: ResourceRegistry;\n  private prompts: PromptRegistry;\n\n  constructor(record: AdapterRecord, deps: Set<Reference>, globalProviders: ProviderRegistry) {\n    super(record);\n    this.deps = deps;\n    this.globalProviders = globalProviders;\n\n    this.ready = this.initialize();\n  }\n\n  protected async initialize() {\n    const depsTokens = [...this.deps];\n    const depsInstances = await Promise.all(depsTokens.map((t) => this.globalProviders.resolveBootstrapDep(t)));\n    const rec = this.record;\n    let adapter: AdapterInterface;\n    if (rec.kind === AdapterKind.CLASS) {\n      const klass = rec.useClass as any;\n      adapter = new klass(...depsInstances);\n    } else if (rec.kind === AdapterKind.CLASS_TOKEN) {\n      const klass = rec.provide as any;\n      adapter = new (klass as Ctor<any>)(...depsInstances);\n    } else if (rec.kind === AdapterKind.FACTORY) {\n      const deps = [...rec.inject()];\n      const args: any[] = [];\n      for (const d of deps) args.push(await this.globalProviders.resolveBootstrapDep(d));\n      adapter = rec.useFactory(...args);\n    } else if (rec.kind === AdapterKind.VALUE) {\n      adapter = rec.useValue;\n    } else {\n      throw Error('Invalid adapter kind');\n    }\n\n    // Inject logger if adapter supports it\n    if (typeof adapter.setLogger === 'function') {\n      const logger = this.globalProviders.get(FrontMcpLogger);\n      adapter.setLogger(logger.child(`adapter:${adapter.options.name}`));\n    }\n\n    const result = await adapter.fetch();\n\n    this.tools = new ToolRegistry(this.globalProviders, result.tools ?? [], {\n      kind: 'adapter',\n      id: `${adapter.options.name}`,\n      ref: rec.provide,\n    });\n\n    // this.resources = new ResourceRegistry(this.globalProviders, result.resources ?? [], {\n    //   kind: 'adapter',\n    //   id: rec.metadata.id ?? rec.metadata.name,\n    //   ref: rec.provide,\n    // });\n\n    // this.prompts = new PromptRegistry(this.globalProviders, result.prompts ?? [], {\n    //   kind: 'adapter',\n    //   id: rec.metadata.id ?? rec.metadata.name,\n    //   ref: rec.provide,\n    // });\n\n    await this.tools.ready;\n  }\n}\n"]}

package/src/adapter/adapter.regsitry.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("reflect-metadata");
-const adapter_utils_1 = require("./adapter.utils");
-const token_utils_1 = require("../utils/token.utils");
-const regsitry_1 = require("../regsitry");
-const adapter_instance_1 = require("./adapter.instance");
-class AdapterRegistry extends regsitry_1.RegistryAbstract {
-    constructor(providers, list) {
-        super('AdapterRegistry', providers, list);
-    }
-    buildMap(list) {
-        const tokens = new Set();
-        const defs = new Map();
-        const graph = new Map();
-        for (const raw of list) {
-            const rec = (0, adapter_utils_1.normalizeAdapter)(raw);
-            const provide = rec.provide;
-            tokens.add(provide);
-            defs.set(provide, rec);
-            graph.set(provide, new Set());
-        }
-        return { tokens, defs, graph };
-    }
-    buildGraph() {
-        for (const token of this.tokens) {
-            const rec = this.defs.get(token);
-            const deps = (0, adapter_utils_1.adapterDiscoveryDeps)(rec);
-            for (const d of deps) {
-                if (!this.providers.get(d)) {
-                    throw new Error(`Adapter ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
-                }
-                this.graph.get(token).add(d);
-            }
-        }
-    }
-    /** Instantiate adapters, run fetch/transform, and populate registries. */
-    async initialize() {
-        const readyArr = [];
-        for (const token of this.tokens) {
-            const rec = this.defs.get(token);
-            const deps = this.graph.get(token);
-            const instance = new adapter_instance_1.AdapterInstance(rec, deps, this.providers);
-            this.instances.set(token, instance);
-            readyArr.push(instance.ready);
-        }
-        await Promise.all(readyArr);
-    }
-    getAdapters() {
-        return [...this.instances.values()];
-    }
-}
-exports.default = AdapterRegistry;
-//# sourceMappingURL=adapter.regsitry.js.map

package/src/adapter/adapter.regsitry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.regsitry.js","sourceRoot":"","sources":["../../../src/adapter/adapter.regsitry.ts"],"names":[],"mappings":";;AAAA,4BAA0B;AAE1B,mDAAyE;AACzE,sDAAiD;AAEjD,0CAAuE;AACvE,yDAAqD;AAErD,MAAqB,eAAgB,SAAQ,2BAA+D;IAE1G,YACE,SAA2B,EAC3B,IAAmB;QAEnB,KAAK,CAAC,iBAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAGkB,QAAQ,CAAC,IAAmB;QAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAA,gCAAgB,EAAC,GAAG,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;IAGS,UAAU;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAA,oCAAoB,EAAC,GAAG,CAAC,CAAC;YAEvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAA,uBAAS,EAAC,KAAK,CAAC,eAAe,IAAA,uBAAS,EAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;gBACtG,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,0EAA0E;IAChE,KAAK,CAAC,UAAU;QAExB,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAEpC,MAAM,QAAQ,GAAG,IAAI,kCAAe,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEhE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAE9B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AA7DD,kCA6DC","sourcesContent":["import 'reflect-metadata';\nimport { AdapterEntry, AdapterRecord, AdapterRegistryInterface, AdapterType, Token } from '../common';\nimport { adapterDiscoveryDeps, normalizeAdapter } from './adapter.utils';\nimport { tokenName } from '../utils/token.utils';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { AdapterInstance } from './adapter.instance';\n\nexport default class AdapterRegistry extends RegistryAbstract<AdapterInstance, AdapterRecord, AdapterType[]> implements AdapterRegistryInterface {\n\n  constructor(\n    providers: ProviderRegistry,\n    list: AdapterType[],\n  ) {\n    super('AdapterRegistry', providers, list);\n  }\n\n\n  protected override buildMap(list: AdapterType[]): RegistryBuildMapResult<AdapterRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, AdapterRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeAdapter(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return { tokens, defs, graph };\n  }\n\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = adapterDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`Adapter ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = this.graph.get(token)!;\n\n      const instance = new AdapterInstance(rec, deps, this.providers);\n\n      this.instances.set(token, instance);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n\n  }\n\n  getAdapters(): AdapterEntry[] {\n    return [...this.instances.values()];\n  }\n}\n"]}

package/src/adapter/adapter.utils.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectAdapterMetadata = collectAdapterMetadata;
-exports.normalizeAdapter = normalizeAdapter;
-exports.adapterDiscoveryDeps = adapterDiscoveryDeps;
-const common_1 = require("../common");
-const metadata_utils_1 = require("../utils/metadata.utils");
-const token_utils_1 = require("../utils/token.utils");
-function collectAdapterMetadata(cls) {
-    return Object.entries(common_1.FrontMcpAdapterTokens).reduce((metadata, [key, token]) => {
-        return Object.assign(metadata, {
-            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
-        });
-    }, {});
-}
-function normalizeAdapter(item) {
-    if ((0, token_utils_1.isClass)(item)) {
-        const metadata = collectAdapterMetadata(item);
-        return { kind: common_1.AdapterKind.CLASS_TOKEN, provide: item, metadata };
-    }
-    if (item && typeof item === 'object') {
-        const { provide, useClass, useValue, useFactory, inject } = item;
-        if (!provide) {
-            const name = item?.name ?? '[object]';
-            throw new Error(`Adapter '${name}' is missing 'provide'.`);
-        }
-        if (useClass) {
-            if (!(0, token_utils_1.isClass)(useClass)) {
-                throw new Error(`'useClass' on adapter '${(0, token_utils_1.tokenName)(provide)}' must be a class.`);
-            }
-            return {
-                kind: common_1.AdapterKind.CLASS,
-                provide,
-                useClass,
-                metadata: item.metadata,
-            };
-        }
-        if (useFactory) {
-            if (typeof useFactory !== 'function') {
-                throw new Error(`'useFactory' on adapter '${(0, token_utils_1.tokenName)(provide)}' must be a function.`);
-            }
-            const inj = typeof inject === 'function' ? inject : () => [];
-            return {
-                kind: common_1.AdapterKind.FACTORY,
-                provide,
-                inject: inj,
-                useFactory,
-                metadata: item.metadata,
-            };
-        }
-        if ('useValue' in item) {
-            const metadata = collectAdapterMetadata(useValue.constructor);
-            return {
-                kind: common_1.AdapterKind.VALUE,
-                provide,
-                useValue,
-                metadata,
-            };
-        }
-    }
-    const name = item?.name ?? String(item);
-    throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);
-}
-/**
- * For graph/cycle detection. Returns dependency tokens that should be graphed.
- * - VALUE: no deps
- * - FACTORY: only includes deps that are registered (others will be resolved)
- * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
- */
-function adapterDiscoveryDeps(rec) {
-    switch (rec.kind) {
-        case common_1.AdapterKind.VALUE:
-            return [];
-        case common_1.AdapterKind.FACTORY: {
-            return [...rec.inject()];
-        }
-        case common_1.AdapterKind.CLASS:
-            return (0, token_utils_1.depsOfClass)(rec.useClass, 'discovery');
-        case common_1.AdapterKind.CLASS_TOKEN:
-            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
-    }
-}
-//# sourceMappingURL=adapter.utils.js.map