@firfi/huly-mcp 0.12.0 → 0.13.0

package/dist/index.cjs

@@ -171638,21 +171638,58 @@ var ActivityCount = Schema_exports.NonNegativeInt.annotations({
   description: "Non-negative integer count for activity replies or reactions"
 });
 var ActivityAction = Schema_exports.Literal("create", "update", "remove");
+var hasAll = (...values4) => values4.every((value3) => value3 !== void 0);
 var ListActivityParamsSchema = Schema_exports.Struct({
-  objectId: NonEmptyString2.annotations({
-    description: "ID of the object to get activity for"
-  }),
-  objectClass: ObjectClassName.annotations({
-    description: "Class of the object (e.g., 'tracker:class:Issue')"
-  }),
+  objectId: Schema_exports.optional(NonEmptyString2.annotations({
+    description: "Advanced: internal Huly object ID to get activity for. Use with objectClass. Prefer project+issueIdentifier, teamspace+document, or channel when available."
+  })),
+  objectClass: Schema_exports.optional(ObjectClassName.annotations({
+    description: "Advanced: internal Huly object class for objectId, such as 'tracker:class:Issue'. Use with objectId."
+  })),
+  project: Schema_exports.optional(ProjectIdentifier.annotations({
+    description: "Project identifier for issue activity, e.g. 'HULY'. Use with issueIdentifier."
+  })),
+  issueIdentifier: Schema_exports.optional(IssueIdentifier.annotations({
+    description: "Issue identifier for issue activity, e.g. 'HULY-123' or '123'. Use with project."
+  })),
+  teamspace: Schema_exports.optional(TeamspaceIdentifier.annotations({
+    description: "Teamspace name or ID for document activity. Use with document."
+  })),
+  document: Schema_exports.optional(DocumentIdentifier.annotations({
+    description: "Document title or ID for document activity. Use with teamspace."
+  })),
+  channel: Schema_exports.optional(ChannelIdentifier.annotations({
+    description: "Channel name or ID for channel activity."
+  })),
   limit: Schema_exports.optional(
     LimitParam.annotations({
       description: "Maximum number of activity messages to return (default: 50)"
     })
   )
-}).annotations({
+}).pipe(
+  Schema_exports.filter((params) => {
+    const rawObjectMode = hasAll(params.objectId, params.objectClass);
+    const issueMode = hasAll(params.project, params.issueIdentifier);
+    const documentMode = hasAll(params.teamspace, params.document);
+    const channelMode = params.channel !== void 0;
+    const modeCount = [rawObjectMode, issueMode, documentMode, channelMode].filter(Boolean).length;
+    if (params.objectId !== void 0 !== (params.objectClass !== void 0)) {
+      return "Provide both objectId and objectClass for raw object activity, or use a friendly target mode.";
+    }
+    if (params.project !== void 0 !== (params.issueIdentifier !== void 0)) {
+      return "Provide both project and issueIdentifier for issue activity.";
+    }
+    if (params.teamspace !== void 0 !== (params.document !== void 0)) {
+      return "Provide both teamspace and document for document activity.";
+    }
+    if (modeCount !== 1) {
+      return "Choose exactly one activity target mode: objectId+objectClass, project+issueIdentifier, teamspace+document, or channel.";
+    }
+    return void 0;
+  })
+).annotations({
   title: "ListActivityParams",
-  description: "Parameters for listing activity on an object"
+  description: "Parameters for listing activity on a Huly object. Prefer friendly identifiers; raw objectId+objectClass is for advanced callers."
 });
 var AddReactionParamsSchema = Schema_exports.Struct({
   messageId: ActivityMessageId.annotations({
@@ -171725,7 +171762,66 @@ var ListMentionsParamsSchema = Schema_exports.Struct({
   title: "ListMentionsParams",
   description: "Parameters for listing mentions of the current user"
 });
-var listActivityParamsJsonSchema = JSONSchema_exports.make(ListActivityParamsSchema);
+var activityLimitJsonSchema = {
+  type: "integer",
+  minimum: 1,
+  maximum: MAX_LIMIT,
+  description: "Maximum number of activity messages to return (default: 50)"
+};
+var targetStringJsonSchema = (description) => ({
+  type: "string",
+  minLength: 1,
+  description
+});
+var listActivityParamsJsonSchema = {
+  type: "object",
+  description: "Choose exactly one target mode for activity lookup: project+issueIdentifier, teamspace+document, channel, or objectId+objectClass.",
+  oneOf: [
+    {
+      title: "Issue activity target",
+      type: "object",
+      additionalProperties: false,
+      required: ["project", "issueIdentifier"],
+      properties: {
+        project: targetStringJsonSchema("Project identifier for issue activity, e.g. 'HULY'."),
+        issueIdentifier: targetStringJsonSchema("Issue identifier for issue activity, e.g. 'HULY-123' or '123'."),
+        limit: activityLimitJsonSchema
+      }
+    },
+    {
+      title: "Document activity target",
+      type: "object",
+      additionalProperties: false,
+      required: ["teamspace", "document"],
+      properties: {
+        teamspace: targetStringJsonSchema("Teamspace name or ID for document activity."),
+        document: targetStringJsonSchema("Document title or ID for document activity."),
+        limit: activityLimitJsonSchema
+      }
+    },
+    {
+      title: "Channel activity target",
+      type: "object",
+      additionalProperties: false,
+      required: ["channel"],
+      properties: {
+        channel: targetStringJsonSchema("Channel name or ID for channel activity."),
+        limit: activityLimitJsonSchema
+      }
+    },
+    {
+      title: "Raw Huly object activity target",
+      type: "object",
+      additionalProperties: false,
+      required: ["objectId", "objectClass"],
+      properties: {
+        objectId: targetStringJsonSchema("Internal Huly object ID to get activity for."),
+        objectClass: targetStringJsonSchema("Internal Huly object class for objectId, such as 'tracker:class:Issue'."),
+        limit: activityLimitJsonSchema
+      }
+    }
+  ]
+};
 var addReactionParamsJsonSchema = JSONSchema_exports.make(AddReactionParamsSchema);
 var removeReactionParamsJsonSchema = JSONSchema_exports.make(RemoveReactionParamsSchema);
 var listReactionsParamsJsonSchema = JSONSchema_exports.make(ListReactionsParamsSchema);
@@ -171792,6 +171888,9 @@ var ListSavedMessagesResultSchema = Schema_exports.Array(SavedMessageWireSchema)
 var ListMentionsResultSchema = Schema_exports.Array(MentionWireSchema);
 
 // src/huly/operations/activity.ts
+var import_core22 = __toESM(require_lib4(), 1);
+
+// src/huly/operations/channels.ts
 var import_core19 = __toESM(require_lib4(), 1);
 
 // src/huly/operations/query-helpers.ts
@@ -171833,552 +171932,311 @@ var task = require_lib34().default;
 var time3 = require_lib35().default;
 var tracker = require_lib36().default;
 
-// src/huly/operations/activity.ts
-var optionalTimestamp = (value3) => value3 === void 0 ? void 0 : Timestamp.make(value3);
-var optionalNullableTimestamp = (value3) => value3 === void 0 || value3 === null ? value3 : Timestamp.make(value3);
-var optionalActivityCount = (value3) => value3 === void 0 ? void 0 : ActivityCount.make(value3);
-var optionalPersonId = (value3) => value3 === void 0 || value3 === "" ? void 0 : PersonId.make(value3);
-var serverPopulatedCreateBy = "";
-var listActivity = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const limit = clampLimit(params.limit);
-  const messages = yield* client.findAll(
-    activity.class.ActivityMessage,
-    {
-      attachedTo: toRef(params.objectId),
-      attachedToClass: toRef(params.objectClass)
-    },
+// 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,
     {
-      limit,
-      sort: {
-        modifiedOn: import_core19.SortingOrder.Descending
-      }
+      _id: toRef(params.messageId),
+      space: channel._id
     }
   );
-  const result = messages.map((msg) => ({
-    id: ActivityMessageId.make(msg._id),
-    objectId: NonEmptyString2.make(msg.attachedTo),
-    objectClass: ObjectClassName.make(msg.attachedToClass),
-    modifiedBy: PersonId.make(msg.modifiedBy),
-    modifiedOn: optionalTimestamp(msg.modifiedOn),
-    isPinned: msg.isPinned,
-    replies: optionalActivityCount(msg.replies),
-    reactions: optionalActivityCount(msg.reactions),
-    editedOn: optionalNullableTimestamp(msg.editedOn)
-  }));
-  return result;
+  if (message === void 0) {
+    return yield* new MessageNotFoundError({
+      messageId: params.messageId,
+      channel: params.channel
+    });
+  }
+  return { client, channel, message };
 });
-var addReaction = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const message = yield* findOneOrFail(
-    client,
-    activity.class.ActivityMessage,
-    { _id: toRef(params.messageId) },
-    () => new ActivityMessageNotFoundError({ messageId: params.messageId })
-  );
-  const reactionId = (0, import_core19.generateId)();
-  const reactionData = {
-    emoji: params.emoji,
-    createBy: serverPopulatedCreateBy
+
+// 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.addCollection(
-    activity.class.Reaction,
-    message.space,
+  yield* client.updateDoc(
+    chunter.class.ChatMessage,
+    channel._id,
     message._id,
-    activity.class.ActivityMessage,
-    "reactions",
-    reactionData,
-    reactionId
+    updateOps
   );
-  return {
-    reactionId: ReactionId.make(reactionId),
-    messageId: ActivityMessageId.make(params.messageId)
-  };
+  return { id: MessageId.make(message._id), updated: true };
 });
-var removeReaction = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const reaction = yield* findOneOrFail(
-    client,
-    activity.class.Reaction,
-    {
-      attachedTo: toRef(params.messageId),
-      emoji: params.emoji
-    },
-    () => new ReactionNotFoundError({
-      messageId: params.messageId,
-      emoji: params.emoji
-    })
-  );
+var deleteChannelMessage = (params) => Effect_exports.gen(function* () {
+  const { channel, client, message } = yield* findChannelMessage(params);
   yield* client.removeDoc(
-    activity.class.Reaction,
-    reaction.space,
-    reaction._id
-  );
-  return {
-    messageId: ActivityMessageId.make(params.messageId),
-    removed: true
-  };
-});
-var listReactions = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const limit = clampLimit(params.limit);
-  const reactions = yield* client.findAll(
-    activity.class.Reaction,
-    {
-      attachedTo: toRef(params.messageId)
-    },
-    { limit }
+    chunter.class.ChatMessage,
+    channel._id,
+    message._id
   );
-  const result = reactions.map((r) => ({
-    id: ReactionId.make(r._id),
-    messageId: ActivityMessageId.make(r.attachedTo),
-    emoji: EmojiCode.make(r.emoji),
-    createdBy: optionalPersonId(r.createBy)
-  }));
-  return result;
+  return { id: MessageId.make(message._id), deleted: true };
 });
