@frontmcp/sdk 0.12.2 → 1.0.0-beta.10

package/esm-loader/package-specifier.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file package-specifier.ts
+ * @description Parse npm package specifiers (e.g., '@scope/pkg@^1.0.0') and build esm.sh URLs.
+ */
+/**
+ * Parsed representation of an npm package specifier.
+ */
+export interface ParsedPackageSpecifier {
+    /** Scope portion, e.g. '@acme' (includes the @) */
+    scope?: string;
+    /** Package name without scope, e.g. 'mcp-tools' */
+    name: string;
+    /** Full package name, e.g. '@acme/mcp-tools' */
+    fullName: string;
+    /** Semver range or tag, e.g. '^1.0.0', 'latest' */
+    range: string;
+    /** Original input string */
+    raw: string;
+}
+/**
+ * Parse an npm-style package specifier string into structured parts.
+ *
+ * @param spec - Package specifier string (e.g., '@acme/mcp-tools@^1.0.0')
+ * @returns Parsed specifier with scope, name, range
+ * @throws Error if the specifier is invalid
+ *
+ * @example
+ * parsePackageSpecifier('@acme/mcp-tools@^1.0.0')
+ * // { scope: '@acme', name: 'mcp-tools', fullName: '@acme/mcp-tools', range: '^1.0.0', raw: '@acme/mcp-tools@^1.0.0' }
+ *
+ * parsePackageSpecifier('my-tools')
+ * // { scope: undefined, name: 'my-tools', fullName: 'my-tools', range: 'latest', raw: 'my-tools' }
+ */
+export declare function parsePackageSpecifier(spec: string): ParsedPackageSpecifier;
+/**
+ * Check whether a string looks like a package specifier (starts with @ or contains alphanumeric).
+ * Used by normalize functions to distinguish package strings from other string inputs.
+ */
+export declare function isPackageSpecifier(value: string): boolean;
+/**
+ * Default esm.sh CDN base URL.
+ */
+export declare const ESM_SH_BASE_URL = "https://esm.sh";
+/**
+ * Build an esm.sh CDN URL for a given package specifier.
+ *
+ * @param spec - Parsed package specifier
+ * @param resolvedVersion - Concrete version to pin to (overrides range)
+ * @param options - Additional URL options
+ * @returns Full esm.sh URL for dynamic import
+ *
+ * @example
+ * buildEsmShUrl(parsePackageSpecifier('@acme/tools@^1.0.0'), '1.2.3')
+ * // 'https://esm.sh/@acme/tools@1.2.3?bundle'
+ */
+export declare function buildEsmShUrl(spec: ParsedPackageSpecifier, resolvedVersion?: string, options?: {
+    baseUrl?: string;
+    bundle?: boolean;
+}): string;
+//# sourceMappingURL=package-specifier.d.ts.map

package/esm-loader/package-specifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-specifier.d.ts","sourceRoot":"","sources":["../../src/esm-loader/package-specifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAqB1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,sBAAsB,EAC5B,eAAe,CAAC,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,MAAM,CAUR"}

package/esm-loader/semver.utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file semver.utils.ts
+ * @description Thin wrapper around the `semver` package for version comparison utilities.
+ * Isolates the semver dependency to a single file for easier maintenance.
+ */
+/**
+ * Check if a specific version satisfies a semver range.
+ *
+ * @param version - Concrete version string (e.g., '1.2.3')
+ * @param range - Semver range string (e.g., '^1.0.0', '>=2.0.0', 'latest')
+ * @returns true if the version satisfies the range
+ */
+export declare function satisfiesRange(version: string, range: string): boolean;
+/**
+ * Find the highest version in a list that satisfies a semver range.
+ *
+ * @param versions - Array of version strings
+ * @param range - Semver range to match against
+ * @returns The highest matching version, or null if none match
+ */
+export declare function maxSatisfying(versions: string[], range: string): string | null;
+/**
+ * Check if a string is a valid semver range.
+ */
+export declare function isValidRange(range: string): boolean;
+/**
+ * Check if a string is a valid semver version.
+ */
+export declare function isValidVersion(version: string): boolean;
+/**
+ * Compare two versions. Returns:
+ * - negative if v1 < v2
+ * - 0 if v1 === v2
+ * - positive if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if v1 is greater than v2.
+ */
+export declare function isNewerVersion(v1: string, v2: string): boolean;
+//# sourceMappingURL=semver.utils.d.ts.map

