@omgbase/sync 0.5.8 → 0.5.12

package/dist/src/mcp-engine-client.d.ts

@@ -4,7 +4,19 @@ import type { EngineClient, ChangesPage, DocBytes } from "./engine-client.js";
 /** Wraps a connected MCP SDK Client, calling the engine's sync tools. */
 export declare class McpEngineClient implements EngineClient {
     private readonly client;
+    private tools;
     constructor(client: Client);
+    /**
+     * The tool names the server lists (`tools/list`), fetched once per
+     * connection — `connectEngine` does it on connect, so a caller may ask
+     * `hasTool` synchronously afterwards. A server may serve a catalog PROFILE
+     * (spec/surface §4 "Profiles", 4.3: `omg mcp --tools minimal` lists ten
+     * tools); the CLI's `--server` verbs ask before calling a sugar tool and fall
+     * back to `apply { effects }` when it is not listed (spec/cli §2.3, 4.2).
+     */
+    listTools(): Promise<ReadonlySet<string>>;
+    /** Whether the server lists `name` — after `listTools()` ran (it has, for a client `connectEngine` returned); `true` while unknown, so a never-listed client behaves as before. */
+    hasTool(name: string): boolean;
     /** Call any MCP tool and return its parsed JSON result. Throws on a tool
      *  error (the message carries the engine error code) or non-JSON output. The
      *  general-purpose call the CLI's `--server` mode uses for arbitrary tools. */

package/dist/src/mcp-engine-client.js

@@ -6,9 +6,29 @@ import { VERSION } from "@omgbase/core";
 /** Wraps a connected MCP SDK Client, calling the engine's sync tools. */
 export class McpEngineClient {
     client;
+    tools = null;
     constructor(client) {
         this.client = client;
     }
+    /**
+     * The tool names the server lists (`tools/list`), fetched once per
+     * connection — `connectEngine` does it on connect, so a caller may ask
+     * `hasTool` synchronously afterwards. A server may serve a catalog PROFILE
+     * (spec/surface §4 "Profiles", 4.3: `omg mcp --tools minimal` lists ten
+     * tools); the CLI's `--server` verbs ask before calling a sugar tool and fall
+     * back to `apply { effects }` when it is not listed (spec/cli §2.3, 4.2).
+     */
+    async listTools() {
+        if (this.tools)
+            return this.tools;
+        const res = await this.client.listTools();
+        this.tools = new Set(res.tools.map((t) => t.name));
+        return this.tools;
+    }
+    /** Whether the server lists `name` — after `listTools()` ran (it has, for a client `connectEngine` returned); `true` while unknown, so a never-listed client behaves as before. */
+    hasTool(name) {
+        return this.tools === null ? true : this.tools.has(name);
+    }
     /** Call any MCP tool and return its parsed JSON result. Throws on a tool
      *  error (the message carries the engine error code) or non-JSON output. The
      *  general-purpose call the CLI's `--server` mode uses for arbitrary tools. */
@@ -74,7 +94,12 @@ export async function connectStdioEngine(spec) {
         ...(spec.env ? { env: spec.env } : {}),
     });
     await client.connect(transport);
-    return new McpEngineClient(client);
+    return listed(new McpEngineClient(client));
+}
+/** The one `tools/list` of a connection (see `McpEngineClient.listTools`), so `hasTool` answers synchronously. */
+async function listed(engine) {
+    await engine.listTools();
+    return engine;
 }
 /** Connect to an omgbase MCP server over Streamable HTTP at `url`. The full URL
  *  (including any base path) is used verbatim, so a secret-prefixed endpoint
@@ -90,7 +115,7 @@ export async function connectHttpEngine(spec) {
         ...(spec.headers && Object.keys(spec.headers).length > 0 ? { requestInit: { headers: spec.headers } } : {}),
     });
     await client.connect(transport);
-    return new McpEngineClient(client);
+    return listed(new McpEngineClient(client));
 }
 const HTTP_URL_RE = /^https?:\/\//i;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omgbase/sync",
-  "version": "0.5.8",
+  "version": "0.5.12",
   "description": "Open Markdown Graph Base — standalone store-to-store synchronizer: a coordinator over an EngineClient seam (in-process or MCP-client) and source adapters",
   "license": "MIT",
   "repository": {
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@omgbase/core": "^0.15.0",
+    "@omgbase/core": "^0.19.0",
     "@omgbase/fs-adapter": "^0.2.0"
   },
   "scripts": {