-var saveMessage = (params) => Effect_exports.gen(function* () {
+
+// src/huly/operations/channels.ts
+var personIdsAsSocialIdentityRefs = (ids3) => ids3;
+var findChannel = (identifier2) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const message = yield* findOneOrFail(
+  const channel = yield* findByNameOrId(
     client,
-    activity.class.ActivityMessage,
-    { _id: toRef(params.messageId) },
-    () => new ActivityMessageNotFoundError({ messageId: params.messageId })
-  );
-  const savedId = (0, import_core19.generateId)();
-  yield* client.createDoc(
-    activity.class.SavedMessage,
-    core.space.Workspace,
-    {
-      attachedTo: message._id
-    },
-    savedId
+    chunter.class.Channel,
+    { name: identifier2 },
+    { _id: toRef(identifier2) }
   );
-  return {
-    savedId: SavedMessageId.make(savedId),
-    messageId: ActivityMessageId.make(params.messageId)
-  };
+  if (channel === void 0) {
+    return yield* new ChannelNotFoundError({ identifier: identifier2 });
+  }
+  return { client, channel };
 });
-var unsaveMessage = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const saved = yield* findOneOrFail(
-    client,
-    activity.class.SavedMessage,
-    {
-      attachedTo: toRef(params.messageId)
-    },
-    () => new SavedMessageNotFoundError({ messageId: params.messageId })
-  );
-  yield* client.removeDoc(
-    activity.class.SavedMessage,
-    saved.space,
-    saved._id
+var buildSocialIdToPersonNameMap = (client, socialIds) => Effect_exports.gen(function* () {
+  if (socialIds.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const socialIdentities = yield* client.findAll(
+    contact.class.SocialIdentity,
+    { _id: { $in: personIdsAsSocialIdentityRefs(socialIds) } }
   );
-  return {
-    messageId: ActivityMessageId.make(params.messageId),
-    removed: true
-  };
-});
-var listSavedMessages = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const limit = clampLimit(params.limit);
-  const saved = yield* client.findAll(
-    activity.class.SavedMessage,
-    {},
-    { limit }
+  if (socialIdentities.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const personRefs = [...new Set(socialIdentities.map((si) => si.attachedTo))];
+  const persons = yield* client.findAll(
+    contact.class.Person,
+    { _id: { $in: personRefs } }
   );
-  const result = saved.map((s) => ({
-    id: SavedMessageId.make(s._id),
-    messageId: ActivityMessageId.make(s.attachedTo)
-  }));
+  const personById = new Map(persons.map((p) => [p._id, p]));
+  const result = /* @__PURE__ */ new Map();
+  for (const si of socialIdentities) {
+    const person = personById.get(si.attachedTo);
+    if (person !== void 0) {
+      result.set(si._id, person.name);
+    }
+  }
   return result;
 });
-var listMentions = (params) => Effect_exports.gen(function* () {
+var buildAccountUuidToNameMap = (client, accountUuids) => Effect_exports.gen(function* () {
+  if (accountUuids.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const employees = yield* client.findAll(
+    contact.mixin.Employee,
+    { personUuid: { $in: accountUuids } }
+  );
+  const result = /* @__PURE__ */ new Map();
+  for (const emp of employees) {
+    if (emp.personUuid !== void 0) {
+      result.set(emp.personUuid, emp.name);
+    }
+  }
+  return result;
+});
+var listChannels = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
+  const query = {};
+  if (!params.includeArchived) {
+    query.archived = false;
+  }
+  if (params.nameSearch !== void 0 && params.nameSearch.trim() !== "") {
+    query.name = { $like: `%${escapeLikeWildcards(params.nameSearch)}%` };
+  }
+  if (params.nameRegex !== void 0 && params.nameRegex.trim() !== "") {
+    query.name = { $regex: params.nameRegex };
+  }
+  if (params.topicSearch !== void 0 && params.topicSearch.trim() !== "") {
+    query.topic = { $like: `%${escapeLikeWildcards(params.topicSearch)}%` };
+  }
   const limit = clampLimit(params.limit);
-  const mentions = yield* client.findAll(
-    activity.class.UserMentionInfo,
-    {},
+  const channels = yield* client.findAll(
+    chunter.class.Channel,
+    query,
     {
       limit,
       sort: {
-        modifiedOn: import_core19.SortingOrder.Descending
+        name: import_core19.SortingOrder.Ascending
       }
     }
   );
-  const result = mentions.map((m) => ({
-    id: MentionId.make(m._id),
-    messageId: ActivityMessageId.make(m.attachedTo),
-    userId: PersonId.make(m.user),
-    content: m.content
+  const summaries = channels.map((ch) => ({
+    id: ChannelId.make(ch._id),
+    name: ChannelName.make(ch.name),
+    topic: ch.topic || void 0,
+    private: ch.private,
+    archived: ch.archived,
+    members: ch.members.length,
+    messages: ch.messages,
+    modifiedOn: ch.modifiedOn
   }));
+  return summaries;
+});
+var getChannel = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  const memberNames = channel.members.length > 0 ? yield* Effect_exports.gen(function* () {
+    const accountUuidToName = yield* buildAccountUuidToNameMap(client, channel.members);
+    return channel.members.map((m) => accountUuidToName.get(m)).filter((n) => n !== void 0);
+  }) : void 0;
+  const result = {
+    id: ChannelId.make(channel._id),
+    name: ChannelName.make(channel.name),
+    topic: channel.topic || void 0,
+    description: channel.description || void 0,
+    private: channel.private,
+    archived: channel.archived,
+    members: memberNames?.map((m) => PersonName.make(m)),
+    messages: channel.messages,
+    modifiedOn: channel.modifiedOn,
+    createdOn: channel.createdOn
+  };
   return result;
 });
-
-// src/mcp/tools/registry.ts
-var deriveTitle = (name) => name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
-var READ_PREFIXES = ["list_", "get_", "search_", "fulltext_", "download_", "preview_"];
-var CREATE_PREFIXES = ["create_", "add_", "upload_", "send_", "log_"];
-var UPDATE_PREFIXES = [
-  "update_",
-  "edit_",
-  "set_",
-  "pin_",
-  "unpin_",
-  "mark_",
-  "archive_",
-  "start_",
-  "stop_",
-  "save_",
-  "unsave_",
-  "remove_",
-  "move_"
-];
-var DELETE_PREFIXES = ["delete_"];
-var matchesPrefix = (name, prefixes) => prefixes.some((p) => name.startsWith(p));
-var deriveAnnotations = (name) => {
-  const title = deriveTitle(name);
-  if (matchesPrefix(name, READ_PREFIXES)) {
-    return { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
-  }
-  if (matchesPrefix(name, CREATE_PREFIXES)) {
-    return { title, readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
-  }
-  if (matchesPrefix(name, UPDATE_PREFIXES)) {
-    return { title, readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
-  }
-  if (matchesPrefix(name, DELETE_PREFIXES)) {
-    return { title, readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };
-  }
-  return { title, readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
-};
-var resolveAnnotations = (tool) => ({
-  ...deriveAnnotations(tool.name),
-  ...tool.annotations
+var createChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const channelId = (0, import_core19.generateId)();
+  const channelData = {
+    name: params.name,
+    topic: params.topic || "",
+    description: "",
+    private: params.private ?? false,
+    archived: false,
+    members: [client.getAccountUuid()],
+    owners: [client.getAccountUuid()]
+  };
+  yield* client.createDoc(
+    chunter.class.Channel,
+    toRef(channelId),
+    channelData,
+    channelId
+  );
+  return { id: ChannelId.make(channelId), name: ChannelName.make(params.name) };
 });
-var encodeOutput = (schema, result) => Schema_exports.encodeUnknownSync(schema)(result);
-var provideHulyClient = (args2) => (effect2) => Either_exports.right(effect2.pipe(Effect_exports.provideService(HulyClient, args2.hulyClient)));
-var provideStorageClient = (args2) => (effect2) => Either_exports.right(effect2.pipe(Effect_exports.provideService(HulyStorageClient, args2.storageClient)));
-var provideCombinedClient = (args2) => (effect2) => Either_exports.right(
-  effect2.pipe(
-    Effect_exports.provideService(HulyClient, args2.hulyClient),
-    Effect_exports.provideService(HulyStorageClient, args2.storageClient)
-  )
-);
-var provideWorkspaceClient = (args2) => (effect2) => args2.workspaceClient !== void 0 ? Either_exports.right(effect2.pipe(Effect_exports.provideService(WorkspaceClient, args2.workspaceClient))) : Either_exports.left(mapDomainErrorToMcp(new HulyError({ message: "WorkspaceClient not available" })));
-var createHandler = (toolName, provide4, parse5, operation, encode8) => async (args2, hulyClient, storageClient, workspaceClient) => {
-  const parseResult = await Effect_exports.runPromiseExit(parse5(args2));
-  if (Exit_exports.isFailure(parseResult)) {
-    return mapParseCauseToMcp(parseResult.cause, toolName);
-  }
-  const provided = provide4({ hulyClient, storageClient, workspaceClient })(operation(parseResult.value));
-  if (Either_exports.isLeft(provided)) {
-    return provided.left;
+var updateChannel = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  const updateOps = {};
+  if (params.name !== void 0) {
+    updateOps.name = params.name;
   }
-  const operationResult = await Effect_exports.runPromiseExit(provided.right);
-  if (Exit_exports.isFailure(operationResult)) {
-    return mapDomainCauseToMcp(operationResult.cause);
+  if (params.topic !== void 0) {
+    updateOps.topic = params.topic;
   }
-  try {
-    const output = encode8 !== void 0 ? encode8(operationResult.value) : operationResult.value;
-    return createSuccessResponse(output);
-  } catch {
-    return mapDomainErrorToMcp(new HulyError({ message: `Tool ${toolName} produced invalid output` }));
+  if (Object.keys(updateOps).length === 0) {
+    return { id: ChannelId.make(channel._id), updated: false };
   }
-};
-var createToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideHulyClient, parse5, operation);
-var createEncodedToolHandler = (toolName, parse5, operation, outputSchema) => createHandler(
-  toolName,
-  provideHulyClient,
-  parse5,
-  operation,
-  (result) => encodeOutput(outputSchema, result)
-);
-var createStorageToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideStorageClient, parse5, operation);
-var createCombinedToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideCombinedClient, parse5, operation);
-var createEncodedWorkspaceToolHandler = (toolName, parse5, operation, outputSchema) => createHandler(
-  toolName,
-  provideWorkspaceClient,
-  parse5,
-  operation,
-  (result) => encodeOutput(outputSchema, result)
-);
-var createEncodedNoParamsWorkspaceToolHandler = (toolName, operation, outputSchema) => createHandler(
-  toolName,
-  provideWorkspaceClient,
-  () => Effect_exports.succeed(void 0),
-  operation,
-  (result) => encodeOutput(outputSchema, result)
-);
-
-// src/mcp/tools/activity.ts
-var CATEGORY = "activity";
-var activityTools = [
-  {
-    name: "list_activity",
-    description: "List activity messages for a Huly object. Returns activity sorted by date (newest first).",
-    category: CATEGORY,
-    inputSchema: listActivityParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "list_activity",
-      parseListActivityParams,
-      listActivity,
-      ListActivityResultSchema
-    )
-  },
-  {
-    name: "add_reaction",
-    description: "Add an emoji reaction to an activity message.",
-    category: CATEGORY,
-    inputSchema: addReactionParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "add_reaction",
-      parseAddReactionParams,
-      addReaction,
-      AddReactionResultSchema
+  yield* client.updateDoc(
+    chunter.class.Channel,
+    toRef(channel._id),
+    channel._id,
+    updateOps
+  );
+  return { id: ChannelId.make(channel._id), updated: true };
+});
+var deleteChannel = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  yield* client.removeDoc(
+    chunter.class.Channel,
+    toRef(channel._id),
+    channel._id
+  );
+  return { id: ChannelId.make(channel._id), deleted: true };
+});
+var listChannelMessages = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  const markupUrlConfig = client.markupUrlConfig;
+  const limit = clampLimit(params.limit);
+  const messages = yield* client.findAll(
+    chunter.class.ChatMessage,
+    {
+      space: channel._id
+    },
+    {
+      limit,
+      sort: {
+        createdOn: import_core19.SortingOrder.Descending
+      }
+    }
+  );
+  const total = messages.total;
+  const uniqueSocialIds = [
+    ...new Set(
+      messages.map((msg) => msg.modifiedBy)
     )
-  },
-  {
-    name: "remove_reaction",
-    description: "Remove an emoji reaction from an activity message.",
-    category: CATEGORY,
-    inputSchema: removeReactionParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "remove_reaction",
-      parseRemoveReactionParams,
-      removeReaction,
-      RemoveReactionResultSchema
-    )
-  },
-  {
-    name: "list_reactions",
-    description: "List reactions on an activity message.",
-    category: CATEGORY,
-    inputSchema: listReactionsParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "list_reactions",
-      parseListReactionsParams,
-      listReactions,
-      ListReactionsResultSchema
-    )
-  },
-  {
-    name: "save_message",
-    description: "Save/bookmark an activity message for later reference.",
-    category: CATEGORY,
-    inputSchema: saveMessageParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "save_message",
-      parseSaveMessageParams,
-      saveMessage,
-      SaveMessageResultSchema
-    )
-  },
-  {
-    name: "unsave_message",
-    description: "Remove an activity message from saved/bookmarks.",
-    category: CATEGORY,
-    inputSchema: unsaveMessageParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "unsave_message",
-      parseUnsaveMessageParams,
-      unsaveMessage,
-      UnsaveMessageResultSchema
-    )
-  },
-  {
-    name: "list_saved_messages",
-    description: "List saved/bookmarked activity messages.",
-    category: CATEGORY,
-    inputSchema: listSavedMessagesParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "list_saved_messages",
-      parseListSavedMessagesParams,
-      listSavedMessages,
-      ListSavedMessagesResultSchema
-    )
-  },
-  {
-    name: "list_mentions",
-    description: "List @mentions of the current user in activity messages.",
-    category: CATEGORY,
-    inputSchema: listMentionsParamsJsonSchema,
-    handler: createEncodedToolHandler(
-      "list_mentions",
-      parseListMentionsParams,
-      listMentions,
-      ListMentionsResultSchema
-    )
-  }
-];
-
-// src/domain/schemas/attachments.ts
-var ListAttachmentsParamsSchema = Schema_exports.Struct({
-  objectId: NonEmptyString2.annotations({
-    description: "ID of the parent object (issue, document, etc.)"
-  }),
-  objectClass: ObjectClassName.annotations({
-    description: "Class of the parent object (e.g., 'tracker:class:Issue', 'document:class:Document')"
-  }),
-  limit: Schema_exports.optional(
-    LimitParam.annotations({
-      description: "Maximum number of attachments to return (default: 50)"
-    })
-  )
-}).annotations({
-  title: "ListAttachmentsParams",
-  description: "Parameters for listing attachments on an object"
-});
-var GetAttachmentParamsSchema = Schema_exports.Struct({
-  attachmentId: AttachmentId.annotations({
-    description: "Attachment ID"
-  })
-}).annotations({
-  title: "GetAttachmentParams",
-  description: "Parameters for getting a single attachment"
-});
-var FileSourceFields = {
-  filename: NonEmptyString2.annotations({
-    description: "Name of the file"
-  }),
-  contentType: MimeType.annotations({
-    description: "MIME type of the file (e.g., 'image/png', 'application/pdf')"
-  }),
-  filePath: Schema_exports.optional(Schema_exports.String.annotations({
-    description: "Local file path to upload (preferred - avoids context flooding)"
-  })),
-  fileUrl: Schema_exports.optional(Schema_exports.String.annotations({
-    description: "URL to fetch file from (for remote files)"
-  })),
-  data: Schema_exports.optional(Schema_exports.String.annotations({
-    description: "Base64-encoded file data (fallback for small files <10KB)"
-  })),
-  description: Schema_exports.optional(Schema_exports.String.annotations({
-    description: "Attachment description"
-  })),
-  pinned: Schema_exports.optional(Schema_exports.Boolean.annotations({
-    description: "Whether to pin the attachment (default: false)"
-  }))
-};
-var hasFileSource = (params) => {
-  const hasSource = params.filePath || params.fileUrl || params.data;
-  return hasSource ? true : "Must provide filePath, fileUrl, or data";
-};
-var AddAttachmentParamsBase = Schema_exports.Struct({
-  objectId: NonEmptyString2.annotations({
-    description: "ID of the parent object (issue, document, etc.)"
-  }),
-  objectClass: ObjectClassName.annotations({
-    description: "Class of the parent object (e.g., 'tracker:class:Issue', 'document:class:Document')"
-  }),
-  space: SpaceId.annotations({
-    description: "Space ID where the parent object resides"
-  }),
-  ...FileSourceFields
-});
-var AddAttachmentParamsSchema = AddAttachmentParamsBase.pipe(
-  Schema_exports.filter(hasFileSource)
-).annotations({
-  title: "AddAttachmentParams",
-  description: "Parameters for adding an attachment. Provide ONE of: filePath, fileUrl, or data"
-});
-var UpdateAttachmentParamsSchema = Schema_exports.Struct({
-  attachmentId: AttachmentId.annotations({
-    description: "Attachment ID"
-  }),
-  description: Schema_exports.optional(
-    Schema_exports.NullOr(Schema_exports.String).annotations({
-      description: "New description (null to clear)"
-    })
-  ),
-  pinned: Schema_exports.optional(Schema_exports.Boolean.annotations({
-    description: "Pin or unpin the attachment"
-  }))
-}).annotations({
-  title: "UpdateAttachmentParams",
-  description: "Parameters for updating an attachment"
-});
-var DeleteAttachmentParamsSchema = Schema_exports.Struct({
-  attachmentId: AttachmentId.annotations({
-    description: "Attachment ID to delete"
-  })
-}).annotations({
-  title: "DeleteAttachmentParams",
-  description: "Parameters for deleting an attachment"
-});
-var PinAttachmentParamsSchema = Schema_exports.Struct({
-  attachmentId: AttachmentId.annotations({
-    description: "Attachment ID"
-  }),
-  pinned: Schema_exports.Boolean.annotations({
-    description: "Whether to pin (true) or unpin (false)"
-  })
-}).annotations({
-  title: "PinAttachmentParams",
-  description: "Parameters for pinning/unpinning an attachment"
-});
-var DownloadAttachmentParamsSchema = Schema_exports.Struct({
-  attachmentId: AttachmentId.annotations({
-    description: "Attachment ID"
-  })
-}).annotations({
-  title: "DownloadAttachmentParams",
-  description: "Parameters for getting attachment download URL"
-});
-var AddIssueAttachmentParamsBase = Schema_exports.Struct({
-  project: ProjectIdentifier.annotations({
-    description: "Project identifier (e.g., 'HULY')"
-  }),
-  identifier: IssueIdentifier.annotations({
-    description: "Issue identifier (e.g., 'HULY-123')"
-  }),
-  ...FileSourceFields
-});
-var AddIssueAttachmentParamsSchema = AddIssueAttachmentParamsBase.pipe(
-  Schema_exports.filter(hasFileSource)
-).annotations({
-  title: "AddIssueAttachmentParams",
-  description: "Parameters for adding an attachment to an issue"
-});
-var AddDocumentAttachmentParamsBase = Schema_exports.Struct({
-  teamspace: TeamspaceIdentifier.annotations({
-    description: "Teamspace name or ID"
-  }),
-  document: DocumentIdentifier.annotations({
-    description: "Document title or ID"
-  }),
-  ...FileSourceFields
+  ];
+  const socialIdToName = yield* buildSocialIdToPersonNameMap(client, uniqueSocialIds);
+  const summaries = messages.map((msg) => {
+    const senderName = socialIdToName.get(msg.modifiedBy);
+    return {
+      id: MessageId.make(msg._id),
+      body: markupToMarkdownString(msg.message, markupUrlConfig),
+      sender: senderName !== void 0 ? PersonName.make(senderName) : void 0,
+      senderId: msg.modifiedBy,
+      createdOn: msg.createdOn,
+      modifiedOn: msg.modifiedOn,
+      editedOn: msg.editedOn,
+      replies: msg.replies
+    };
+  });
+  return { messages: summaries, total };
 });
