mcp-creatio 0.4.1 → 0.6.0

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

@@ -0,0 +1,64 @@
+import { ConfigurationCaller, ConfigurationCallResult, SysSettingReader } from '../creatio-rest';
+export type { ConfigurationCaller, ConfigurationCallRequest, ConfigurationCallResult, ConfigurationHttpMethod, SysSettingReader, } from '../creatio-rest';
+/**
+ * DataForge access layer.
+ *
+ * Single responsibility: build correct requests against the Creatio-hosted
+ * DataForge REST services and expose the read/maintenance operations plus an
+ * availability probe. It knows nothing about MCP tool registration.
+ *
+ * The DataForge WCF services use `[WebInvoke(BodyStyle = Wrapped)]`, so each
+ * single-parameter method expects its DTO wrapped under a top-level `request`.
+ */
+export interface SimilarTablesQuery {
+    query: string;
+    limit?: number | undefined;
+}
+export interface TableRelationshipsQuery {
+    sourceTable: string;
+    targetTable: string;
+    limit?: number | undefined;
+    bidirectional?: boolean | undefined;
+    skipDetails?: boolean | undefined;
+}
+export interface LookupValuesQuery {
+    query: string;
+    schemaName?: string | undefined;
+    limit?: number | undefined;
+}
+export declare class DataForgeClient {
+    private readonly _configuration;
+    private readonly _sysSettings;
+    constructor(configuration: ConfigurationCaller, sysSettings: SysSettingReader);
+    /**
+     * Whether DataForge is configured on this environment. Gated on a non-empty
+     * `DataForgeServiceUrl`, mirroring the server-side `IsDataForgeEnabled` check.
+     * Probe failures are treated as "disabled" so callers degrade gracefully.
+     */
+    isEnabled(): Promise<boolean>;
+    getSimilarTableNames(q: SimilarTablesQuery): Promise<ConfigurationCallResult>;
+    getTableDetails(q: SimilarTablesQuery): Promise<ConfigurationCallResult>;
+    getTableRelationships(q: TableRelationshipsQuery): Promise<ConfigurationCallResult>;
+    getLookupValues(q: LookupValuesQuery): Promise<ConfigurationCallResult>;
+    getTableColumns(tableName: string): Promise<ConfigurationCallResult>;
+    getServiceStatus(): Promise<ConfigurationCallResult>;
+    /**
+     * Column details for `describe-entity` routing: returns the response body when
+     * DataForge answers successfully, or `null` so the caller can fall back to
+     * OData metadata. Per-call resilience only — a single miss or error never
+     * disables DataForge globally (that verdict is owned by {@link isEnabled}).
+     */
+    getColumnsOrNull(tableName: string): Promise<unknown | null>;
+    private _read;
+    /**
+     * The configuration REST services use WCF `BodyStyle = Wrapped`, so a response
+     * is nested under a single `<Method>Result` key (e.g. `GetTableColumnsDetailsResult`).
+     * Unwrap it so failure detection and the returned payload see the actual response.
+     */
+    private _unwrapResult;
+    /** Creatio serializes `BaseResponse.Success` as camelCase `success`; tolerate both. */
+    private _isFailure;
+    private _errorCode;
+    private _omitUndefined;
+}
+//# sourceMappingURL=dataforge-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataforge-client.d.ts","sourceRoot":"","sources":["../../../../src/server/mcp/dataforge/dataforge-client.ts"],"names":[],"mappings":"AACA,OAAO,EACN,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAEhB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACX,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAMD,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;gBAEpC,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB;IAK7E;;;;OAIG;IACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC,oBAAoB,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI7E,eAAe,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIxE,qBAAqB,CAAC,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAUnF,eAAe,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQvE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIpE,gBAAgB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAS3D;;;;;OAKG;IACU,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAiBzE,OAAO,CAAC,KAAK;IAYb;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAUrB,uFAAuF;IACvF,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,cAAc;CAGtB"}

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

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataForgeClient = void 0;
+const log_1 = __importDefault(require("../../../log"));
+const creatio_rest_1 = require("../creatio-rest");
+const READ_SERVICE = 'DataForgeSchemaReadService';
+const MAINTENANCE_SERVICE = 'DataForgeMaintenanceService';
+const SERVICE_URL_SETTING = 'DataForgeServiceUrl';
+class DataForgeClient {
+    _configuration;
+    _sysSettings;
+    constructor(configuration, sysSettings) {
+        this._configuration = configuration;
+        this._sysSettings = sysSettings;
+    }
+    /**
+     * Whether DataForge is configured on this environment. Gated on a non-empty
+     * `DataForgeServiceUrl`, mirroring the server-side `IsDataForgeEnabled` check.
+     * Probe failures are treated as "disabled" so callers degrade gracefully.
+     */
+    async isEnabled() {
+        try {
+            const response = await this._sysSettings.queryValues([SERVICE_URL_SETTING]);
+            return (0, creatio_rest_1.hasNonEmptySetting)(response, SERVICE_URL_SETTING);
+        }
+        catch (err) {
+            log_1.default.warn('dataforge.probe.failed', { error: String(err) });
+            return false;
+        }
+    }
+    getSimilarTableNames(q) {
+        return this._read('GetSimilarTableNames', { query: q.query, limit: q.limit });
+    }
+    getTableDetails(q) {
+        return this._read('GetTableDetails', { query: q.query, limit: q.limit });
+    }
+    getTableRelationships(q) {
+        return this._read('GetTableRelationships', {
+            sourceTable: q.sourceTable,
+            targetTable: q.targetTable,
+            limit: q.limit,
+            bidirectional: q.bidirectional,
+            skipDetails: q.skipDetails,
+        });
+    }
+    getLookupValues(q) {
+        return this._read('GetLookupValues', {
+            query: q.query,
+            schemaName: q.schemaName,
+            limit: q.limit,
+        });
+    }
+    getTableColumns(tableName) {
+        return this._read('GetTableColumnsDetails', { tableName });
+    }
+    getServiceStatus() {
+        return this._configuration.call({
+            service: MAINTENANCE_SERVICE,
+            method: 'GetServiceStatus',
+            httpMethod: 'POST',
+            body: {},
+        });
+    }
+    /**
+     * Column details for `describe-entity` routing: returns the response body when
+     * DataForge answers successfully, or `null` so the caller can fall back to
+     * OData metadata. Per-call resilience only — a single miss or error never
+     * disables DataForge globally (that verdict is owned by {@link isEnabled}).
+     */
+    async getColumnsOrNull(tableName) {
+        try {
+            const { body } = await this.getTableColumns(tableName);
+            const result = this._unwrapResult(body);
+            if (this._isFailure(result)) {
+                log_1.default.info('dataforge.describe-entity.fallback', {
+                    reason: this._errorCode(result) ?? 'success_false',
+                });
+                return null;
+            }
+            return result ?? null;
+        }
+        catch (err) {
+            log_1.default.warn('dataforge.describe-entity.error', { error: String(err) });
+            return null;
+        }
+    }
+    _read(method, request) {
+        return this._configuration.call({
+            service: READ_SERVICE,
+            method,
+            httpMethod: 'POST',
+            body: { request: this._omitUndefined(request) },
+        });
+    }
+    /**
+     * The configuration REST services use WCF `BodyStyle = Wrapped`, so a response
+     * is nested under a single `<Method>Result` key (e.g. `GetTableColumnsDetailsResult`).
+     * Unwrap it so failure detection and the returned payload see the actual response.
+     */
+    _unwrapResult(body) {
+        if (body && typeof body === 'object' && !Array.isArray(body)) {
+            const keys = Object.keys(body);
+            if (keys.length === 1 && keys[0].endsWith('Result')) {
+                return body[keys[0]];
+            }
+        }
+        return body;
+    }
+    /** Creatio serializes `BaseResponse.Success` as camelCase `success`; tolerate both. */
+    _isFailure(result) {
+        if (!result || typeof result !== 'object') {
+            return false;
+        }
+        const r = result;
+        return r.success === false || r.Success === false;
+    }
+    _errorCode(result) {
+        const r = result;
+        const info = r?.errorInfo ?? r?.ErrorInfo;
+        return info?.errorCode ?? info?.ErrorCode;
+    }
+    _omitUndefined(obj) {
+        return Object.fromEntries(Object.entries(obj).filter(([, value]) => value !== undefined));
+    }
+}
+exports.DataForgeClient = DataForgeClient;
+//# sourceMappingURL=dataforge-client.js.map

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

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

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

