@firfi/huly-mcp 0.52.0 → 0.52.3

package/README.md

@@ -10,6 +10,8 @@
 
 **Huly MCP** is a feature-complete MCP server for [Huly](https://huly.io/) integration. Published on npm as [`@firfi/huly-mcp`](https://www.npmjs.com/package/@firfi/huly-mcp).
 
+It connects to any Huly Platform deployment, so it should also work with the [Platform Collective](https://github.com/Platform-Collective/platform) fork and [TraceX](https://tracex.co) — unofficial for now.
+
 > [!IMPORTANT]
 > **Hosted Huly is shutting down.** Huly's upstream README says shutdown is expected July 20. If you use `https://huly.app`, [export and migrate your data](https://github.com/hcengineering/platform/blob/develop/README.md) as soon as possible. See the [backup and restore guide](https://github.com/hcengineering/platform/blob/develop/docs/guides/backup-restore.en.md) and [self-hosting repository](https://github.com/hcengineering/huly-selfhost). Self-hosted deployments are not affected.
 

package/dist/index.cjs

@@ -117849,7 +117849,7 @@ var require_lib7 = __commonJS({
 });
 
 // src/huly/huly-plugins.ts
-var import_node_module, import_setting, load, activity, attachment, board, calendar, cardPlugin, chunter, contact, core, documentPlugin, gmailModule, gmail, hrModule, hr, inventory, love, mail, notification, preference, request3, setting, support, tags, task, templates, telegram, time3, tracker, view, workbench;
+var import_node_module, import_setting, load, activity, attachment, board, calendar, cardPlugin, chunter, contact, core, documentPlugin, gmailModule, gmail, hrModule, hr, inventory, love, mail, notification, preference, request3, isSettingPlugin, resolveSettingPlugin, setting, support, tags, task, templates, telegram, time3, tracker, view, workbench;
 var init_huly_plugins = __esm({
   "src/huly/huly-plugins.ts"() {
     "use strict";
@@ -117875,7 +117875,16 @@ var init_huly_plugins = __esm({
     notification = load("@hcengineering/notification").default;
     preference = load("@hcengineering/preference").default;
     request3 = load("@hcengineering/request").default;
-    setting = import_setting.default;
+    isSettingPlugin = (value3) => typeof value3 === "object" && value3 !== null && "class" in value3 && typeof value3.class === "object" && value3.class !== null && "OfficeSettings" in value3.class && value3.class.OfficeSettings === "setting:class:OfficeSettings";
+    resolveSettingPlugin = (candidate = import_setting.default) => {
+      const direct = candidate;
+      if (isSettingPlugin(direct)) return direct;
+      if (typeof direct === "object" && direct !== null && "default" in direct && isSettingPlugin(direct.default)) {
+        return direct.default;
+      }
+      throw new Error("@hcengineering/setting did not expose its declared default plugin");
+    };
+    setting = resolveSettingPlugin();
     support = load("@hcengineering/support").default;
     tags = load("@hcengineering/tags").default;
     task = load("@hcengineering/task").default;
@@ -132446,7 +132455,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.52.0" : "0.0.0-dev";
+    VERSION = true ? "0.52.3" : "0.0.0-dev";
   }
 });
 
@@ -233801,7 +233810,7 @@ var init_tool_call_notices = __esm({
 });
 
 // src/mcp/protocol-handlers.ts
-var NPM_FETCH_TIMEOUT_MS, NPM_PACKAGE_NAME2, computeOutputBytes, deriveEditMode, validateHulyContextResult, validateVersionToolResult, liveNowClock, fetchLatestNpmVersion, invokeToolEditMode, resolveClientBundle, proxyClients, proxyEditMode, resolveProxyClients, responseStatus, selectNativeCallRegistry, nativeArgumentError, createMcpProtocolHandlers;
+var NPM_FETCH_TIMEOUT_MS, NPM_PACKAGE_NAME2, computeOutputBytes, deriveEditMode, validateHulyContextResult, validateVersionToolResult, liveNowClock, fetchLatestNpmVersion, proxyCallTelemetry, resolveClientBundle, proxyClients, resolveProxyClients, responseStatus, selectNativeCallRegistry, nativeArgumentError, createMcpProtocolHandlers;
 var init_protocol_handlers = __esm({
   "src/mcp/protocol-handlers.ts"() {
     "use strict";
@@ -233846,9 +233855,16 @@ var init_protocol_handlers = __esm({
         return "unknown";
       }
     };
-    invokeToolEditMode = (args2) => {
+    proxyCallTelemetry = (toolName, args2, registry2) => {
+      if (toolName !== INVOKE_TOOL_TOOL_NAME) return { toolName, callPath: "direct" };
       const decoded = Schema_exports.decodeUnknownResult(InvokeToolParamsSchema)(args2);
-      return Result_exports.isSuccess(decoded) ? deriveEditMode(decoded.success.toolName, decoded.success.arguments) : void 0;
+      if (Result_exports.isFailure(decoded)) return { toolName, callPath: "invoke_tool" };
+      const target = decoded.success.toolName;
+      return {
+        toolName: registry2.tools.has(target) ? target : toolName,
+        callPath: "invoke_tool",
+        editMode: deriveEditMode(target, decoded.success.arguments)
+      };
     };
     resolveClientBundle = async (resolveClients) => {
       try {
@@ -233863,7 +233879,6 @@ var init_protocol_handlers = __esm({
       storageClient: clients.storageClient,
       ...clients.workspaceClient === void 0 ? {} : { workspaceClient: clients.workspaceClient }
     });
-    proxyEditMode = (toolName, args2) => toolName === INVOKE_TOOL_TOOL_NAME ? invokeToolEditMode(args2) : void 0;
     resolveProxyClients = (toolName, resolveClients) => toolName === INVOKE_TOOL_TOOL_NAME ? resolveClientBundle(resolveClients) : Promise.resolve(void 0);
     responseStatus = (response) => response.isError === true ? "error" : "success";
     selectNativeCallRegistry = (exposure, toolName) => exposure.visibleNativeRegistry.tools.has(toolName) ? exposure.visibleNativeRegistry : exposure.context.resolvedMode === "proxy" ? exposure.proxyCandidateRegistry : exposure.visibleNativeRegistry;
@@ -233918,19 +233933,18 @@ var init_protocol_handlers = __esm({
             noticeClaim.delivered();
             return responseWithNotice;
           };
-          const returnError = (errorResponse, editMode) => {
+          const returnError = (errorResponse, attribution = { toolName: name, callPath: "direct" }) => {
             const responseWithNotice = withClaimedNotice(errorResponse);
             const durationMs = clock.currentTimeMillis() - start;
             telemetry.toolCalled({
-              toolName: name,
+              ...attribution,
               status: "error",
               clientKind: exposure.context.clientKind,
               resolvedMode: exposure.context.resolvedMode,
               errorTag: responseWithNotice._meta?.errorTag,
               durationMs,
               inputBytes,
-              outputBytes: computeOutputBytes(responseWithNotice),
-              editMode
+              outputBytes: computeOutputBytes(responseWithNotice)
             });
             return toMcpResponse(responseWithNotice);
           };
@@ -233981,10 +233995,10 @@ var init_protocol_handlers = __esm({
           };
           const callProxyTool = async (toolName) => {
             if (exposure.context.resolvedMode !== "proxy") return returnError(createUnknownToolError(toolName));
-            const editMode = proxyEditMode(toolName, args2);
+            const attribution = proxyCallTelemetry(toolName, args2, exposure.proxyCandidateRegistry);
             const clientResolution = await resolveProxyClients(toolName, resolveClients);
             if (clientResolution?._tag === "Failure") {
-              return returnError(clientResolution.response, editMode);
+              return returnError(clientResolution.response, attribution);
             }
             const response = await handleProxyToolCall({
               toolName,
@@ -233995,15 +234009,14 @@ var init_protocol_handlers = __esm({
             const responseWithNotice = withClaimedNotice(response);
             const durationMs = clock.currentTimeMillis() - start;
             telemetry.toolCalled({
-              toolName,
+              ...attribution,
               status: responseStatus(responseWithNotice),
               clientKind: exposure.context.clientKind,
               resolvedMode: exposure.context.resolvedMode,
               errorTag: responseWithNotice._meta?.errorTag,
               durationMs,
               inputBytes,
-              outputBytes: computeOutputBytes(responseWithNotice),
-              editMode
+              outputBytes: computeOutputBytes(responseWithNotice)
             });
             return toMcpResponse(responseWithNotice);
           };
@@ -234015,9 +234028,13 @@ var init_protocol_handlers = __esm({
             if (tool === void 0) return returnError(createUnknownToolError(name));
             const argumentError = nativeArgumentError(tool, args2);
             if (argumentError !== void 0) return returnError(argumentError);
-            const editMode = deriveEditMode(hulyToolName, args2);
+            const attribution = {
+              toolName: hulyToolName,
+              callPath: "direct",
+              editMode: deriveEditMode(hulyToolName, args2)
+            };
             const clientResolution = await resolveClientBundle(resolveClients);
-            if (clientResolution._tag === "Failure") return returnError(clientResolution.response, editMode);
+            if (clientResolution._tag === "Failure") return returnError(clientResolution.response, attribution);
             const { clients } = clientResolution;
             const response = await nativeCallRegistry.handleToolCall(
               hulyToolName,
@@ -234027,18 +234044,17 @@ var init_protocol_handlers = __esm({
               clients.workspaceClient
             );
             const durationMs = clock.currentTimeMillis() - start;
-            if (response === null) return returnError(createUnknownToolError(name), editMode);
+            if (response === null) return returnError(createUnknownToolError(name), attribution);
             const responseWithNotice = withClaimedNotice(response);
             telemetry.toolCalled({
-              toolName: hulyToolName,
+              ...attribution,
               status: responseStatus(responseWithNotice),
               clientKind: exposure.context.clientKind,
               resolvedMode: exposure.context.resolvedMode,
               errorTag: responseWithNotice._meta?.errorTag,
               durationMs,
               inputBytes,
-              outputBytes: computeOutputBytes(responseWithNotice),
-              editMode
+              outputBytes: computeOutputBytes(responseWithNotice)
             });
             return toMcpResponse(responseWithNotice);
           };
@@ -238480,16 +238496,29 @@ var init_stderr = __esm({
 });
 
 // src/telemetry/posthog.ts
-var POSTHOG_API_KEY, SHUTDOWN_TIMEOUT_MS, defaultDependencies, createPostHogTelemetry, createPostHogTelemetryWithContext;
+var POSTHOG_API_KEY, SHUTDOWN_TIMEOUT_MS, ToolCalledPropertiesSchema, defaultDependencies, createPostHogTelemetry, createPostHogTelemetryWithContext;
 var init_posthog = __esm({
   "src/telemetry/posthog.ts"() {
     "use strict";
     init_index_node();
+    init_dist();
     init_stderr();
     init_version();
     init_context();
     POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
     SHUTDOWN_TIMEOUT_MS = 2e3;
+    ToolCalledPropertiesSchema = Schema_exports.Struct({
+      tool_name: Schema_exports.String,
+      call_path: Schema_exports.Literals(["direct", "invoke_tool"]),
+      status: Schema_exports.Literals(["success", "error"]),
+      duration_ms: Schema_exports.Number,
+      client_kind: Schema_exports.optionalKey(Schema_exports.String),
+      resolved_mode: Schema_exports.optionalKey(Schema_exports.String),
+      error_tag: Schema_exports.optionalKey(Schema_exports.String),
+      input_bytes: Schema_exports.optionalKey(Schema_exports.Number),
+      output_bytes: Schema_exports.optionalKey(Schema_exports.Number),
+      edit_mode: Schema_exports.optionalKey(Schema_exports.String)
+    });
     defaultDependencies = {
       createClient: () => new PostHog(POSTHOG_API_KEY, { host: "https://us.i.posthog.com", flushAt: 10, flushInterval: 6e4 }),
       createSessionId: () => crypto.randomUUID(),
@@ -238554,6 +238583,7 @@ var init_posthog = __esm({
             event: "tool_called",
             properties: {
               tool_name: props.toolName,
+              call_path: props.callPath ?? "direct",
               status: props.status,
               duration_ms: props.durationMs,
               ...props.clientKind !== void 0 && { client_kind: props.clientKind },
@@ -239402,7 +239432,7 @@ if (unsupportedRuntime) {
     detectedNodeVersion: process.versions.node,
     executable: process.execPath,
     requiredNodeVersion: nodeEngineRequirement,
-    serverVersion: "0.52.0"
+    serverVersion: "0.52.3"
   });
   startUnsupportedNodeMcp(config2);
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firfi/huly-mcp",
-  "version": "0.52.0",
+  "version": "0.52.3",
   "description": "Huly MCP: feature-complete MCP server for Huly integration",
   "mcpName": "io.github.dearlordylord/huly-mcp",
   "type": "module",