@frontmcp/sdk 0.6.2 → 0.7.1

package/remote-mcp/resilience/health-check.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @file health-check.ts
+ * @description Health check mechanism for proactive monitoring of remote MCP connections
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+export interface HealthCheckResult {
+    status: HealthStatus;
+    latencyMs?: number;
+    lastChecked: Date;
+    consecutiveFailures: number;
+    consecutiveSuccesses: number;
+    error?: string;
+}
+export interface HealthCheckOptions {
+    /** Interval between health checks in ms (default: 30000) */
+    intervalMs?: number;
+    /** Timeout for health check in ms (default: 5000) */
+    timeoutMs?: number;
+    /** Number of failures before marking unhealthy (default: 3) */
+    unhealthyThreshold?: number;
+    /** Number of successes before marking healthy (default: 2) */
+    healthyThreshold?: number;
+    /** Latency threshold for degraded status in ms (default: 2000) */
+    degradedLatencyMs?: number;
+    /** Callback on health status change */
+    onStatusChange?: (appId: string, status: HealthStatus, previousStatus: HealthStatus) => void;
+}
+/**
+ * Health checker for a single remote MCP connection
+ */
+export declare class HealthChecker {
+    private readonly appId;
+    private readonly options;
+    private readonly checkFn;
+    private status;
+    private lastResult?;
+    private consecutiveFailures;
+    private consecutiveSuccesses;
+    private intervalTimer?;
+    private isChecking;
+    constructor(appId: string, checkFn: () => Promise<void>, options?: HealthCheckOptions);
+    /**
+     * Start periodic health checks
+     */
+    start(): void;
+    /**
+     * Stop periodic health checks
+     */
+    stop(): void;
+    /**
+     * Perform a single health check
+     */
+    check(): Promise<HealthCheckResult>;
+    /**
+     * Get current health status
+     */
+    getStatus(): HealthStatus;
+    /**
+     * Get last check result
+     */
+    getLastResult(): HealthCheckResult | undefined;
+    /**
+     * Reset health checker state
+     */
+    reset(): void;
+    /**
+     * Mark as healthy (e.g., after successful operation)
+     */
+    markHealthy(): void;
+    /**
+     * Mark as unhealthy (e.g., after failed operation)
+     */
+    markUnhealthy(error?: Error): void;
+}
+/**
+ * Manager for multiple health checkers (one per remote app)
+ */
+export declare class HealthCheckManager {
+    private readonly checkers;
+    private readonly defaultOptions;
+    constructor(defaultOptions?: HealthCheckOptions);
+    /**
+     * Create and start a health checker for an app
+     */
+    addChecker(appId: string, checkFn: () => Promise<void>, options?: HealthCheckOptions): HealthChecker;
+    /**
+     * Remove and stop a health checker
+     */
+    removeChecker(appId: string): void;
+    /**
+     * Get health checker for an app
+     */
+    getChecker(appId: string): HealthChecker | undefined;
+    /**
+     * Get health status for all apps
+     */
+    getAllStatuses(): Map<string, HealthCheckResult | undefined>;
+    /**
+     * Stop all health checkers
+     */
+    stopAll(): void;
+    /**
+     * Dispose and clean up
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=health-check.d.ts.map

package/remote-mcp/resilience/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../../src/remote-mcp/resilience/health-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9F;AAWD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,UAAU,CAAS;gBAEf,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,kBAAuB;IAMzF;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA2EzC;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;OAEG;IACH,aAAa,IAAI,iBAAiB,GAAG,SAAS;IAI9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,WAAW,IAAI,IAAI;IAWnB;;OAEG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;CAYnC;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,cAAc,GAAE,kBAAuB;IAInD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,aAAa;IAcpG;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIpD;;OAEG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAQ5D;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/remote-mcp/resilience/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file index.ts
+ * @description Barrel exports for remote MCP resilience utilities
+ */
+export { withRetry, isTransientError, isConnectionError, isAuthError, type RetryOptions } from './retry';
+export { CircuitBreaker, CircuitBreakerManager, CircuitOpenError, type CircuitState, type CircuitBreakerOptions, } from './circuit-breaker';
+export { HealthChecker, HealthCheckManager, type HealthStatus, type HealthCheckResult, type HealthCheckOptions, } from './health-check';
+//# sourceMappingURL=index.d.ts.map

package/remote-mcp/resilience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remote-mcp/resilience/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzG,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/remote-mcp/resilience/retry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file retry.ts
+ * @description Retry utilities with exponential backoff for resilient remote MCP operations
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts?: number;
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelayMs?: number;
+    /** Maximum delay in milliseconds (default: 30000) */
+    maxDelayMs?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Jitter factor 0-1 to randomize delays (default: 0.1) */
+    jitterFactor?: number;
+    /** Function to determine if error is retryable (default: all errors) */
+    isRetryable?: (error: Error) => boolean;
+    /** Callback on each retry attempt */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+/**
+ * Execute an operation with retry logic and exponential backoff
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Common retryable error detection for MCP operations
+ */
+export declare function isTransientError(error: Error): boolean;
+/**
+ * Check if error is a connection error (requires reconnection)
+ */
+export declare function isConnectionError(error: Error): boolean;
+/**
+ * Check if error is an authentication error
+ */
+export declare function isAuthError(error: Error): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/remote-mcp/resilience/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/remote-mcp/resilience/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACxC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAyCD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAyCtG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAuCtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAWvD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAWjD"}

package/resource/flows/read-resource.flow.d.ts

@@ -87,7 +87,7 @@ declare const stateSchema: z.ZodObject<{
     }, z.core.$loose>>;
 }, z.core.$strip>;
 declare const plan: {
-    readonly pre: ["parseInput", "findResource", "createResourceContext"];
+    readonly pre: ["parseInput", "ensureRemoteCapabilities", "findResource", "createResourceContext"];
     readonly execute: ["execute", "validateOutput"];
     readonly finalize: ["finalize"];
 };
