mcp-creatio 0.4.1 → 0.5.0

package/dist/server/mcp/dataforge/dataforge-tool-preparer.d.ts

@@ -0,0 +1,17 @@
+import { ToolPreparer, ToolRegistrar } from '../tool-preparer';
+import { DataForgeClient } from './dataforge-client';
+/** Stable capability key; also used by the Server to gate describe-entity routing. */
+export declare const DATAFORGE_CAPABILITY = "dataforge";
+/**
+ * Registers the DataForge MCP tools, but only when DataForge is enabled on the
+ * environment. Encapsulates everything DataForge-specific so the Server remains
+ * agnostic of how the capability is probed or wired.
+ */
+export declare class DataForgeToolPreparer implements ToolPreparer {
+    readonly name = "dataforge";
+    private readonly _client;
+    constructor(client: DataForgeClient);
+    prepare(registrar: ToolRegistrar): Promise<boolean>;
+    private _registerTools;
+}
+//# sourceMappingURL=dataforge-tool-preparer.d.ts.map

package/dist/server/mcp/dataforge/dataforge-tool-preparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataforge-tool-preparer.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp/dataforge/dataforge-tool-preparer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAc/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,SAAgB,IAAI,eAAwB;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,MAAM,EAAE,eAAe;IAItB,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE,OAAO,CAAC,cAAc;CA2CtB"}

package/dist/server/mcp/dataforge/dataforge-tool-preparer.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataForgeToolPreparer = exports.DATAFORGE_CAPABILITY = void 0;
+const utils_1 = require("../../../utils");
+const tools_data_1 = require("../tools-data");
+/** Stable capability key; also used by the Server to gate describe-entity routing. */
+exports.DATAFORGE_CAPABILITY = 'dataforge';
+/**
+ * Registers the DataForge MCP tools, but only when DataForge is enabled on the
+ * environment. Encapsulates everything DataForge-specific so the Server remains
+ * agnostic of how the capability is probed or wired.
+ */
+class DataForgeToolPreparer {
+    name = exports.DATAFORGE_CAPABILITY;
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+    async prepare(registrar) {
+        const enabled = await this._client.isEnabled();
+        if (!enabled) {
+            return false;
+        }
+        this._registerTools(registrar);
+        return true;
+    }
+    _registerTools(registrar) {
+        registrar.register('dataforge-similar-tables', tools_data_1.dataforgeSimilarTablesDescriptor, (0, utils_1.withValidation)(tools_data_1.dataforgeSimilarTablesInput, ({ query, limit }) => this._client.getSimilarTableNames({ query, limit })));
+        registrar.register('dataforge-table-details', tools_data_1.dataforgeTableDetailsDescriptor, (0, utils_1.withValidation)(tools_data_1.dataforgeTableDetailsInput, ({ query, limit }) => this._client.getTableDetails({ query, limit })));
+        registrar.register('dataforge-table-relationships', tools_data_1.dataforgeTableRelationshipsDescriptor, (0, utils_1.withValidation)(tools_data_1.dataforgeTableRelationshipsInput, ({ sourceTable, targetTable, limit, bidirectional, skipDetails }) => this._client.getTableRelationships({
+            sourceTable,
+            targetTable,
+            limit,
+            bidirectional,
+            skipDetails,
+        })));
+        registrar.register('dataforge-lookup-values', tools_data_1.dataforgeLookupValuesDescriptor, (0, utils_1.withValidation)(tools_data_1.dataforgeLookupValuesInput, ({ query, schemaName, limit }) => this._client.getLookupValues({ query, schemaName, limit })));
+        registrar.register('dataforge-status', tools_data_1.dataforgeStatusDescriptor, (0, utils_1.withValidation)(tools_data_1.dataforgeStatusInput, () => this._client.getServiceStatus()));
+    }
+}
+exports.DataForgeToolPreparer = DataForgeToolPreparer;
+//# sourceMappingURL=dataforge-tool-preparer.js.map

