[gchat] [bug] render markdown links with proper Google Chat custom link syntax

.changeset/gchat-link-labels.md

@@ -0,0 +1,5 @@
+---
+"@chat-adapter/gchat": patch
+---
+
+Preserve custom link labels in Google Chat text messages by rendering Markdown links with Google Chat's supported `<url|text>` syntax.

packages/adapter-gchat/src/markdown.test.ts

@@ -43,10 +43,10 @@ describe("GoogleChatFormatConverter", () => {
       expect(result).toContain("https://example.com");
     });
 
-    it("should output 'text (url)' when link text differs", () => {
+    it("should output Google Chat custom link syntax when link text differs", () => {
       const ast = converter.toAst("[click here](https://example.com)");
       const result = converter.fromAst(ast);
-      expect(result).toContain("click here (https://example.com)");
+      expect(result).toContain("<https://example.com|click here>");
     });
 
     it("should handle blockquotes", () => {

packages/adapter-gchat/src/markdown.ts

@@ -106,16 +106,14 @@ export class GoogleChatFormatConverter extends BaseFormatConverter {
     }
 
     if (isLinkNode(node)) {
-      // Google Chat auto-detects links, so we just output the URL
+      // Google Chat supports custom link labels using <url|text> syntax.
       const linkText = getNodeChildren(node)
         .map((child) => this.nodeToGChat(child))
         .join("");
-      // If link text matches URL, just output URL
       if (linkText === node.url) {
         return node.url;
       }
-      // Otherwise output "text (url)"
-      return `${linkText} (${node.url})`;
+      return `<${node.url}|${linkText}>`;
     }
 
     if (isBlockquoteNode(node)) {

packages/integration-tests/src/gchat.test.ts

@@ -415,6 +415,32 @@ describe("Google Chat Integration", () => {
       expect(sent.text).toContain("`code`");
     });
 
+    it("should preserve custom link labels in posted messages", async () => {
+      chat.onNewMention(async (thread) => {
+        await thread.post({
+          markdown: "[Click here](https://example.com)",
+        });
+      });
+
+      const event = createGoogleChatEvent({
+        text: `@${GCHAT_BOT_NAME} link test`,
+        messageName: `${TEST_SPACE_NAME}/messages/msg-001`,
+        spaceName: TEST_SPACE_NAME,
+        threadName: TEST_THREAD_NAME,
+        senderId: "users/user-123",
+        senderName: "John Doe",
+        hasBotMention: true,
+      });
+
+      await chat.webhooks.gchat(createGoogleChatWebhookRequest(event), {
+        waitUntil: tracker.waitUntil,
+      });
+      await tracker.waitForAll();
+
+      const sent = mockChatApi.sentMessages[0];
+      expect(sent.text).toBe("<https://example.com|Click here>");
+    });
+
     it("should pass @mentions through as-is in posted messages", async () => {
       chat.onNewMention(async (thread) => {
         await thread.post("Hey @john, check this out!");