package/esm-loader/semver.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.utils.d.ts","sourceRoot":"","sources":["../../src/esm-loader/semver.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/esm-loader/version-poller.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @file version-poller.ts
+ * @description Background polling service that checks npm registry for new package versions.
+ * Triggers callbacks when a new version matching the semver range is detected.
+ */
+import type { FrontMcpLogger } from '../common';
+import type { EsmRegistryAuth } from './esm-auth.types';
+import type { ParsedPackageSpecifier } from './package-specifier';
+/**
+ * Result of checking a single package for updates.
+ */
+export interface VersionCheckResult {
+    /** Full package name */
+    packageName: string;
+    /** Currently loaded version */
+    currentVersion: string;
+    /** Latest version matching the range */
+    latestVersion: string;
+    /** Whether a newer version is available */
+    hasUpdate: boolean;
+    /** Whether the latest version satisfies the original range */
+    satisfiesRange: boolean;
+}
+/**
+ * Options for the version poller.
+ */
+export interface VersionPollerOptions {
+    /** Polling interval in milliseconds (default: 300000 = 5 minutes) */
+    intervalMs?: number;
+    /** Authentication for private registries */
+    registryAuth?: EsmRegistryAuth;
+    /** Logger instance */
+    logger?: FrontMcpLogger;
+    /** Callback when a new version is detected */
+    onNewVersion: (packageName: string, oldVersion: string, newVersion: string) => Promise<void>;
+}
+/**
+ * Background service that periodically checks npm registry for package updates.
+ *
+ * When a new version matching the semver range is detected, triggers the
+ * `onNewVersion` callback to drive hot-reload of ESM packages.
+ */
+export declare class VersionPoller {
+    private readonly intervalMs;
+    private readonly logger?;
+    private readonly onNewVersion;
+    private readonly versionResolver;
+    private readonly packages;
+    private intervalId?;
+    private running;
+    private polling;
+    constructor(options: VersionPollerOptions);
+    /**
+     * Add a package to the polling watchlist.
+     *
+     * @param specifier - Parsed package specifier with semver range
+     * @param currentVersion - Currently loaded concrete version
+     */
+    addPackage(specifier: ParsedPackageSpecifier, currentVersion: string): void;
+    /**
+     * Remove a package from the polling watchlist.
+     */
+    removePackage(packageName: string): void;
+    /**
+     * Update the current version for a tracked package (after hot-reload).
+     *
+     * @returns `true` if the package was found and updated, `false` if unknown.
+     */
+    updateCurrentVersion(packageName: string, newVersion: string): boolean;
+    /**
+     * Start the background polling loop.
+     */
+    start(): void;
+    /**
+     * Stop the background polling loop.
+     */
+    stop(): void;
+    /**
+     * Check all tracked packages for updates immediately (without waiting for the interval).
+     *
+     * @returns Array of check results for all tracked packages
+     */
+    checkNow(): Promise<VersionCheckResult[]>;
+    /**
+     * Whether the poller is currently running.
+     */
+    isRunning(): boolean;
+    /**
+     * Number of packages being tracked.
+     */
+    get trackedCount(): number;
+    /**
+     * Internal polling loop iteration.
+     */
+    private poll;
+    /**
+     * Check a single package for updates.
+     */
+    private checkPackage;
+}
+//# sourceMappingURL=version-poller.d.ts.map

package/esm-loader/version-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-poller.d.ts","sourceRoot":"","sources":["../../src/esm-loader/version-poller.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAC;CACzB;AAUD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8CAA8C;IAC9C,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9F;AAKD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0C;IACnE,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,oBAAoB;IASzC;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAO3E;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;OAIG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAStE;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAe/C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;YACW,IAAI;IAwBlB;;OAEG;YACW,YAAY;CAiB3B"}

package/esm-loader/version-resolver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file version-resolver.ts
+ * @description Resolves semver ranges to concrete versions using the npm registry API.
+ */
+import type { EsmRegistryAuth } from './esm-auth.types';
+import type { ParsedPackageSpecifier } from './package-specifier';
+/**
+ * Result of a version resolution.
+ */
+export interface VersionResolutionResult {
+    /** The concrete version that was resolved */
+    resolvedVersion: string;
+    /** All available versions from the registry */
+    availableVersions: string[];
+    /** When the resolved version was published (ISO string) */
+    publishedAt?: string;
+}
+/**
+ * Options for the version resolver.
+ */
+export interface VersionResolverOptions {
+    /** Authentication for private registries */
+    registryAuth?: EsmRegistryAuth;
+    /** Request timeout in milliseconds (default: 15000) */
+    timeout?: number;
+}
+/**
+ * Resolves semver ranges to concrete versions by querying the npm registry API.
+ */
+export declare class VersionResolver {
+    private readonly registryAuth?;
+    private readonly timeout;
+    constructor(options?: VersionResolverOptions);
+    /**
+     * Resolve a package specifier's semver range to a concrete version.
+     *
+     * @param specifier - Parsed package specifier with range
+     * @returns Resolution result with concrete version
+     * @throws Error if the package is not found or no version matches the range
+     */
+    resolve(specifier: ParsedPackageSpecifier): Promise<VersionResolutionResult>;
+    /**
+     * Resolve version from already-fetched registry data.
+     */
+    private resolveFromRegistryData;
+}
+//# sourceMappingURL=version-resolver.d.ts.map