@@ -100,6 +100,12 @@ declare const name: "resources:read-resource";
 export default class ReadResourceFlow extends FlowBase<typeof name> {
     logger: import("../../common").FrontMcpLogger;
     parseInput(): Promise<void>;
+    /**
+     * Ensure remote app capabilities are loaded before looking up resources.
+     * Remote apps use lazy capability discovery - this triggers the loading.
+     * Uses provider registry to find all remote apps across all app registries.
+     */
+    ensureRemoteCapabilities(): Promise<void>;
     findResource(): Promise<void>;
     createResourceContext(): Promise<void>;
     execute(): Promise<void>;
@@ -107,3 +113,4 @@ export default class ReadResourceFlow extends FlowBase<typeof name> {
     finalize(): Promise<void>;
 }
 export {};
+//# sourceMappingURL=read-resource.flow.d.ts.map

package/resource/flows/read-resource.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-resource.flow.d.ts","sourceRoot":"","sources":["../../../src/resource/flows/read-resource.flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,QAAQ,EAAyB,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAY1E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAIf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;iBAA2B,CAAC;AAE9C,QAAA,MAAM,WAAW;;;;cAKiB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;;cAG9B,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;qBAEjB,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYtD,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,yBAAyB,EAAE,cAAc,CACvC,gBAAgB,EAChB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,yBAAkC,CAAC;AAUhD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACjE,MAAM,wCAA8C;IAG9C,UAAU;IA+BhB;;;;OAIG;IAEG,wBAAwB;IA2CxB,YAAY;IA6DZ,qBAAqB;IAkCrB,OAAO;IA4BP,cAAc;IAuBd,QAAQ;CA6Cf"}

package/resource/flows/resource-templates-list.flow.d.ts

@@ -63,7 +63,7 @@ declare const stateSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const plan: {
-    readonly pre: ["parseInput"];
+    readonly pre: ["parseInput", "ensureRemoteCapabilities"];
     readonly execute: ["findTemplates", "resolveConflicts"];
     readonly post: ["parseTemplates"];
 };
@@ -77,8 +77,15 @@ export default class ResourceTemplatesListFlow extends FlowBase<typeof name> {
     logger: import("../../common").FrontMcpLogger;
     private sample;
     parseInput(): Promise<void>;
+    /**
+     * Ensure remote app capabilities are loaded before listing resource templates.
+     * Remote apps use lazy capability discovery - this triggers the loading.
+     * Uses provider registry to find all remote apps across all app registries.
+     */
+    ensureRemoteCapabilities(): Promise<void>;
     findTemplates(): Promise<void>;
     resolveConflicts(): Promise<void>;
     parseTemplates(): Promise<void>;
 }
 export {};
+//# sourceMappingURL=resource-templates-list.flow.d.ts.map

package/resource/flows/resource-templates-list.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-templates-list.flow.d.ts","sourceRoot":"","sources":["../../../src/resource/flows/resource-templates-list.flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,QAAQ,EAAsC,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAGf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAoC,CAAC;AAEvD,QAAA,MAAM,WAAW;;;;;;;;;;;iBAef,CAAC;AAIH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,mCAAmC,EAAE,cAAc,CACjD,yBAAyB,EACzB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,mCAA4C,CAAC;AAU1D,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAC1E,MAAM,wCAAuD;IAE7D,OAAO,CAAC,MAAM;IAKR,UAAU;IAwBhB;;;;OAIG;IAEG,wBAAwB;IA2CxB,aAAa;IA4Bb,gBAAgB;IAqChB,cAAc;CAiDrB"}

package/resource/flows/resources-list.flow.d.ts

@@ -63,7 +63,7 @@ declare const stateSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const plan: {
-    readonly pre: ["parseInput"];
+    readonly pre: ["parseInput", "ensureRemoteCapabilities"];
     readonly execute: ["findResources", "resolveConflicts"];
     readonly post: ["parseResources"];
 };
@@ -77,8 +77,15 @@ export default class ResourcesListFlow extends FlowBase<typeof name> {
     logger: import("../../common").FrontMcpLogger;
     private sample;
     parseInput(): Promise<void>;
+    /**
+     * Ensure remote app capabilities are loaded before listing resources.
+     * Remote apps use lazy capability discovery - this triggers the loading.
+     * Uses provider registry to find all remote apps across all app registries.
+     */
+    ensureRemoteCapabilities(): Promise<void>;
     findResources(): Promise<void>;
     resolveConflicts(): Promise<void>;
     parseResources(): Promise<void>;
 }
 export {};
+//# sourceMappingURL=resources-list.flow.d.ts.map

package/resource/flows/resources-list.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources-list.flow.d.ts","sourceRoot":"","sources":["../../../src/resource/flows/resources-list.flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,QAAQ,EAAsC,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAGf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA4B,CAAC;AAE/C,QAAA,MAAM,WAAW;;;;;;;;;;;iBAef,CAAC;AAIH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,0BAA0B,EAAE,cAAc,CACxC,iBAAiB,EACjB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,0BAAmC,CAAC;AAUjD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAClE,MAAM,wCAA+C;IAErD,OAAO,CAAC,MAAM;IAKR,UAAU;IAwBhB;;;;OAIG;IAEG,wBAAwB;IA2CxB,aAAa;IAsCb,gBAAgB;IAqChB,cAAc;CAqDrB"}

package/resource/flows/subscribe-resource.flow.d.ts

@@ -56,3 +56,4 @@ export default class SubscribeResourceFlow extends FlowBase<typeof name> {
     finalize(): Promise<void>;
 }
 export {};
+//# sourceMappingURL=subscribe-resource.flow.d.ts.map

package/resource/flows/subscribe-resource.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-resource.flow.d.ts","sourceRoot":"","sources":["../../../src/resource/flows/subscribe-resource.flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,QAAQ,EAAyB,cAAc,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAGf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;kBAAoB,CAAC;AAEvC,QAAA,MAAM,WAAW;;;;;;;;;;;;;iBAMf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,qBAAqB,EAAE,cAAc,CACnC,qBAAqB,EACrB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,qBAA8B,CAAC;AAU5C,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACtE,MAAM,wCAAmD;IAGnD,UAAU;IAgCV,gBAAgB;IAkBhB,SAAS;IAiBT,QAAQ;CAMf"}

package/resource/flows/unsubscribe-resource.flow.d.ts

@@ -55,3 +55,4 @@ export default class UnsubscribeResourceFlow extends FlowBase<typeof name> {
     finalize(): Promise<void>;
 }
 export {};
+//# sourceMappingURL=unsubscribe-resource.flow.d.ts.map

package/resource/flows/unsubscribe-resource.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsubscribe-resource.flow.d.ts","sourceRoot":"","sources":["../../../src/resource/flows/unsubscribe-resource.flow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,QAAQ,EAAyB,cAAc,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;iBAGf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;kBAAoB,CAAC;AAEvC,QAAA,MAAM,WAAW;;;;;;;;;;;;;iBAMf,CAAC;AAEH,QAAA,MAAM,IAAI;;;;CAI2B,CAAC;AAEtC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,uBAAuB,EAAE,cAAc,CACrC,uBAAuB,EACvB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,YAAY,EACnB,OAAO,WAAW,CACnB,CAAC;KACH;CACF;AAED,QAAA,MAAM,IAAI,EAAG,uBAAgC,CAAC;AAU9C,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IACxE,MAAM,wCAAqD;IAGrD,UAAU;IAgCV,WAAW;IAmBX,QAAQ;CAMf"}

package/resource/index.d.ts

@@ -6,3 +6,4 @@ export * from './resource.utils';
 export { default as ResourcesListFlow } from './flows/resources-list.flow';
 export { default as ResourceTemplatesListFlow } from './flows/resource-templates-list.flow';
 export { default as ReadResourceFlow } from './flows/read-resource.flow';
+//# sourceMappingURL=index.d.ts.map

package/resource/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resource/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/resource/resource.events.d.ts

@@ -1,4 +1,4 @@
-import { ResourceInstance } from './resource.instance';
+import { ResourceEntry } from '../common';
 export type ResourceChangeKind = 'added' | 'updated' | 'removed' | 'reset';
 /**
  * The scope of a change event.
@@ -13,7 +13,7 @@ export type ResourceChangeEvent = {
     sessionId?: string;
     relatedRequestId?: string;
     version: number;
-    snapshot: readonly ResourceInstance[];
+    snapshot: readonly ResourceEntry[];
 };
 type Listener = (e: ResourceChangeEvent) => void;
 export declare class ResourceEmitter {
@@ -22,3 +22,4 @@ export declare class ResourceEmitter {
     emit(e: ResourceChangeEvent): void;
 }
 export {};
+//# sourceMappingURL=resource.events.d.ts.map

package/resource/resource.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.events.d.ts","sourceRoot":"","sources":["../../src/resource/resource.events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,kBAAkB,CAAC;IACzB,oEAAoE;IACpE,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC,CAAC;AAEF,KAAK,QAAQ,GAAG,CAAC,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAEjD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAuB;IAExC,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,IAAI;IAK3B,IAAI,CAAC,CAAC,EAAE,mBAAmB;CAG5B"}

package/resource/resource.instance.d.ts

@@ -33,3 +33,4 @@ export declare class ResourceInstance<Params extends Record<string, string> = Re
      */
     safeParseOutput(raw: Out): ResourceSafeTransformResult<ParsedResourceResult>;
 }
