@firfi/huly-mcp 0.7.0 → 0.8.0

package/README.md

@@ -222,10 +222,10 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | `create_teamspace` | Create a new Huly document teamspace. Idempotent: returns existing teamspace if one with the same name exists. |
 | `update_teamspace` | Update fields on an existing Huly document teamspace. Only provided fields are modified. Set description to null to clear it. |
 | `delete_teamspace` | Permanently delete a Huly document teamspace. This action cannot be undone. |
-| `list_documents` | List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Supports searching by title substring (titleSearch) and content (contentSearch). |
-| `get_document` | Retrieve full details for a Huly document including markdown content. Use this to view document content and metadata. |
-| `create_document` | Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id. Use link_document_to_issue to associate the document with a tracker issue. |
-| `edit_document` | Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams. |
+| `list_documents` | List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Each result includes a 'url' field pointing to the document in the Huly web app. Supports searching by title substring (titleSearch) and content (contentSearch). |
+| `get_document` | Retrieve full details for a Huly document including markdown content and a 'url' field pointing to the document in the Huly web app. Use this to view document content and metadata. |
+| `create_document` | Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id and a 'url' field pointing to the document in the Huly web app. Use link_document_to_issue to associate the document with a tracker issue. |
+| `edit_document` | Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams. Returns a 'url' field pointing to the document in the Huly web app. |
 | `list_inline_comments` | List inline comment threads from a Huly document. Extracts comments embedded in document content as ProseMirror marks. Each comment includes the highlighted text and thread ID. Set includeReplies=true to also fetch thread reply messages with sender names. |
 | `delete_document` | Permanently delete a Huly document. This action cannot be undone. |
 
@@ -282,6 +282,8 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | `delete_channel` | Permanently delete a Huly channel. This action cannot be undone. |
 | `list_channel_messages` | List messages in a Huly channel. Returns messages sorted by date (newest first). |
 | `send_channel_message` | Send a message to a Huly channel. Message body supports markdown formatting. |
+| `update_channel_message` | Update a channel message. Only the body can be modified. |
+| `delete_channel_message` | Permanently delete a channel message. This action cannot be undone. |
 | `list_direct_messages` | List direct message conversations in Huly. Returns conversations sorted by date (newest first). |
 | `list_thread_replies` | List replies in a message thread. Returns replies sorted by date (oldest first). |
 | `add_thread_reply` | Add a reply to a message thread. Reply body supports markdown formatting. |

package/dist/index.cjs