@@ -1,2 +1,8 @@
-export declare function buildFilterFromStructured(filters: any | undefined): string | undefined;
+import { FilterNode, OrderSpec } from '../../creatio/contracts';
+/** Build the neutral {@link FilterNode} from the structured `filters` argument (AND of the
+ *  `all` group with the `any` group), or undefined when there is nothing to filter on. */
+export declare function buildFilterNode(filters: unknown): FilterNode | undefined;
+/** Parse an OData-style `$orderby` clause ("Name asc, CreatedOn desc") into neutral order
+ *  terms. Direction defaults to ascending when omitted. */
+export declare function parseOrderBy(orderBy: unknown): OrderSpec[] | undefined;
 //# sourceMappingURL=filters.d.ts.map

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":"AAAA,OAAO,EAAoB,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAqDlF;0FAC0F;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAexE;AAED;2DAC2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,SAAS,CAatE"}

package/dist/server/mcp/filters.js

@@ -1,94 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildFilterFromStructured = buildFilterFromStructured;
-function isGuid(s) {
-    return (typeof s === 'string' &&
-        /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(s));
-}
-function isIdish(field) {
-    return /(^|\/)Id$/.test(field) || /Id$/i.test(field);
-}
-function escapeStr(val) {
-    return val.replace(/'/g, "''");
-}
-function literalFor(field, value) {
-    if (value == null) {
-        return 'null';
-    }
-    const t = typeof value;
-    if (t === 'number') {
-        return String(value);
-    }
-    if (t === 'boolean') {
-        return value ? 'true' : 'false';
-    }
-    if (t === 'string') {
-        const v = String(value);
-        const isNavigationProperty = field.includes('/');
-        if (isGuid(v) && isIdish(field) && !isNavigationProperty) {
-            return v;
-        }
-        return `'${escapeStr(v)}'`;
-    }
-    return `'${escapeStr(JSON.stringify(value))}'`;
-}
-function buildCondition(c) {
+exports.buildFilterNode = buildFilterNode;
+exports.parseOrderBy = parseOrderBy;
+function toNode(c) {
     if (!c || !c.field) {
         return undefined;
     }
     const field = String(c.field);
     if (Array.isArray(c.in)) {
-        const values = c.in;
-        if (!values.length) {
-            return undefined;
-        }
-        const parts = values.map((v) => `${field} eq ${literalFor(field, v)}`);
-        return parts.length === 1 ? parts[0] : `(${parts.join(' or ')})`;
+        return c.in.length ? { kind: 'in', field, values: c.in } : undefined;
     }
-    const op = String(c.op || 'eq');
-    const value = c.value;
-    if (op === 'contains' || op === 'startswith' || op === 'endswith') {
-        return `${op}(${field},${literalFor(field, value)})`;
+    const op = (c.op ? String(c.op) : 'eq');
+    // A null/absent value against eq/ne is a null-check; route it through the dedicated
+    // neutral ops so each backend renders it correctly (OData `field eq null`,
+    // DataService `IsNullFilter`).
+    if (c.value === null || c.value === undefined) {
+        if (op === 'eq') {
+            return { kind: 'condition', field, op: 'isNull' };
+        }
+        if (op === 'ne') {
+            return { kind: 'condition', field, op: 'isNotNull' };
+        }
     }
-    if (value == null && (op === 'eq' || op === 'ne')) {
-        return `${field} ${op} null`;
+    return { kind: 'condition', field, op, value: c.value };
+}
+function group(logic, conditions) {
+    const items = conditions.map(toNode).filter((n) => Boolean(n));
+    if (!items.length) {
+        return undefined;
     }
-    return `${field} ${op} ${literalFor(field, value)}`;
+    return { kind: 'group', logic, items };
 }
-function buildFilterFromStructured(filters) {
+/** Build the neutral {@link FilterNode} from the structured `filters` argument (AND of the
+ *  `all` group with the `any` group), or undefined when there is nothing to filter on. */
+function buildFilterNode(filters) {
     if (!filters || typeof filters !== 'object') {
         return undefined;
     }
-    const andParts = [];
-    const orParts = [];
-    if (Array.isArray(filters.all)) {
-        for (const c of filters.all) {
-            const s = buildCondition(c);
-            if (s) {
-                andParts.push(s);
-            }
-        }
-    }
-    if (Array.isArray(filters.any)) {
-        for (const c of filters.any) {
-            const s = buildCondition(c);
-            if (s) {
-                orParts.push(s);
-            }
-        }
-    }
-    const andStr = andParts.join(' and ');
-    const orStr = orParts.join(' or ');
-    const parts = [];
-    if (andStr) {
-        parts.push(andParts.length > 1 ? `(${andStr})` : andStr);
+    const f = filters;
+    const allNode = Array.isArray(f.all) ? group('and', f.all) : undefined;
+    const anyNode = Array.isArray(f.any) ? group('or', f.any) : undefined;
+    const parts = [allNode, anyNode].filter((n) => Boolean(n));
+    if (!parts.length) {
+        return undefined;
     }
-    if (orStr) {
-        parts.push(orParts.length > 1 ? `(${orStr})` : orStr);
+    if (parts.length === 1) {
+        return parts[0];
     }
-    if (!parts.length) {
+    return { kind: 'group', logic: 'and', items: parts };
+}
+/** Parse an OData-style `$orderby` clause ("Name asc, CreatedOn desc") into neutral order
+ *  terms. Direction defaults to ascending when omitted. */
+function parseOrderBy(orderBy) {
+    if (typeof orderBy !== 'string' || !orderBy.trim()) {
         return undefined;
     }
-    return parts.join(' and ');
+    const terms = orderBy
+        .split(',')
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .map((part) => {
+        const [field, dir] = part.split(/\s+/);
+        return { field: field, dir: (dir ?? '').toLowerCase() === 'desc' ? 'desc' : 'asc' };
+    });
+    return terms.length ? terms : undefined;
 }
 //# sourceMappingURL=filters.js.map

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":"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"}

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