@frontmcp/sdk 0.8.1 → 0.9.0

package/README.md

@@ -0,0 +1,108 @@
+# @frontmcp/sdk
+
+The core FrontMCP framework for building MCP servers and clients in TypeScript.
+
+[![NPM](https://img.shields.io/npm/v/@frontmcp/sdk.svg)](https://www.npmjs.com/package/@frontmcp/sdk)
+
+## Install
+
+```bash
+npm install @frontmcp/sdk reflect-metadata
+```
+
+> Most users should scaffold with `npx frontmcp create my-app` instead of installing manually. See [Installation][docs-install].
+
+## Features
+
+- **`@FrontMcp` server** — single decorator configures info, apps, HTTP, logging, session, auth ([docs][docs-server])
+- **`@App`** — group tools, resources, prompts into isolated domains ([docs][docs-apps])
+- **`@Tool`** — typed actions with Zod input schemas, class or function style ([docs][docs-tools])
+- **`@Resource`** — read-only data with static and template URIs ([docs][docs-resources])
+- **`@Prompt`** — reusable message templates returning `GetPromptResult` ([docs][docs-prompts])
+- **`@Agent`** — orchestrated multi-step tool chains ([docs][docs-agents])
+- **Elicitation** — request structured user input mid-flow ([docs][docs-elicitation])
+- **Skills** — HTTP-discoverable tool manifests for agent marketplaces ([docs][docs-skills])
+- **5 context classes** — `ToolContext`, `ResourceContext`, `PromptContext`, `AgentContext`, `HookContext`
+- **Direct client** — `create()`, `connect()`, `connectOpenAI()`, `connectClaude()`, `connectLangChain()`, `connectVercelAI()` ([docs][docs-direct])
+- **Authentication** — Remote OAuth, Local OAuth, JWKS, DCR, per-app auth surfaces ([docs][docs-auth])
+- **Sessions** — stateful / stateless modes, JWT or UUID transport IDs
+- **Hooks** — tool, list-tools, HTTP, resource, prompt hook families ([docs][docs-hooks])
+- **Ext-Apps** — mount external MCP servers as sub-apps ([docs][docs-ext-apps])
+- **Providers / DI** — scoped injection with GLOBAL and CONTEXT scopes ([docs][docs-providers])
+- **ConfigPlugin** — load `frontmcp.yaml` / `frontmcp.json` config files ([docs][docs-config])
+- **Transport** — Streamable HTTP + SSE ([docs][docs-transport])
+
+## Quick Example
+
+```ts
+import 'reflect-metadata';
+import { FrontMcp, App, Tool } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+@Tool({ name: 'greet', inputSchema: { name: z.string() } })
+class GreetTool {
+  async execute({ name }: { name: string }) {
+    return `Hello, ${name}!`;
+  }
+}
+
+@App({ id: 'hello', name: 'Hello', tools: [GreetTool] })
+class HelloApp {}
+
+@FrontMcp({ info: { name: 'Demo', version: '0.1.0' }, apps: [HelloApp], http: { port: 3000 } })
+export default class Server {}
+```
+
+> Full walkthrough: [Quickstart][docs-quickstart]
+
+## Docs
+
+| Topic                     | Link                                                                                               |
+| ------------------------- | -------------------------------------------------------------------------------------------------- |
+| Server configuration      | [The FrontMCP Server][docs-server]                                                                 |
+| Apps & isolation          | [Apps][docs-apps]                                                                                  |
+| Tools, Resources, Prompts | [Tools][docs-tools] · [Resources][docs-resources] · [Prompts][docs-prompts]          |
+| Agents                    | [Agents][docs-agents]                                                                              |
+| Authentication            | [Auth Overview][docs-auth] · [Remote OAuth][docs-remote] · [Local OAuth][docs-local] |
+| Direct client             | [Direct Client][docs-direct]                                                                       |
+| Hooks & providers         | [Hooks][docs-hooks] · [Providers][docs-providers]                                           |
+| Deployment                | [Local Dev][docs-deploy] · [Production][docs-production]                                    |
+| SDK reference             | [Overview][docs-sdk-ref]                                                                           |
+
+## Related Packages
+
+- [`@frontmcp/cli`](../cli) — scaffolding and dev tooling
+- [`@frontmcp/auth`](../auth) — authentication library
+- [`@frontmcp/adapters`](../adapters) — OpenAPI adapter
+- [`@frontmcp/plugins`](../plugins) — Cache, Remember, CodeCall, Dashboard
+- [`@frontmcp/testing`](../testing) — E2E testing framework
+- [`@frontmcp/ui`](../ui) / [`@frontmcp/uipack`](../uipack) — UI components and build tools
+
+## License
+
+Apache-2.0 — see [LICENSE](../../LICENSE).
+
+<!-- links -->
+
+[docs-install]: https://docs.agentfront.dev/frontmcp/getting-started/installation
+[docs-quickstart]: https://docs.agentfront.dev/frontmcp/getting-started/quickstart
+[docs-server]: https://docs.agentfront.dev/frontmcp/servers/server
+[docs-apps]: https://docs.agentfront.dev/frontmcp/servers/apps
+[docs-tools]: https://docs.agentfront.dev/frontmcp/servers/tools
+[docs-resources]: https://docs.agentfront.dev/frontmcp/servers/resources
+[docs-prompts]: https://docs.agentfront.dev/frontmcp/servers/prompts
+[docs-agents]: https://docs.agentfront.dev/frontmcp/servers/agents
+[docs-elicitation]: https://docs.agentfront.dev/frontmcp/servers/elicitation
+[docs-skills]: https://docs.agentfront.dev/frontmcp/servers/skills
+[docs-auth]: https://docs.agentfront.dev/frontmcp/authentication/overview
+[docs-remote]: https://docs.agentfront.dev/frontmcp/authentication/remote
+[docs-local]: https://docs.agentfront.dev/frontmcp/authentication/local
+[docs-direct]: https://docs.agentfront.dev/frontmcp/deployment/direct-client
+[docs-transport]: https://docs.agentfront.dev/frontmcp/deployment/transport
+[docs-ext-apps]: https://docs.agentfront.dev/frontmcp/servers/ext-apps
+[docs-hooks]: https://docs.agentfront.dev/frontmcp/extensibility/hooks
+[docs-providers]: https://docs.agentfront.dev/frontmcp/extensibility/providers
+[docs-config]: https://docs.agentfront.dev/frontmcp/extensibility/config-yaml
+[docs-deploy]: https://docs.agentfront.dev/frontmcp/deployment/local-dev-server
+[docs-production]: https://docs.agentfront.dev/frontmcp/deployment/production-build
+[docs-sdk-ref]: https://docs.agentfront.dev/frontmcp/sdk-reference/overview

package/auth/flows/oauth.authorize.flow.d.ts

@@ -24,7 +24,7 @@ import { z } from 'zod';
 declare const oauthAuthorizeRequestSchema: z.ZodObject<{
     response_type: z.ZodLiteral<"code">;
     client_id: z.ZodString;
-    redirect_uri: z.ZodString;
+    redirect_uri: z.ZodURL;
     code_challenge: z.ZodString;
     code_challenge_method: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"S256">>>;
     scope: z.ZodOptional<z.ZodString>;
@@ -35,7 +35,7 @@ declare const oauthAuthorizeRequestSchema: z.ZodObject<{
  * Minimal request for anonymous/default provider mode
  */
 declare const anonymousAuthorizeRequestSchema: z.ZodObject<{
-    redirect_uri: z.ZodString;
+    redirect_uri: z.ZodURL;
     state: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type OAuthAuthorizeRequest = z.infer<typeof oauthAuthorizeRequestSchema>;
@@ -52,7 +52,7 @@ declare const stateSchema: z.ZodObject<{
     validatedRequest: z.ZodOptional<z.ZodObject<{
         response_type: z.ZodLiteral<"code">;
         client_id: z.ZodString;
-        redirect_uri: z.ZodString;
+        redirect_uri: z.ZodURL;
         code_challenge: z.ZodString;
         code_challenge_method: z.ZodDefault<z.ZodOptional<z.ZodLiteral<"S256">>>;
         scope: z.ZodOptional<z.ZodString>;

package/auth/flows/oauth.authorize.flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.authorize.flow.d.ts","sourceRoot":"","sources":["../../../src/auth/flows/oauth.authorize.flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,OAAO,EAEL,QAAQ,EAER,cAAc,EAQf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAuDlC;;GAEG;AACH,QAAA,MAAM,2BAA2B;;;;;;;;;iBAS/B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,+BAA+B;;;iBAGnC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,QAAA,MAAM,WAAW;;;;iBAAkB,CAAC;AAEpC,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAIhB,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAQ2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,iBAAiB,EAAE,cAAc,CAC/B,kBAAkB,EAClB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,iBAA0B,CAAC;AAcxC,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACnE,OAAO,CAAC,MAAM,CAAiD;IAGzD,UAAU;IAiEV,aAAa;IAmFb,iBAAiB;IAOjB,2BAA2B;IAmG3B,oBAAoB;IA0GpB,cAAc;IAIpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkRzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAyCxB"}
+{"version":3,"file":"oauth.authorize.flow.d.ts","sourceRoot":"","sources":["../../../src/auth/flows/oauth.authorize.flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,OAAO,EAEL,QAAQ,EAER,cAAc,EAQf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAY,MAAM,KAAK,CAAC;AAuElC;;GAEG;AACH,QAAA,MAAM,2BAA2B;;;;;;;;;iBAS/B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,+BAA+B;;;iBAGnC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAMxF,QAAA,MAAM,WAAW;;;;iBAAkB,CAAC;AAEpC,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAIhB,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAQ2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,iBAAiB,EAAE,cAAc,CAC/B,kBAAkB,EAClB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,iBAA0B,CAAC;AAcxC,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACnE,OAAO,CAAC,MAAM,CAAiD;IAGzD,UAAU;IAiEV,aAAa;IAqFb,iBAAiB;IAOjB,2BAA2B;IAmG3B,oBAAoB;IA0GpB,cAAc;IAIpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAyBjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkRzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAyCxB"}

package/auth/machine-id.d.ts

@@ -14,7 +14,15 @@
  */
 /**
  * Get the current machine ID.
- * This value is stable for the lifetime of the process.
+ * Returns the override (if set via `setMachineIdOverride`) or the computed value.
  */
 export declare function getMachineId(): string;
+/**
+ * Set a process-wide machine ID override.
+ * Pass `undefined` to clear the override and revert to the computed value.
+ *
+ * This is used by `create()` to inject a stable machine ID for session continuity,
+ * especially when using Redis-backed sessions across process restarts.
+ */
+export declare function setMachineIdOverride(id: string | undefined): void;
 //# sourceMappingURL=machine-id.d.ts.map

package/auth/machine-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"machine-id.d.ts","sourceRoot":"","sources":["../../src/auth/machine-id.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AA4GH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
+{"version":3,"file":"machine-id.d.ts","sourceRoot":"","sources":["../../src/auth/machine-id.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AA+GH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEjE"}

package/direct/create.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `create()` Factory Function
+ *
+ * Spins up a FrontMCP direct server from a flat config object — no decorators,
+ * no App classes, no HTTP server. Supports machineId injection for session
+ * continuity and caching for reuse.
+ *
+ * @example
+ * ```typescript
+ * import { create } from '@frontmcp/sdk';
+ *
+ * const server = await create({
+ *   info: { name: 'my-service', version: '1.0.0' },
+ *   tools: [MyTool],
+ *   adapters: [OpenapiAdapter.init({ name: 'api', spec, baseUrl })],
+ * });
+ *
+ * const { tools } = await server.listTools();
+ * const result = await server.callTool('my-tool', { arg: 'value' });
+ * await server.dispose();
+ * ```
+ */
+import 'reflect-metadata';
+import type { DirectMcpServer } from './direct.types';
+import type { CreateConfig } from './create.types';
+/**
+ * Create a FrontMCP direct server from a flat config object.
+ *
+ * Returns a `DirectMcpServer` that provides `listTools`, `callTool`,
+ * `listResources`, `readResource`, `listPrompts`, `getPrompt`, and `dispose`.
+ *
+ * @param config - Flat configuration combining server and app fields
+ * @returns A ready-to-use `DirectMcpServer`
+ *
+ * @example Basic usage
+ * ```typescript
+ * const server = await create({
+ *   info: { name: 'my-service', version: '1.0.0' },
+ *   tools: [MyTool],
+ * });
+ * const { tools } = await server.listTools();
+ * await server.dispose();
+ * ```
+ *
+ * @example With caching and machineId
+ * ```typescript
+ * const server = await create({
+ *   info: { name: 'my-service', version: '1.0.0' },
+ *   tools: [MyTool],
+ *   machineId: 'stable-id-for-sessions',
+ *   cacheKey: 'tenant-123',
+ * });
+ * ```
+ */
+export declare function create(config: CreateConfig): Promise<DirectMcpServer>;
+/**
+ * Clear the create() instance cache.
+ * Useful for testing to ensure clean state between test runs.
+ * Does NOT dispose cached servers — call `dispose()` on each first.
+ */
+export declare function clearCreateCache(): void;
+//# sourceMappingURL=create.d.ts.map

package/direct/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/direct/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA6D3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/direct/create.types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Configuration types for the `create()` factory function.
+ *
+ * Provides a flat config interface that combines server-level and app-level
+ * fields, avoiding the need for decorators or explicit app class definitions.
+ */
+import type { ServerInfoOptions, RedisOptionsInput, PubsubOptionsInput, TransportOptionsInput, LoggingOptionsInput, PaginationOptions, ElicitationOptionsInput, SkillsConfigOptionsInput, ExtAppsOptionsInput, AuthOptionsInput } from '../common/types';
+import type { ToolType, ResourceType, PromptType, PluginType, ProviderType, AdapterType, AgentType, SkillType, AuthProviderType } from '../common/interfaces';
+/**
+ * Flat configuration for the `create()` factory function.
+ *
+ * Combines server-level metadata (info, redis, transport, etc.) with
+ * app-level entries (tools, resources, prompts, etc.) into a single object.
+ * Internally, app-level fields are wrapped into a synthetic app definition.
+ *
+ * @example
+ * ```typescript
+ * import { create } from '@frontmcp/sdk';
+ *
+ * const server = await create({
+ *   info: { name: 'my-service', version: '1.0.0' },
+ *   tools: [MyTool],
+ *   adapters: [OpenapiAdapter.init({ name: 'api', spec, baseUrl })],
+ *   machineId: 'stable-id',
+ *   cacheKey: 'tenant-123',
+ * });
+ * ```
+ */
+export interface CreateConfig {
+    /** Server name and version (required) */
+    info: ServerInfoOptions;
+    /** Redis configuration for sessions, persistence, etc. */
+    redis?: RedisOptionsInput;
+    /** Pub/Sub configuration (Redis-only) for resource subscriptions */
+    pubsub?: PubsubOptionsInput;
+    /** Transport and session lifecycle configuration */
+    transport?: TransportOptionsInput;
+    /** Logging configuration */
+    logging?: LoggingOptionsInput;
+    /** Pagination configuration for list operations */
+    pagination?: PaginationOptions;
+    /** Elicitation configuration for interactive user input */
+    elicitation?: ElicitationOptionsInput;
+    /** Skills HTTP endpoints configuration */
+    skillsConfig?: SkillsConfigOptionsInput;
+    /** MCP Apps (ext-apps) configuration */
+    extApps?: ExtAppsOptionsInput;
+    /** Tool classes or builder-defined tools */
+    tools?: ToolType[];
+    /** Resource classes or builder-defined resources */
+    resources?: ResourceType[];
+    /** Prompt classes or builder-defined prompts */
+    prompts?: PromptType[];
+    /** Adapter instances (e.g., OpenapiAdapter.init({...})) */
+    adapters?: AdapterType[];
+    /** Plugin instances */
+    plugins?: PluginType[];
+    /** Dependency injection providers */
+    providers?: ProviderType[];
+    /** Auth providers (e.g., GithubAuthProvider, GoogleAuthProvider) */
+    authProviders?: AuthProviderType[];
+    /** Autonomous AI agents */
+    agents?: AgentType[];
+    /** Skills for multi-step task workflows */
+    skills?: SkillType[];
+    /** Authentication configuration for the app */
+    auth?: AuthOptionsInput;
+    /**
+     * Name for the synthetic app.
+     * Defaults to `info.name` if not provided.
+     */
+    appName?: string;
+    /**
+     * Process-wide machine ID override for session continuity.
+     * When set, `getMachineId()` returns this value instead of the computed one.
+     * Useful for maintaining sessions across process restarts with Redis storage.
+     */
+    machineId?: string;
+    /**
+     * Cache key for reusing server instances.
+     * Same `cacheKey` returns the same `DirectMcpServer` promise.
+     * Calling `dispose()` on the server automatically evicts it from the cache.
+     */
+    cacheKey?: string;
+}
+//# sourceMappingURL=create.types.d.ts.map

package/direct/create.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.types.d.ts","sourceRoot":"","sources":["../../src/direct/create.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAG3B,yCAAyC;IACzC,IAAI,EAAE,iBAAiB,CAAC;IAExB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAE1B,oEAAoE;IACpE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B,oDAAoD;IACpD,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAElC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAE9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAEtC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,wBAAwB,CAAC;IAExC,wCAAwC;IACxC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAI9B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IAEnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B,gDAAgD;IAChD,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB,uBAAuB;IACvB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IAEvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B,oEAAoE;IACpE,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAIxB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/direct/direct-server.d.ts

@@ -6,6 +6,8 @@
  */
 import type { ListToolsResult, CallToolResult, ListResourcesResult, ReadResourceResult, ListPromptsResult, GetPromptResult, ListResourceTemplatesResult } from '@modelcontextprotocol/sdk/types.js';
 import type { DirectMcpServer, DirectCallOptions } from './direct.types';
+import type { ConnectOptions } from './client.types';
+import type { DirectClient } from './client.types';
 import type { Scope } from '../scope/scope.instance';
 /**
  * Implementation of DirectMcpServer that bypasses HTTP transport
@@ -33,6 +35,7 @@ export declare class DirectMcpServerImpl implements DirectMcpServer {
     readResource(uri: string, options?: DirectCallOptions): Promise<ReadResourceResult>;
     listPrompts(options?: DirectCallOptions): Promise<ListPromptsResult>;
     getPrompt(name: string, args?: Record<string, string>, options?: DirectCallOptions): Promise<GetPromptResult>;
+    connect(sessionIdOrOptions?: string | ConnectOptions): Promise<DirectClient>;
     dispose(): Promise<void>;
 }
 //# sourceMappingURL=direct-server.d.ts.map

package/direct/direct-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct-server.d.ts","sourceRoot":"","sources":["../../src/direct/direct-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAA4C,MAAM,gBAAgB,CAAC;AACnH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAsCrD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,KAAK,EAAE,KAAK;IAMxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;YACW,OAAO;IAmCf,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAY5G,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQxE,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQxF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYnF,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAY7G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc/B"}
+{"version":3,"file":"direct-server.d.ts","sourceRoot":"","sources":["../../src/direct/direct-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAA4C,MAAM,gBAAgB,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAsCrD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,KAAK,EAAE,KAAK;IAMxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;YACW,OAAO;IAmCf,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAY5G,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQxE,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQxF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAYnF,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAY7G,OAAO,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAgB5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc/B"}

package/direct/direct.types.d.ts

@@ -5,6 +5,7 @@
  * Useful for embedding MCP servers in existing applications, testing, and agent backends.
  */
 import type { ListToolsResult, CallToolResult, ListResourcesResult, ReadResourceResult, ListPromptsResult, GetPromptResult, ListResourceTemplatesResult } from '@modelcontextprotocol/sdk/types.js';
+import type { DirectClient, ConnectOptions } from './client.types';
 /**
  * Auth context for direct server invocation.
  * Simulates what would come from JWT validation in the HTTP layer.
@@ -126,6 +127,14 @@ export interface DirectMcpServer {
      * @returns Prompt content with messages
      */
     getPrompt(name: string, args?: Record<string, string>, options?: DirectCallOptions): Promise<GetPromptResult>;
+    /**
+     * Connect a new MCP client to this server.
+     * Each client gets its own session and in-memory transport.
+     *
+     * @param sessionIdOrOptions - Session ID string (shorthand) or full ConnectOptions
+     * @returns Connected DirectClient instance
+     */
+    connect(sessionIdOrOptions?: string | ConnectOptions): Promise<DirectClient>;
     /**
      * Dispose the server and cleanup resources.
      */

package/direct/direct.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"direct.types.d.ts","sourceRoot":"","sources":["../../src/direct/direct.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAM9B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjE;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAM7G;;;;;OAKG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEzF;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAMpF;;;;;OAKG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAErE;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAM9G;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"direct.types.d.ts","sourceRoot":"","sources":["../../src/direct/direct.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAM9B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjE;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAM7G;;;;;OAKG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEzF;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAMpF;;;;;OAKG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAErE;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAM9G;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAM7E;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/direct/index.d.ts

@@ -12,4 +12,6 @@ export { detectPlatform, formatToolsForPlatform, formatResultForPlatform, PLATFO
 export type { OpenAITool, ClaudeTool, LangChainTool, VercelAITool, VercelAITools } from './llm-platform';
 export type { DirectMcpServer, DirectAuthContext, DirectCallOptions, DirectRequestMetadata } from './direct.types';
 export { DirectMcpServerImpl } from './direct-server';
+export { create, clearCreateCache } from './create';
+export type { CreateConfig } from './create.types';
 //# sourceMappingURL=index.d.ts.map

package/direct/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/direct/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EAEX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAEhB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,eAAe,EACf,cAAc,EAEd,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMzG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEnH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/direct/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EAEX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAEhB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,eAAe,EACf,cAAc,EAEd,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACvH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMzG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEnH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAMtD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}