package/dist/server/mcp/dataforge/dataforge-tool-preparer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataforge-tool-preparer.js","sourceRoot":"","sources":["../../../../src/server/mcp/dataforge/dataforge-tool-preparer.ts"],"names":[],"mappings":";;;AAAA,0CAAgD;AAEhD,8CAWuB;AAIvB,sFAAsF;AACzE,QAAA,oBAAoB,GAAG,WAAW,CAAC;AAEhD;;;;GAIG;AACH,MAAa,qBAAqB;IACjB,IAAI,GAAG,4BAAoB,CAAC;IAE3B,OAAO,CAAkB;IAE1C,YAAY,MAAuB;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,SAAwB;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,cAAc,CAAC,SAAwB;QAC9C,SAAS,CAAC,QAAQ,CACjB,0BAA0B,EAC1B,6CAAgC,EAChC,IAAA,sBAAc,EAAC,wCAA2B,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAChE,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CACnD,CACD,CAAC;QACF,SAAS,CAAC,QAAQ,CACjB,yBAAyB,EACzB,4CAA+B,EAC/B,IAAA,sBAAc,EAAC,uCAA0B,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAC/D,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAC9C,CACD,CAAC;QACF,SAAS,CAAC,QAAQ,CACjB,+BAA+B,EAC/B,kDAAqC,EACrC,IAAA,sBAAc,EACb,6CAAgC,EAChC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,EAAE,CACnE,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC;YAClC,WAAW;YACX,WAAW;YACX,KAAK;YACL,aAAa;YACb,WAAW;SACX,CAAC,CACH,CACD,CAAC;QACF,SAAS,CAAC,QAAQ,CACjB,yBAAyB,EACzB,4CAA+B,EAC/B,IAAA,sBAAc,EAAC,uCAA0B,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAC3E,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAC1D,CACD,CAAC;QACF,SAAS,CAAC,QAAQ,CACjB,kBAAkB,EAClB,sCAAyB,EACzB,IAAA,sBAAc,EAAC,iCAAoB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAC3E,CAAC;IACH,CAAC;CACD;AA7DD,sDA6DC"}

package/dist/server/mcp/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/server/mcp/filters.ts"],"names":[],"mappings":"AA6DA,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmCtF"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/server/mcp/filters.ts"],"names":[],"mappings":"AA8EA,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmCtF"}

package/dist/server/mcp/filters.js

@@ -24,14 +24,26 @@ function literalFor(field, value) {
     }
     if (t === 'string') {
         const v = String(value);
-        const isNavigationProperty = field.includes('/');
-        if (isGuid(v) && isIdish(field) && !isNavigationProperty) {
+        // Bare (unquoted) GUID for any Id-typed path — the scalar key `Id`, a lookup
+        // FK `XxxId`, or a navigation `Xxx/Id`. Other strings (incl. `Xxx/Name`) are quoted.
+        if (isGuid(v) && isIdish(field)) {
             return v;
         }
         return `'${escapeStr(v)}'`;
     }
     return `'${escapeStr(JSON.stringify(value))}'`;
 }