package/esm-loader/version-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolver.d.ts","sourceRoot":"","sources":["../../src/esm-loader/version-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,sBAAsB;IAK5C;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2ClF;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgDhC"}

package/ext-apps/ext-apps.handler.d.ts.map

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

package/flows/flow.instance.d.ts

@@ -1,7 +1,6 @@
 import 'reflect-metadata';
-import { FlowEntry, FlowInputOf, FlowName, FlowOutputOf, FlowRecord, Reference, ServerRequest, Token, Type } from '../common';
+import { FlowEntry, FlowInputOf, FlowName, FlowOutputOf, FlowRecord, Reference, ScopeEntry, ServerRequest, Token, Type } from '../common';
 import ProviderRegistry from '../provider/provider.registry';
-import { Scope } from '../scope';
 export declare class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {
     readonly deps: Reference[];
     readonly globalProviders: ProviderRegistry;
@@ -10,7 +9,7 @@ export declare class FlowInstance<Name extends FlowName> extends FlowEntry<Name>
     private stages;
     private hooks;
     private readonly logger;
-    constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry);
+    constructor(scope: ScopeEntry, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry);
     protected initialize(): Promise<void>;
     canActivate(request: ServerRequest): Promise<boolean>;
     /**

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;AAC1B,OAAO,EAIL,SAAS,EACT,WAAW,EAEX,QAAQ,EACR,YAAY,EAEZ,UAAU,EAKV,SAAS,EACT,aAAa,EACb,KAAK,EACL,IAAI,EACL,MAAM,WAAW,CAAC;AACnB,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AA2BjC,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,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAWrF,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;AAC1B,OAAO,EAIL,SAAS,EACT,WAAW,EAEX,QAAQ,EACR,YAAY,EAEZ,UAAU,EAKV,SAAS,EACT,UAAU,EACV,aAAa,EACb,KAAK,EACL,IAAI,EACL,MAAM,WAAW,CAAC;AACnB,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AA6B7D,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"}

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

@@ -20,7 +20,7 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * Useful for graph visualization and introspection.
      */
     getScopes(): ScopeEntry[];
-    static bootstrap(options: FrontMcpConfigType): Promise<void>;
+    static bootstrap(options: FrontMcpConfigInput | FrontMcpConfigType): Promise<void>;
     /**
      * Creates and initializes a FrontMCP instance without starting the HTTP server.
      * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).
@@ -43,6 +43,16 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * const scopes = instance.getScopes();
      */
     static createForGraph(options: FrontMcpConfigInput): Promise<FrontMcpInstance>;
+    /**
+     * Creates a FrontMCP instance optimized for CLI execution.
+     * Skips non-essential registries (UI widget compilation, event stores,
+     * elicitation stores) for faster startup (~100-150ms savings).
+     *
+     * @example
+     * const instance = await FrontMcpInstance.createForCli(config);
+     * const scopes = instance.getScopes();
+     */
+    static createForCli(options: FrontMcpConfigInput): Promise<FrontMcpInstance>;
     /**
      * Creates a DirectMcpServer from a FrontMCP configuration.
      * This provides direct programmatic access to MCP operations
@@ -125,7 +135,7 @@ export declare class FrontMcpInstance implements FrontMcpInterface {
      * await handle.close();
      * ```
      */
-    static runUnixSocket(options: FrontMcpConfigInput & {
+    static runUnixSocket(options: (FrontMcpConfigInput | FrontMcpConfigType) & {
         socketPath: string;
         sqlite?: SqliteOptionsInput;
     }): Promise<{

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":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAGjB,UAAU,EAEX,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,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;IASX;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;WAIL,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAQzD;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAchF;;;;;;;;OAQG;WACiB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ3F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACiB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBxF;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH;;;;;;;;;;;;;;;;;;;;;OAqBG;WACiB,aAAa,CAC/B,OAAO,EAAE,mBAAmB,GAAG;QAC7B,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;CA0G1E"}
+{"version":3,"file":"front-mcp.d.ts","sourceRoot":"","sources":["../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAGjB,UAAU,EAGX,MAAM,WAAW,CAAC;AAMnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,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;IASX;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;WAIL,SAAS,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAkB/E;;;;;;;;;;OAUG;WACiB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAchF;;;;;;;;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;IASzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;CAyG1E"}