@@ -82791,7 +82791,7 @@ var require_client6 = __commonJS({
     var import_core48 = require_lib4();
     var import_platform2 = require_lib();
     var import_config8 = require_config();
-    var import_markup9 = require_markup();
+    var import_markup10 = require_markup();
     var import_utils14 = require_utils9();
     async function connect(url4, options) {
       const config3 = await (0, import_config8.loadServerConfig)(url4);
@@ -82832,7 +82832,7 @@ var require_client6 = __commonJS({
         this.connection = connection;
         this.account = account;
         this.client = new import_core48.TxOperations(connection, account.primarySocialId);
-        this.markup = (0, import_markup9.createMarkupOperations)(url4, workspace, token, config3);
+        this.markup = (0, import_markup10.createMarkupOperations)(url4, workspace, token, config3);
       }
       static {
         __name(this, "PlatformClientImpl");
@@ -82861,7 +82861,7 @@ var require_client6 = __commonJS({
       async processMarkup(_class, id, data) {
         const result = {};
         for (const [key, value3] of Object.entries(data)) {
-          if (value3 instanceof import_markup9.MarkupContent) {
+          if (value3 instanceof import_markup10.MarkupContent) {
             result[key] = this.markup.uploadMarkup(_class, id, key, value3.content, value3.kind);
           } else {
             result[key] = value3;
@@ -150609,6 +150609,7 @@ var NotificationProviderId = NonEmptyString2.pipe(Schema_exports.brand("Notifica
 var NotificationTypeId = NonEmptyString2.pipe(Schema_exports.brand("NotificationTypeId"));
 var WorkspaceName = NonEmptyString2.pipe(Schema_exports.brand("WorkspaceName"));
 var UrlString = NonEmptyString2.pipe(Schema_exports.brand("UrlString"));
+var WorkspaceUrlSlug = NonEmptyString2.pipe(Schema_exports.brand("WorkspaceUrlSlug"));
 var WorkspaceVersion = NonEmptyString2.pipe(Schema_exports.brand("WorkspaceVersion"));
 var WorkspaceMode = NonEmptyString2.pipe(Schema_exports.brand("WorkspaceMode"));
 var WorkspaceUuid = NonEmptyString2.pipe(Schema_exports.brand("WorkspaceUuid"));
@@ -151501,7 +151502,7 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
     _HulyClient,
     Effect_exports.gen(function* () {
       const config3 = yield* HulyConfigService;
-      const { accountUuid, client, imageUrl, markupOps, refUrl } = yield* connectRestWithRetry({
+      const { accountUuid, client, imageUrl, markupOps, refUrl, workspaceUrlSlug } = yield* connectRestWithRetry({
         url: config3.url,
         auth: config3.auth,
         workspace: config3.workspace
@@ -151510,6 +151511,10 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
         refUrl: UrlString.make(refUrl),
         imageUrl: UrlString.make(imageUrl)
       };
+      const documentUrlConfig = {
+        baseUrl: UrlString.make(config3.url),
+        workspaceUrlSlug
+      };
       const withClient = (op, errorMsg) => Effect_exports.tryPromise({
         try: () => op(client),
         catch: (e) => new HulyConnectionError({
@@ -151519,6 +151524,7 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       });
       const operations = {
         getAccountUuid: () => accountUuid,
+        documentUrlConfig,
         markupUrlConfig,
         findAll: (_class, query, options) => withClient(
           (client2) => client2.findAll(_class, query, options),
@@ -151598,6 +151604,10 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       // AccountUuid is a double-branded string type with no public constructor
       // eslint-disable-next-line no-restricted-syntax -- see above
       getAccountUuid: () => "test-account-uuid",
+      documentUrlConfig: {
+        baseUrl: UrlString.make("https://test.huly.local"),
+        workspaceUrlSlug: WorkspaceUrlSlug.make("test-workspace")
+      },
       markupUrlConfig: testMarkupUrlConfig,
       findAll: noopFindAll,
       findOne: noopFindOne,
@@ -151642,7 +151652,7 @@ function createMarkupOps(url4, workspace, token, collaboratorUrl) {
 var connectRest = async (config3) => {
   const serverConfig = await (0, import_api_client.loadServerConfig)(config3.url);
   const authOptions = authToOptions(config3.auth, config3.workspace);
-  const { endpoint, token, workspaceId } = await (0, import_api_client.getWorkspaceToken)(
+  const { endpoint, info, token, workspaceId } = await (0, import_api_client.getWorkspaceToken)(
     config3.url,
     authOptions,
     serverConfig
@@ -151656,7 +151666,14 @@ var connectRest = async (config3) => {
     token,
     serverConfig.COLLABORATOR_URL
   );
-  return { client, accountUuid: account.uuid, markupOps, refUrl, imageUrl };
+  return {
+    client,
+    accountUuid: account.uuid,
+    workspaceUrlSlug: WorkspaceUrlSlug.make(info.workspaceUrl),
+    markupOps,
+    refUrl,
+    imageUrl
+  };
 };
 var connectRestWithRetry = (config3) => connectWithRetry(() => connectRest(config3), "Connection failed");
 
@@ -172329,6 +172346,22 @@ var import_core24 = __toESM(require_lib4(), 1);
 var import_core23 = __toESM(require_lib4(), 1);
 var import_rank = __toESM(require_lib32(), 1);
 
+// src/huly/url-builders.ts
+var slugifyTitle = (title) => {
+  const lowered = title.toLowerCase();
+  const stripped = lowered.replace(/[^a-z0-9.\-\s]/g, "");
+  const hyphenated = stripped.replace(/\s+/g, "-");
+  const collapsed = hyphenated.replace(/-+/g, "-");
+  return collapsed.replace(/^-+|-+$/g, "");
+};
+var buildDocumentUrl = (baseUrl, workspaceUrlSlug, title, id) => {
+  const trimmedBase = baseUrl.replace(/\/+$/, "");
+  const slug = slugifyTitle(title);
+  const pathSegment = slug === "" ? id : `${slug}-${id}`;
+  return UrlString.make(`${trimmedBase}/workbench/${workspaceUrlSlug}/document/${pathSegment}`);
+};
+var buildDocumentUrlFromConfig = (config3, title, id) => buildDocumentUrl(config3.baseUrl, config3.workspaceUrlSlug, title, id);
+
 // src/huly/operations/documents-edit.ts
 var editDocument = (params) => Effect_exports.gen(function* () {
   const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
@@ -172392,8 +172425,10 @@ var editDocument = (params) => Effect_exports.gen(function* () {
     );
     contentUpdatedInPlace = true;
   }
+  const finalTitle = updateOps.title ?? doc.title;
+  const url4 = buildDocumentUrlFromConfig(client.documentUrlConfig, finalTitle, DocumentId.make(doc._id));
   if (Object.keys(updateOps).length === 0 && !contentUpdatedInPlace) {
-    return { id: DocumentId.make(doc._id), updated: false };
+    return { id: DocumentId.make(doc._id), updated: false, url: url4 };
   }
   if (Object.keys(updateOps).length > 0) {
     yield* client.updateDoc(
@@ -172403,7 +172438,7 @@ var editDocument = (params) => Effect_exports.gen(function* () {
       updateOps
     );
   }
-  return { id: DocumentId.make(doc._id), updated: true };
+  return { id: DocumentId.make(doc._id), updated: true, url: url4 };
 });
 var countOccurrences = (text, search) => {
   let count3 = 0;
@@ -172421,6 +172456,55 @@ var import_text3 = __toESM(require_lib9(), 1);
 
 // src/huly/operations/channels.ts
 var import_core21 = __toESM(require_lib4(), 1);
+
+// src/huly/operations/channel-messages-shared.ts
+var findChannelMessage = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  const message = yield* client.findOne(
+    chunter.class.ChatMessage,
+    {
+      _id: toRef(params.messageId),
+      space: channel._id
+    }
+  );
+  if (message === void 0) {
+    return yield* new MessageNotFoundError({
+      messageId: params.messageId,
+      channel: params.channel
+    });
+  }
+  return { client, channel, message };
+});
+
+// src/huly/operations/channels-messages.ts
+var updateChannelMessage = (params) => Effect_exports.gen(function* () {
+  const { channel, client, message } = yield* findChannelMessage(params);
+  const markupUrlConfig = client.markupUrlConfig;
+  const markup = markdownToMarkupString(params.body, markupUrlConfig);
+  const now2 = yield* Clock_exports.currentTimeMillis;
+  const updateOps = {
+    message: markup,
+    editedOn: now2
+  };
+  yield* client.updateDoc(
+    chunter.class.ChatMessage,
+    channel._id,
+    message._id,
+    updateOps
+  );
+  return { id: MessageId.make(message._id), updated: true };
+});
+var deleteChannelMessage = (params) => Effect_exports.gen(function* () {
+  const { channel, client, message } = yield* findChannelMessage(params);
+  yield* client.removeDoc(
+    chunter.class.ChatMessage,
+    channel._id,
+    message._id
+  );
+  return { id: MessageId.make(message._id), deleted: true };
+});
+
+// src/huly/operations/channels.ts
 var personIdsAsSocialIdentityRefs = (ids3) => ids3;
 var findChannel = (identifier2) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
@@ -172939,6 +173023,7 @@ var listDocuments = (params) => Effect_exports.gen(function* () {
     id: DocumentId.make(doc._id),
     title: doc.title,
     teamspace: teamspace.name,
+    url: buildDocumentUrlFromConfig(client.documentUrlConfig, doc.title, DocumentId.make(doc._id)),
     modifiedOn: doc.modifiedOn
   }));
   return {
@@ -172963,6 +173048,7 @@ var getDocument = (params) => Effect_exports.gen(function* () {
     title: doc.title,
     content,
     teamspace: teamspace.name,
+    url: buildDocumentUrlFromConfig(client.documentUrlConfig, doc.title, DocumentId.make(doc._id)),
     modifiedOn: doc.modifiedOn,
     createdOn: doc.createdOn
   };
@@ -173012,7 +173098,11 @@ var createDocument = (params) => Effect_exports.gen(function* () {
     documentData,
     documentId
   );
-  return { id: DocumentId.make(documentId), title: params.title };
+  return {
+    id: DocumentId.make(documentId),
+    title: params.title,
+    url: buildDocumentUrlFromConfig(client.documentUrlConfig, params.title, DocumentId.make(documentId))
+  };
 });
 var deleteDocument = (params) => Effect_exports.gen(function* () {
   const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
@@ -176044,6 +176134,31 @@ var SendChannelMessageParamsSchema = Schema_exports.Struct({
   title: "SendChannelMessageParams",
   description: "Parameters for sending a message to a channel"
 });
+var UpdateChannelMessageParamsSchema = Schema_exports.Struct({
+  channel: ChannelIdentifier.annotations({
+    description: "Channel name or ID"
+  }),
+  messageId: MessageId.annotations({
+    description: "Message ID to update"
+  }),
+  body: NonEmptyString2.annotations({
+    description: "New message body (markdown supported)"
+  })
+}).annotations({
+  title: "UpdateChannelMessageParams",
+  description: "Parameters for updating a channel message"
+});
+var DeleteChannelMessageParamsSchema = Schema_exports.Struct({
+  channel: ChannelIdentifier.annotations({
+    description: "Channel name or ID"
+  }),
+  messageId: MessageId.annotations({
+    description: "Message ID to delete"
+  })
+}).annotations({
+  title: "DeleteChannelMessageParams",
+  description: "Parameters for deleting a channel message"
+});
 var ListDirectMessagesParamsSchema = Schema_exports.Struct({
   limit: Schema_exports.optional(
     LimitParam.annotations({
@@ -176122,6 +176237,8 @@ var updateChannelParamsJsonSchema = JSONSchema_exports.make(UpdateChannelParamsS
 var deleteChannelParamsJsonSchema = JSONSchema_exports.make(DeleteChannelParamsSchema);
 var listChannelMessagesParamsJsonSchema = JSONSchema_exports.make(ListChannelMessagesParamsSchema);
 var sendChannelMessageParamsJsonSchema = JSONSchema_exports.make(SendChannelMessageParamsSchema);
+var updateChannelMessageParamsJsonSchema = JSONSchema_exports.make(UpdateChannelMessageParamsSchema);
+var deleteChannelMessageParamsJsonSchema = JSONSchema_exports.make(DeleteChannelMessageParamsSchema);
 var listDirectMessagesParamsJsonSchema = JSONSchema_exports.make(ListDirectMessagesParamsSchema);
 var listThreadRepliesParamsJsonSchema = JSONSchema_exports.make(ListThreadRepliesParamsSchema);
 var addThreadReplyParamsJsonSchema = JSONSchema_exports.make(AddThreadReplyParamsSchema);
@@ -176134,6 +176251,8 @@ var parseUpdateChannelParams = Schema_exports.decodeUnknown(UpdateChannelParamsS
 var parseDeleteChannelParams = Schema_exports.decodeUnknown(DeleteChannelParamsSchema);
 var parseListChannelMessagesParams = Schema_exports.decodeUnknown(ListChannelMessagesParamsSchema);
 var parseSendChannelMessageParams = Schema_exports.decodeUnknown(SendChannelMessageParamsSchema);
+var parseUpdateChannelMessageParams = Schema_exports.decodeUnknown(UpdateChannelMessageParamsSchema);
+var parseDeleteChannelMessageParams = Schema_exports.decodeUnknown(DeleteChannelMessageParamsSchema);
 var parseListDirectMessagesParams = Schema_exports.decodeUnknown(ListDirectMessagesParamsSchema);
 var parseListThreadRepliesParams = Schema_exports.decodeUnknown(ListThreadRepliesParamsSchema);
 var parseAddThreadReplyParams = Schema_exports.decodeUnknown(AddThreadReplyParamsSchema);
@@ -177564,20 +177683,6 @@ var cardTools = [
 
 // src/huly/operations/threads.ts
 var import_core28 = __toESM(require_lib4(), 1);
-var findMessage = (channelIdentifier, messageId) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(channelIdentifier);
-  const message = yield* client.findOne(
-    chunter.class.ChatMessage,
-    {
-      _id: toRef(messageId),
-      space: channel._id
-    }
-  );
-  if (message === void 0) {
-    return yield* new MessageNotFoundError({ messageId, channel: channelIdentifier });
-  }
-  return { client, channel, message };
-});
 var findReply = (client, channel, message, replyId) => Effect_exports.gen(function* () {
   const reply = yield* client.findOne(
     chunter.class.ThreadMessage,
@@ -177596,7 +177701,7 @@ var findReply = (client, channel, message, replyId) => Effect_exports.gen(functi
   return reply;
 });
 var listThreadReplies = (params) => Effect_exports.gen(function* () {
-  const { channel, client, message } = yield* findMessage(params.channel, params.messageId);
+  const { channel, client, message } = yield* findChannelMessage(params);
   const markupUrlConfig = client.markupUrlConfig;
   const limit = Math.min(params.limit ?? 50, 200);
   const replies = yield* client.findAll(
@@ -177634,7 +177739,7 @@ var listThreadReplies = (params) => Effect_exports.gen(function* () {
   return { replies: threadMessages, total };
 });
 var addThreadReply = (params) => Effect_exports.gen(function* () {
-  const { channel, client, message } = yield* findMessage(params.channel, params.messageId);
+  const { channel, client, message } = yield* findChannelMessage(params);
   const markupUrlConfig = client.markupUrlConfig;
   const replyId = (0, import_core28.generateId)();
   const markup = markdownToMarkupString(params.body, markupUrlConfig);
@@ -177660,7 +177765,7 @@ var addThreadReply = (params) => Effect_exports.gen(function* () {
   };
 });
 var updateThreadReply = (params) => Effect_exports.gen(function* () {
-  const { channel, client, message } = yield* findMessage(params.channel, params.messageId);
+  const { channel, client, message } = yield* findChannelMessage(params);
   const reply = yield* findReply(client, channel, message, params.replyId);
   const markupUrlConfig = client.markupUrlConfig;
   const markup = markdownToMarkupString(params.body, markupUrlConfig);
@@ -177678,7 +177783,7 @@ var updateThreadReply = (params) => Effect_exports.gen(function* () {
   return { id: ThreadReplyId.make(reply._id), updated: true };
 });
 var deleteThreadReply = (params) => Effect_exports.gen(function* () {
-  const { channel, client, message } = yield* findMessage(params.channel, params.messageId);
+  const { channel, client, message } = yield* findChannelMessage(params);
   const reply = yield* findReply(client, channel, message, params.replyId);
   yield* client.removeDoc(
     chunter.class.ThreadMessage,
@@ -177768,6 +177873,28 @@ var channelTools = [
       sendChannelMessage
     )
   },
+  {
+    name: "update_channel_message",
+    description: "Update a channel message. Only the body can be modified.",
+    category: CATEGORY5,
+    inputSchema: updateChannelMessageParamsJsonSchema,
+    handler: createToolHandler(
+      "update_channel_message",
+      parseUpdateChannelMessageParams,
+      updateChannelMessage
+    )
+  },
+  {
+    name: "delete_channel_message",
+    description: "Permanently delete a channel message. This action cannot be undone.",
+    category: CATEGORY5,
+    inputSchema: deleteChannelMessageParamsJsonSchema,
+    handler: createToolHandler(
+      "delete_channel_message",
+      parseDeleteChannelMessageParams,
+      deleteChannelMessage
+    )
+  },
   {
     name: "list_direct_messages",
     description: "List direct message conversations in Huly. Returns conversations sorted by date (newest first).",
@@ -179407,7 +179534,7 @@ var documentTools = [
   },
   {
     name: "list_documents",
-    description: "List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Supports searching by title substring (titleSearch) and content (contentSearch).",
+    description: "List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Each result includes a 'url' field pointing to the document in the Huly web app. Supports searching by title substring (titleSearch) and content (contentSearch).",
     category: CATEGORY10,
     inputSchema: listDocumentsParamsJsonSchema,
     handler: createToolHandler(
@@ -179418,7 +179545,7 @@ var documentTools = [
   },
   {
     name: "get_document",
-    description: "Retrieve full details for a Huly document including markdown content. Use this to view document content and metadata.",
+    description: "Retrieve full details for a Huly document including markdown content and a 'url' field pointing to the document in the Huly web app. Use this to view document content and metadata.",
     category: CATEGORY10,
     inputSchema: getDocumentParamsJsonSchema,
     handler: createToolHandler(
@@ -179429,7 +179556,7 @@ var documentTools = [
   },
   {
     name: "create_document",
-    description: "Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id. Use link_document_to_issue to associate the document with a tracker issue.",
+    description: "Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id and a 'url' field pointing to the document in the Huly web app. Use link_document_to_issue to associate the document with a tracker issue.",
     category: CATEGORY10,
     inputSchema: createDocumentParamsJsonSchema,
     handler: createToolHandler(
@@ -179440,7 +179567,7 @@ var documentTools = [
   },
   {
     name: "edit_document",
-    description: "Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams.",
+    description: "Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams. Returns a 'url' field pointing to the document in the Huly web app.",
     category: CATEGORY10,
     inputSchema: editDocumentParamsJsonSchema,
     handler: createToolHandler(