@alaarab/ogrid-mcp 2.16.0 → 2.17.0

package/dist/esm/bridge-client.d.ts

@@ -25,18 +25,18 @@
  *
  * This module contains NO Node.js-specific imports  -  safe to bundle in browsers.
  */
-interface BridgeColumnInfo {
+export interface BridgeColumnInfo {
     columnId: string;
     headerName?: string;
     type?: string;
 }
-interface BridgeCommand {
+export interface BridgeCommand {
     id: string;
     type: 'update_cell' | 'set_filter' | 'clear_filters' | 'set_sort' | 'go_to_page';
     payload: Record<string, unknown>;
 }
 /** Minimal subset of IOGridApi used by the bridge. */
-interface BridgeGridApi {
+export interface BridgeGridApi {
     updateSort?: (model: Array<{
         columnId: string;
         direction: 'asc' | 'desc';
@@ -46,7 +46,7 @@ interface BridgeGridApi {
     goToPage?: (page: number) => void;
     getSelectedRows?: () => unknown[];
 }
-interface ConnectGridOptions {
+export interface ConnectGridOptions {
     /** Unique identifier for this grid instance (shown in list_grids). */
     gridId: string;
     /** Returns the currently displayed rows. Called on every state push. */
@@ -76,12 +76,10 @@ interface ConnectGridOptions {
     /** How often to push state and poll commands (ms, default: 500). */
     pollIntervalMs?: number;
 }
-interface BridgeConnection {
+export interface BridgeConnection {
     /** Stop polling and disconnect. */
     disconnect: () => void;
     /** Manually push current state immediately. */
     push: () => Promise<void>;
 }
-declare function connectGridToBridge(options: ConnectGridOptions): BridgeConnection;
-
-export { type BridgeColumnInfo, type BridgeCommand, type BridgeConnection, type BridgeGridApi, type ConnectGridOptions, connectGridToBridge };
+export declare function connectGridToBridge(options: ConnectGridOptions): BridgeConnection;

package/dist/esm/bridge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * OGrid Live Testing Bridge
+ *
+ * An HTTP server (default port 7890) that running OGrid instances connect to.
+ * The MCP server holds a BridgeStore in-process and queries it directly when
+ * tools like list_grids / get_grid_state / send_grid_command are invoked.
+ *
+ * Protocol (used by bridge-client.ts in the browser):
+ *   POST   /grids/connect                -  register / heartbeat
+ *   PUT    /grids/:id/state              -  push current grid state
+ *   GET    /grids/:id/commands           -  poll for pending commands
+ *   POST   /grids/:id/commands/:cmdId/result   -  post command result
+ *
+ * Internal (used by MCP tools via BridgeStore directly):
+ *   bridgeStore.listGrids()
+ *   bridgeStore.getState(gridId)
+ *   bridgeStore.enqueueCommand(gridId, cmd)
+ *   bridgeStore.waitForResult(cmdId, timeoutMs)
+ */
+export interface GridColumnInfo {
+    columnId: string;
+    headerName?: string;
+    type?: string;
+}
+export interface GridStateSnapshot {
+    gridId: string;
+    connectedAt: number;
+    lastSeen: number;
+    rowCount: number;
+    totalCount: number;
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    data: unknown[];
+    columns: GridColumnInfo[];
+    sortModel: Array<{
+        columnId: string;
+        direction: 'asc' | 'desc';
+    }>;
+    filterModel: Record<string, unknown>;
+    selectedRowIndices: number[];
+}
+export type GridCommandType = 'update_cell' | 'set_filter' | 'clear_filters' | 'set_sort' | 'go_to_page';
+export interface GridCommand {
+    id: string;
+    type: GridCommandType;
+    payload: Record<string, unknown>;
+    createdAt: number;
+    status: 'pending' | 'completed' | 'error';
+    result?: unknown;
+    error?: string;
+}
+export declare class BridgeStore {
+    private readonly grids;
+    private readonly commandQueues;
+    private readonly commandResults;
+    private cmdSeq;
+    upsertGrid(gridId: string, partial: Partial<GridStateSnapshot>): void;
+    popPendingCommands(gridId: string): GridCommand[];
+    resolveCommand(cmdId: string, result: unknown, error?: string): void;
+    listGrids(): GridStateSnapshot[];
+    getState(gridId: string): GridStateSnapshot | undefined;
+    enqueueCommand(gridId: string, type: GridCommandType, payload: Record<string, unknown>): GridCommand | null;
+    waitForResult(cmdId: string, timeoutMs?: number): Promise<GridCommand>;
+}
+export declare function startBridgeServer(store: BridgeStore, port?: number): Promise<() => Promise<void>>;

package/dist/esm/docsLoader.d.ts

@@ -0,0 +1,24 @@
+export interface CodeBlock {
+    language: string;
+    code: string;
+    framework?: string;
+}
+export interface DocEntry {
+    path: string;
+    title: string;
+    description: string;
+    category: string;
+    content: string;
+    codeBlocks: CodeBlock[];
+}
+export interface DocsIndex {
+    entries: DocEntry[];
+    search(query: string, limit?: number): DocEntry[];
+    getByPath(path: string): DocEntry | undefined;
+    getByCategory(category: string): DocEntry[];
+    getCodeExamples(query: string, framework?: string): Array<{
+        entry: DocEntry;
+        block: CodeBlock;
+    }>;
+}
+export declare function loadDocsIndex(docsDir: string): DocsIndex;

package/dist/esm/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DocsIndex } from './docsLoader.js';
+import type { BridgeStore } from './bridge.js';
+export declare function createOGridMcpServer(index: DocsIndex, bridge?: BridgeStore): McpServer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-mcp",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "MCP server for OGrid documentation",
   "type": "module",
   "repository": {
@@ -28,18 +28,18 @@
   ],
   "scripts": {
     "prebuild": "node scripts/bundle-docs.mjs",
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly --outDir dist/esm",
     "dev": "tsup --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "bun test --preload ../../bun-test.setup.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "zod": "^4.4.3"
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2"
   },
   "engines": {
     "node": ">=18"