foundryvtt-mcp 0.11.0

package/dist/foundry/client.d.ts

@@ -0,0 +1,95 @@
+/**
+ * FoundryVTT client for API communication via Socket.IO
+ *
+ * Connects to FoundryVTT using the proven 4-step authentication flow,
+ * caches worldData in memory, and serves all queries from the snapshot.
+ */
+import { type AxiosRequestConfig, type AxiosResponse } from 'axios';
+import type { ActorSearchResult, DiceRoll, FoundryActor, FoundryScene, FoundryWorld, ItemSearchResult, WorldActor, WorldCombat, WorldData, WorldItem, WorldJournal, WorldMessage, WorldScene, WorldUser } from './types.js';
+export interface FoundryClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+    username?: string;
+    password?: string;
+    userId?: string;
+    timeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    socketPath?: string;
+}
+export interface SearchActorsParams {
+    query?: string;
+    type?: string;
+    limit?: number;
+}
+export interface SearchItemsParams {
+    query?: string;
+    type?: string;
+    rarity?: string;
+    limit?: number;
+}
+export declare class FoundryClient {
+    private http;
+    private socket;
+    private config;
+    private _isConnected;
+    private worldData;
+    constructor(config: FoundryClientConfig);
+    /**
+     * Connects to FoundryVTT.
+     * REST API mode: tests /api/status endpoint.
+     * Socket.IO mode: authenticates and loads full worldData.
+     */
+    connect(): Promise<void>;
+    /**
+     * Connects Socket.IO with an authenticated session and loads worldData.
+     */
+    private connectAndLoadWorld;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    /**
+     * Returns true if worldData is available (Socket.IO mode connected).
+     */
+    hasWorldData(): boolean;
+    /**
+     * Re-emits 'world' on the existing socket to refresh the cached snapshot.
+     */
+    refreshWorldData(): Promise<void>;
+    getWorldData(): WorldData | null;
+    searchActors(params: SearchActorsParams): Promise<ActorSearchResult>;
+    getActor(actorId: string): Promise<FoundryActor>;
+    /**
+     * Returns the raw WorldActor with the full system data (game-system specific).
+     */
+    getRawActor(actorId: string): WorldActor | undefined;
+    searchItems(params: SearchItemsParams): Promise<ItemSearchResult>;
+    getCurrentScene(sceneId?: string): Promise<FoundryScene>;
+    getScene(sceneId: string): Promise<FoundryScene>;
+    getScenes(): WorldScene[];
+    getWorldInfo(): Promise<FoundryWorld>;
+    getCombatState(): WorldCombat | null;
+    getChatMessages(limit?: number): WorldMessage[];
+    getUsers(): {
+        users: WorldUser[];
+        activeUsers: string[];
+    };
+    getJournals(): WorldJournal[];
+    searchJournals(query: string): WorldJournal[];
+    getJournal(journalId: string): WorldJournal | undefined;
+    searchWorld(query: string): {
+        actors: WorldActor[];
+        items: WorldItem[];
+        scenes: WorldScene[];
+        journals: WorldJournal[];
+    };
+    getWorldSummary(): Record<string, number>;
+    rollDice(formula: string, reason?: string): Promise<DiceRoll>;
+    private fallbackDiceRoll;
+    testConnection(): Promise<boolean>;
+    private executeWithRetry;
+    get<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    post<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    put<T = unknown>(url: string, data?: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    delete<T = unknown>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/foundry/client.d.ts.map

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