+// Creatio OData cannot filter a lookup by its scalar FK column (`ContactId eq <guid>`
+// 500s "Column by path ContactId not found"); it must be filtered through the
+// navigation property (`Contact/Id eq <guid>`), per the official docs and verified
+// live. Rewrite `<Lookup>Id` -> `<Lookup>/Id` for equality against a GUID. The
+// primary key `Id` and already-navigated paths are left untouched.
+function lookupNavField(field, value) {
+    if (isGuid(value) && field !== 'Id' && !field.includes('/') && /Id$/.test(field)) {
+        return `${field.slice(0, -2)}/Id`;
+    }
+    return field;
+}
 function buildCondition(c) {
     if (!c || !c.field) {
         return undefined;
@@ -42,7 +54,10 @@ function buildCondition(c) {
         if (!values.length) {
             return undefined;
         }
-        const parts = values.map((v) => `${field} eq ${literalFor(field, v)}`);
+        const parts = values.map((v) => {
+            const f = lookupNavField(field, v);
+            return `${f} eq ${literalFor(f, v)}`;
+        });
         return parts.length === 1 ? parts[0] : `(${parts.join(' or ')})`;
     }
     const op = String(c.op || 'eq');
@@ -53,7 +68,8 @@ function buildCondition(c) {
     if (value == null && (op === 'eq' || op === 'ne')) {
         return `${field} ${op} null`;
     }
-    return `${field} ${op} ${literalFor(field, value)}`;
+    const f = op === 'eq' || op === 'ne' ? lookupNavField(field, value) : field;
+    return `${f} ${op} ${literalFor(f, value)}`;
 }
 function buildFilterFromStructured(filters) {
     if (!filters || typeof filters !== 'object') {

package/dist/server/mcp/filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../src/server/mcp/filters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../src/server/mcp/filters.ts"],"names":[],"mappings":";;AA8EA,8DAmCC;AAjHD,SAAS,MAAM,CAAC,CAAU;IACzB,OAAO,CACN,OAAO,CAAC,KAAK,QAAQ;QACrB,+EAA+E,CAAC,IAAI,CAAC,CAAC,CAAC,CACvF,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAU;IAC5C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,6EAA6E;QAC7E,qFAAqF;QACrF,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC;QACV,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;AAChD,CAAC;AAED,sFAAsF;AACtF,8EAA8E;AAC9E,mFAAmF;AACnF,+EAA+E;AAC/E,mEAAmE;AACnE,SAAS,cAAc,CAAC,KAAa,EAAE,KAAc;IACpD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,CAAM;IAC7B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAE,CAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAI,CAAS,CAAC,EAAW,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IAClE,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAI,CAAS,CAAC,KAAK,CAAC;IAC/B,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,KAAK,YAAY,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACnE,OAAO,GAAG,EAAE,IAAI,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,KAAK,IAAI,EAAE,OAAO,CAAC;IAC9B,CAAC;IACD,MAAM,CAAC,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;AAC7C,CAAC;AAED,SAAgB,yBAAyB,CAAC,OAAwB;IACjE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC;gBACP,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACF,CAAC;IACF,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;IACF,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/server/mcp/globalsearch/globalsearch-client.d.ts

@@ -0,0 +1,50 @@
+import { ConfigurationCaller, SysSettingReader } from '../creatio-rest';
+/**
+ * Global Search access layer.
+ *
+ * Single responsibility: call the Creatio-hosted `GlobalSearchService` (which
+ * proxies Elasticsearch) and expose an availability probe. Knows nothing about
+ * MCP tool registration.
+ *
+ * `GlobalSearchService.Search` uses `[WebInvoke(BodyStyle = Wrapped)]` with
+ * several primitive parameters, so the request body is a FLAT object with one
+ * top-level key per parameter (unlike DataForge's single wrapped `request`).
+ */
+export interface GlobalSearchQuery {
+    /** Free-text search string. */
+    query: string;
+    /** Optional comma-separated entity schema names to restrict the search to. */
+    type?: string | undefined;
+    /** Optional current section entity name (UI context). */
+    sectionEntityName?: string | undefined;
+    /** Max records to return. */
+    recordCount?: number | undefined;
+    /** Pagination offset. */
+    from?: number | undefined;
+}
+export declare class GlobalSearchClient {
+    private readonly _configuration;
+    private readonly _sysSettings;
+    constructor(configuration: ConfigurationCaller, sysSettings: SysSettingReader);
+    /**
+     * Whether Global Search is configured on this environment. Gated on a non-empty
+     * `GlobalSearchUrl`. Note: the platform additionally requires the `GlobalSearch_V2`
+     * feature; a configured URL is the cheap operator-facing signal used to decide
+     * whether to expose the tool. Probe failures degrade to "disabled".
+     */
+    isEnabled(): Promise<boolean>;
+    /**
+     * Run a global search and return a compact, UI-like result: per match the
+     * entity, record id, a display title, and the highlighted `matched` columns —
+     * plus `total`/`nextFrom` for paging. (The raw service returns every indexed
+     * column of every record as a stringified `SearchResult`; that is far too large
+     * to hand to an LLM, so we parse and project it. Use `read` with the id for the
+     * full record.)
+     */
+    search(q: GlobalSearchQuery): Promise<unknown>;
+    /** Parse the stringified `SearchResult` envelope and project it to a compact shape. */
+    private _project;
+    /** Best-effort human title from a record's column values (string or `{ displayValue }`). */
+    private _displayName;
+}
+//# sourceMappingURL=globalsearch-client.d.ts.map

package/dist/server/mcp/globalsearch/globalsearch-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalsearch-client.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp/globalsearch/globalsearch-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAsB,MAAM,iBAAiB,CAAC;AAE5F;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IACjC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAQD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;gBAEpC,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB;IAK7E;;;;;OAKG;IACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAU1C;;;;;;;OAOG;IACU,MAAM,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB3D,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAoChB,4FAA4F;IAC5F,OAAO,CAAC,YAAY;CAmBpB"}

package/dist/server/mcp/globalsearch/globalsearch-client.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalSearchClient = void 0;
+const log_1 = __importDefault(require("../../../log"));
+const creatio_rest_1 = require("../creatio-rest");
+const SEARCH_SERVICE = 'GlobalSearchService';
+// Either URL being set is the operator-facing signal that Global Search is wired;
+// `GlobalSearchUrl` (the Elasticsearch endpoint) is the core requirement.
+const SEARCH_URL_SETTING = 'GlobalSearchUrl';
+const DEFAULT_RECORD_COUNT = 15;
+class GlobalSearchClient {
+    _configuration;
+    _sysSettings;
+    constructor(configuration, sysSettings) {
+        this._configuration = configuration;
+        this._sysSettings = sysSettings;
+    }
+    /**
+     * Whether Global Search is configured on this environment. Gated on a non-empty
+     * `GlobalSearchUrl`. Note: the platform additionally requires the `GlobalSearch_V2`
+     * feature; a configured URL is the cheap operator-facing signal used to decide
+     * whether to expose the tool. Probe failures degrade to "disabled".
+     */
+    async isEnabled() {
+        try {
+            const response = await this._sysSettings.queryValues([SEARCH_URL_SETTING]);
+            return (0, creatio_rest_1.hasNonEmptySetting)(response, SEARCH_URL_SETTING);
+        }
+        catch (err) {
+            log_1.default.warn('globalsearch.probe.failed', { error: String(err) });
+            return false;
+        }
+    }
+    /**
+     * Run a global search and return a compact, UI-like result: per match the
+     * entity, record id, a display title, and the highlighted `matched` columns —
+     * plus `total`/`nextFrom` for paging. (The raw service returns every indexed
+     * column of every record as a stringified `SearchResult`; that is far too large
+     * to hand to an LLM, so we parse and project it. Use `read` with the id for the
+     * full record.)
+     */
+    async search(q) {
+        // `GlobalSearchService.Search(queryString, sectionEntityName, recordCount, type="", from=0)`
+        // — the first three parameters have no defaults, so the WCF Wrapped body MUST
+        // include them or binding fails with HTTP 400. `type` is optional; only send it
+        // when filtering, mirroring the UI call.
+        const body = {
+            queryString: q.query,
+            sectionEntityName: q.sectionEntityName ?? '',
+            recordCount: q.recordCount ?? DEFAULT_RECORD_COUNT,
+            from: q.from ?? 0,
+        };
+        if (q.type) {
+            body.type = q.type;
+        }
+        const response = await this._configuration.call({
+            service: SEARCH_SERVICE,
+            method: 'Search',
+            httpMethod: 'POST',
+            body,
+        });
+        return this._project(response.body);
+    }
+    /** Parse the stringified `SearchResult` envelope and project it to a compact shape. */
+    _project(body) {
+        const raw = body?.SearchResult;
+        let parsed = raw;
+        if (typeof raw === 'string') {
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                return body;
+            }
+        }
+        const p = parsed;
+        if (!p || !Array.isArray(p.data)) {
+            return parsed ?? body;
+        }
+        return {
+            success: p.success,
+            total: p.total,
+            nextFrom: p.nextFrom,
+            took: p.took,
+            errorInfo: p.errorInfo ?? null,
+            results: p.data.map((r) => ({
+                entityName: r.entityName,
+                id: r.id,
+                title: this._displayName(r.columnValues),
+                matched: r.foundColumns,
+            })),
+        };
+    }
+    /** Best-effort human title from a record's column values (string or `{ displayValue }`). */
+    _displayName(columnValues) {
+        if (!columnValues || typeof columnValues !== 'object') {
+            return undefined;
+        }
+        const cv = columnValues;
+        for (const key of ['Name', 'Title', 'LeadName', 'BpmName', 'Subject', 'Number', 'Email']) {
+            const v = cv[key];
+            const s = typeof v === 'string'
+                ? v
+                : v && typeof v === 'object'
+                    ? v.displayValue
+                    : undefined;
+            if (typeof s === 'string' && s.trim().length > 0) {
+                return s.trim();
+            }
+        }
+        return undefined;
+    }
+}
+exports.GlobalSearchClient = GlobalSearchClient;
+//# sourceMappingURL=globalsearch-client.js.map

package/dist/server/mcp/globalsearch/globalsearch-client.js.map

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

package/dist/server/mcp/globalsearch/globalsearch-tool-preparer.d.ts

@@ -0,0 +1,16 @@
+import { ToolPreparer, ToolRegistrar } from '../tool-preparer';
+import { GlobalSearchClient } from './globalsearch-client';
+/** Stable capability key. */
+export declare const GLOBAL_SEARCH_CAPABILITY = "global-search";
+/**
+ * Registers the `global-search` tool, but only when Global Search is enabled on
+ * the environment. Encapsulates everything Global-Search-specific so the Server
+ * stays agnostic (Open/Closed: adding capabilities = adding preparers).
+ */
+export declare class GlobalSearchToolPreparer implements ToolPreparer {
+    readonly name = "global-search";
+    private readonly _client;
+    constructor(client: GlobalSearchClient);
+    prepare(registrar: ToolRegistrar): Promise<boolean>;
+}
+//# sourceMappingURL=globalsearch-tool-preparer.d.ts.map

package/dist/server/mcp/globalsearch/globalsearch-tool-preparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalsearch-tool-preparer.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp/globalsearch/globalsearch-tool-preparer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,6BAA6B;AAC7B,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC5D,SAAgB,IAAI,mBAA4B;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,MAAM,EAAE,kBAAkB;IAIzB,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBhE"}

package/dist/server/mcp/globalsearch/globalsearch-tool-preparer.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GlobalSearchToolPreparer = exports.GLOBAL_SEARCH_CAPABILITY = void 0;
+const utils_1 = require("../../../utils");
+const tools_data_1 = require("../tools-data");
+/** Stable capability key. */
+exports.GLOBAL_SEARCH_CAPABILITY = 'global-search';
+/**
+ * Registers the `global-search` tool, but only when Global Search is enabled on
+ * the environment. Encapsulates everything Global-Search-specific so the Server
+ * stays agnostic (Open/Closed: adding capabilities = adding preparers).
+ */
+class GlobalSearchToolPreparer {
+    name = exports.GLOBAL_SEARCH_CAPABILITY;
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+    async prepare(registrar) {
+        const enabled = await this._client.isEnabled();
+        if (!enabled) {
+            return false;
+        }
+        registrar.register('global-search', tools_data_1.globalSearchDescriptor, (0, utils_1.withValidation)(tools_data_1.globalSearchInput, ({ query, entities, limit, from }) => this._client.search({
+            query,
+            type: entities && entities.length > 0 ? entities.join(',') : undefined,
+            recordCount: limit,
+            from,
+        })));
+        return true;
+    }
+}
+exports.GlobalSearchToolPreparer = GlobalSearchToolPreparer;
+//# sourceMappingURL=globalsearch-tool-preparer.js.map

package/dist/server/mcp/globalsearch/globalsearch-tool-preparer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalsearch-tool-preparer.js","sourceRoot":"","sources":["../../../../src/server/mcp/globalsearch/globalsearch-tool-preparer.ts"],"names":[],"mappings":";;;AAAA,0CAAgD;AAEhD,8CAA0E;AAI1E,6BAA6B;AAChB,QAAA,wBAAwB,GAAG,eAAe,CAAC;AAExD;;;;GAIG;AACH,MAAa,wBAAwB;IACpB,IAAI,GAAG,gCAAwB,CAAC;IAE/B,OAAO,CAAqB;IAE7C,YAAY,MAA0B;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,SAAwB;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACd,CAAC;QACD,SAAS,CAAC,QAAQ,CACjB,eAAe,EACf,mCAAsB,EACtB,IAAA,sBAAc,EAAC,8BAAiB,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CACtE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACnB,KAAK;YACL,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YACtE,WAAW,EAAE,KAAK;YAClB,IAAI;SACJ,CAAC,CACF,CACD,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AA5BD,4DA4BC"}

package/dist/server/mcp/json-schema-to-zod.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare function jsonSchemaToZodShape(schema: unknown): Record<string, z.ZodTypeAny>;
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/server/mcp/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../../src/server/mcp/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAUlF"}

package/dist/server/mcp/json-schema-to-zod.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToZodShape = jsonSchemaToZodShape;
+const zod_1 = require("zod");
+function jsonSchemaToZodShape(schema) {
+    const node = asNode(schema);
+    const properties = isRecord(node.properties) ? node.properties : {};
+    const required = new Set(Array.isArray(node.required) ? node.required : []);
+    const shape = {};
+    for (const [key, raw] of Object.entries(properties)) {
+        const zodType = nodeToZod(raw);
+        shape[key] = required.has(key) ? zodType : zodType.optional();
+    }
+    return shape;
+}
+function nodeToZod(raw) {
+    const node = asNode(raw);
+    let zodType = baseType(node);
+    if (typeof node.description === 'string' && node.description.length > 0) {
+        zodType = zodType.describe(node.description);
+    }
+    return zodType;
+}
+function baseType(node) {
+    if (Array.isArray(node.enum) && node.enum.length > 0) {
+        const literals = node.enum.map((value) => zod_1.z.literal(value));
+        return literals.length === 1
+            ? literals[0]
+            : zod_1.z.union(literals);
+    }
+    switch (node.type) {
+        case 'string':
+            return zod_1.z.string();
+        case 'integer':
+            return zod_1.z.number().int();
+        case 'number':
+            return zod_1.z.number();
+        case 'boolean':
+            return zod_1.z.boolean();
+        case 'array':
+            return zod_1.z.array(node.items === undefined ? zod_1.z.any() : nodeToZod(node.items));
+        case 'object':
+            return zod_1.z.record(zod_1.z.string(), zod_1.z.any());
+        default:
+            return zod_1.z.any();
+    }
+}
+function asNode(value) {
+    return isRecord(value) ? value : {};
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=json-schema-to-zod.js.map

package/dist/server/mcp/json-schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.js","sourceRoot":"","sources":["../../../src/server/mcp/json-schema-to-zod.ts"],"names":[],"mappings":"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"}

package/dist/server/mcp/server.d.ts

@@ -11,6 +11,12 @@ export declare class Server {
     private _readonly;
     private _serverName;
     private _serverVersion;
+    private readonly _dataForge;
+    private readonly _dataForgePreparer;
+    private readonly _globalSearchPreparer;
+    private readonly _publishedToolsPreparer;
+    private readonly _preparers;
+    private readonly _capabilities;
     get authProvider(): ICreatioAuthProvider;
     constructor(engines: CreatioEngineManager, config: ServerConfig);
     private _registerData;
@@ -18,6 +24,18 @@ export declare class Server {
     private _normalizeToToolHandler;
     private _registerAsTool;
     private _registerPrompts;
+    private _textResult;
+    /** Adapter exposing handler registration to {@link ToolPreparer}s. */
+    private _toolRegistrar;
+    /**
+     * Run every optional-capability preparer once: probe the environment and let
+     * each register its tools only when available. A failing preparer is isolated
+     * and recorded as disabled. Invoked from {@link startMcp} after the core tools
+     * are in place.
+     */
+    private _prepareTools;
+    /** Whether DataForge was probed as enabled at startup. */
+    private _isDataForgeReady;
     private _registerClientTools;
     startMcp(): Promise<McpServer>;
     stopMcp(): Promise<void>;

package/dist/server/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EAEpB,MAAM,eAAe,CAAC;AAgDvB,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAW;IAEjC,IAAW,YAAY,IAAI,oBAAoB,CAE9C;gBAEW,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAM/D,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,oBAAoB;IAyQf,QAAQ;IAaR,OAAO;CAWpB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EAEpB,MAAM,eAAe,CAAC;AA0DvB,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAW;IAIjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA2B;IACjE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA+B;IACvE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAE5D,IAAW,YAAY,IAAI,oBAAoB,CAE9C;gBAEW,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAoB/D,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,8BAA8B;IAQtC,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,WAAW;IAWnB,sEAAsE;IACtE,OAAO,CAAC,cAAc;IAOtB;;;;;OAKG;YACW,aAAa;IAc3B,0DAA0D;IAC1D,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,oBAAoB;IAsQf,QAAQ;IAqBR,OAAO;CAWpB"}