-var AddDocumentAttachmentParamsSchema = AddDocumentAttachmentParamsBase.pipe(
-  Schema_exports.filter(hasFileSource)
-).annotations({
-  title: "AddDocumentAttachmentParams",
-  description: "Parameters for adding an attachment to a document"
+var sendChannelMessage = (params) => Effect_exports.gen(function* () {
+  const { channel, client } = yield* findChannel(params.channel);
+  const markupUrlConfig = client.markupUrlConfig;
+  const messageId = (0, import_core19.generateId)();
+  const markup = markdownToMarkupString(params.body, markupUrlConfig);
+  const messageData = {
+    message: markup,
+    attachments: 0
+  };
+  yield* client.addCollection(
+    chunter.class.ChatMessage,
+    channel._id,
+    channel._id,
+    chunter.class.Channel,
+    "messages",
+    messageData,
+    messageId
+  );
+  return { id: MessageId.make(messageId), channelId: ChannelId.make(channel._id) };
+});
+var listDirectMessages = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const limit = clampLimit(params.limit);
+  const dms = yield* client.findAll(
+    chunter.class.DirectMessage,
+    { members: client.getAccountUuid() },
+    {
+      limit,
+      sort: {
+        modifiedOn: import_core19.SortingOrder.Descending
+      }
+    }
+  );
+  const total = dms.total;
+  const uniqueAccountUuids = [
+    ...new Set(
+      dms.flatMap((dm) => dm.members)
+    )
+  ];
+  const accountUuidToName = yield* buildAccountUuidToNameMap(client, uniqueAccountUuids);
+  const summaries = dms.map((dm) => {
+    const participants = dm.members.map((m) => accountUuidToName.get(m)).filter((n) => n !== void 0).map((n) => PersonName.make(n));
+    const participantIds = dm.members.map((m) => AccountUuid.make(m));
+    return {
+      id: ChannelId.make(dm._id),
+      participants,
+      participantIds,
+      messages: dm.messages,
+      modifiedOn: dm.modifiedOn
+    };
+  });
+  return { conversations: summaries, total };
 });
-var listAttachmentsParamsJsonSchema = JSONSchema_exports.make(ListAttachmentsParamsSchema);
-var getAttachmentParamsJsonSchema = JSONSchema_exports.make(GetAttachmentParamsSchema);
-var addAttachmentParamsJsonSchema = JSONSchema_exports.make(AddAttachmentParamsSchema);
-var updateAttachmentParamsJsonSchema = JSONSchema_exports.make(UpdateAttachmentParamsSchema);
-var deleteAttachmentParamsJsonSchema = JSONSchema_exports.make(DeleteAttachmentParamsSchema);
-var pinAttachmentParamsJsonSchema = JSONSchema_exports.make(PinAttachmentParamsSchema);
-var downloadAttachmentParamsJsonSchema = JSONSchema_exports.make(DownloadAttachmentParamsSchema);
-var addIssueAttachmentParamsJsonSchema = JSONSchema_exports.make(AddIssueAttachmentParamsSchema);
-var addDocumentAttachmentParamsJsonSchema = JSONSchema_exports.make(AddDocumentAttachmentParamsSchema);
-var parseListAttachmentsParams = Schema_exports.decodeUnknown(ListAttachmentsParamsSchema);
-var parseGetAttachmentParams = Schema_exports.decodeUnknown(GetAttachmentParamsSchema);
-var parseAddAttachmentParams = Schema_exports.decodeUnknown(AddAttachmentParamsSchema);
-var parseUpdateAttachmentParams = Schema_exports.decodeUnknown(UpdateAttachmentParamsSchema);
-var parseDeleteAttachmentParams = Schema_exports.decodeUnknown(DeleteAttachmentParamsSchema);
-var parsePinAttachmentParams = Schema_exports.decodeUnknown(PinAttachmentParamsSchema);
-var parseDownloadAttachmentParams = Schema_exports.decodeUnknown(DownloadAttachmentParamsSchema);
-var parseAddIssueAttachmentParams = Schema_exports.decodeUnknown(AddIssueAttachmentParamsSchema);
-var parseAddDocumentAttachmentParams = Schema_exports.decodeUnknown(AddDocumentAttachmentParamsSchema);
-
-// src/huly/operations/attachments.ts
-var import_core23 = __toESM(require_lib4(), 1);
 
 // src/huly/operations/documents.ts
-var import_core22 = __toESM(require_lib4(), 1);
+var import_core21 = __toESM(require_lib4(), 1);
 var import_rank = __toESM(require_lib33(), 1);
 
 // src/huly/operations/documents-edit.ts
@@ -172412,875 +172270,1141 @@ var editDocument = (params) => Effect_exports.gen(function* () {
       updateOps.content = contentMarkupRef;
     }
   }
