@frontmcp/sdk 1.2.1 → 1.4.0

package/flows/flow.instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAEL,SAAS,EAGT,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EAMf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAInB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAyBlE,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAW1F,UAAU;IA4DpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;;OASG;YACW,cAAc;IAiCtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CA6TrG"}
+{"version":3,"file":"flow.instance.d.ts","sourceRoot":"","sources":["../../src/flows/flow.instance.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAEL,SAAS,EAGT,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,UAAU,EAMf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAInB,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAyBlE,qBAAa,YAAY,CAAC,IAAI,SAAS,QAAQ,CAAE,SAAQ,SAAS,CAAC,IAAI,CAAC;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAW1F,UAAU;IAkFpB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;;;;OASG;YACW,cAAc;IAiCtB,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CA6TrG"}

package/front-mcp/front-mcp.d.ts

@@ -1,6 +1,12 @@
 import { type FrontMcpConfigInput, type FrontMcpConfigType, type FrontMcpInterface, type ScopeEntry } from '../common';
 import { type SqliteOptionsInput } from '../common/types/options/sqlite/schema';
 import { type DirectMcpServer } from '../direct';
+/**
+ * A `@FrontMcp`-decorated server class, or the raw config object it wraps.
+ * Entry points that accept either resolve a class to its stored config via
+ * {@link resolveConfigInput}.
+ */
+export type ConfigOrServerClass = FrontMcpConfigInput | (abstract new (...args: never[]) => unknown);
 export declare class FrontMcpInstance implements FrontMcpInterface {
     config: FrontMcpConfigType;
     readonly ready: Promise<void>;
@@ -25,6 +31,15 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * Called before server.start() or server.prepare() to register health routes.
      */
     private wireHealthService;
+    /**
+     * Wire the `/metrics` service into the server instance (issue #397).
+     *
+     * Off by default — `metrics.enabled` must be set to `true` explicitly.
+     * The `MetricsService` is instantiated here (not in scope construction)
+     * because the endpoint is server-wide, not per-app — counters and process
+     * stats are process-global.
+     */
+    private wireMetricsService;
     static bootstrap(options: FrontMcpConfigInput | FrontMcpConfigType): Promise<void>;
     /**
      * Creates and initializes a FrontMCP instance without starting the HTTP server.
@@ -89,35 +104,6 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * ```
      */
     static createDirect(options: FrontMcpConfigInput): Promise<DirectMcpServer>;
-    /**
-     * Runs the FrontMCP server using stdio transport for use with Claude Code
-     * or other MCP clients that support stdio communication.
-     *
-     * This method connects the server to stdin/stdout and handles MCP protocol
-     * messages directly. It does not return until the connection is closed.
-     *
-     * @example
-     * ```typescript
-     * // In your CLI entrypoint
-     * import { FrontMcpInstance } from '@frontmcp/sdk';
-     * import MyServer from './my-server';
-     *
-     * FrontMcpInstance.runStdio(MyServer);
-     * ```
-     *
-     * @example
-     * ```bash
-     * # In Claude Desktop config:
-     * {
-     *   "mcpServers": {
-     *     "my-server": {
-     *       "command": "node",
-     *       "args": ["./dist/main.js", "--stdio"]
-     *     }
-     *   }
-     * }
-     * ```
-     */
     /**
      * Runs the FrontMCP server on a Unix socket for local-only access.
      *
@@ -125,13 +111,16 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * a Unix `.sock` file. The entire HTTP feature set (streamable HTTP, SSE,
      * elicitation, sessions) works unchanged over Unix sockets.
      *
+     * Pass the same config object you give to `@FrontMcp()` (not the decorated
+     * class — spreading a class yields no config) plus the socket path.
+     *
      * @example
      * ```typescript
      * import { FrontMcpInstance } from '@frontmcp/sdk';
-     * import MyServer from './my-server';
+     * import { serverConfig } from './server-config';
      *
      * const handle = await FrontMcpInstance.runUnixSocket({
-     *   ...MyServer,
+     *   ...serverConfig,
      *   socketPath: '/tmp/my-app.sock',
      *   sqlite: { path: '~/.frontmcp/data/my-app.sqlite' },
      * });
@@ -146,6 +135,46 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
     }): Promise<{
         close: () => Promise<void>;
     }>;
-    static runStdio(options: FrontMcpConfigInput): Promise<void>;
+    /**
+     * Runs the FrontMCP server over **stdio** (stdin/stdout JSON-RPC) for local
+     * MCP clients such as Claude Desktop, Claude Code, and Cursor. Connects the
+     * transport and returns only when the connection closes. **No TCP port is
+     * bound** — the HTTP server is disabled for this entry point (#451).
+     *
+     * Accepts either a `@FrontMcp`-decorated class or the same config object you
+     * pass to `@FrontMcp()` (#450).
+     *
+     * IMPORTANT — importing a `@FrontMcp`-decorated class starts an HTTP server at
+     * import time unless `FRONTMCP_STDIO=1` is set *before* the import. Two safe
+     * patterns avoid that:
+     *
+     * 1. Built bundles — `frontmcp build --target node`, then run the emitted
+     *    runner with `--stdio` (it sets `FRONTMCP_STDIO=1` for you, so the
+     *    decorator serves over stdio). A `--target cli` binary supports
+     *    `<bin> --stdio` the same way.
+     * 2. Hand-written entry — keep the config object in its own module (no
+     *    decorated class in the import graph) and pass it directly, as below.
+     *
+     * @example Hand-written stdio entry (config kept separate from the class)
+     * ```typescript
+     * // server-config.ts — a plain object, no @FrontMcp decorator here
+     * export const serverConfig = { info: { name: 'my-server', version: '0.1.0' }, apps: [MyApp] };
+     *
+     * // stdio.ts
+     * import { FrontMcpInstance } from '@frontmcp/sdk';
+     * import { serverConfig } from './server-config';
+     * FrontMcpInstance.runStdio(serverConfig);
+     * ```
+     *
+     * @example Claude Desktop config (built `--target node` runner)
+     * ```json
+     * {
+     *   "mcpServers": {
+     *     "my-server": { "command": "/abs/path/dist/node/my-server", "args": ["--stdio"] }
+     *   }
+     * }
+     * ```
+     */
+    static runStdio(optionsOrClass: ConfigOrServerClass): Promise<void>;
 }
 //# sourceMappingURL=front-mcp.d.ts.map

package/front-mcp/front-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAatE,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAiB;gBAEjB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,KAAK;IAkBX;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;WAiCL,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAkB/E;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBhF;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;OAQG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH;;;;;;;;;;;;;;;;;;;;;OAqBG;WACiB,aAAa,CAC/B,OAAO,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,GAAG;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,GACA,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;WAmDtB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA8K1E"}
+{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AActE;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC;AAiCrG,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAiB;gBAEjB,MAAM,EAAE,kBAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,KAAK;IA8BX;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;IAIzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;WAoBN,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAkB/E;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBhF;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;OAQG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBxF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACiB,aAAa,CAC/B,OAAO,EAAE,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,GAAG;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,GACA,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAmD1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;WACiB,QAAQ,CAAC,cAAc,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuOjF"}