+//# sourceMappingURL=resource.instance.d.ts.map

package/resource/resource.instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.instance.d.ts","sourceRoot":"","sources":["../../src/resource/resource.instance.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,cAAc,EAEd,eAAe,EAEf,gBAAgB,EAChB,wBAAwB,EAExB,sBAAsB,EAEvB,MAAM,WAAW,CAAC;AACnB,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,YAAY,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMjC,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9D,GAAG,GAAG,OAAO,CACb,SAAQ,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAE7B,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAAC,CAA4C;gBAErD,MAAM,EAAE,cAAc,GAAG,sBAAsB,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa;cAyB9F,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3C,WAAW,IAAI,gBAAgB,GAAG,wBAAwB;IAI1D;;;;OAIG;IACM,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAgBpE;;OAEG;IACM,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC;IAkClG;;OAEG;IACM,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,oBAAoB;IA8BpD;;OAEG;IACM,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,2BAA2B,CAAC,oBAAoB,CAAC;CAOtF"}

package/resource/resource.registry.d.ts

@@ -33,6 +33,17 @@ ResourceRecord | ResourceTemplateRecord, ResourceType[]> implements ResourceRegi
      * We *reference* the child's resource instances; no duplicates are created.
      */
     adoptFromChild(child: ResourceRegistry, _childOwner: EntryOwnerRef): void;
