@firfi/huly-mcp 0.25.0 → 0.26.0

package/README.md

@@ -296,7 +296,7 @@ Planned feature surfaces:
 - Team planner and schedule reporting: team agendas, workload/capacity summaries, and visibility-aware free/busy views across members/projects.
 - Virtual office and meetings: offices, floors, rooms, access/language/default recording/transcription settings, meeting schedules, active participants, room info, meeting notes/transcript records (minutes), recordings, and device preferences.
 - Chat and communication: direct-message send/update/delete, group DMs, channel member mutations, join/leave/request access, archive/unarchive, star/favorite channels, close/reopen conversations, pinned messages, message attachments, translation, applets, in-message polls, and guest communication settings.
-- Notifications and activity: mark unread, unarchive, hide/unhide/mute contexts, unsubscribe per context/type, notification type settings, collaborators, pin/unpin activity messages, generic activity replies, filters, references, mentions, and update-message introspection.
+- Notifications and activity: mute contexts, unsubscribe per context/type, notification type settings, collaborators, pin/unpin activity messages, generic activity replies, filters, references, mentions, and update-message introspection.
 - Attachments and media: saved attachments, photos, drawings, embeddings, previews/preview metadata, and friendly wrappers for additional object types.
 - Core schema and workspace administration: attribute/property create/update/delete/hide, enum CRUD/options, sequence management, role assignment mutations, role/permission definition writes, generic space creation, global space admins, integrations registry, invite settings, role capability settings, and workspace setting metadata.
 - Integrations: GitHub repository/project mappings and sync metadata, Google Calendar connect/configure/sync controls, Bitrix entity/field mappings and sync status, Gmail/email channel messages, Telegram messages, Huly Mail/Mail plugin behavior, AI assistant integration state, and AI bot configuration if server-side APIs expose stable behavior.
@@ -537,14 +537,17 @@ SDK upgrade revisit:
 |------|-------------|
 | `list_notifications` | List inbox notifications. Returns notifications sorted by modification date (newest first). Supports filtering by read/archived status. |
 | `get_notification` | Retrieve full details for a notification. Use this to view notification content and metadata. |
-| `mark_notification_read` | Mark a notification as read. |
+| `mark_notification_read` | Mark a notification as read. Idempotent: returns success when the notification is already read. |
+| `mark_notification_unread` | Mark a notification as unread. Idempotent: returns success when the notification is already unread. |
 | `mark_all_notifications_read` | Mark all unread notifications as read. Returns the count of notifications marked. |
-| `archive_notification` | Archive a notification. Archived notifications are hidden from the main inbox view. |
+| `archive_notification` | Archive a notification. Archived notifications are hidden from the main inbox view. Idempotent when already archived. |
+| `unarchive_notification` | Unarchive a notification so it can appear in active notification lists again. Idempotent when already active. |
 | `archive_all_notifications` | Archive all notifications. Returns the count of notifications archived. |
 | `delete_notification` | Permanently delete a notification. This action cannot be undone. |
 | `get_notification_context` | Get notification context for an entity. Returns tracking information for a specific object. |
-| `list_notification_contexts` | List notification contexts. Returns contexts sorted by last update timestamp (newest first). Supports filtering by pinned status. |
-| `pin_notification_context` | Pin or unpin a notification context. Pinned contexts are highlighted in the inbox. |
+| `list_notification_contexts` | List notification contexts. Returns contexts sorted by last update timestamp (newest first). Supports filtering by pinned status and can include hidden contexts. |
+| `pin_notification_context` | Pin or unpin a notification context. Pinned contexts are highlighted in the inbox. Idempotent when the pin state already matches. |
+| `hide_notification_context` | Hide or unhide a notification context. Hidden contexts are omitted from list_notification_contexts unless includeHidden is true. Idempotent when the hidden state already matches. |
 | `list_notification_settings` | List notification provider settings. Returns current notification preferences. |
 | `update_notification_provider_setting` | Update notification provider setting. Enable or disable notifications for a specific provider. |
 | `get_unread_notification_count` | Get the count of unread notifications. |

package/dist/index.cjs

@@ -81771,7 +81771,7 @@ var require_connection2 = __commonJS({
     });
     module2.exports = __toCommonJS2(connection_exports);
     var import_analytics = require_lib2();
-    var import_client48 = __toESM2(require_lib6());
+    var import_client50 = __toESM2(require_lib6());
     var import_core65 = __toESM2(require_lib4());
     var import_platform4 = __toESM2(require_lib());
     var import_rpc = require_lib18();