-  if (params.old_text !== void 0 && params.new_text !== void 0) {
-    if (!doc.content) {
-      return yield* new DocumentEmptyContentError({ identifier: params.document });
-    }
-    const currentContent = yield* client.fetchMarkup(
-      doc._class,
-      doc._id,
-      "content",
-      doc.content,
-      "markdown"
-    );
-    const occurrences = countOccurrences(currentContent, params.old_text);
-    if (occurrences === 0) {
-      return yield* new DocumentTextNotFoundError({ searchText: params.old_text });
-    }
-    if (occurrences > 1 && !params.replace_all) {
-      return yield* new DocumentTextMultipleMatchesError({
-        searchText: params.old_text,
-        matchCount: occurrences
-      });
-    }
-    const idx = currentContent.indexOf(params.old_text);
-    const newContent = params.replace_all ? currentContent.split(params.old_text).join(params.new_text) : currentContent.substring(0, idx) + params.new_text + currentContent.substring(idx + params.old_text.length);
-    yield* client.updateMarkup(
-      documentPlugin.class.Document,
-      doc._id,
-      "content",
-      newContent,
-      "markdown"
-    );
-    contentUpdatedInPlace = true;
+  if (params.old_text !== void 0 && params.new_text !== void 0) {
+    if (!doc.content) {
+      return yield* new DocumentEmptyContentError({ identifier: params.document });
+    }
+    const currentContent = yield* client.fetchMarkup(
+      doc._class,
+      doc._id,
+      "content",
+      doc.content,
+      "markdown"
+    );
+    const occurrences = countOccurrences(currentContent, params.old_text);
+    if (occurrences === 0) {
+      return yield* new DocumentTextNotFoundError({ searchText: params.old_text });
+    }
+    if (occurrences > 1 && !params.replace_all) {
+      return yield* new DocumentTextMultipleMatchesError({
+        searchText: params.old_text,
+        matchCount: occurrences
+      });
+    }
+    const idx = currentContent.indexOf(params.old_text);
+    const newContent = params.replace_all ? currentContent.split(params.old_text).join(params.new_text) : currentContent.substring(0, idx) + params.new_text + currentContent.substring(idx + params.old_text.length);
+    yield* client.updateMarkup(
+      documentPlugin.class.Document,
+      doc._id,
+      "content",
+      newContent,
+      "markdown"
+    );
+    contentUpdatedInPlace = true;
+  }
+  const finalTitle = updateOps.title ?? doc.title;
+  const url4 = buildDocumentUrlFromConfig(client.workbenchUrlConfig, finalTitle, DocumentId.make(doc._id));
+  if (Object.keys(updateOps).length === 0 && !contentUpdatedInPlace) {
+    return { id: DocumentId.make(doc._id), updated: false, url: url4 };
+  }
+  if (Object.keys(updateOps).length > 0) {
+    yield* client.updateDoc(
+      documentPlugin.class.Document,
+      teamspace._id,
+      doc._id,
+      updateOps
+    );
+  }
+  return { id: DocumentId.make(doc._id), updated: true, url: url4 };
+});
+var countOccurrences = (text, search) => {
+  let count3 = 0;
+  let pos = text.indexOf(search);
+  while (pos !== -1) {
+    count3++;
+    pos = text.indexOf(search, pos + search.length);
+  }
+  return count3;
+};
+
+// src/huly/operations/documents-inline-comments.ts
+var import_core20 = __toESM(require_lib4(), 1);
+var import_text3 = __toESM(require_lib9(), 1);
+var INLINE_COMMENT_MARK_TYPE = "inline-comment";
+var extractInlineComments = (root) => {
+  const threadMap = /* @__PURE__ */ new Map();
+  (0, import_text3.traverseAllMarks)(root, (textNode, mark) => {
+    if (String(mark.type) !== INLINE_COMMENT_MARK_TYPE) return;
+    const threadId = mark.attrs?.thread;
+    if (typeof threadId !== "string" || threadId === "") return;
+    const text = textNode.text ?? "";
+    if (!threadMap.has(threadId)) {
+      threadMap.set(threadId, []);
+    }
+    threadMap.get(threadId)?.push(text);
+  });
+  return [...threadMap.entries()].map(([threadId, textFragments]) => ({
+    threadId,
+    textFragments
+  }));
+};
+var listInlineComments = (params) => Effect_exports.gen(function* () {
+  const { client, doc } = yield* findTeamspaceAndDocument({
+    teamspace: params.teamspace,
+    document: params.document
+  });
+  const markupUrlConfig = client.markupUrlConfig;
+  if (!doc.content) {
+    return { comments: [], total: 0 };
+  }
+  const rawMarkup = yield* client.fetchMarkup(
+    doc._class,
+    doc._id,
+    "content",
+    doc.content,
+    "markup"
+  );
+  const root = (0, import_text3.markupToJSON)(rawMarkup);
+  const extracted = extractInlineComments(root);
+  if (extracted.length === 0) {
+    return { comments: [], total: 0 };
+  }
+  let nameMap = /* @__PURE__ */ new Map();
+  const threadRepliesMap = /* @__PURE__ */ new Map();
+  if (params.includeReplies) {
+    const threadIds = extracted.map((c) => toRef(c.threadId));
+    const allReplies = yield* client.findAll(
+      chunter.class.ThreadMessage,
+      { attachedTo: { $in: threadIds } },
+      { sort: { createdOn: import_core20.SortingOrder.Ascending } }
+    );
+    for (const r of allReplies) {
+      const key = r.attachedTo;
+      if (!threadRepliesMap.has(key)) {
+        threadRepliesMap.set(key, []);
+      }
+      threadRepliesMap.get(key)?.push(r);
+    }
+    const senderIds = [
+      ...new Set(
+        allReplies.map((r) => r.createdBy).filter((id) => id !== void 0)
+      )
+    ];
+    nameMap = yield* buildSocialIdToPersonNameMap(client, senderIds);
+  }
+  const comments = extracted.map((comment) => {
+    const thread = {
+      threadId: comment.threadId,
+      text: comment.textFragments.join("")
+    };
+    if (params.includeReplies) {
+      const threadReplies = threadRepliesMap.get(comment.threadId) ?? [];
+      const replies = threadReplies.map((r) => ({
+        id: r._id,
+        body: optionalMarkupToMarkdown(r.message, markupUrlConfig, ""),
+        sender: r.createdBy !== void 0 ? nameMap.get(r.createdBy) : void 0,
+        createdOn: r.createdOn
+      }));
+      return { ...thread, replies };
+    }
+    return thread;
+  });
+  return { comments, total: comments.length };
+});
+
+// src/huly/operations/documents.ts
+var findTeamspace = (identifier2, opts) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const nameQuery = { name: identifier2 };
+  const idQuery = { _id: toRef(identifier2) };
+  if (!opts?.includeArchived) {
+    nameQuery.archived = false;
+    idQuery.archived = false;
+  }
+  const teamspace = yield* findByNameOrId(
+    client,
+    documentPlugin.class.Teamspace,
+    nameQuery,
+    idQuery
+  );
+  if (teamspace === void 0) {
+    return yield* new TeamspaceNotFoundError({ identifier: identifier2 });
+  }
+  return { client, teamspace };
+});
+var findTeamspaceAndDocument = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace);
+  const doc = yield* findByNameOrId(
+    client,
+    documentPlugin.class.Document,
+    { space: teamspace._id, title: params.document },
+    { space: teamspace._id, _id: toRef(params.document) }
+  );
+  if (doc === void 0) {
+    return yield* new DocumentNotFoundError({
+      identifier: params.document,
+      teamspace: params.teamspace
+    });
+  }
+  return { client, teamspace, doc };
+});
+var listTeamspaces = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const query = {};
+  if (!params.includeArchived) {
+    query.archived = false;
+  }
+  const limit = clampLimit(params.limit);
+  const teamspaces = yield* client.findAll(
+    documentPlugin.class.Teamspace,
+    query,
+    {
+      limit,
+      sort: {
+        name: import_core21.SortingOrder.Ascending
+      }
+    }
+  );
+  const total = teamspaces.total;
+  const summaries = teamspaces.map((ts) => ({
+    id: TeamspaceId.make(ts._id),
+    name: ts.name,
+    description: ts.description || void 0,
+    archived: ts.archived,
+    private: ts.private
+  }));
+  return {
+    teamspaces: summaries,
+    total
+  };
+});
+var getTeamspace = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
+  const docs = yield* client.findAll(
+    documentPlugin.class.Document,
+    { space: teamspace._id },
+    { limit: 1, total: true }
+  );
+  return {
+    id: TeamspaceId.make(teamspace._id),
+    name: teamspace.name,
+    description: teamspace.description || void 0,
+    archived: teamspace.archived,
+    private: teamspace.private,
+    documents: docs.total
+  };
+});
+var createTeamspace = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const existing = yield* client.findOne(
+    documentPlugin.class.Teamspace,
+    { name: params.name, archived: false }
+  );
+  if (existing !== void 0) {
+    return {
+      id: TeamspaceId.make(existing._id),
+      name: existing.name,
+      created: false
+    };
+  }
+  const teamspaceId = (0, import_core21.generateId)();
+  const teamspaceData = {
+    name: params.name,
+    description: params.description ?? "",
+    private: params.private ?? false,
+    archived: false,
+    members: [client.getAccountUuid()],
+    owners: [client.getAccountUuid()],
+    icon: documentPlugin.icon.Teamspace,
+    type: documentPlugin.spaceType.DefaultTeamspaceType
+  };
+  yield* client.createDoc(
+    documentPlugin.class.Teamspace,
+    core.space.Space,
+    teamspaceData,
+    teamspaceId
+  );
+  return {
+    id: TeamspaceId.make(teamspaceId),
+    name: params.name,
+    created: true
+  };
+});
+var updateTeamspace = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
+  const updateOps = {};
+  if (params.name !== void 0) {
+    updateOps.name = params.name;
+  }
+  if (params.description !== void 0) {
+    updateOps.description = params.description === null ? "" : params.description;
   }
-  const finalTitle = updateOps.title ?? doc.title;
-  const url4 = buildDocumentUrlFromConfig(client.workbenchUrlConfig, finalTitle, DocumentId.make(doc._id));
-  if (Object.keys(updateOps).length === 0 && !contentUpdatedInPlace) {
-    return { id: DocumentId.make(doc._id), updated: false, url: url4 };
+  if (params.archived !== void 0) {
+    updateOps.archived = params.archived;
   }
-  if (Object.keys(updateOps).length > 0) {
-    yield* client.updateDoc(
-      documentPlugin.class.Document,
-      teamspace._id,
-      doc._id,
-      updateOps
-    );
+  if (Object.keys(updateOps).length === 0) {
+    return { id: TeamspaceId.make(teamspace._id), updated: false };
   }
-  return { id: DocumentId.make(doc._id), updated: true, url: url4 };
+  yield* client.updateDoc(
+    documentPlugin.class.Teamspace,
+    core.space.Space,
+    teamspace._id,
+    updateOps
+  );
+  return { id: TeamspaceId.make(teamspace._id), updated: true };
 });
-var countOccurrences = (text, search) => {
-  let count3 = 0;
-  let pos = text.indexOf(search);
-  while (pos !== -1) {
-    count3++;
-    pos = text.indexOf(search, pos + search.length);
+var deleteTeamspace = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
+  yield* client.removeDoc(
+    documentPlugin.class.Teamspace,
+    core.space.Space,
+    teamspace._id
+  );
+  return { id: TeamspaceId.make(teamspace._id), deleted: true };
+});
+var listDocuments = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace);
+  const limit = clampLimit(params.limit);
+  const query = {
+    space: teamspace._id
+  };
+  if (params.titleSearch !== void 0 && params.titleSearch.trim() !== "") {
+    query.title = { $like: `%${escapeLikeWildcards(params.titleSearch)}%` };
   }
-  return count3;
-};
-
-// src/huly/operations/documents-inline-comments.ts
-var import_core21 = __toESM(require_lib4(), 1);
-var import_text3 = __toESM(require_lib9(), 1);
-
-// src/huly/operations/channels.ts
-var import_core20 = __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,
+  if (params.titleRegex !== void 0 && params.titleRegex.trim() !== "") {
+    query.title = { $regex: params.titleRegex };
+  }
+  if (params.contentSearch !== void 0 && params.contentSearch.trim() !== "") {
+    query.$search = params.contentSearch;
+  }
+  const documents = yield* client.findAll(
+    documentPlugin.class.Document,
+    query,
     {
-      _id: toRef(params.messageId),
-      space: channel._id
+      limit,
+      sort: {
+        modifiedOn: import_core21.SortingOrder.Descending
+      }
     }
   );
-  if (message === void 0) {
-    return yield* new MessageNotFoundError({
-      messageId: params.messageId,
-      channel: params.channel
-    });
-  }
-  return { client, channel, message };
+  const total = documents.total;
+  const summaries = documents.map((doc) => ({
+    id: DocumentId.make(doc._id),
+    title: doc.title,
+    teamspace: teamspace.name,
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
+    modifiedOn: doc.modifiedOn
+  }));
+  return {
+    documents: summaries,
+    total
+  };
 });
-
-// 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
+var getDocument = (params) => Effect_exports.gen(function* () {
+  const { client, doc, teamspace } = yield* findTeamspaceAndDocument({
+    teamspace: params.teamspace,
+    document: params.document
+  });
+  const content = doc.content ? yield* client.fetchMarkup(
+    doc._class,
+    doc._id,
+    "content",
+    doc.content,
+    "markdown"
+  ) : void 0;
+  const result = {
+    id: DocumentId.make(doc._id),
+    title: doc.title,
+    content,
+    teamspace: teamspace.name,
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
+    modifiedOn: doc.modifiedOn,
+    createdOn: doc.createdOn
   };
-  yield* client.updateDoc(
-    chunter.class.ChatMessage,
-    channel._id,
-    message._id,
-    updateOps
+  return result;
+});
+var createDocument = (params) => Effect_exports.gen(function* () {
+  const { client, teamspace } = yield* findTeamspace(params.teamspace);
+  const documentId = (0, import_core21.generateId)();
+  const parent = params.parent;
+  const parentRef = parent === void 0 ? documentPlugin.ids.NoParent : yield* Effect_exports.gen(function* () {
+    const parentDoc = yield* findByNameOrId(
+      client,
+      documentPlugin.class.Document,
+      { space: teamspace._id, title: parent },
+      { space: teamspace._id, _id: toRef(parent) }
+    );
+    if (parentDoc === void 0) {
+      return yield* new DocumentNotFoundError({
+        identifier: parent,
+        teamspace: params.teamspace
+      });
+    }
+    return parentDoc._id;
+  });
+  const lastDoc = yield* client.findOne(
+    documentPlugin.class.Document,
+    { space: teamspace._id },
+    { sort: { rank: import_core21.SortingOrder.Descending } }
   );
-  return { id: MessageId.make(message._id), updated: true };
+  const rank = (0, import_rank.makeRank)(lastDoc?.rank, void 0);
+  const contentMarkupRef = params.content !== void 0 && params.content.trim() !== "" ? yield* client.uploadMarkup(
+    documentPlugin.class.Document,
+    documentId,
+    "content",
+    params.content,
+    "markdown"
+  ) : null;
+  const documentData = {
+    title: params.title,
+    content: contentMarkupRef,
+    parent: parentRef,
+    rank
+  };
+  yield* client.createDoc(
+    documentPlugin.class.Document,
+    teamspace._id,
+    documentData,
+    documentId
+  );
+  return {
+    id: DocumentId.make(documentId),
+    title: params.title,
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, params.title, DocumentId.make(documentId))
+  };
 });