+    /**
+     * Adopt resources directly from a remote app's resources registry.
+     * Remote apps expose resources via proxy entries that forward execution to the remote server.
+     * This also subscribes to updates from the remote app's registry for lazy-loaded resources.
+     */
+    private adoptResourcesFromRemoteApp;
+    /**
+     * Adopt resources from a local app's child ResourceRegistry instances.
+     * Local apps use the hierarchical registry pattern for resource discovery.
+     */
+    private adoptResourcesFromLocalApp;
     /**
      * Get all static resources (not templates)
      */
@@ -48,40 +59,40 @@ ResourceRecord | ResourceTemplateRecord, ResourceType[]> implements ResourceRegi
     /**
      * Find a resource by exact URI match
      */
-    findByUri(uri: string): ResourceInstance | undefined;
+    findByUri(uri: string): ResourceEntry | undefined;
     /**
      * Match a URI against template resources and extract parameters
      */
     matchTemplateByUri(uri: string): {
-        instance: ResourceInstance;
+        instance: ResourceEntry;
         params: Record<string, string>;
     } | undefined;
     /**
      * Find a resource by URI - tries exact match first, then template matching
      */
     findResourceForUri(uri: string): {
-        instance: ResourceInstance;
+        instance: ResourceEntry;
         params: Record<string, string>;
     } | undefined;
     /** Internal snapshot of effective indexed rows (locals + adopted). */
     listAllIndexed(): IndexedResource[];
     /** List all instances (locals + adopted). */