@@ -81882,7 +81882,7 @@ var require_connection2 = __commonJS({
           }
           if (!this.closed) {
             void this.sendRequest({
-              method: import_client48.pingConst,
+              method: import_client50.pingConst,
               params: [],
               once: true,
               handleResult: /* @__PURE__ */ __name(async (result) => {
@@ -81915,7 +81915,7 @@ var require_connection2 = __commonJS({
         }
       }
       isConnected() {
-        return this.websocket != null && this.websocket.readyState === import_client48.ClientSocketReadyState.OPEN && this.helloReceived;
+        return this.websocket != null && this.websocket.readyState === import_client50.ClientSocketReadyState.OPEN && this.helloReceived;
       }
       delay = 0;
       onConnectHandlers = [];
@@ -82055,8 +82055,8 @@ var require_connection2 = __commonJS({
           }
           return;
         }
-        if (resp.result === import_client48.pingConst) {
-          void this.sendRequest({ method: import_client48.pingConst, params: [] }).catch((err) => {
+        if (resp.result === import_client50.pingConst) {
+          void this.sendRequest({ method: import_client50.pingConst, params: [] }).catch((err) => {
             this.ctx.error("failed to send ping", { err });
           });
           return;
@@ -82148,15 +82148,15 @@ var require_connection2 = __commonJS({
         }
       }
       checkArrayBufferPing(data) {
-        if (data.byteLength === import_client48.pingConst.length || data.byteLength === import_client48.pongConst.length) {
+        if (data.byteLength === import_client50.pingConst.length || data.byteLength === import_client50.pongConst.length) {
           const text = new TextDecoder().decode(data);
-          if (text === import_client48.pingConst) {
-            void this.sendRequest({ method: import_client48.pingConst, params: [] }).catch((err) => {
+          if (text === import_client50.pingConst) {
+            void this.sendRequest({ method: import_client50.pingConst, params: [] }).catch((err) => {
               this.ctx.error("failed to send ping", { err });
             });
             return true;
           }
-          if (text === import_client48.pongConst) {
+          if (text === import_client50.pongConst) {
             this.pingResponse = Date.now();
             return true;
           }
@@ -82166,7 +82166,7 @@ var require_connection2 = __commonJS({
       openConnection(ctx, socketId) {
         this.binaryMode = false;
         this.helloReceived = false;
-        const clientSocketFactory = this.opt?.socketFactory ?? (0, import_platform4.getMetadata)(import_client48.default.metadata.ClientSocketFactory) ?? ((url4) => {
+        const clientSocketFactory = this.opt?.socketFactory ?? (0, import_platform4.getMetadata)(import_client50.default.metadata.ClientSocketFactory) ?? ((url4) => {
           const s = new WebSocket(url4);
           return s;
         });
@@ -82201,12 +82201,12 @@ var require_connection2 = __commonJS({
           if (this.websocket !== wsocket) {
             return;
           }
-          if (event.data === import_client48.pongConst) {
+          if (event.data === import_client50.pongConst) {
             this.pingResponse = Date.now();
             return;
           }
-          if (event.data === import_client48.pingConst) {
-            void this.sendRequest({ method: import_client48.pingConst, params: [] }).catch((err) => {
+          if (event.data === import_client50.pingConst) {
+            void this.sendRequest({ method: import_client50.pingConst, params: [] }).catch((err) => {
               this.ctx.error("failed to send ping", { err });
             });
             return;
@@ -82271,8 +82271,8 @@ var require_connection2 = __commonJS({
           if (this.websocket !== wsocket) {
             return;
           }
-          const useBinary = this.opt?.useBinaryProtocol ?? (0, import_platform4.getMetadata)(import_client48.default.metadata.UseBinaryProtocol) ?? true;
-          this.compressionMode = this.opt?.useProtocolCompression ?? (0, import_platform4.getMetadata)(import_client48.default.metadata.UseProtocolCompression) ?? false;
+          const useBinary = this.opt?.useBinaryProtocol ?? (0, import_platform4.getMetadata)(import_client50.default.metadata.UseBinaryProtocol) ?? true;
+          this.compressionMode = this.opt?.useProtocolCompression ?? (0, import_platform4.getMetadata)(import_client50.default.metadata.UseProtocolCompression) ?? false;
           const helloRequest = {
             method: "hello",
             params: [],
@@ -82318,13 +82318,13 @@ var require_connection2 = __commonJS({
             if (w instanceof Promise) {
               await w;
             }
-            if (data.method !== import_client48.pingConst) {
+            if (data.method !== import_client50.pingConst) {
               this.requests.set(id, promise4);
             }
             promise4.sendData = () => {
-              if (this.websocket?.readyState === import_client48.ClientSocketReadyState.OPEN) {
+              if (this.websocket?.readyState === import_client50.ClientSocketReadyState.OPEN) {
                 promise4.startTime = Date.now();
-                if (data.method !== import_client48.pingConst) {
+                if (data.method !== import_client50.pingConst) {
                   const dta = this.rpcHandler.serialize(
                     {
                       method: data.method,
@@ -82337,7 +82337,7 @@ var require_connection2 = __commonJS({
                   );
                   this.websocket?.send(dta);
                 } else {
-                  this.websocket?.send(import_client48.pingConst);
+                  this.websocket?.send(import_client50.pingConst);
                 }
               }
             };
@@ -82351,7 +82351,7 @@ var require_connection2 = __commonJS({
               };
             }
             promise4.sendData();
-            if (data.method !== import_client48.pingConst) {
+            if (data.method !== import_client50.pingConst) {
               return await promise4.promise;
             }
           },
@@ -82517,7 +82517,7 @@ var require_lib19 = __commonJS({
       default: () => index_default
     });
     module2.exports = __toCommonJS2(index_exports2);
-    var import_client48 = __toESM2(require_lib6());
+    var import_client50 = __toESM2(require_lib6());
     var import_core65 = __toESM2(require_lib4());
     var import_platform4 = __toESM2(require_lib());
     var import_connection = require_connection2();
@@ -82561,8 +82561,8 @@ var require_lib19 = __commonJS({
       return {
         function: {
           GetClient: /* @__PURE__ */ __name(async (token, endpoint, opt) => {
-            const filterModel = (0, import_platform4.getMetadata)(import_client48.default.metadata.FilterModel) ?? "none";
-            const extraFilter = (0, import_platform4.getMetadata)(import_client48.default.metadata.ExtraFilter) ?? [];
+            const filterModel = (0, import_platform4.getMetadata)(import_client50.default.metadata.FilterModel) ?? "none";
+            const extraFilter = (0, import_platform4.getMetadata)(import_client50.default.metadata.ExtraFilter) ?? [];
             const handler = /* @__PURE__ */ __name(async (handler2) => {
               const url4 = (0, import_core65.concatLink)(endpoint, `/${token}`);
               const upgradeHandler = /* @__PURE__ */ __name((...txes) => {
@@ -82590,7 +82590,7 @@ var require_lib19 = __commonJS({
                 throw new Error("Workspace or account not found in token");
               }
               const newOpt = { ...opt };
-              const connectTimeout = opt?.connectionTimeout ?? (0, import_platform4.getMetadata)(import_client48.default.metadata.ConnectionTimeout);
+              const connectTimeout = opt?.connectionTimeout ?? (0, import_platform4.getMetadata)(import_client50.default.metadata.ConnectionTimeout);
               let connectPromise;
               if ((connectTimeout ?? 0) > 0) {
                 connectPromise = new Promise((resolve2, reject) => {
@@ -82642,7 +82642,7 @@ var require_lib19 = __commonJS({
     function returnUITxes(txes, extraFilter) {
       const configs = /* @__PURE__ */ new Map();
       (0, import_core65.fillConfiguration)(txes, configs);
-      const allowedPlugins = [...(0, import_platform4.getPlugins)(), ...(0, import_platform4.getMetadata)(import_client48.default.metadata.ExtraPlugins) ?? []];
+      const allowedPlugins = [...(0, import_platform4.getPlugins)(), ...(0, import_platform4.getMetadata)(import_client50.default.metadata.ExtraPlugins) ?? []];
       const excludedPlugins = Array.from(configs.values()).filter(
         (it) => !it.enabled || !allowedPlugins.includes(it.pluginId) || extraFilter.includes(it.pluginId)
       );
@@ -82690,7 +82690,7 @@ var require_lib19 = __commonJS({
     }
     __name(returnClientTxes, "returnClientTxes");
     function createModelPersistence(workspace) {
-      const overrideStore = (0, import_platform4.getMetadata)(import_client48.default.metadata.OverridePersistenceStore);
+      const overrideStore = (0, import_platform4.getMetadata)(import_client50.default.metadata.OverridePersistenceStore);
       if (overrideStore !== void 0) {
         return overrideStore;
       }
@@ -82787,7 +82787,7 @@ var require_client6 = __commonJS({
     });
     module2.exports = __toCommonJS2(client_exports);
     var import_account_client2 = require_lib5();
-    var import_client48 = __toESM2(require_lib6());
+    var import_client50 = __toESM2(require_lib6());
     var import_core65 = require_lib4();
     var import_platform4 = require_lib();
     var import_config9 = require_config();
@@ -82813,9 +82813,9 @@ var require_client6 = __commonJS({
     }
     __name(connect, "connect");
     async function createClient(url4, endpoint, token, workspaceUuid, account, config3, options) {
-      (0, import_platform4.addLocation)(import_client48.clientId, () => Promise.resolve().then(() => __toESM(require_lib19())));
+      (0, import_platform4.addLocation)(import_client50.clientId, () => Promise.resolve().then(() => __toESM(require_lib19())));
       const { socketFactory, connectionTimeout } = options;
-      const clientFactory = await (0, import_platform4.getResource)(import_client48.default.function.GetClient);
+      const clientFactory = await (0, import_platform4.getResource)(import_client50.default.function.GetClient);
       const connection = await clientFactory(token, endpoint, {
         socketFactory,
         connectionTimeout
@@ -83936,11 +83936,11 @@ var require_storage2 = __commonJS({
     var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
     var storage_exports = {};
     __export2(storage_exports, {
-      connectStorage: () => import_client48.connectStorage,
-      createStorageClient: () => import_client48.createStorageClient
+      connectStorage: () => import_client50.connectStorage,
+      createStorageClient: () => import_client50.createStorageClient
     });
     module2.exports = __toCommonJS2(storage_exports);
-    var import_client48 = require_client7();
+    var import_client50 = require_client7();
     __reExport2(storage_exports, require_error3(), module2.exports);
     __reExport2(storage_exports, require_types8(), module2.exports);
   }
@@ -171577,6 +171577,7 @@ var parseUnlinkDocumentFromIssueParams = Schema_exports.decodeUnknown(UnlinkDocu
 // src/domain/schemas/notifications.ts
 var DEFAULT_UNREAD_ONLY = false;
 var DEFAULT_PINNED_CONTEXTS_ONLY = false;
+var DEFAULT_INCLUDE_HIDDEN_CONTEXTS = false;
 var ListNotificationsParamsSchema = Schema_exports.Struct({
   limit: Schema_exports.optional(
     LimitParam.annotations({
@@ -171613,6 +171614,14 @@ var MarkNotificationReadParamsSchema = Schema_exports.Struct({
   title: "MarkNotificationReadParams",
   description: "Parameters for marking a notification as read"
 });
+var MarkNotificationUnreadParamsSchema = Schema_exports.Struct({
+  notificationId: NotificationId.annotations({
+    description: "Notification ID to mark as unread"
+  })
+}).annotations({
+  title: "MarkNotificationUnreadParams",
+  description: "Parameters for marking a notification as unread"
+});
 var ArchiveNotificationParamsSchema = Schema_exports.Struct({
   notificationId: NotificationId.annotations({
     description: "Notification ID to archive"
@@ -171621,6 +171630,14 @@ var ArchiveNotificationParamsSchema = Schema_exports.Struct({
   title: "ArchiveNotificationParams",
   description: "Parameters for archiving a notification"
 });
+var UnarchiveNotificationParamsSchema = Schema_exports.Struct({
+  notificationId: NotificationId.annotations({
+    description: "Notification ID to unarchive"
+  })
+}).annotations({
+  title: "UnarchiveNotificationParams",
+  description: "Parameters for unarchiving a notification"
+});
 var DeleteNotificationParamsSchema = Schema_exports.Struct({
   notificationId: NotificationId.annotations({
     description: "Notification ID to delete"
@@ -171650,6 +171667,11 @@ var ListNotificationContextsParamsSchema = Schema_exports.Struct({
     Schema_exports.Boolean.annotations({
       description: `Return only pinned contexts (default: ${DEFAULT_PINNED_CONTEXTS_ONLY})`
     })
+  ),
+  includeHidden: Schema_exports.optional(
+    Schema_exports.Boolean.annotations({
+      description: `Include hidden notification contexts in results (default: ${DEFAULT_INCLUDE_HIDDEN_CONTEXTS})`
+    })
   )
 }).annotations({
   title: "ListNotificationContextsParams",
@@ -171666,6 +171688,17 @@ var PinNotificationContextParamsSchema = Schema_exports.Struct({
   title: "PinNotificationContextParams",
   description: "Parameters for pinning/unpinning a notification context"
 });
+var HideNotificationContextParamsSchema = Schema_exports.Struct({
+  contextId: NotificationContextId.annotations({
+    description: "Notification context ID to hide/unhide"
+  }),
+  hidden: Schema_exports.Boolean.annotations({
+    description: "Whether to hide (true) or unhide (false) the context"
+  })
+}).annotations({
+  title: "HideNotificationContextParams",
+  description: "Parameters for hiding/unhiding a notification context"
+});
 var ListNotificationSettingsParamsSchema = Schema_exports.Struct({
   limit: Schema_exports.optional(
     LimitParam.annotations({
@@ -171690,11 +171723,14 @@ var UpdateNotificationProviderSettingParamsSchema = Schema_exports.Struct({
 var listNotificationsParamsJsonSchema = JSONSchema_exports.make(ListNotificationsParamsSchema);
 var getNotificationParamsJsonSchema = JSONSchema_exports.make(GetNotificationParamsSchema);
 var markNotificationReadParamsJsonSchema = JSONSchema_exports.make(MarkNotificationReadParamsSchema);
+var markNotificationUnreadParamsJsonSchema = JSONSchema_exports.make(MarkNotificationUnreadParamsSchema);
 var archiveNotificationParamsJsonSchema = JSONSchema_exports.make(ArchiveNotificationParamsSchema);
+var unarchiveNotificationParamsJsonSchema = JSONSchema_exports.make(UnarchiveNotificationParamsSchema);
 var deleteNotificationParamsJsonSchema = JSONSchema_exports.make(DeleteNotificationParamsSchema);
 var getNotificationContextParamsJsonSchema = JSONSchema_exports.make(GetNotificationContextParamsSchema);
 var listNotificationContextsParamsJsonSchema = JSONSchema_exports.make(ListNotificationContextsParamsSchema);
 var pinNotificationContextParamsJsonSchema = JSONSchema_exports.make(PinNotificationContextParamsSchema);
+var hideNotificationContextParamsJsonSchema = JSONSchema_exports.make(HideNotificationContextParamsSchema);
 var listNotificationSettingsParamsJsonSchema = JSONSchema_exports.make(ListNotificationSettingsParamsSchema);
 var updateNotificationProviderSettingParamsJsonSchema = JSONSchema_exports.make(
   UpdateNotificationProviderSettingParamsSchema
@@ -171702,11 +171738,14 @@ var updateNotificationProviderSettingParamsJsonSchema = JSONSchema_exports.make(
 var parseListNotificationsParams = Schema_exports.decodeUnknown(ListNotificationsParamsSchema);
 var parseGetNotificationParams = Schema_exports.decodeUnknown(GetNotificationParamsSchema);
 var parseMarkNotificationReadParams = Schema_exports.decodeUnknown(MarkNotificationReadParamsSchema);
+var parseMarkNotificationUnreadParams = Schema_exports.decodeUnknown(MarkNotificationUnreadParamsSchema);
 var parseArchiveNotificationParams = Schema_exports.decodeUnknown(ArchiveNotificationParamsSchema);
+var parseUnarchiveNotificationParams = Schema_exports.decodeUnknown(UnarchiveNotificationParamsSchema);
 var parseDeleteNotificationParams = Schema_exports.decodeUnknown(DeleteNotificationParamsSchema);
 var parseGetNotificationContextParams = Schema_exports.decodeUnknown(GetNotificationContextParamsSchema);
 var parseListNotificationContextsParams = Schema_exports.decodeUnknown(ListNotificationContextsParamsSchema);
 var parsePinNotificationContextParams = Schema_exports.decodeUnknown(PinNotificationContextParamsSchema);
+var parseHideNotificationContextParams = Schema_exports.decodeUnknown(HideNotificationContextParamsSchema);
 var parseListNotificationSettingsParams = Schema_exports.decodeUnknown(ListNotificationSettingsParamsSchema);
 var parseUpdateNotificationProviderSettingParams = Schema_exports.decodeUnknown(
   UpdateNotificationProviderSettingParamsSchema
@@ -172691,7 +172730,7 @@ var parseListDriveFileVersionsParams = Schema_exports.decodeUnknown(ListDriveFil
 var parseRestoreDriveFileVersionParams = Schema_exports.decodeUnknown(RestoreDriveFileVersionParamsSchema);
 
 // src/version.ts
-var VERSION = true ? "0.25.0" : "0.0.0-dev";
+var VERSION = true ? "0.26.0" : "0.0.0-dev";
 
 // src/mcp/tool-output-schema.ts
 var defaultToolOutputSchema = {
@@ -182938,6 +182977,8 @@ var milestoneTools = [
 
 // src/huly/operations/notifications.ts
 var import_core40 = __toESM(require_lib4(), 1);
+
+// src/huly/operations/notifications-shared.ts
 var toDocNotifyContextSummary = (ctx) => ({
   id: NotificationContextId.make(ctx._id),
   objectId: DocId.make(ctx.objectId),
@@ -182967,63 +183008,37 @@ var findNotificationContext = (contextId) => Effect_exports.gen(function* () {
   );
   return { client, context: ctx };
 });
-var listNotifications = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const query = {};
-  if (!params.includeArchived) {
-    query.archived = false;
-  }
-  if (params.unreadOnly) {
-    query.isViewed = false;
+var findUnreadActiveNotifications = (client, limit) => client.findAll(
+  notification.class.InboxNotification,
+  hulyQuery({ isViewed: false, archived: false }),
+  { limit }
+);
+
+// src/huly/operations/notifications-state.ts
+var BULK_NOTIFICATION_LIMIT = 200;
+var markNotificationRead = (params) => Effect_exports.gen(function* () {
+  const { client, notification: notif } = yield* findNotification(params.notificationId);
+  if (notif.isViewed) {
+    return { id: NotificationId.make(notif._id), marked: true };
   }
-  const limit = clampLimit(params.limit);
-  const notifications = yield* client.findAll(
+  const updateOps = {
+    isViewed: true
+  };
+  yield* client.updateDoc(
     notification.class.InboxNotification,
-    query,
-    {
-      limit,
-      sort: {
-        modifiedOn: import_core40.SortingOrder.Descending
-      }
-    }
+    notif.space,
+    notif._id,
+    updateOps
   );
-  const summaries = notifications.map((n) => ({
-    id: NotificationId.make(n._id),
-    isViewed: n.isViewed,
-    archived: n.archived,
-    objectId: DocId.make(n.objectId),
-    objectClass: ObjectClassName.make(n.objectClass),
-    title: n.title,
-    body: n.body,
-    createdOn: n.createdOn,
-    modifiedOn: n.modifiedOn
-  }));
-  return summaries;
-});
-var getNotification = (params) => Effect_exports.gen(function* () {
-  const { notification: notif } = yield* findNotification(params.notificationId);
-  const result = {
-    id: NotificationId.make(notif._id),
-    isViewed: notif.isViewed,
-    archived: notif.archived,
-    objectId: DocId.make(notif.objectId),
-    objectClass: ObjectClassName.make(notif.objectClass),
-    docNotifyContextId: NotificationContextId.make(notif.docNotifyContext),
-    title: notif.title,
-    body: notif.body,
-    data: notif.data ? notif.data : void 0,
-    createdOn: notif.createdOn,
-    modifiedOn: notif.modifiedOn
-  };
-  return result;
+  return { id: NotificationId.make(notif._id), marked: true };
 });
-var markNotificationRead = (params) => Effect_exports.gen(function* () {
+var markNotificationUnread = (params) => Effect_exports.gen(function* () {
   const { client, notification: notif } = yield* findNotification(params.notificationId);
-  if (notif.isViewed) {
+  if (!notif.isViewed) {
     return { id: NotificationId.make(notif._id), marked: true };
   }
   const updateOps = {
-    isViewed: true
+    isViewed: false
   };
   yield* client.updateDoc(
     notification.class.InboxNotification,
@@ -183035,11 +183050,7 @@ var markNotificationRead = (params) => Effect_exports.gen(function* () {
 });
 var markAllNotificationsRead = () => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const unreadNotifications = yield* client.findAll(
-    notification.class.InboxNotification,
-    { isViewed: false, archived: false },
-    { limit: 200 }
-  );
+  const unreadNotifications = yield* findUnreadActiveNotifications(client, BULK_NOTIFICATION_LIMIT);
   yield* Effect_exports.forEach(
     unreadNotifications,
     (notif) => client.updateDoc(
@@ -183068,12 +183079,28 @@ var archiveNotification = (params) => Effect_exports.gen(function* () {
   );
   return { id: NotificationId.make(notif._id), archived: true };
 });
+var unarchiveNotification = (params) => Effect_exports.gen(function* () {
+  const { client, notification: notif } = yield* findNotification(params.notificationId);
+  if (!notif.archived) {
+    return { id: NotificationId.make(notif._id), archived: false };
+  }
+  const updateOps = {
+    archived: false
+  };
+  yield* client.updateDoc(
+    notification.class.InboxNotification,
+    notif.space,
+    notif._id,
+    updateOps
+  );
+  return { id: NotificationId.make(notif._id), archived: false };
+});
 var archiveAllNotifications = () => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const activeNotifications = yield* client.findAll(
     notification.class.InboxNotification,
     { archived: false },
-    { limit: 200 }
+    { limit: BULK_NOTIFICATION_LIMIT }
   );
   yield* Effect_exports.forEach(
     activeNotifications,
@@ -183096,6 +183123,87 @@ var deleteNotification = (params) => Effect_exports.gen(function* () {
   );
   return { id: NotificationId.make(notif._id), deleted: true };
 });
+var pinNotificationContext = (params) => Effect_exports.gen(function* () {
+  const { client, context: context6 } = yield* findNotificationContext(params.contextId);
+  if (context6.isPinned === params.pinned) {
+    return { id: NotificationContextId.make(context6._id), isPinned: context6.isPinned };
+  }
+  const updateOps = {
+    isPinned: params.pinned
+  };
+  yield* client.updateDoc(
+    notification.class.DocNotifyContext,
+    context6.space,
+    context6._id,
+    updateOps
+  );
+  return { id: NotificationContextId.make(context6._id), isPinned: params.pinned };
+});
+var hideNotificationContext = (params) => Effect_exports.gen(function* () {
+  const { client, context: context6 } = yield* findNotificationContext(params.contextId);
+  if (context6.hidden === params.hidden) {
+    return { id: NotificationContextId.make(context6._id), hidden: context6.hidden };
+  }
+  const updateOps = {
+    hidden: params.hidden
+  };
+  yield* client.updateDoc(
+    notification.class.DocNotifyContext,
+    context6.space,
+    context6._id,
+    updateOps
+  );
+  return { id: NotificationContextId.make(context6._id), hidden: params.hidden };
+});
+
+// src/huly/operations/notifications.ts
+var listNotifications = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const query = {
+    ...params.includeArchived ? {} : { archived: false },
+    ...params.unreadOnly ? { isViewed: false } : {}
+  };
+  const limit = clampLimit(params.limit);
+  const notifications = yield* client.findAll(
+    notification.class.InboxNotification,
+    hulyQuery(query),
+    {
+      limit,
+      sort: {
+        modifiedOn: import_core40.SortingOrder.Descending
+      }
+    }
+  );
+  const summaries = notifications.map((n) => ({
+    id: NotificationId.make(n._id),
+    isViewed: n.isViewed,
+    archived: n.archived,
+    objectId: DocId.make(n.objectId),
+    objectClass: ObjectClassName.make(n.objectClass),
+    title: n.title,
+    body: n.body,
+    createdOn: n.createdOn,
+    modifiedOn: n.modifiedOn
+  }));
+  return summaries;
+});
+var getNotification = (params) => Effect_exports.gen(function* () {
+  const { notification: notif } = yield* findNotification(params.notificationId);
+  const result = {
+    id: NotificationId.make(notif._id),
+    isViewed: notif.isViewed,
+    archived: notif.archived,
+    objectId: DocId.make(notif.objectId),
+    objectClass: ObjectClassName.make(notif.objectClass),
+    docNotifyContextId: NotificationContextId.make(notif.docNotifyContext),
+    title: notif.title,
+    body: notif.body,
+    data: notif.data ? notif.data : void 0,
+    createdOn: notif.createdOn,
+    modifiedOn: notif.modifiedOn
+  };
+  return result;
+});
 var getNotificationContext = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const ctx = yield* client.findOne(
@@ -183113,15 +183221,13 @@ var getNotificationContext = (params) => Effect_exports.gen(function* () {
 var listNotificationContexts = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const query = {
-    hidden: false
+    ...params.includeHidden ? {} : { hidden: false },
+    ...params.pinnedOnly ? { isPinned: true } : {}
   };
-  if (params.pinnedOnly) {
-    query.isPinned = true;
-  }
   const limit = clampLimit(params.limit);
   const contexts = yield* client.findAll(
     notification.class.DocNotifyContext,
-    query,
+    hulyQuery(query),
     {
       limit,
       sort: {
@@ -183131,22 +183237,6 @@ var listNotificationContexts = (params) => Effect_exports.gen(function* () {
   );
   return contexts.map(toDocNotifyContextSummary);
 });
-var pinNotificationContext = (params) => Effect_exports.gen(function* () {
-  const { client, context: context6 } = yield* findNotificationContext(params.contextId);
-  if (context6.isPinned === params.pinned) {
-    return { id: NotificationContextId.make(context6._id), isPinned: context6.isPinned };
-  }
-  const updateOps = {
-    isPinned: params.pinned
-  };
-  yield* client.updateDoc(
-    notification.class.DocNotifyContext,
-    context6.space,
-    context6._id,
-    updateOps
-  );
-  return { id: NotificationContextId.make(context6._id), isPinned: params.pinned };
-});
 var listNotificationSettings = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const limit = clampLimit(params.limit);
@@ -183184,11 +183274,7 @@ var updateNotificationProviderSetting = (params) => Effect_exports.gen(function*
 });
 var getUnreadNotificationCount = () => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const unreadNotifications = yield* client.findAll(
-    notification.class.InboxNotification,
-    { isViewed: false, archived: false },
-    { limit: 1 }
-  );
+  const unreadNotifications = yield* findUnreadActiveNotifications(client, 1);
   const count3 = unreadNotifications.total;
   return { count: listTotal(count3) };
 });
@@ -183220,7 +183306,7 @@ var notificationTools = [
   },
   {
     name: "mark_notification_read",
-    description: "Mark a notification as read.",
+    description: "Mark a notification as read. Idempotent: returns success when the notification is already read.",
     category: CATEGORY17,
     inputSchema: markNotificationReadParamsJsonSchema,
     handler: createToolHandler(
@@ -183229,6 +183315,17 @@ var notificationTools = [
       markNotificationRead
     )
   },
+  {
+    name: "mark_notification_unread",
+    description: "Mark a notification as unread. Idempotent: returns success when the notification is already unread.",
+    category: CATEGORY17,
+    inputSchema: markNotificationUnreadParamsJsonSchema,
+    handler: createToolHandler(
+      "mark_notification_unread",
+      parseMarkNotificationUnreadParams,
+      markNotificationUnread
+    )
+  },
   {
     name: "mark_all_notifications_read",
     description: "Mark all unread notifications as read. Returns the count of notifications marked.",
@@ -183242,7 +183339,7 @@ var notificationTools = [
   },
   {
     name: "archive_notification",
-    description: "Archive a notification. Archived notifications are hidden from the main inbox view.",
+    description: "Archive a notification. Archived notifications are hidden from the main inbox view. Idempotent when already archived.",
     category: CATEGORY17,
     inputSchema: archiveNotificationParamsJsonSchema,
     handler: createToolHandler(
@@ -183251,6 +183348,17 @@ var notificationTools = [
       archiveNotification
     )
   },
+  {
+    name: "unarchive_notification",
+    description: "Unarchive a notification so it can appear in active notification lists again. Idempotent when already active.",
+    category: CATEGORY17,
+    inputSchema: unarchiveNotificationParamsJsonSchema,
+    handler: createToolHandler(
+      "unarchive_notification",
+      parseUnarchiveNotificationParams,
+      unarchiveNotification
+    )
+  },
   {
     name: "archive_all_notifications",
     description: "Archive all notifications. Returns the count of notifications archived.",
@@ -183286,7 +183394,7 @@ var notificationTools = [
   },
   {
     name: "list_notification_contexts",
-    description: "List notification contexts. Returns contexts sorted by last update timestamp (newest first). Supports filtering by pinned status.",
+    description: "List notification contexts. Returns contexts sorted by last update timestamp (newest first). Supports filtering by pinned status and can include hidden contexts.",
     category: CATEGORY17,
     inputSchema: listNotificationContextsParamsJsonSchema,
     handler: createToolHandler(
@@ -183297,7 +183405,7 @@ var notificationTools = [
   },
   {
     name: "pin_notification_context",
-    description: "Pin or unpin a notification context. Pinned contexts are highlighted in the inbox.",
+    description: "Pin or unpin a notification context. Pinned contexts are highlighted in the inbox. Idempotent when the pin state already matches.",
     category: CATEGORY17,
     inputSchema: pinNotificationContextParamsJsonSchema,
     handler: createToolHandler(
@@ -183306,6 +183414,17 @@ var notificationTools = [
       pinNotificationContext
     )
   },
+  {
+    name: "hide_notification_context",
+    description: "Hide or unhide a notification context. Hidden contexts are omitted from list_notification_contexts unless includeHidden is true. Idempotent when the hidden state already matches.",
+    category: CATEGORY17,
+    inputSchema: hideNotificationContextParamsJsonSchema,
+    handler: createToolHandler(
+      "hide_notification_context",
+      parseHideNotificationContextParams,
+      hideNotificationContext
+    )
+  },
   {
     name: "list_notification_settings",
     description: "List notification provider settings. Returns current notification preferences.",

package/package.json

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