-var deleteChannelMessage = (params) => Effect_exports.gen(function* () {
-  const { channel, client, message } = yield* findChannelMessage(params);
+var deleteDocument = (params) => Effect_exports.gen(function* () {
+  const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
   yield* client.removeDoc(
-    chunter.class.ChatMessage,
-    channel._id,
-    message._id
+    documentPlugin.class.Document,
+    teamspace._id,
+    doc._id
   );
-  return { id: MessageId.make(message._id), deleted: true };
+  return { id: DocumentId.make(doc._id), deleted: true };
 });
 
-// src/huly/operations/channels.ts
-var personIdsAsSocialIdentityRefs = (ids3) => ids3;
-var findChannel = (identifier2) => Effect_exports.gen(function* () {
+// src/huly/operations/issues-shared.ts
+var import_tracker = __toESM(require_lib36(), 1);
+
+// src/utils/normalize.ts
+var normalizeForComparison = (s) => s.replace(/[-_ ]/g, "").toLowerCase();
+
+// src/huly/operations/issues-shared.ts
+var zeroAsUnset = (value3) => value3 > 0 ? PositiveNumber.make(value3) : void 0;
+var findProject = (projectIdentifier) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const channel = yield* findByNameOrId(
-    client,
-    chunter.class.Channel,
-    { name: identifier2 },
-    { _id: toRef(identifier2) }
+  const project3 = yield* findOneOrFail(
+    client,
+    tracker.class.Project,
+    { identifier: projectIdentifier },
+    () => new ProjectNotFoundError({ identifier: projectIdentifier })
   );
-  if (channel === void 0) {
-    return yield* new ChannelNotFoundError({ identifier: identifier2 });
-  }
-  return { client, channel };
+  return { client, project: project3 };
 });
-var buildSocialIdToPersonNameMap = (client, socialIds) => Effect_exports.gen(function* () {
-  if (socialIds.length === 0) {
-    return /* @__PURE__ */ new Map();
-  }
-  const socialIdentities = yield* client.findAll(
-    contact.class.SocialIdentity,
-    { _id: { $in: personIdsAsSocialIdentityRefs(socialIds) } }
-  );
-  if (socialIdentities.length === 0) {
-    return /* @__PURE__ */ new Map();
-  }
-  const personRefs = [...new Set(socialIdentities.map((si) => si.attachedTo))];
-  const persons = yield* client.findAll(
-    contact.class.Person,
-    { _id: { $in: personRefs } }
+var findProjectWithStatuses = (projectIdentifier) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const project3 = yield* findOneOrFail(
+    client,
+    tracker.class.Project,
+    { identifier: projectIdentifier },
+    () => new ProjectNotFoundError({ identifier: projectIdentifier }),
+    { lookup: { type: task.class.ProjectType } }
   );
-  const personById = new Map(persons.map((p) => [p._id, p]));
-  const result = /* @__PURE__ */ new Map();
-  for (const si of socialIdentities) {
-    const person = personById.get(si.attachedTo);
-    if (person !== void 0) {
-      result.set(si._id, person.name);
+  const projectType = project3.$lookup?.type;
+  const statuses = [];
+  if (projectType?.statuses) {
+    const statusRefs = projectType.statuses.map((s) => s._id);
+    if (statusRefs.length > 0) {
+      const statusDocsResult = yield* Effect_exports.either(
+        client.findAll(
+          core.class.Status,
+          { _id: { $in: statusRefs } }
+        )
+      );
+      if (statusDocsResult._tag === "Right") {
+        for (const doc of statusDocsResult.right) {
+          const categoryStr = doc.category ? doc.category : "";
+          statuses.push({
+            _id: doc._id,
+            name: doc.name,
+            isDone: categoryStr === task.statusCategory.Won,
+            isCanceled: categoryStr === task.statusCategory.Lost
+          });
+        }
+      } else {
+        yield* Effect_exports.logWarning(
+          `Status query failed for project ${projectIdentifier}, using fallback. Category-based filtering (open/done/canceled) will use name heuristics. Error: ${statusDocsResult.left.message}`
+        );
+        for (const ps of projectType.statuses) {
+          const name = ps._id.split(":").pop() ?? "Unknown";
+          const nameLower = name.toLowerCase();
+          const isDone5 = nameLower.includes("done") || nameLower.includes("complete") || nameLower.includes("finished") || nameLower.includes("resolved") || nameLower.includes("closed");
+          const isCanceled = nameLower.includes("cancel") || nameLower.includes("reject") || nameLower.includes("abort") || nameLower.includes("wontfix") || nameLower.includes("invalid");
+          statuses.push({
+            _id: ps._id,
+            name,
+            isDone: isDone5,
+            isCanceled
+          });
+        }
+      }
     }
   }
-  return result;
+  const defaultStatusId = project3.defaultIssueStatus || statuses[0]?._id;
+  return { client, project: project3, statuses, defaultStatusId };
 });
-var buildAccountUuidToNameMap = (client, accountUuids) => Effect_exports.gen(function* () {
-  if (accountUuids.length === 0) {
-    return /* @__PURE__ */ new Map();
+var parseIssueIdentifier = (identifier2, projectIdentifier) => {
+  const idStr = String(identifier2).trim();
+  const match16 = idStr.match(/^([A-Z]+)-(\d+)$/i);
+  if (match16) {
+    return {
+      fullIdentifier: `${match16[1].toUpperCase()}-${match16[2]}`,
+      number: parseInt(match16[2], 10)
+    };
   }
-  const employees = yield* client.findAll(
-    contact.mixin.Employee,
-    { personUuid: { $in: accountUuids } }
+  const numMatch = idStr.match(/^\d+$/);
+  if (numMatch) {
+    const num = parseInt(idStr, 10);
+    return {
+      fullIdentifier: `${projectIdentifier.toUpperCase()}-${num}`,
+      number: num
+    };
+  }
+  return { fullIdentifier: idStr, number: null };
+};
+var findIssueInProject = (client, project3, identifierStr) => Effect_exports.gen(function* () {
+  const { fullIdentifier, number: number8 } = parseIssueIdentifier(
+    identifierStr,
+    project3.identifier
   );
-  const result = /* @__PURE__ */ new Map();
-  for (const emp of employees) {
-    if (emp.personUuid !== void 0) {
-      result.set(emp.personUuid, emp.name);
+  const issue2 = (yield* client.findOne(
+    tracker.class.Issue,
+    {
+      space: project3._id,
+      identifier: fullIdentifier
     }
-  }
-  return result;
-});
-var listChannels = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const query = {};
-  if (!params.includeArchived) {
-    query.archived = false;
-  }
-  if (params.nameSearch !== void 0 && params.nameSearch.trim() !== "") {
-    query.name = { $like: `%${escapeLikeWildcards(params.nameSearch)}%` };
-  }
-  if (params.nameRegex !== void 0 && params.nameRegex.trim() !== "") {
-    query.name = { $regex: params.nameRegex };
-  }
-  if (params.topicSearch !== void 0 && params.topicSearch.trim() !== "") {
-    query.topic = { $like: `%${escapeLikeWildcards(params.topicSearch)}%` };
-  }
-  const limit = clampLimit(params.limit);
-  const channels = yield* client.findAll(
-    chunter.class.Channel,
-    query,
+  )) ?? (number8 !== null ? yield* client.findOne(
+    tracker.class.Issue,
     {
-      limit,
-      sort: {
-        name: import_core20.SortingOrder.Ascending
-      }
+      space: project3._id,
+      number: number8
     }
-  );
-  const summaries = channels.map((ch) => ({
-    id: ChannelId.make(ch._id),
-    name: ChannelName.make(ch.name),
-    topic: ch.topic || void 0,
-    private: ch.private,
-    archived: ch.archived,
-    members: ch.members.length,
-    messages: ch.messages,
-    modifiedOn: ch.modifiedOn
-  }));
-  return summaries;
+  ) : void 0);
+  if (issue2 === void 0) {
+    return yield* new IssueNotFoundError({
+      identifier: identifierStr,
+      project: project3.identifier
+    });
+  }
+  return issue2;
 });
-var getChannel = (params) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(params.channel);
-  const memberNames = channel.members.length > 0 ? yield* Effect_exports.gen(function* () {
-    const accountUuidToName = yield* buildAccountUuidToNameMap(client, channel.members);
-    return channel.members.map((m) => accountUuidToName.get(m)).filter((n) => n !== void 0);
-  }) : void 0;
-  const result = {
-    id: ChannelId.make(channel._id),
-    name: ChannelName.make(channel.name),
-    topic: channel.topic || void 0,
-    description: channel.description || void 0,
-    private: channel.private,
-    archived: channel.archived,
-    members: memberNames?.map((m) => PersonName.make(m)),
-    messages: channel.messages,
-    modifiedOn: channel.modifiedOn,
-    createdOn: channel.createdOn
-  };
-  return result;
+var findProjectAndIssue = (params) => Effect_exports.gen(function* () {
+  const { client, project: project3 } = yield* findProject(params.project);
+  const issue2 = yield* findIssueInProject(client, project3, params.identifier);
+  return { client, project: project3, issue: issue2 };
 });
-var createChannel = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const channelId = (0, import_core20.generateId)();
-  const channelData = {
-    name: params.name,
-    topic: params.topic || "",
-    description: "",
-    private: params.private ?? false,
-    archived: false,
-    members: [client.getAccountUuid()],
-    owners: [client.getAccountUuid()]
-  };
-  yield* client.createDoc(
-    chunter.class.Channel,
-    toRef(channelId),
-    channelData,
-    channelId
+var priorityToStringMap = {
+  [import_tracker.IssuePriority.Urgent]: "urgent",
+  [import_tracker.IssuePriority.High]: "high",
+  [import_tracker.IssuePriority.Medium]: "medium",
+  [import_tracker.IssuePriority.Low]: "low",
+  [import_tracker.IssuePriority.NoPriority]: "no-priority"
+};
+var priorityToString = (priority) => priorityToStringMap[priority];
+var stringToPriorityMap = {
+  "urgent": import_tracker.IssuePriority.Urgent,
+  "high": import_tracker.IssuePriority.High,
+  "medium": import_tracker.IssuePriority.Medium,
+  "low": import_tracker.IssuePriority.Low,
+  "no-priority": import_tracker.IssuePriority.NoPriority
+};
+var stringToPriority = (priority) => stringToPriorityMap[priority];
+var resolveStatusByName = (statuses, statusName, project3) => {
+  const normalizedInput = normalizeForComparison(statusName);
+  const matchingStatus = statuses.find(
+    (s) => normalizeForComparison(s.name) === normalizedInput
   );
-  return { id: ChannelId.make(channelId), name: ChannelName.make(params.name) };
-});
-var updateChannel = (params) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(params.channel);
-  const updateOps = {};
-  if (params.name !== void 0) {
-    updateOps.name = params.name;
-  }
-  if (params.topic !== void 0) {
-    updateOps.topic = params.topic;
-  }
-  if (Object.keys(updateOps).length === 0) {
-    return { id: ChannelId.make(channel._id), updated: false };
+  if (matchingStatus === void 0) {
+    return Effect_exports.fail(new InvalidStatusError({ status: statusName, project: project3 }));
   }
-  yield* client.updateDoc(
-    chunter.class.Channel,
-    toRef(channel._id),
-    channel._id,
-    updateOps
-  );
-  return { id: ChannelId.make(channel._id), updated: true };
+  return Effect_exports.succeed(matchingStatus._id);
+};
+
+// src/huly/operations/activity.ts
+var optionalTimestamp = (value3) => value3 === void 0 ? void 0 : Timestamp.make(value3);
+var optionalNullableTimestamp = (value3) => value3 === void 0 || value3 === null ? value3 : Timestamp.make(value3);
+var optionalActivityCount = (value3) => value3 === void 0 ? void 0 : ActivityCount.make(value3);
+var optionalPersonId = (value3) => value3 === void 0 || value3 === "" ? void 0 : PersonId.make(value3);
+var activityTarget = (client, objectId, objectClass) => ({
+  client,
+  objectId: NonEmptyString2.make(objectId),
+  objectClass: ObjectClassName.make(objectClass)
 });
-var deleteChannel = (params) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(params.channel);
-  yield* client.removeDoc(
-    chunter.class.Channel,
-    toRef(channel._id),
-    channel._id
+var resolveActivityTarget = (params) => Effect_exports.gen(function* () {
+  if (params.objectId !== void 0 && params.objectClass !== void 0) {
+    const client = yield* HulyClient;
+    return activityTarget(client, params.objectId, params.objectClass);
+  }
+  if (params.project !== void 0 && params.issueIdentifier !== void 0) {
+    const { client, issue: issue2 } = yield* findProjectAndIssue({
+      project: params.project,
+      identifier: params.issueIdentifier
+    });
+    return activityTarget(client, issue2._id, tracker.class.Issue);
+  }
+  if (params.teamspace !== void 0 && params.document !== void 0) {
+    const { client, doc } = yield* findTeamspaceAndDocument({
+      teamspace: params.teamspace,
+      document: params.document
+    });
+    return activityTarget(client, doc._id, documentPlugin.class.Document);
+  }
+  if (params.channel !== void 0) {
+    const { channel, client } = yield* findChannel(params.channel);
+    return activityTarget(client, channel._id, chunter.class.Channel);
+  }
+  return yield* Effect_exports.dieMessage(
+    "Invalid list_activity parameters: choose objectId+objectClass, project+issueIdentifier, teamspace+document, or channel."
   );
-  return { id: ChannelId.make(channel._id), deleted: true };
 });
-var listChannelMessages = (params) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(params.channel);
-  const markupUrlConfig = client.markupUrlConfig;
+var serverPopulatedCreateBy = "";
+var listActivity = (params) => Effect_exports.gen(function* () {
+  const target = yield* resolveActivityTarget(params);
   const limit = clampLimit(params.limit);
-  const messages = yield* client.findAll(
-    chunter.class.ChatMessage,
+  const messages = yield* target.client.findAll(
+    activity.class.ActivityMessage,
     {
-      space: channel._id
+      attachedTo: toRef(target.objectId),
+      attachedToClass: toRef(target.objectClass)
     },
     {
       limit,
       sort: {
-        createdOn: import_core20.SortingOrder.Descending
+        modifiedOn: import_core22.SortingOrder.Descending
       }
     }
   );
-  const total = messages.total;
-  const uniqueSocialIds = [
-    ...new Set(
-      messages.map((msg) => msg.modifiedBy)
-    )
-  ];
-  const socialIdToName = yield* buildSocialIdToPersonNameMap(client, uniqueSocialIds);
-  const summaries = messages.map((msg) => {
-    const senderName = socialIdToName.get(msg.modifiedBy);
-    return {
-      id: MessageId.make(msg._id),
-      body: markupToMarkdownString(msg.message, markupUrlConfig),
-      sender: senderName !== void 0 ? PersonName.make(senderName) : void 0,
-      senderId: msg.modifiedBy,
-      createdOn: msg.createdOn,
-      modifiedOn: msg.modifiedOn,
-      editedOn: msg.editedOn,
-      replies: msg.replies
-    };
-  });
-  return { messages: summaries, total };
+  const result = messages.map((msg) => ({
+    id: ActivityMessageId.make(msg._id),
+    objectId: NonEmptyString2.make(msg.attachedTo),
+    objectClass: ObjectClassName.make(msg.attachedToClass),
+    modifiedBy: PersonId.make(msg.modifiedBy),
+    modifiedOn: optionalTimestamp(msg.modifiedOn),
+    isPinned: msg.isPinned,
+    replies: optionalActivityCount(msg.replies),
+    reactions: optionalActivityCount(msg.reactions),
+    editedOn: optionalNullableTimestamp(msg.editedOn)
+  }));
+  return result;
 });
-var sendChannelMessage = (params) => Effect_exports.gen(function* () {
-  const { channel, client } = yield* findChannel(params.channel);
-  const markupUrlConfig = client.markupUrlConfig;
-  const messageId = (0, import_core20.generateId)();
-  const markup = markdownToMarkupString(params.body, markupUrlConfig);
-  const messageData = {
-    message: markup,
-    attachments: 0
+var addReaction = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const message = yield* findOneOrFail(
+    client,
+    activity.class.ActivityMessage,
+    { _id: toRef(params.messageId) },
+    () => new ActivityMessageNotFoundError({ messageId: params.messageId })
+  );
+  const reactionId = (0, import_core22.generateId)();
+  const reactionData = {
+    emoji: params.emoji,
+    createBy: serverPopulatedCreateBy
   };
   yield* client.addCollection(
-    chunter.class.ChatMessage,
-    channel._id,
-    channel._id,
-    chunter.class.Channel,
-    "messages",
-    messageData,
-    messageId
+    activity.class.Reaction,
+    message.space,
+    message._id,
+    activity.class.ActivityMessage,
+    "reactions",
+    reactionData,
+    reactionId
   );
-  return { id: MessageId.make(messageId), channelId: ChannelId.make(channel._id) };
+  return {
+    reactionId: ReactionId.make(reactionId),
+    messageId: ActivityMessageId.make(params.messageId)
+  };
 });
-var listDirectMessages = (params) => Effect_exports.gen(function* () {
+var removeReaction = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const limit = clampLimit(params.limit);
-  const dms = yield* client.findAll(
-    chunter.class.DirectMessage,
-    { members: client.getAccountUuid() },
+  const reaction = yield* findOneOrFail(
+    client,
+    activity.class.Reaction,
     {
-      limit,
-      sort: {
-        modifiedOn: import_core20.SortingOrder.Descending
-      }
-    }
+      attachedTo: toRef(params.messageId),
+      emoji: params.emoji
+    },
+    () => new ReactionNotFoundError({
+      messageId: params.messageId,
+      emoji: params.emoji
+    })
   );
-  const total = dms.total;
-  const uniqueAccountUuids = [
-    ...new Set(
-      dms.flatMap((dm) => dm.members)
-    )
-  ];
-  const accountUuidToName = yield* buildAccountUuidToNameMap(client, uniqueAccountUuids);
-  const summaries = dms.map((dm) => {
-    const participants = dm.members.map((m) => accountUuidToName.get(m)).filter((n) => n !== void 0).map((n) => PersonName.make(n));
-    const participantIds = dm.members.map((m) => AccountUuid.make(m));
-    return {
-      id: ChannelId.make(dm._id),
-      participants,
-      participantIds,
-      messages: dm.messages,
-      modifiedOn: dm.modifiedOn
-    };
-  });
-  return { conversations: summaries, total };
+  yield* client.removeDoc(
+    activity.class.Reaction,
+    reaction.space,
+    reaction._id
+  );
+  return {
+    messageId: ActivityMessageId.make(params.messageId),
+    removed: true
+  };
 });
-
-// src/huly/operations/documents-inline-comments.ts
-var INLINE_COMMENT_MARK_TYPE = "inline-comment";
-var extractInlineComments = (root) => {
-  const threadMap = /* @__PURE__ */ new Map();
-  (0, import_text3.traverseAllMarks)(root, (textNode, mark) => {
-    if (String(mark.type) !== INLINE_COMMENT_MARK_TYPE) return;
-    const threadId = mark.attrs?.thread;
-    if (typeof threadId !== "string" || threadId === "") return;
-    const text = textNode.text ?? "";
-    if (!threadMap.has(threadId)) {
-      threadMap.set(threadId, []);
-    }
-    threadMap.get(threadId)?.push(text);
-  });
-  return [...threadMap.entries()].map(([threadId, textFragments]) => ({
-    threadId,
-    textFragments
+var listReactions = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const limit = clampLimit(params.limit);
+  const reactions = yield* client.findAll(
+    activity.class.Reaction,
+    {
+      attachedTo: toRef(params.messageId)
+    },
+    { limit }
+  );
+  const result = reactions.map((r) => ({
+    id: ReactionId.make(r._id),
+    messageId: ActivityMessageId.make(r.attachedTo),
+    emoji: EmojiCode.make(r.emoji),
+    createdBy: optionalPersonId(r.createBy)
   }));
-};
-var listInlineComments = (params) => Effect_exports.gen(function* () {
-  const { client, doc } = yield* findTeamspaceAndDocument({
-    teamspace: params.teamspace,
-    document: params.document
-  });
-  const markupUrlConfig = client.markupUrlConfig;
-  if (!doc.content) {
-    return { comments: [], total: 0 };
-  }
-  const rawMarkup = yield* client.fetchMarkup(
-    doc._class,
-    doc._id,
-    "content",
-    doc.content,
-    "markup"
+  return result;
+});
+var saveMessage = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const message = yield* findOneOrFail(
+    client,
+    activity.class.ActivityMessage,
+    { _id: toRef(params.messageId) },
+    () => new ActivityMessageNotFoundError({ messageId: params.messageId })
   );
-  const root = (0, import_text3.markupToJSON)(rawMarkup);
-  const extracted = extractInlineComments(root);
-  if (extracted.length === 0) {
-    return { comments: [], total: 0 };
-  }
-  let nameMap = /* @__PURE__ */ new Map();
-  const threadRepliesMap = /* @__PURE__ */ new Map();
-  if (params.includeReplies) {
-    const threadIds = extracted.map((c) => toRef(c.threadId));
-    const allReplies = yield* client.findAll(
-      chunter.class.ThreadMessage,
-      { attachedTo: { $in: threadIds } },
-      { sort: { createdOn: import_core21.SortingOrder.Ascending } }
-    );
-    for (const r of allReplies) {
-      const key = r.attachedTo;
-      if (!threadRepliesMap.has(key)) {
-        threadRepliesMap.set(key, []);
-      }
-      threadRepliesMap.get(key)?.push(r);
-    }
-    const senderIds = [
-      ...new Set(
-        allReplies.map((r) => r.createdBy).filter((id) => id !== void 0)
-      )
-    ];
-    nameMap = yield* buildSocialIdToPersonNameMap(client, senderIds);
-  }
-  const comments = extracted.map((comment) => {
-    const thread = {
-      threadId: comment.threadId,
-      text: comment.textFragments.join("")
-    };
-    if (params.includeReplies) {
-      const threadReplies = threadRepliesMap.get(comment.threadId) ?? [];
-      const replies = threadReplies.map((r) => ({
-        id: r._id,
-        body: optionalMarkupToMarkdown(r.message, markupUrlConfig, ""),
-        sender: r.createdBy !== void 0 ? nameMap.get(r.createdBy) : void 0,
-        createdOn: r.createdOn
-      }));
-      return { ...thread, replies };
-    }
-    return thread;
-  });
-  return { comments, total: comments.length };
+  const savedId = (0, import_core22.generateId)();
+  yield* client.createDoc(
+    activity.class.SavedMessage,
+    core.space.Workspace,
+    {
+      attachedTo: message._id
+    },
+    savedId
+  );
+  return {
+    savedId: SavedMessageId.make(savedId),
+    messageId: ActivityMessageId.make(params.messageId)
+  };
 });
-
-// src/huly/operations/documents.ts
-var findTeamspace = (identifier2, opts) => Effect_exports.gen(function* () {
+var unsaveMessage = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const nameQuery = { name: identifier2 };
-  const idQuery = { _id: toRef(identifier2) };
-  if (!opts?.includeArchived) {
-    nameQuery.archived = false;
-    idQuery.archived = false;
-  }
-  const teamspace = yield* findByNameOrId(
+  const saved = yield* findOneOrFail(
     client,
-    documentPlugin.class.Teamspace,
-    nameQuery,
-    idQuery
+    activity.class.SavedMessage,
+    {
+      attachedTo: toRef(params.messageId)
+    },
+    () => new SavedMessageNotFoundError({ messageId: params.messageId })
   );
-  if (teamspace === void 0) {
-    return yield* new TeamspaceNotFoundError({ identifier: identifier2 });
-  }
-  return { client, teamspace };
+  yield* client.removeDoc(
+    activity.class.SavedMessage,
+    saved.space,
+    saved._id
+  );
+  return {
+    messageId: ActivityMessageId.make(params.messageId),
+    removed: true
+  };
 });
-var findTeamspaceAndDocument = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace);
-  const doc = yield* findByNameOrId(
-    client,
-    documentPlugin.class.Document,
-    { space: teamspace._id, title: params.document },
-    { space: teamspace._id, _id: toRef(params.document) }
+var listSavedMessages = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const limit = clampLimit(params.limit);
+  const saved = yield* client.findAll(
+    activity.class.SavedMessage,
+    {},
+    { limit }
   );
-  if (doc === void 0) {
-    return yield* new DocumentNotFoundError({
-      identifier: params.document,
-      teamspace: params.teamspace
-    });
-  }
-  return { client, teamspace, doc };
+  const result = saved.map((s) => ({
+    id: SavedMessageId.make(s._id),
+    messageId: ActivityMessageId.make(s.attachedTo)
+  }));
+  return result;
 });
-var listTeamspaces = (params) => Effect_exports.gen(function* () {
+var listMentions = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const query = {};
-  if (!params.includeArchived) {
-    query.archived = false;
-  }
   const limit = clampLimit(params.limit);
-  const teamspaces = yield* client.findAll(
-    documentPlugin.class.Teamspace,
-    query,
+  const mentions = yield* client.findAll(
+    activity.class.UserMentionInfo,
+    {},
     {
       limit,
       sort: {
-        name: import_core22.SortingOrder.Ascending
+        modifiedOn: import_core22.SortingOrder.Descending
       }
     }
   );
-  const total = teamspaces.total;
-  const summaries = teamspaces.map((ts) => ({
-    id: TeamspaceId.make(ts._id),
-    name: ts.name,
-    description: ts.description || void 0,
-    archived: ts.archived,
-    private: ts.private
+  const result = mentions.map((m) => ({
+    id: MentionId.make(m._id),
+    messageId: ActivityMessageId.make(m.attachedTo),
+    userId: PersonId.make(m.user),
+    content: m.content
   }));
-  return {
-    teamspaces: summaries,
-    total
-  };
-});
-var getTeamspace = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
-  const docs = yield* client.findAll(
-    documentPlugin.class.Document,
-    { space: teamspace._id },
-    { limit: 1, total: true }
-  );
-  return {
-    id: TeamspaceId.make(teamspace._id),
-    name: teamspace.name,
-    description: teamspace.description || void 0,
-    archived: teamspace.archived,
-    private: teamspace.private,
-    documents: docs.total
-  };
-});
-var createTeamspace = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const existing = yield* client.findOne(
-    documentPlugin.class.Teamspace,
-    { name: params.name, archived: false }
-  );
-  if (existing !== void 0) {
-    return {
-      id: TeamspaceId.make(existing._id),
-      name: existing.name,
-      created: false
-    };
-  }
-  const teamspaceId = (0, import_core22.generateId)();
-  const teamspaceData = {
-    name: params.name,
-    description: params.description ?? "",
-    private: params.private ?? false,
-    archived: false,
-    members: [client.getAccountUuid()],
-    owners: [client.getAccountUuid()],
-    icon: documentPlugin.icon.Teamspace,
-    type: documentPlugin.spaceType.DefaultTeamspaceType
-  };
-  yield* client.createDoc(
-    documentPlugin.class.Teamspace,
-    core.space.Space,
-    teamspaceData,
-    teamspaceId
-  );
-  return {
-    id: TeamspaceId.make(teamspaceId),
-    name: params.name,
-    created: true
-  };
+  return result;
 });
-var updateTeamspace = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
-  const updateOps = {};
-  if (params.name !== void 0) {
-    updateOps.name = params.name;
+
+// src/mcp/tools/registry.ts
+var deriveTitle = (name) => name.split("_").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+var READ_PREFIXES = ["list_", "get_", "search_", "fulltext_", "download_", "preview_"];
+var CREATE_PREFIXES = ["create_", "add_", "upload_", "send_", "log_"];
+var UPDATE_PREFIXES = [
+  "update_",
+  "edit_",
+  "set_",
+  "pin_",
+  "unpin_",
+  "mark_",
+  "archive_",
+  "start_",
+  "stop_",
+  "save_",
+  "unsave_",
+  "remove_",
+  "move_"
+];
+var DELETE_PREFIXES = ["delete_"];
+var matchesPrefix = (name, prefixes) => prefixes.some((p) => name.startsWith(p));
+var deriveAnnotations = (name) => {
+  const title = deriveTitle(name);
+  if (matchesPrefix(name, READ_PREFIXES)) {
+    return { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
   }
-  if (params.description !== void 0) {
-    updateOps.description = params.description === null ? "" : params.description;
+  if (matchesPrefix(name, CREATE_PREFIXES)) {
+    return { title, readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
   }
-  if (params.archived !== void 0) {
-    updateOps.archived = params.archived;
+  if (matchesPrefix(name, UPDATE_PREFIXES)) {
+    return { title, readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
   }
-  if (Object.keys(updateOps).length === 0) {
-    return { id: TeamspaceId.make(teamspace._id), updated: false };
+  if (matchesPrefix(name, DELETE_PREFIXES)) {
+    return { title, readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };
   }
-  yield* client.updateDoc(
-    documentPlugin.class.Teamspace,
-    core.space.Space,
-    teamspace._id,
-    updateOps
-  );
-  return { id: TeamspaceId.make(teamspace._id), updated: true };
-});
-var deleteTeamspace = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace, { includeArchived: true });
-  yield* client.removeDoc(
-    documentPlugin.class.Teamspace,
-    core.space.Space,
-    teamspace._id
-  );
-  return { id: TeamspaceId.make(teamspace._id), deleted: true };
+  return { title, readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
+};
+var resolveAnnotations = (tool) => ({
+  ...deriveAnnotations(tool.name),
+  ...tool.annotations
 });
-var listDocuments = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace);
-  const limit = clampLimit(params.limit);
-  const query = {
-    space: teamspace._id
-  };
-  if (params.titleSearch !== void 0 && params.titleSearch.trim() !== "") {
-    query.title = { $like: `%${escapeLikeWildcards(params.titleSearch)}%` };
+var encodeOutput = (schema, result) => Schema_exports.encodeUnknownSync(schema)(result);
+var provideHulyClient = (args2) => (effect2) => Either_exports.right(effect2.pipe(Effect_exports.provideService(HulyClient, args2.hulyClient)));
+var provideStorageClient = (args2) => (effect2) => Either_exports.right(effect2.pipe(Effect_exports.provideService(HulyStorageClient, args2.storageClient)));
+var provideCombinedClient = (args2) => (effect2) => Either_exports.right(
+  effect2.pipe(
+    Effect_exports.provideService(HulyClient, args2.hulyClient),
+    Effect_exports.provideService(HulyStorageClient, args2.storageClient)
+  )
+);
+var provideWorkspaceClient = (args2) => (effect2) => args2.workspaceClient !== void 0 ? Either_exports.right(effect2.pipe(Effect_exports.provideService(WorkspaceClient, args2.workspaceClient))) : Either_exports.left(mapDomainErrorToMcp(new HulyError({ message: "WorkspaceClient not available" })));
+var createHandler = (toolName, provide4, parse5, operation, encode8) => async (args2, hulyClient, storageClient, workspaceClient) => {
+  const parseResult = await Effect_exports.runPromiseExit(parse5(args2));
+  if (Exit_exports.isFailure(parseResult)) {
+    return mapParseCauseToMcp(parseResult.cause, toolName);
   }
-  if (params.titleRegex !== void 0 && params.titleRegex.trim() !== "") {
-    query.title = { $regex: params.titleRegex };
+  const provided = provide4({ hulyClient, storageClient, workspaceClient })(operation(parseResult.value));
+  if (Either_exports.isLeft(provided)) {
+    return provided.left;
   }
-  if (params.contentSearch !== void 0 && params.contentSearch.trim() !== "") {
-    query.$search = params.contentSearch;
+  const operationResult = await Effect_exports.runPromiseExit(provided.right);
+  if (Exit_exports.isFailure(operationResult)) {
+    return mapDomainCauseToMcp(operationResult.cause);
+  }
+  try {
+    const output = encode8 !== void 0 ? encode8(operationResult.value) : operationResult.value;
+    return createSuccessResponse(output);
+  } catch {
+    return mapDomainErrorToMcp(new HulyError({ message: `Tool ${toolName} produced invalid output` }));
+  }
+};
+var createToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideHulyClient, parse5, operation);
+var createEncodedToolHandler = (toolName, parse5, operation, outputSchema) => createHandler(
+  toolName,
+  provideHulyClient,
+  parse5,
+  operation,
+  (result) => encodeOutput(outputSchema, result)
+);
+var createStorageToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideStorageClient, parse5, operation);
+var createCombinedToolHandler = (toolName, parse5, operation) => createHandler(toolName, provideCombinedClient, parse5, operation);
+var createEncodedWorkspaceToolHandler = (toolName, parse5, operation, outputSchema) => createHandler(
+  toolName,
+  provideWorkspaceClient,
+  parse5,
+  operation,
+  (result) => encodeOutput(outputSchema, result)
+);
+var createEncodedNoParamsWorkspaceToolHandler = (toolName, operation, outputSchema) => createHandler(
+  toolName,
+  provideWorkspaceClient,
+  () => Effect_exports.succeed(void 0),
+  operation,
+  (result) => encodeOutput(outputSchema, result)
+);
+
+// src/mcp/tools/activity.ts
+var CATEGORY = "activity";
+var activityTools = [
+  {
+    name: "list_activity",
+    description: "List activity messages for a Huly issue, document, channel, or raw Huly object. Prefer friendly targets: project+issueIdentifier for issues, teamspace+document for documents, or channel for channels. Advanced callers may pass objectId+objectClass directly. Returns activity sorted by date (newest first).",
+    category: CATEGORY,
+    inputSchema: listActivityParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "list_activity",
+      parseListActivityParams,
+      listActivity,
+      ListActivityResultSchema
+    )
+  },
+  {
+    name: "add_reaction",
+    description: "Add an emoji reaction to an activity message.",
+    category: CATEGORY,
+    inputSchema: addReactionParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "add_reaction",
+      parseAddReactionParams,
+      addReaction,
+      AddReactionResultSchema
+    )
+  },
+  {
+    name: "remove_reaction",
+    description: "Remove an emoji reaction from an activity message.",
+    category: CATEGORY,
+    inputSchema: removeReactionParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "remove_reaction",
+      parseRemoveReactionParams,
+      removeReaction,
+      RemoveReactionResultSchema
+    )
+  },
+  {
+    name: "list_reactions",
+    description: "List reactions on an activity message.",
+    category: CATEGORY,
+    inputSchema: listReactionsParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "list_reactions",
+      parseListReactionsParams,
+      listReactions,
+      ListReactionsResultSchema
+    )
+  },
+  {
+    name: "save_message",
+    description: "Save/bookmark an activity message for later reference.",
+    category: CATEGORY,
+    inputSchema: saveMessageParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "save_message",
+      parseSaveMessageParams,
+      saveMessage,
+      SaveMessageResultSchema
+    )
+  },
+  {
+    name: "unsave_message",
+    description: "Remove an activity message from saved/bookmarks.",
+    category: CATEGORY,
+    inputSchema: unsaveMessageParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "unsave_message",
+      parseUnsaveMessageParams,
+      unsaveMessage,
+      UnsaveMessageResultSchema
+    )
+  },
+  {
+    name: "list_saved_messages",
+    description: "List saved/bookmarked activity messages.",
+    category: CATEGORY,
+    inputSchema: listSavedMessagesParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "list_saved_messages",
+      parseListSavedMessagesParams,
+      listSavedMessages,
+      ListSavedMessagesResultSchema
+    )
+  },
+  {
+    name: "list_mentions",
+    description: "List @mentions of the current user in activity messages.",
+    category: CATEGORY,
+    inputSchema: listMentionsParamsJsonSchema,
+    handler: createEncodedToolHandler(
+      "list_mentions",
+      parseListMentionsParams,
+      listMentions,
+      ListMentionsResultSchema
+    )
   }
-  const documents = yield* client.findAll(
-    documentPlugin.class.Document,
-    query,
-    {
-      limit,
-      sort: {
-        modifiedOn: import_core22.SortingOrder.Descending
-      }
-    }
-  );
-  const total = documents.total;
-  const summaries = documents.map((doc) => ({
-    id: DocumentId.make(doc._id),
-    title: doc.title,
-    teamspace: teamspace.name,
-    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
-    modifiedOn: doc.modifiedOn
-  }));
-  return {
-    documents: summaries,
-    total
-  };
+];
+
+// src/domain/schemas/attachments.ts
+var ListAttachmentsParamsSchema = Schema_exports.Struct({
+  objectId: NonEmptyString2.annotations({
+    description: "ID of the parent object (issue, document, etc.)"
+  }),
+  objectClass: ObjectClassName.annotations({
+    description: "Class of the parent object (e.g., 'tracker:class:Issue', 'document:class:Document')"
+  }),
+  limit: Schema_exports.optional(
+    LimitParam.annotations({
+      description: "Maximum number of attachments to return (default: 50)"
+    })
+  )
+}).annotations({
+  title: "ListAttachmentsParams",
+  description: "Parameters for listing attachments on an object"
 });
-var getDocument = (params) => Effect_exports.gen(function* () {
-  const { client, doc, teamspace } = yield* findTeamspaceAndDocument({
-    teamspace: params.teamspace,
-    document: params.document
-  });
-  const content = doc.content ? yield* client.fetchMarkup(
-    doc._class,
-    doc._id,
-    "content",
-    doc.content,
-    "markdown"
-  ) : void 0;
-  const result = {
-    id: DocumentId.make(doc._id),
-    title: doc.title,
-    content,
-    teamspace: teamspace.name,
-    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
-    modifiedOn: doc.modifiedOn,
-    createdOn: doc.createdOn
-  };
-  return result;
+var GetAttachmentParamsSchema = Schema_exports.Struct({
+  attachmentId: AttachmentId.annotations({
+    description: "Attachment ID"
+  })
+}).annotations({
+  title: "GetAttachmentParams",
+  description: "Parameters for getting a single attachment"
 });
-var createDocument = (params) => Effect_exports.gen(function* () {
-  const { client, teamspace } = yield* findTeamspace(params.teamspace);
-  const documentId = (0, import_core22.generateId)();
-  const parent = params.parent;
-  const parentRef = parent === void 0 ? documentPlugin.ids.NoParent : yield* Effect_exports.gen(function* () {
-    const parentDoc = yield* findByNameOrId(
-      client,
-      documentPlugin.class.Document,
-      { space: teamspace._id, title: parent },
-      { space: teamspace._id, _id: toRef(parent) }
-    );
-    if (parentDoc === void 0) {
-      return yield* new DocumentNotFoundError({
-        identifier: parent,
-        teamspace: params.teamspace
-      });
-    }
-    return parentDoc._id;
-  });
-  const lastDoc = yield* client.findOne(
-    documentPlugin.class.Document,
-    { space: teamspace._id },
-    { sort: { rank: import_core22.SortingOrder.Descending } }
-  );
-  const rank = (0, import_rank.makeRank)(lastDoc?.rank, void 0);
-  const contentMarkupRef = params.content !== void 0 && params.content.trim() !== "" ? yield* client.uploadMarkup(
-    documentPlugin.class.Document,
-    documentId,
-    "content",
-    params.content,
-    "markdown"
-  ) : null;
-  const documentData = {
-    title: params.title,
-    content: contentMarkupRef,
-    parent: parentRef,
-    rank
-  };
-  yield* client.createDoc(
-    documentPlugin.class.Document,
-    teamspace._id,
-    documentData,
-    documentId
-  );
-  return {
-    id: DocumentId.make(documentId),
-    title: params.title,
-    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, params.title, DocumentId.make(documentId))
-  };
+var FileSourceFields = {
+  filename: NonEmptyString2.annotations({
+    description: "Name of the file"
+  }),
+  contentType: MimeType.annotations({
+    description: "MIME type of the file (e.g., 'image/png', 'application/pdf')"
+  }),
+  filePath: Schema_exports.optional(Schema_exports.String.annotations({
+    description: "Local file path to upload (preferred - avoids context flooding)"
+  })),
+  fileUrl: Schema_exports.optional(Schema_exports.String.annotations({
+    description: "URL to fetch file from (for remote files)"
+  })),
+  data: Schema_exports.optional(Schema_exports.String.annotations({
+    description: "Base64-encoded file data (fallback for small files <10KB)"
+  })),
+  description: Schema_exports.optional(Schema_exports.String.annotations({
+    description: "Attachment description"
+  })),
+  pinned: Schema_exports.optional(Schema_exports.Boolean.annotations({
+    description: "Whether to pin the attachment (default: false)"
+  }))
+};
+var hasFileSource = (params) => {
+  const hasSource = params.filePath || params.fileUrl || params.data;
+  return hasSource ? true : "Must provide filePath, fileUrl, or data";
+};
+var AddAttachmentParamsBase = Schema_exports.Struct({
+  objectId: NonEmptyString2.annotations({
+    description: "ID of the parent object (issue, document, etc.)"
+  }),
+  objectClass: ObjectClassName.annotations({
+    description: "Class of the parent object (e.g., 'tracker:class:Issue', 'document:class:Document')"
+  }),
+  space: SpaceId.annotations({
+    description: "Space ID where the parent object resides"
+  }),
+  ...FileSourceFields
 });
-var deleteDocument = (params) => Effect_exports.gen(function* () {
-  const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
-  yield* client.removeDoc(
-    documentPlugin.class.Document,
-    teamspace._id,
-    doc._id
-  );
-  return { id: DocumentId.make(doc._id), deleted: true };
+var AddAttachmentParamsSchema = AddAttachmentParamsBase.pipe(
+  Schema_exports.filter(hasFileSource)
+).annotations({
+  title: "AddAttachmentParams",
+  description: "Parameters for adding an attachment. Provide ONE of: filePath, fileUrl, or data"
 });
-
-// src/huly/operations/issues-shared.ts
-var import_tracker = __toESM(require_lib36(), 1);
-
-// src/utils/normalize.ts
-var normalizeForComparison = (s) => s.replace(/[-_ ]/g, "").toLowerCase();
-
-// src/huly/operations/issues-shared.ts
-var zeroAsUnset = (value3) => value3 > 0 ? PositiveNumber.make(value3) : void 0;
-var findProject = (projectIdentifier) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const project3 = yield* findOneOrFail(
-    client,
-    tracker.class.Project,
-    { identifier: projectIdentifier },
-    () => new ProjectNotFoundError({ identifier: projectIdentifier })
-  );
-  return { client, project: project3 };
+var UpdateAttachmentParamsSchema = Schema_exports.Struct({
+  attachmentId: AttachmentId.annotations({
+    description: "Attachment ID"
+  }),
+  description: Schema_exports.optional(
+    Schema_exports.NullOr(Schema_exports.String).annotations({
+      description: "New description (null to clear)"
+    })
+  ),
+  pinned: Schema_exports.optional(Schema_exports.Boolean.annotations({
+    description: "Pin or unpin the attachment"
+  }))
+}).annotations({
+  title: "UpdateAttachmentParams",
+  description: "Parameters for updating an attachment"
 });
-var findProjectWithStatuses = (projectIdentifier) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const project3 = yield* findOneOrFail(
-    client,
-    tracker.class.Project,
-    { identifier: projectIdentifier },
-    () => new ProjectNotFoundError({ identifier: projectIdentifier }),
-    { lookup: { type: task.class.ProjectType } }
-  );
-  const projectType = project3.$lookup?.type;
-  const statuses = [];
-  if (projectType?.statuses) {
-    const statusRefs = projectType.statuses.map((s) => s._id);
-    if (statusRefs.length > 0) {
-      const statusDocsResult = yield* Effect_exports.either(
-        client.findAll(
-          core.class.Status,
-          { _id: { $in: statusRefs } }
-        )
-      );
-      if (statusDocsResult._tag === "Right") {
-        for (const doc of statusDocsResult.right) {
-          const categoryStr = doc.category ? doc.category : "";
-          statuses.push({
-            _id: doc._id,
-            name: doc.name,
-            isDone: categoryStr === task.statusCategory.Won,
-            isCanceled: categoryStr === task.statusCategory.Lost
-          });
-        }
-      } else {
-        yield* Effect_exports.logWarning(
-          `Status query failed for project ${projectIdentifier}, using fallback. Category-based filtering (open/done/canceled) will use name heuristics. Error: ${statusDocsResult.left.message}`
-        );
-        for (const ps of projectType.statuses) {
-          const name = ps._id.split(":").pop() ?? "Unknown";
-          const nameLower = name.toLowerCase();
-          const isDone5 = nameLower.includes("done") || nameLower.includes("complete") || nameLower.includes("finished") || nameLower.includes("resolved") || nameLower.includes("closed");
-          const isCanceled = nameLower.includes("cancel") || nameLower.includes("reject") || nameLower.includes("abort") || nameLower.includes("wontfix") || nameLower.includes("invalid");
-          statuses.push({
-            _id: ps._id,
-            name,
-            isDone: isDone5,
-            isCanceled
-          });
-        }
-      }
-    }
-  }
-  const defaultStatusId = project3.defaultIssueStatus || statuses[0]?._id;
-  return { client, project: project3, statuses, defaultStatusId };
+var DeleteAttachmentParamsSchema = Schema_exports.Struct({
+  attachmentId: AttachmentId.annotations({
+    description: "Attachment ID to delete"
+  })
+}).annotations({
+  title: "DeleteAttachmentParams",
+  description: "Parameters for deleting an attachment"
 });
-var parseIssueIdentifier = (identifier2, projectIdentifier) => {
-  const idStr = String(identifier2).trim();
-  const match16 = idStr.match(/^([A-Z]+)-(\d+)$/i);
-  if (match16) {
-    return {
-      fullIdentifier: `${match16[1].toUpperCase()}-${match16[2]}`,
-      number: parseInt(match16[2], 10)
-    };
-  }
-  const numMatch = idStr.match(/^\d+$/);
-  if (numMatch) {
-    const num = parseInt(idStr, 10);
-    return {
-      fullIdentifier: `${projectIdentifier.toUpperCase()}-${num}`,
-      number: num
-    };
-  }
-  return { fullIdentifier: idStr, number: null };
-};
-var findIssueInProject = (client, project3, identifierStr) => Effect_exports.gen(function* () {
-  const { fullIdentifier, number: number8 } = parseIssueIdentifier(
-    identifierStr,
-    project3.identifier
-  );
-  const issue2 = (yield* client.findOne(
-    tracker.class.Issue,
-    {
-      space: project3._id,
-      identifier: fullIdentifier
-    }
-  )) ?? (number8 !== null ? yield* client.findOne(
-    tracker.class.Issue,
-    {
-      space: project3._id,
-      number: number8
-    }
-  ) : void 0);
-  if (issue2 === void 0) {
-    return yield* new IssueNotFoundError({
-      identifier: identifierStr,
-      project: project3.identifier
-    });
-  }
-  return issue2;
+var PinAttachmentParamsSchema = Schema_exports.Struct({
+  attachmentId: AttachmentId.annotations({
+    description: "Attachment ID"
+  }),
+  pinned: Schema_exports.Boolean.annotations({
+    description: "Whether to pin (true) or unpin (false)"
+  })
+}).annotations({
+  title: "PinAttachmentParams",
+  description: "Parameters for pinning/unpinning an attachment"
 });
-var findProjectAndIssue = (params) => Effect_exports.gen(function* () {
-  const { client, project: project3 } = yield* findProject(params.project);
-  const issue2 = yield* findIssueInProject(client, project3, params.identifier);
-  return { client, project: project3, issue: issue2 };
+var DownloadAttachmentParamsSchema = Schema_exports.Struct({
+  attachmentId: AttachmentId.annotations({
+    description: "Attachment ID"
+  })
+}).annotations({
+  title: "DownloadAttachmentParams",
+  description: "Parameters for getting attachment download URL"
 });
-var priorityToStringMap = {
-  [import_tracker.IssuePriority.Urgent]: "urgent",
-  [import_tracker.IssuePriority.High]: "high",
-  [import_tracker.IssuePriority.Medium]: "medium",
-  [import_tracker.IssuePriority.Low]: "low",
-  [import_tracker.IssuePriority.NoPriority]: "no-priority"
-};
-var priorityToString = (priority) => priorityToStringMap[priority];
-var stringToPriorityMap = {
-  "urgent": import_tracker.IssuePriority.Urgent,
-  "high": import_tracker.IssuePriority.High,
-  "medium": import_tracker.IssuePriority.Medium,
-  "low": import_tracker.IssuePriority.Low,
-  "no-priority": import_tracker.IssuePriority.NoPriority
-};
-var stringToPriority = (priority) => stringToPriorityMap[priority];
-var resolveStatusByName = (statuses, statusName, project3) => {
-  const normalizedInput = normalizeForComparison(statusName);
-  const matchingStatus = statuses.find(
-    (s) => normalizeForComparison(s.name) === normalizedInput
-  );
-  if (matchingStatus === void 0) {
-    return Effect_exports.fail(new InvalidStatusError({ status: statusName, project: project3 }));
-  }
-  return Effect_exports.succeed(matchingStatus._id);
-};
+var AddIssueAttachmentParamsBase = Schema_exports.Struct({
+  project: ProjectIdentifier.annotations({
+    description: "Project identifier (e.g., 'HULY')"
+  }),
+  identifier: IssueIdentifier.annotations({
+    description: "Issue identifier (e.g., 'HULY-123')"
+  }),
+  ...FileSourceFields
+});
+var AddIssueAttachmentParamsSchema = AddIssueAttachmentParamsBase.pipe(
+  Schema_exports.filter(hasFileSource)
+).annotations({
+  title: "AddIssueAttachmentParams",
+  description: "Parameters for adding an attachment to an issue"
+});
+var AddDocumentAttachmentParamsBase = Schema_exports.Struct({
+  teamspace: TeamspaceIdentifier.annotations({
+    description: "Teamspace name or ID"
+  }),
+  document: DocumentIdentifier.annotations({
+    description: "Document title or ID"
+  }),
+  ...FileSourceFields
+});
+var AddDocumentAttachmentParamsSchema = AddDocumentAttachmentParamsBase.pipe(
+  Schema_exports.filter(hasFileSource)
+).annotations({
+  title: "AddDocumentAttachmentParams",
+  description: "Parameters for adding an attachment to a document"
+});
+var listAttachmentsParamsJsonSchema = JSONSchema_exports.make(ListAttachmentsParamsSchema);
+var getAttachmentParamsJsonSchema = JSONSchema_exports.make(GetAttachmentParamsSchema);
+var addAttachmentParamsJsonSchema = JSONSchema_exports.make(AddAttachmentParamsSchema);
+var updateAttachmentParamsJsonSchema = JSONSchema_exports.make(UpdateAttachmentParamsSchema);
+var deleteAttachmentParamsJsonSchema = JSONSchema_exports.make(DeleteAttachmentParamsSchema);
+var pinAttachmentParamsJsonSchema = JSONSchema_exports.make(PinAttachmentParamsSchema);
+var downloadAttachmentParamsJsonSchema = JSONSchema_exports.make(DownloadAttachmentParamsSchema);
+var addIssueAttachmentParamsJsonSchema = JSONSchema_exports.make(AddIssueAttachmentParamsSchema);
+var addDocumentAttachmentParamsJsonSchema = JSONSchema_exports.make(AddDocumentAttachmentParamsSchema);
+var parseListAttachmentsParams = Schema_exports.decodeUnknown(ListAttachmentsParamsSchema);
+var parseGetAttachmentParams = Schema_exports.decodeUnknown(GetAttachmentParamsSchema);
+var parseAddAttachmentParams = Schema_exports.decodeUnknown(AddAttachmentParamsSchema);
+var parseUpdateAttachmentParams = Schema_exports.decodeUnknown(UpdateAttachmentParamsSchema);
+var parseDeleteAttachmentParams = Schema_exports.decodeUnknown(DeleteAttachmentParamsSchema);
+var parsePinAttachmentParams = Schema_exports.decodeUnknown(PinAttachmentParamsSchema);
+var parseDownloadAttachmentParams = Schema_exports.decodeUnknown(DownloadAttachmentParamsSchema);
+var parseAddIssueAttachmentParams = Schema_exports.decodeUnknown(AddIssueAttachmentParamsSchema);
+var parseAddDocumentAttachmentParams = Schema_exports.decodeUnknown(AddDocumentAttachmentParamsSchema);
 
 // src/huly/operations/attachments.ts
+var import_core23 = __toESM(require_lib4(), 1);
 var clearAttachmentDescription = (ops) => {
   Object.assign(ops, { description: "" });
 };
@@ -177035,6 +177159,7 @@ var RemoveIssueRelationResultSchema = Schema_exports.Struct({
 });
 var ListIssueRelationsResultSchema = Schema_exports.Struct({
   blockedBy: Schema_exports.Array(RelationEntryWireSchema),
+  blocks: Schema_exports.Array(RelationEntryWireSchema),
   relations: Schema_exports.Array(RelationEntryWireSchema),
   documents: Schema_exports.Array(DocumentRelationEntryWireSchema)
 });
@@ -180719,9 +180844,6 @@ var listIssueRelations = (params) => Effect_exports.gen(function* () {
   });
   const blockedByRefs = issue2.blockedBy ?? [];
   const relationsRefs = issue2.relations ?? [];
-  if (blockedByRefs.length === 0 && relationsRefs.length === 0) {
-    return { blockedBy: [], relations: [], documents: [] };
-  }
   const docClass = String(documentPlugin.class.Document);
   const issueRelationsRefs = [];
   const docRelationsRefs = [];
@@ -180746,6 +180868,16 @@ var listIssueRelations = (params) => Effect_exports.gen(function* () {
     _id: toIssueId(String(r._id)),
     _class: toObjectClassName(String(r._class))
   });
+  const toIssueEntry = (i) => ({
+    identifier: toIssueIdentifier(i.identifier),
+    _id: toIssueId(String(i._id)),
+    _class: toObjectClassName(String(i._class))
+  });
+  const blockingIssueCandidates = yield* client.findAll(
+    tracker.class.Issue,
+    { "blockedBy._id": toRef(issue2._id) }
+  );
+  const blocks = blockingIssueCandidates.filter((candidate) => candidate._id !== issue2._id && hasRelationById(candidate.blockedBy, issue2._id)).map(toIssueEntry);
   const documents = [];
   if (docRelationsRefs.length > 0) {
     const toDocRef = toRef;
@@ -180779,6 +180911,7 @@ var listIssueRelations = (params) => Effect_exports.gen(function* () {
   }
   return {
     blockedBy: blockedByRefs.map(toEntry),
+    blocks,
     relations: issueRelationsRefs.map(toEntry),
     documents
   };
@@ -182244,7 +182377,7 @@ var issueTools = [
   },
   {
     name: "list_issue_relations",
-    description: "List all relations of an issue. Returns blockedBy (issues blocking this one), relations (bidirectional issue links), and documents (linked documents with title/teamspace). Does NOT return issues that this issue blocks \u2014 use list_issue_relations on the target issue to see that.",
+    description: "List all relations of an issue. Returns blockedBy (issues blocking this one), blocks (issues this one blocks), relations (bidirectional issue links), and documents (linked documents with title/teamspace).",
     category: CATEGORY11,
     inputSchema: listIssueRelationsParamsJsonSchema,
     handler: createEncodedToolHandler(