-    listAllInstances(): readonly ResourceInstance[];
+    listAllInstances(): readonly ResourceEntry[];
     /** List instances by owner path (e.g. "app:Portal/plugin:Okta") */
-    listByOwner(ownerPath: string): readonly ResourceInstance[];
+    listByOwner(ownerPath: string): readonly ResourceEntry[];
     private reindex;
     /**
      * Produce unique, MCP-valid exported names.
      */
     exportResolvedNames(opts?: ResourceExportOptions): Array<{
         name: string;
-        instance: ResourceInstance;
+        instance: ResourceEntry;
     }>;
     /** Lookup by the exported (resolved) name. */
-    getExported(name: string, opts?: ResourceExportOptions): ResourceInstance | undefined;
+    getExported(name: string, opts?: ResourceExportOptions): ResourceEntry | undefined;
     subscribe(opts: {
         immediate?: boolean;
-        filter?: (i: ResourceInstance) => boolean;
+        filter?: (i: ResourceEntry) => boolean;
     }, cb: (evt: ResourceChangeEvent) => void): () => void;
     private bump;
     /** Build an IndexedResource row */
@@ -97,6 +108,19 @@ ResourceRecord | ResourceTemplateRecord, ResourceType[]> implements ResourceRegi
      * These are reported to clients during initialization.
      */
     getCapabilities(): Partial<ServerCapabilities>;
+    /**
+     * Register an existing ResourceEntry instance directly (for remote resources).
+     * This allows pre-constructed resource instances to be added without going through
+     * the standard token-based initialization flow.
+     *
+     * **IMPORTANT: Scope Binding**
+     * The ResourceEntry captures its scope and providers at construction time.
+     * The resource will use the scope from its original `providers` argument, NOT this registry's scope.
+     *
+     * @param resource - The resource instance to register (ResourceInstance or RemoteResourceInstance)
+     * @throws Error if resource is not a valid instance
+     */
+    registerResourceInstance(resource: ResourceEntry): void;
     /**
      * Dynamically register a resource or resource template at runtime.
      *
@@ -107,3 +131,4 @@ ResourceRecord | ResourceTemplateRecord, ResourceType[]> implements ResourceRegi
      */
     registerDynamicResource(resourceDef: ResourceType): void;
 }
+//# sourceMappingURL=resource.registry.d.ts.map

package/resource/resource.registry.d.ts.map

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

package/resource/resource.types.d.ts

@@ -1,7 +1,6 @@
-import { EntryLineage, Token, Type, FuncType } from '../common';
-import { ResourceInstance } from './resource.instance';
+import { EntryLineage, Token, Type, FuncType, ResourceEntry } from '../common';
 import ResourceRegistry from './resource.registry';
