@firfi/huly-mcp 0.44.5 → 0.44.7

package/README.md

@@ -10,6 +10,9 @@
 
 **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).
 
+> [!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.
+
 ## Installation
 
 The standard configuration works with most MCP clients:
@@ -21,7 +24,7 @@ The standard configuration works with most MCP clients:
       "command": "npx",
       "args": ["-y", "@firfi/huly-mcp@latest"],
       "env": {
-        "HULY_URL": "https://huly.app",
+        "HULY_URL": "https://your-huly-instance.example.com",
         "HULY_EMAIL": "your@email.com",
         "HULY_PASSWORD": "yourpassword",
         "HULY_WORKSPACE": "yourworkspace"
@@ -44,7 +47,7 @@ Use Codex's MCP manager:
 
 ```bash
 codex mcp add huly \
-  --env HULY_URL=https://huly.app \
+  --env HULY_URL=https://your-huly-instance.example.com \
   --env HULY_EMAIL=your@email.com \
   --env HULY_PASSWORD=yourpassword \
   --env HULY_WORKSPACE=yourworkspace \
@@ -59,7 +62,7 @@ command = "npx"
 args = ["-y", "@firfi/huly-mcp@latest"]
 
 [mcp_servers.huly.env]
-HULY_URL = "https://huly.app"
+HULY_URL = "https://your-huly-instance.example.com"
 HULY_EMAIL = "your@email.com"
 HULY_PASSWORD = "yourpassword"
 HULY_WORKSPACE = "yourworkspace"
@@ -72,7 +75,7 @@ HULY_WORKSPACE = "yourworkspace"
 
 ```bash
 claude mcp add huly \
-  -e HULY_URL=https://huly.app \
+  -e HULY_URL=https://your-huly-instance.example.com \
   -e HULY_EMAIL=your@email.com \
   -e HULY_PASSWORD=yourpassword \
   -e HULY_WORKSPACE=yourworkspace \
@@ -105,7 +108,7 @@ Add with Command Palette → "MCP: Add Server", or put this in a VS Code MCP con
       "command": "npx",
       "args": ["-y", "@firfi/huly-mcp@latest"],
       "env": {
-        "HULY_URL": "https://huly.app",
+        "HULY_URL": "https://your-huly-instance.example.com",
         "HULY_EMAIL": "your@email.com",
         "HULY_PASSWORD": "yourpassword",
         "HULY_WORKSPACE": "yourworkspace"
@@ -143,7 +146,7 @@ Open the global configuration file (`~/.config/opencode/opencode.json`) and merg
       "type": "local",
       "command": ["npx", "-y", "@firfi/huly-mcp@latest"],
       "environment": {
-        "HULY_URL": "https://huly.app",
+        "HULY_URL": "https://your-huly-instance.example.com",
         "HULY_EMAIL": "your@email.com",
         "HULY_PASSWORD": "yourpassword",
         "HULY_WORKSPACE": "yourworkspace"
@@ -173,7 +176,7 @@ The `@latest` tag asks the package runner for the newest version. Some MCP clien
 By default, the server uses stdio transport. For HTTP transport (Streamable HTTP):
 
 ```bash
-HULY_URL=https://huly.app \
+HULY_URL=https://your-huly-instance.example.com \
 HULY_EMAIL=your@email.com \
 HULY_PASSWORD=yourpassword \
 HULY_WORKSPACE=yourworkspace \
@@ -235,7 +238,7 @@ For a Smithery publish schema example, see [docs/SMITHERY_URL_PUBLISH.md](docs/S
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `HULY_URL` | Yes | Huly instance URL |
+| `HULY_URL` | Yes | Reachable self-hosted or replacement hosted Huly instance URL |
 | `HULY_EMAIL` | Auth* | Account email |
 | `HULY_PASSWORD` | Auth* | Account password |
 | `HULY_TOKEN` | Auth* | API token (alternative to email/password) |

package/dist/index.cjs

@@ -162617,12 +162617,54 @@ var DocumentReferenceError = class extends Schema_exports.TaggedError()(
   }
 };
 
+// src/domain/schemas/tool-warnings.ts
+var ToolWarningCodeSchema = Schema_exports.Literal(
+  "status_metadata_unresolved",
+  "space_role_assignments_degraded",
+  "message_template_metadata_degraded",
+  "viewlet_descriptor_metadata_degraded",
+  "space_preference_metadata_degraded",
+  "approval_request_person_metadata_degraded",
+  "approval_request_count_metadata_degraded",
+  "hosted_huly_shutdown"
+).annotations({
+  identifier: "ToolWarningCode",
+  title: "ToolWarningCode",
+  description: "Machine-readable code for an agent-visible MCP tool warning."
+});
+var StatusMetadataUnresolvedWarningCode = ToolWarningCodeSchema.literals[0];
+var SpaceRoleAssignmentsDegradedWarningCode = ToolWarningCodeSchema.literals[1];
+var MessageTemplateMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[2];
+var ViewletDescriptorMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[3];
+var SpacePreferenceMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[4];
+var ApprovalRequestPersonMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[5];
+var ApprovalRequestCountMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[6];
+var HostedHulyShutdownWarningCode = ToolWarningCodeSchema.literals[7];
+var ToolWarningSchema = Schema_exports.Struct({
+  code: ToolWarningCodeSchema,
+  message: Schema_exports.Trim.pipe(Schema_exports.nonEmptyString()).annotations({
+    description: "LLM-facing explanation of degraded result fidelity or an important operational condition requiring user action."
+  })
+}).annotations({
+  identifier: "ToolWarning",
+  title: "ToolWarning",
+  description: "Warning surfaced to an agent alongside a tool result without changing whether that tool call succeeded."
+});
+
 // src/huly/unavailable-diagnostics.ts
 var DEFAULT_HULY_CLOUD_ORIGIN = "https://huly.app";
 var HOSTED_HULY_SUNSET = {
-  sourceUrl: "https://github.com/hcengineering/huly",
+  sourceUrl: "https://github.com/hcengineering/platform/blob/develop/README.md",
+  backupRestoreUrl: "https://github.com/hcengineering/platform/blob/develop/docs/guides/backup-restore.en.md",
+  selfHostingUrl: "https://github.com/hcengineering/huly-selfhost",
   expectedShutdown: "July 20"
 };
+var HOSTED_HULY_MIGRATION_LINKS = `Announcement: ${HOSTED_HULY_SUNSET.sourceUrl}. Backup and restore guide: ${HOSTED_HULY_SUNSET.backupRestoreUrl}. Self-hosting: ${HOSTED_HULY_SUNSET.selfHostingUrl}.`;
+var HOSTED_HULY_MIGRATION_INSTRUCTIONS = `Important: Hosted Huly is shutting down. Huly's upstream README says the hosted service is being discontinued because hosting is no longer funded, with shutdown expected ${HOSTED_HULY_SUNSET.expectedShutdown}. If this MCP uses ${DEFAULT_HULY_CLOUD_ORIGIN}, export and back up important data and migrate as soon as possible. ${HOSTED_HULY_MIGRATION_LINKS} Self-hosted deployments are not affected.`;
+var HOSTED_HULY_MIGRATION_WARNING = Schema_exports.decodeUnknownSync(ToolWarningSchema)({
+  code: HostedHulyShutdownWarningCode,
+  message: HOSTED_HULY_MIGRATION_INSTRUCTIONS
+});
 var HulyEndpointOriginSchema = Schema_exports.String.pipe(
   Schema_exports.filter((value3) => {
     try {
@@ -166187,7 +166229,7 @@ var INTERNAL_ERROR_PREFIX = {
 var hulyUnavailableMessage = (error2) => {
   const failureGuidance = error2.failureKind === "timeout" ? " The request timed out; verify HULY_CONNECTION_TIMEOUT before retrying." : error2.failureKind === "dns" || error2.failureKind === "tls" ? " Verify the hostname, certificate, DNS, and proxy configuration before retrying." : "";
   if (isDefaultHulyCloudOrigin(error2.endpointOrigin)) {
-    return `Cannot reach hosted Huly (${error2.endpointOrigin}) from this MCP server. Huly's README announces that hosted Huly is being discontinued, with shutdown expected ${HOSTED_HULY_SUNSET.expectedShutdown}; this outage may be related but is not confirmed. Export and back up your data, then migrate to a hosted alternative or self-hosted Huly. Check network/DNS/proxy access if you need one last connection; set HULY_URL to a reachable self-hosted instance after migration. Do not retry a write until connectivity is restored.${failureGuidance}`;
+    return `Cannot reach hosted Huly (${error2.endpointOrigin}) from this MCP server. Huly's README announces that hosted Huly is being discontinued, with shutdown expected ${HOSTED_HULY_SUNSET.expectedShutdown}; this outage may be related but is not confirmed. Export and back up your data, then migrate to a hosted alternative or self-hosted Huly. ${HOSTED_HULY_MIGRATION_LINKS} Check network/DNS/proxy access if you need one last connection; set HULY_URL to a reachable self-hosted instance after migration. Do not retry a write until connectivity is restored.${failureGuidance}`;
   }
   return `Cannot reach the configured Huly endpoint (${error2.endpointOrigin}). Check with this deployment's operator, then verify HULY_URL, network/DNS/proxy access, and HULY_CONNECTION_TIMEOUT before retrying. Do not retry a write until connectivity is restored.${failureGuidance}`;
 };
@@ -166271,6 +166313,36 @@ var createSuccessResponse = (result, warnings = []) => ({
     result
   }
 });
+var appendWarningContent = (content, warnings, replaceExistingWarningBlock) => {
+  const [first2, ...remaining] = content;
+  const preserved = replaceExistingWarningBlock ? remaining.slice(0, remaining.length - 1) : remaining;
+  return [first2, ...preserved, { type: "text", text: encodeJsonText({ warnings }) }];
+};
+var appendToolWarnings = (response, warnings) => {
+  if (warnings.length === 0) return response;
+  if (response.isError === true) {
+    return {
+      ...response,
+      content: appendWarningContent(response.content, warnings, false)
+    };
+  }
+  if (response.structuredContent === void 0) {
+    return {
+      ...response,
+      content: appendWarningContent(response.content, warnings, false)
+    };
+  }
+  const existingWarnings = response.structuredContent.warnings ?? [];
+  const combinedWarnings = [...existingWarnings, ...warnings];
+  return {
+    ...response,
+    content: appendWarningContent(response.content, combinedWarnings, existingWarnings.length > 0),
+    structuredContent: {
+      result: response.structuredContent.result,
+      warnings: combinedWarnings
+    }
+  };
+};
 var createUnknownToolError = (toolName) => createErrorResponse(`Unknown tool: ${toolName}`, McpErrorCode.InvalidParams, "UnknownTool");
 var createInvalidParamsError = (message, errorTag) => createErrorResponse(message, McpErrorCode.InvalidParams, errorTag);
 var toMcpResponse = (response) => response.isError === true ? {
@@ -166931,38 +167003,6 @@ var StdioServerTransport = class {
 // src/domain/schemas/output-helpers.ts
 var optionalOutput = (schema) => Schema_exports.optionalWith(schema, { exact: true });
 
-// src/domain/schemas/tool-warnings.ts
-var ToolWarningCodeSchema = Schema_exports.Literal(
-  "status_metadata_unresolved",
-  "space_role_assignments_degraded",
-  "message_template_metadata_degraded",
-  "viewlet_descriptor_metadata_degraded",
-  "space_preference_metadata_degraded",
-  "approval_request_person_metadata_degraded",
-  "approval_request_count_metadata_degraded"
-).annotations({
-  identifier: "ToolWarningCode",
-  title: "ToolWarningCode",
-  description: "Machine-readable code for an agent-visible MCP tool warning."
-});
-var StatusMetadataUnresolvedWarningCode = ToolWarningCodeSchema.literals[0];
-var SpaceRoleAssignmentsDegradedWarningCode = ToolWarningCodeSchema.literals[1];
-var MessageTemplateMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[2];
-var ViewletDescriptorMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[3];
-var SpacePreferenceMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[4];
-var ApprovalRequestPersonMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[5];
-var ApprovalRequestCountMetadataDegradedWarningCode = ToolWarningCodeSchema.literals[6];
-var ToolWarningSchema = Schema_exports.Struct({
-  code: ToolWarningCodeSchema,
-  message: Schema_exports.Trim.pipe(Schema_exports.nonEmptyString()).annotations({
-    description: "LLM-facing explanation of what part of the returned tool payload is degraded and how the agent should interpret it."
-  })
-}).annotations({
-  identifier: "ToolWarning",
-  title: "ToolWarning",
-  description: "Warning surfaced to an agent when a tool result is intentionally degraded instead of failing."
-});
-
 // src/domain/schemas/document-native-references.ts
 var HULY_NATIVE_REFERENCE_MARKDOWN_INPUT = "Markdown links to current-workspace Huly browse URLs with _class, _id, and label become native Huly references; external URLs and other-workspace browse URLs stay normal links.";
 var DOCUMENT_NATIVE_REFERENCE_LINK_USAGE = "Use markdown links to current-workspace Huly browse URLs for native references; Huly browse links returned in get_document content round-trip as native references. The URL identifies the object; link text is display text; plain issue keys stay text.";
@@ -178444,7 +178484,7 @@ var parseDeleteDriveFileCommentParams = Schema_exports.decodeUnknown(DeleteDrive
 var parseListDriveFileActivityParams = Schema_exports.decodeUnknown(ListDriveFileActivityParamsSchema);
 
 // src/version.ts
-var VERSION = true ? "0.44.5" : "0.0.0-dev";
+var VERSION = true ? "0.44.7" : "0.0.0-dev";
 
 // src/mcp/json-schema-refs.ts
 var isJsonObject = (value3) => typeof value3 === "object" && value3 !== null && !Array.isArray(value3);
@@ -178489,7 +178529,7 @@ var stripCollidingSchemaIdsProperties = (properties) => Object.fromEntries(
 var toolWarningCodeEnum = [...ToolWarningCodeSchema.literals];
 var warningOutputSchema = {
   type: "array",
-  description: "Optional agent-visible warnings about degraded result fidelity. Omitted when the server returned the documented happy-path payload.",
+  description: "Optional agent-visible warnings about degraded result fidelity or important operational conditions. Omitted when there is nothing the agent needs to surface.",
   items: {
     type: "object",
     properties: {
@@ -206783,7 +206823,61 @@ var toListedHulyTool = (tool) => toListedTool({
   annotations: resolveAnnotations(tool)
 });
 
+// src/mcp/tool-call-notices.ts
+var noNoticeClaim = { _tag: "None" };
+var noToolCallNoticeProvider = {
+  claim: () => noNoticeClaim
+};
+var isHostedHulyOrigin = (origin) => origin !== void 0 && isDefaultHulyCloudOrigin(normalizeHulyOrigin(origin));
+var hostedHulyMigrationInstructionsForOrigin = (origin) => isHostedHulyOrigin(origin) ? HOSTED_HULY_MIGRATION_INSTRUCTIONS : void 0;
+var alwaysNoticeProvider = () => ({
+  claim: () => ({
+    _tag: "Claimed",
+    warning: HOSTED_HULY_MIGRATION_WARNING,
+    delivered: () => {
+    },
+    release: () => {
+    }
+  })
+});
+var onceNoticeProvider = () => {
+  let state = "pending";
+  return {
+    claim: () => {
+      if (state !== "pending") return noNoticeClaim;
+      state = "claimed";
+      return {
+        _tag: "Claimed",
+        warning: HOSTED_HULY_MIGRATION_WARNING,
+        delivered: () => {
+          if (state === "claimed") state = "delivered";
+        },
+        release: () => {
+          if (state === "claimed") state = "pending";
+        }
+      };
+    }
+  };
+};
+var createHostedHulyMigrationNoticeProvider = (config3) => {
+  if (hostedHulyMigrationInstructionsForOrigin(config3.hulyOrigin) === void 0) return noToolCallNoticeProvider;
+  return config3.delivery === "always" ? alwaysNoticeProvider() : onceNoticeProvider();
+};
+
 // src/mcp/protocol-handlers.ts
+var ServerDiscoverResultSchema = Schema_exports.Struct({
+  resultType: Schema_exports.Literal("complete"),
+  supportedVersions: Schema_exports.Tuple(Schema_exports.Literal("2026-07-28")),
+  capabilities: Schema_exports.Struct({
+    tools: Schema_exports.Struct({}),
+    resources: Schema_exports.Struct({})
+  }),
+  serverInfo: Schema_exports.Struct({
+    name: Schema_exports.Literal("huly-mcp"),
+    version: Schema_exports.String
+  }),
+  instructions: Schema_exports.optionalWith(Schema_exports.Literal(HOSTED_HULY_MIGRATION_INSTRUCTIONS), { exact: true })
+});
 var DRAIN_POLL_MS = 50;
 var DRAIN_TIMEOUT_MS2 = 3e4;
 var NPM_FETCH_TIMEOUT_MS = 5e3;
@@ -206798,6 +206892,7 @@ var deriveEditMode = (name, args2) => {
 };
 var validateHulyContextResult = (value3) => Schema_exports.decodeUnknownSync(GetHulyContextResultSchema)(value3);
 var validateVersionToolResult = (value3) => Schema_exports.decodeUnknownSync(VersionToolResultSchema)(value3);
+var parseServerDiscoverResult = (value3) => Schema_exports.decodeUnknownSync(ServerDiscoverResultSchema)(value3);
 var liveNowClock = {
   currentTimeMillis: () => Effect_exports.runSync(Clock_exports.currentTimeMillis)
 };
@@ -206834,7 +206929,7 @@ var invokeToolEditMode = (args2) => {
   const decoded = Schema_exports.decodeUnknownEither(InvokeToolParamsSchema)(args2);
   return decoded._tag === "Right" ? deriveEditMode(decoded.right.toolName, decoded.right.arguments) : void 0;
 };
-var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyContext, clock3 = liveNowClock, fetchLatestVersion = fetchLatestNpmVersion, exposureOptions = {}) => {
+var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyContext, clock3 = liveNowClock, fetchLatestVersion = fetchLatestNpmVersion, exposureOptions = {}, toolCallNoticeProvider = noToolCallNoticeProvider, serverInstructions) => {
   const registries = normalizeRegistries(registry2);
   const defaults = defaultExposureOptions();
   const protocolExposureOptions = {
@@ -206866,25 +206961,33 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
   };
   const callTool = async (request3) => {
     enter();
+    const noticeClaim = toolCallNoticeProvider.claim();
     try {
       const { arguments: args2, name } = request3.params;
       const exposure = resolveProtocolExposure(registries, protocolExposureOptions);
       const start3 = clock3.currentTimeMillis();
       const inputBytes = JSON.stringify(args2 ?? {}).length;
+      const withClaimedNotice = (response2) => {
+        if (noticeClaim._tag === "None") return response2;
+        const responseWithNotice2 = appendToolWarnings(response2, [noticeClaim.warning]);
+        noticeClaim.delivered();
+        return responseWithNotice2;
+      };
       const returnError = (errorResponse, editMode2) => {
+        const responseWithNotice2 = withClaimedNotice(errorResponse);
         const durationMs2 = clock3.currentTimeMillis() - start3;
         telemetry.toolCalled({
           toolName: name,
           status: "error",
           clientKind: exposure.context.clientKind,
           resolvedMode: exposure.context.resolvedMode,
-          errorTag: errorResponse._meta?.errorTag,
+          errorTag: responseWithNotice2._meta?.errorTag,
           durationMs: durationMs2,
           inputBytes,
-          outputBytes: computeOutputBytes(errorResponse),
+          outputBytes: computeOutputBytes(responseWithNotice2),
           editMode: editMode2
         });
-        return toMcpResponse(errorResponse);
+        return toMcpResponse(responseWithNotice2);
       };
       if (name === VERSION_TOOL_NAME) {
         if (!isEmptyArgumentsObject(args2)) return returnError(createUnexpectedArgumentsError(VERSION_TOOL_NAME));
@@ -206895,7 +206998,7 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
         } catch {
           return returnError(mapDomainErrorToMcp(new HulyError({ message: "Failed to build version result" })));
         }
-        const versionResponse = createSuccessResponse(versionResult);
+        const versionResponse = withClaimedNotice(createSuccessResponse(versionResult));
         const durationMs2 = clock3.currentTimeMillis() - start3;
         telemetry.toolCalled({
           toolName: name,
@@ -206918,7 +207021,7 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
         } catch {
           return returnError(mapDomainErrorToMcp(new HulyError({ message: "Failed to build Huly context" })));
         }
-        const contextResponse = createSuccessResponse(context6);
+        const contextResponse = withClaimedNotice(createSuccessResponse(context6));
         const durationMs2 = clock3.currentTimeMillis() - start3;
         telemetry.toolCalled({
           toolName: name,
@@ -206955,19 +207058,20 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
             }
           }
         });
+        const responseWithNotice2 = withClaimedNotice(response2);
         const durationMs2 = clock3.currentTimeMillis() - start3;
         telemetry.toolCalled({
           toolName: name,
-          status: response2.isError === true ? "error" : "success",
+          status: responseWithNotice2.isError === true ? "error" : "success",
           clientKind: exposure.context.clientKind,
           resolvedMode: exposure.context.resolvedMode,
-          errorTag: response2._meta?.errorTag,
+          errorTag: responseWithNotice2._meta?.errorTag,
           durationMs: durationMs2,
           inputBytes,
-          outputBytes: computeOutputBytes(response2),
+          outputBytes: computeOutputBytes(responseWithNotice2),
           editMode: editMode2
         });
-        return toMcpResponse(response2);
+        return toMcpResponse(responseWithNotice2);
       }
       const hulyToolName = parseToolName(name);
       if (hulyToolName === void 0) return returnError(createUnknownToolError(name));
@@ -206997,18 +207101,22 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
       );
       const durationMs = clock3.currentTimeMillis() - start3;
       if (response === null) return returnError(createUnknownToolError(name), editMode);
+      const responseWithNotice = withClaimedNotice(response);
       telemetry.toolCalled({
         toolName: hulyToolName,
-        status: response.isError === true ? "error" : "success",
+        status: responseWithNotice.isError === true ? "error" : "success",
         clientKind: exposure.context.clientKind,
         resolvedMode: exposure.context.resolvedMode,
-        errorTag: response._meta?.errorTag,
+        errorTag: responseWithNotice._meta?.errorTag,
         durationMs,
         inputBytes,
-        outputBytes: computeOutputBytes(response),
+        outputBytes: computeOutputBytes(responseWithNotice),
         editMode
       });
-      return toMcpResponse(response);
+      return toMcpResponse(responseWithNotice);
+    } catch (error2) {
+      if (noticeClaim._tag === "Claimed") noticeClaim.release();
+      throw error2;
     } finally {
       leave();
     }
@@ -207020,11 +207128,12 @@ var createMcpProtocolHandlers = (resolveClients, telemetry, registry2, getHulyCo
     listResources: resourceHandlers.listResources,
     listResourceTemplates,
     readResource: resourceHandlers.readResource,
-    serverDiscover: () => ({
+    serverDiscover: () => parseServerDiscoverResult({
       resultType: "complete",
       supportedVersions: ["2026-07-28"],
       capabilities: { tools: {}, resources: {} },
-      serverInfo: { name: "huly-mcp", version: VERSION }
+      serverInfo: { name: "huly-mcp", version: VERSION },
+      ...serverInstructions === void 0 ? {} : { instructions: serverInstructions }
     }),
     drainInflight
   };
@@ -212649,7 +212758,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/sdk-server.ts
-var createDefaultMcpSdkServer = () => new Server(
+var createDefaultMcpSdkServer = (instructions) => new Server(
   {
     name: "huly-mcp",
     version: VERSION
@@ -212658,7 +212767,8 @@ var createDefaultMcpSdkServer = () => new Server(
     capabilities: {
       resources: {},
       tools: {}
-    }
+    },
+    ...instructions === void 0 ? {} : { instructions }
   }
 );
 
@@ -212667,8 +212777,8 @@ var currentClientInfoFromServer = (server) => {
   const maybeServer = server;
   return parseMcpClientInfo(maybeServer.getClientVersion?.());
 };
-var createMcpServer = (resolveClients, telemetry, registry2, getHulyContext, createServer = createDefaultMcpSdkServer, exposureOptions = {}) => {
-  const server = createServer();
+var createMcpServer = (resolveClients, telemetry, registry2, getHulyContext, createServer = createDefaultMcpSdkServer, exposureOptions = {}, toolCallNoticeProvider = noToolCallNoticeProvider, serverInstructions) => {
+  const server = createServer(serverInstructions);
   const currentClientInfo = () => exposureOptions.currentClientInfo?.() ?? currentClientInfoFromServer(server);
   const handlers = createMcpProtocolHandlers(
     resolveClients,
@@ -212680,7 +212790,9 @@ var createMcpServer = (resolveClients, telemetry, registry2, getHulyContext, cre
     {
       ...exposureOptions,
       currentClientInfo
-    }
+    },
+    toolCallNoticeProvider,
+    serverInstructions
   );
   server.setRequestHandler(ListToolsRequestSchema, handlers.listTools);
   server.setRequestHandler(CallToolRequestSchema, handlers.callTool);
@@ -216743,13 +216855,19 @@ var McpServerService = class _McpServerService extends Context_exports.Tag("@hul
             }
             yield* Ref_exports.set(isRunning2, true);
             if (config3.transport === "stdio") {
+              const stdioRuntimeConfig = getRuntimeConfigContext();
               const [stdioServer, drainInflight] = createMcpServer(
                 config3.resolveClients,
                 telemetry,
                 registries,
-                (toolExposure) => getHulyContext(getRuntimeConfigContext(), toolExposure),
+                (toolExposure) => getHulyContext(stdioRuntimeConfig, toolExposure),
                 config3.createServer,
-                sdkExposureOptions
+                sdkExposureOptions,
+                createHostedHulyMigrationNoticeProvider({
+                  delivery: "once",
+                  hulyOrigin: stdioRuntimeConfig.huly.url.origin
+                }),
+                hostedHulyMigrationInstructionsForOrigin(stdioRuntimeConfig.huly.url.origin)
               );
               yield* Ref_exports.set(serverRef, stdioServer);
               const transport = config3.createStdioTransport?.() ?? new StdioServerTransport();
@@ -216809,7 +216927,12 @@ var McpServerService = class _McpServerService extends Context_exports.Tag("@hul
                     registries,
                     (toolExposure) => getHulyContext(requestRuntimeConfig, toolExposure),
                     config3.createServer,
-                    requestExposureOptions(() => clientInfoFromLegacyHttpRequest(req))
+                    requestExposureOptions(() => clientInfoFromLegacyHttpRequest(req)),
+                    createHostedHulyMigrationNoticeProvider({
+                      delivery: "always",
+                      hulyOrigin: requestRuntimeConfig.huly.url.origin
+                    }),
+                    hostedHulyMigrationInstructionsForOrigin(requestRuntimeConfig.huly.url.origin)
                   )[0];
                 },
                 config3.httpTransportDependencies,
@@ -216822,7 +216945,12 @@ var McpServerService = class _McpServerService extends Context_exports.Tag("@hul
                     (toolExposure) => getHulyContext(requestRuntimeConfig, toolExposure),
                     void 0,
                     void 0,
-                    requestExposureOptions(() => clientInfoFromMcp2026Request(req))
+                    requestExposureOptions(() => clientInfoFromMcp2026Request(req)),
+                    createHostedHulyMigrationNoticeProvider({
+                      delivery: "always",
+                      hulyOrigin: requestRuntimeConfig.huly.url.origin
+                    }),
+                    hostedHulyMigrationInstructionsForOrigin(requestRuntimeConfig.huly.url.origin)
                   );
                 }
               ).pipe(

package/package.json

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