-import type { NameCase } from '../utils/naming.utils';
+import type { NameCase } from '@frontmcp/utils';
 export interface ResourceTemplateInterface<In = any, Out = any> {
     execute(uri: string, params: Record<string, string>, context: any): Promise<Out>;
 }
@@ -9,7 +8,8 @@ export type ResourceTemplateType<In = any, Out = any> = Type<ResourceTemplateInt
 /** Internal augmented row: instance + provenance + token */
 export type IndexedResource = {
     token: Token;
-    instance: ResourceInstance;
+    /** Resource entry (ResourceInstance for local, proxy ResourceEntry for remote) */
+    instance: ResourceEntry;
     /** base resource name from metadata (unmodified) */
     baseName: string;
     /** URI for static resources */
@@ -33,3 +33,4 @@ export type ResourceExportOptions = {
     prefixSource?: 'provider' | 'owner';
 };
 export declare const DEFAULT_RESOURCE_EXPORT_OPTS: Required<ResourceExportOptions>;
+//# sourceMappingURL=resource.types.d.ts.map

package/resource/resource.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.types.d.ts","sourceRoot":"","sources":["../../src/resource/resource.types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/E,OAAO,gBAAgB,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAMhD,MAAM,WAAW,yBAAyB,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG;IAC5D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAClF;AAED,MAAM,MAAM,oBAAoB,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,IAChD,IAAI,CAAC,yBAAyB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GACxC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAMjD,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,kFAAkF;IAClF,QAAQ,EAAE,aAAa,CAAC;IACxB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAMF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;CACrC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,qBAAqB,CAKxE,CAAC"}

package/resource/resource.utils.d.ts

@@ -1,9 +1,6 @@
-import { ResourceMetadata, ResourceTemplateMetadata, ResourceType, Token, ResourceRecord, ResourceTemplateRecord } from '../common';
+import { Token } from '@frontmcp/di';
+import { ResourceMetadata, ResourceTemplateMetadata, ResourceType, ResourceRecord, ResourceTemplateRecord } from '../common';
 import { ResourceTemplateType } from './resource.types';
-export { splitWords, toCase, sepFor, normalizeSegment, normalizeProviderId, normalizeOwnerPath, shortHash, ensureMaxLen, } from '../utils/naming.utils';
-export { ownerKeyOf, qualifiedNameOf } from '../utils/lineage.utils';
-export { parseUriTemplate, matchUriTemplate, expandUriTemplate, extractTemplateParams, isUriTemplate, } from '../utils/uri-template.utils';
-export { buildResourceContent as buildParsedResourceResult } from '../utils/content.utils';
 /**
  * Collect metadata from a class decorated with @FrontMcpResource
  */
@@ -28,3 +25,4 @@ export declare function isResourceTemplate(item: any): boolean;
  * Get dependency tokens for graph/cycle detection
  */
 export declare function resourceDiscoveryDeps(rec: ResourceRecord | ResourceTemplateRecord): Token[];
+//# sourceMappingURL=resource.utils.d.ts.map

package/resource/resource.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.utils.d.ts","sourceRoot":"","sources":["../../src/resource/resource.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAuD,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EAKxB,YAAY,EACZ,cAAc,EAEd,sBAAsB,EAGvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAY3E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,oBAAoB,GAAG,wBAAwB,CAYnG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,cAAc,CAuB3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,GAAG,GAAG,sBAAsB,CAuB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAiBrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,sBAAsB,GAAG,KAAK,EAAE,CAS3F"}

package/scope/flows/http.request.flow.d.ts

@@ -100,3 +100,4 @@ export default class HttpRequestFlow extends FlowBase<typeof name> {
     private logError;
 }
 export {};
+//# sourceMappingURL=http.request.flow.d.ts.map

package/scope/flows/http.request.flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.request.flow.d.ts","sourceRoot":"","sources":["../../../src/scope/flows/http.request.flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,QAAQ,EACR,UAAU,EAEV,aAAa,EASd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,IAAI;;;;;CA8B2B,CAAC;AAEtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC;AAEH,QAAA,MAAM,IAAI,EAAG,cAAuB,CAAC;AAGrC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW;QACnB,cAAc,EAAE,cAAc,CAC5B,eAAe,EACf,OAAO,IAAI,EACX,OAAO,eAAe,EACtB,OAAO,gBAAgB,EACvB,OAAO,sBAAsB,CAC9B,CAAC;KACH;CACF;AAYD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,QAAQ,CAAC,OAAO,IAAI,CAAC;IAChE,MAAM,wCAA8C;IACpD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,SAAS,CAAM;IAEvB,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU;IActD,YAAY;IAkDZ,kBAAkB;IA8ClB,MAAM;IAuHN,eAAe;IAuBf,SAAS;IAuBT,oBAAoB;IAuBpB,kBAAkB;IAuBlB,mBAAmB;IAuBnB,mBAAmB;IAsCnB,QAAQ;IAcd;;;OAGG;IACH,OAAO,CAAC,QAAQ;CA8CjB"}

package/scope/index.d.ts

@@ -1 +1,2 @@
 export { Scope } from './scope.instance';
+//# sourceMappingURL=index.d.ts.map

package/scope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAA"}

package/scope/scope.instance.d.ts

@@ -7,8 +7,10 @@ import { TransportService } from '../transport/transport.registry';
 import ToolRegistry from '../tool/tool.registry';
 import ResourceRegistry from '../resource/resource.registry';
 import PromptRegistry from '../prompt/prompt.registry';
+import AgentRegistry from '../agent/agent.registry';
 import { NotificationService } from '../notification';
 import { ToolUIRegistry } from '../tool/ui';
+import PluginRegistry from '../plugin/plugin.registry';
 export declare class Scope extends ScopeEntry {
     readonly id: string;
     private readonly globalProviders;
@@ -21,6 +23,8 @@ export declare class Scope extends ScopeEntry {
     private scopeTools;
     private scopeResources;
     private scopePrompts;
+    private scopeAgents;
+    private scopePlugins?;
     transportService: TransportService;
     notificationService: NotificationService;
     private toolUIRegistry;
@@ -40,8 +44,11 @@ export declare class Scope extends ScopeEntry {
     get toolUI(): ToolUIRegistry;
     get resources(): ResourceRegistry;
     get prompts(): PromptRegistry;
+    get agents(): AgentRegistry;
+    get plugins(): PluginRegistry | undefined;
     get notifications(): NotificationService;
     registryFlows(...flows: FlowType[]): Promise<void>;
     runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
     runFlowForOutput<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name>>;
 }
+//# sourceMappingURL=scope.instance.d.ts.map

package/scope/scope.instance.d.ts.map

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

package/scope/scope.registry.d.ts

@@ -7,4 +7,10 @@ export declare class ScopeRegistry extends RegistryAbstract<ScopeEntry, ScopeRec
     protected buildMap(metadata: FrontMcpConfigType): RegistryBuildMapResult<ScopeRecord>;
     protected buildGraph(): void;
     protected initialize(): Promise<void>;
+    /**
+     * Get all initialized scope instances.
+     * Useful for graph visualization and introspection.
+     */
+    getScopes(): ScopeEntry[];
 }
+//# sourceMappingURL=scope.registry.d.ts.map

package/scope/scope.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.registry.d.ts","sourceRoot":"","sources":["../../src/scope/scope.registry.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAW,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAa,MAAM,WAAW,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAM7D,qBAAa,aAAc,SAAQ,gBAAgB,CAAC,UAAU,EAAE,WAAW,EAAE,kBAAkB,CAAC;gBAClF,eAAe,EAAE,gBAAgB;cAK1B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,sBAAsB,CAAC,WAAW,CAAC;cAmD3E,UAAU;cAcb,UAAU;IAqB1B;;;OAGG;IACH,SAAS,IAAI,UAAU,EAAE;CAG1B"}

package/scope/scope.utils.d.ts

@@ -1,4 +1,5 @@
-import { AppType, FrontMcpMultiAppConfig, FrontMcpSplitByAppConfig, Token, ScopeRecord } from '../common';
+import { Token } from '@frontmcp/di';
+import { AppType, FrontMcpMultiAppConfig, FrontMcpSplitByAppConfig, ScopeRecord } from '../common';
 /**
  * Normalize a raw scope metadata list into useful maps/sets.
  * - tokens: all provided tokens
@@ -11,3 +12,4 @@ export declare function normalizeMultiAppScope(includedApps: AppType[], metadata
  * For graph/cycle detection. Returns dependency tokens that should be graphed.
  */
 export declare function scopeDiscoveryDeps(rec: ScopeRecord): Token[];
+//# sourceMappingURL=scope.utils.d.ts.map

package/scope/scope.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.utils.d.ts","sourceRoot":"","sources":["../../src/scope/scope.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,cAAc,CAAC;AAClD,OAAO,EAEL,OAAO,EACP,sBAAsB,EACtB,wBAAwB,EAExB,WAAW,EAEZ,MAAM,WAAW,CAAC;AAInB;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,sBAAsB,GAAG,wBAAwB,GAC1D,WAAW,CAuBb;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,sBAAsB,GAAG,WAAW,CAU7G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,EAAE,CAO5D"}

package/server/adapters/base.host.adapter.d.ts

@@ -14,3 +14,4 @@ export declare abstract class HostServerAdapter extends FrontMcpServer {
      */
     abstract start(port: number): Promise<void> | void;
 }
+//# sourceMappingURL=base.host.adapter.d.ts.map

package/server/adapters/base.host.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.host.adapter.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/base.host.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,8BAAsB,iBAAkB,SAAQ,cAAc;IAC5D;;;OAGG;aACe,OAAO,IAAI,IAAI;IAEjC;;OAEG;aACe,UAAU,IAAI,OAAO;IAEvC;;OAEG;aACe,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAC5D"}

package/server/adapters/express.host.adapter.d.ts

@@ -22,3 +22,4 @@ export declare class ExpressHostAdapter extends HostServerAdapter {
     getHandler(): express.Application;
     start(port: number): void;
 }
+//# sourceMappingURL=express.host.adapter.d.ts.map

package/server/adapters/express.host.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.host.adapter.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/express.host.adapter.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAiB,oBAAoB,EAAkB,MAAM,cAAc,CAAC;AAE/F,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAS;;IAgBzB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAI7E,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAInE,eAAe,CAAC,OAAO,EAAE,oBAAoB,IACnC,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,YAAY;IAQjF;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAMf;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,WAAW;IAKjC,KAAK,CAAC,IAAI,EAAE,MAAM;CAQnB"}

package/server/server.instance.d.ts

@@ -13,3 +13,4 @@ export declare class FrontMcpServerInstance extends FrontMcpServer {
     getHandler(): unknown;
     start(): void;
 }
+//# sourceMappingURL=server.instance.d.ts.map

package/server/server.instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.instance.d.ts","sourceRoot":"","sources":["../../src/server/server.instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,qBAAqB,CAAS;gBAE1B,UAAU,EAAE,UAAU;IAMlC,OAAO,CAAC,aAAa;IAWrB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAInE,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAIpE,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB;IAI7E,OAAO;IAUP,UAAU,IAAI,OAAO;IAIrB,KAAK;CAIN"}

package/server/server.types.d.ts

@@ -22,3 +22,4 @@ declare module '@modelcontextprotocol/sdk/server/auth/types.js' {
         transport: LocalTransportAdapter<StreamableHTTPServerTransport | SSEServerTransport>;
     }
 }
+//# sourceMappingURL=server.types.d.ts.map

package/server/server.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.types.d.ts","sourceRoot":"","sources":["../../src/server/server.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,gDAAgD,CAAC;AACxE,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,qBAAqB,EAAC,MAAM,+CAA+C,CAAC;AACpF,OAAO,EAAC,6BAA6B,EAAC,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAC,kBAAkB,EAAC,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAC,KAAK,EAAC,MAAM,UAAU,CAAC;AAE/B,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,aAAa,CAAC;CAC5B;AAED,OAAO,QAAQ,gDAAgD,CAAC;IAC9D,UAAiB,QAAQ;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,SAAS,EAAE,qBAAqB,CAAC,6BAA6B,GAAG,kBAAkB,CAAC,CAAC;KACtF;CACF"}