@firfi/huly-mcp 0.11.0 → 0.12.0

package/README.md

@@ -285,6 +285,7 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | `update_channel_message` | Update a channel message. Only the body can be modified. |
 | `delete_channel_message` | Permanently delete a channel message. This action cannot be undone. |
 | `list_direct_messages` | List direct message conversations in Huly. Returns conversations sorted by date (newest first). |
+| `create_direct_message` | Open a one-to-one direct-message conversation with a workspace member. The `person` argument accepts an email or exact display name (e.g. `Smith,Bill`). Idempotent: if a DM with that participant already exists, returns it (`created: false`); otherwise creates a new DM (`created: true`). The returned `id` can be passed as `dm` to send_dm_message, list_dm_messages, etc. |
 | `list_dm_messages` | List messages in a direct-message conversation, newest first. The `dm` argument accepts either the DM `_id` or a participant display name (e.g. `Kerr,Shannon`); a name resolves only to a one-to-one DM with the authenticated account. |
 | `send_dm_message` | Send a message to a direct-message conversation. The `dm` argument accepts either the DM `_id` or a participant display name; a name resolves only to a one-to-one DM with the authenticated account. Message body supports markdown formatting. |
 | `update_dm_message` | Update a direct-message message. The `dm` argument accepts either the DM `_id` or a participant display name; a name resolves only to a one-to-one DM with the authenticated account. Only the body can be modified. |

package/dist/index.cjs

@@ -150748,6 +150748,7 @@ var MasterTagNotFoundError = class extends Schema_exports.TaggedError()(
 };
 
 // src/huly/errors-contacts.ts
+var MIN_AMBIGUOUS_PERSON_MATCHES = 2;
 var PersonNotFoundError = class extends Schema_exports.TaggedError()(
   "PersonNotFoundError",
   {
@@ -150758,6 +150759,17 @@ var PersonNotFoundError = class extends Schema_exports.TaggedError()(
     return `Person '${this.identifier}' not found`;
   }
 };
+var PersonIdentifierAmbiguousError = class extends Schema_exports.TaggedError()(
+  "PersonIdentifierAmbiguousError",
+  {
+    identifier: Schema_exports.String,
+    matches: Schema_exports.Number.pipe(Schema_exports.int(), Schema_exports.greaterThanOrEqualTo(MIN_AMBIGUOUS_PERSON_MATCHES))
+  }
+) {
+  get message() {
+    return `Person identifier '${this.identifier}' matched ${this.matches} people; use an exact email address instead`;
+  }
+};
 var OrganizationNotFoundError = class extends Schema_exports.TaggedError()(
   "OrganizationNotFoundError",
   {
@@ -151147,6 +151159,26 @@ var DirectMessageIdentifierAmbiguousError = class extends Schema_exports.TaggedE
     return `Direct message '${this.identifier}' is ambiguous (${this.matches} matches); use the DM _id`;
   }
 };
+var CannotDirectMessageSelfError = class extends Schema_exports.TaggedError()(
+  "CannotDirectMessageSelfError",
+  {
+    identifier: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Cannot start a direct-message conversation with yourself ('${this.identifier}')`;
+  }
+};
+var PersonNotAnEmployeeError = class extends Schema_exports.TaggedError()(
+  "PersonNotAnEmployeeError",
+  {
+    identifier: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Person '${this.identifier}' is not a workspace member (no Huly account) and cannot receive direct messages`;
+  }
+};
 var MessageNotFoundError = class extends Schema_exports.TaggedError()(
   "MessageNotFoundError",
   {
@@ -151395,6 +151427,7 @@ var HulyDomainError = Schema_exports.Union(
   IssueNotFoundError,
   ProjectNotFoundError,
   InvalidStatusError,
+  PersonIdentifierAmbiguousError,
   PersonNotFoundError,
   OrganizationNotFoundError,
   OrganizationIdentifierAmbiguousError,
@@ -151411,9 +151444,11 @@ var HulyDomainError = Schema_exports.Union(
   CommentNotFoundError,
   MilestoneNotFoundError,
   ChannelNotFoundError,
+  CannotDirectMessageSelfError,
   DirectMessageIdentifierAmbiguousError,
   DirectMessageNotFoundError,
   MessageNotFoundError,
+  PersonNotAnEmployeeError,
   ThreadReplyNotFoundError,
   CalendarNotAccessibleError,
   EventNotFoundError,
@@ -171366,7 +171401,7 @@ var PostHog = class extends PostHogBackendClient {
 };
 
 // src/version.ts
-var VERSION = true ? "0.11.0" : "0.0.0-dev";
+var VERSION = true ? "0.12.0" : "0.0.0-dev";
 
 // src/telemetry/posthog.ts
 var POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
@@ -171494,6 +171529,7 @@ var INVALID_PARAMS_TAGS = /* @__PURE__ */ new Set([
   "IssueNotFoundError",
   "ProjectNotFoundError",
   "InvalidStatusError",
+  "PersonIdentifierAmbiguousError",
   "PersonNotFoundError",
   "OrganizationNotFoundError",
   "OrganizationIdentifierAmbiguousError",
@@ -171510,6 +171546,8 @@ var INVALID_PARAMS_TAGS = /* @__PURE__ */ new Set([
   "ChannelNotFoundError",
   "DirectMessageIdentifierAmbiguousError",
   "DirectMessageNotFoundError",
+  "CannotDirectMessageSelfError",
+  "PersonNotAnEmployeeError",
   "MessageNotFoundError",
   "ThreadReplyNotFoundError",
   "CalendarNotAccessibleError",
@@ -176681,14 +176719,24 @@ var DeleteDmMessageParamsSchema = Schema_exports.Struct({
   title: "DeleteDmMessageParams",
   description: "Parameters for deleting a direct-message message"
 });
+var CreateDirectMessageParamsSchema = Schema_exports.Struct({
+  person: PersonRefInput.annotations({
+    description: "Participant to open a one-to-one DM with: email address or exact display name (e.g. `Smith,Bill`). Resolved via the Employee mixin to a Huly account."
+  })
+}).annotations({
+  title: "CreateDirectMessageParams",
+  description: "Parameters for opening a one-to-one direct-message conversation with another workspace member. If a one-to-one DM with that participant already exists, it is returned unchanged."
+});
 var listDmMessagesParamsJsonSchema = JSONSchema_exports.make(ListDmMessagesParamsSchema);
 var sendDmMessageParamsJsonSchema = JSONSchema_exports.make(SendDmMessageParamsSchema);
 var updateDmMessageParamsJsonSchema = JSONSchema_exports.make(UpdateDmMessageParamsSchema);
 var deleteDmMessageParamsJsonSchema = JSONSchema_exports.make(DeleteDmMessageParamsSchema);
+var createDirectMessageParamsJsonSchema = JSONSchema_exports.make(CreateDirectMessageParamsSchema);
 var parseListDmMessagesParams = Schema_exports.decodeUnknown(ListDmMessagesParamsSchema);
 var parseSendDmMessageParams = Schema_exports.decodeUnknown(SendDmMessageParamsSchema);
 var parseUpdateDmMessageParams = Schema_exports.decodeUnknown(UpdateDmMessageParamsSchema);
 var parseDeleteDmMessageParams = Schema_exports.decodeUnknown(DeleteDmMessageParamsSchema);
+var parseCreateDirectMessageParams = Schema_exports.decodeUnknown(CreateDirectMessageParamsSchema);
 
 // src/domain/schemas/time.ts
 var LogTimeParamsSchema = Schema_exports.Struct({
@@ -178202,8 +178250,165 @@ var cardTools = [
 ];
 
 // src/huly/operations/direct-messages.ts
+var import_core28 = __toESM(require_lib4(), 1);
+
+// src/huly/operations/contacts-shared.ts
 var import_core27 = __toESM(require_lib4(), 1);
-var ONE_TO_ONE_DM_MEMBER_COUNT = 2;
+var isEmailIdentifier = Schema_exports.is(Email);
+var findPersonById = (client, personId) => client.findOne(
+  contact.class.Person,
+  { _id: toRef(personId) }
+);
+var findPersonByEmail = (client, email3) => Effect_exports.gen(function* () {
+  const channels = yield* client.findAll(
+    contact.class.Channel,
+    {
+      value: email3,
+      provider: contact.channelProvider.Email
+    }
+  );
+  if (channels.length === 0) {
+    return void 0;
+  }
+  const channel = channels[0];
+  return yield* client.findOne(
+    contact.class.Person,
+    { _id: toRef(channel.attachedTo) }
+  );
+});
+var batchGetEmailsForPersons = (client, personIds) => Effect_exports.gen(function* () {
+  if (personIds.length === 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  const channels = yield* client.findAll(
+    contact.class.Channel,
+    {
+      attachedTo: { $in: personIds },
+      provider: contact.channelProvider.Email
+    }
+  );
+  const emailMap = /* @__PURE__ */ new Map();
+  for (const channel of channels) {
+    if (!emailMap.has(channel.attachedTo)) {
+      emailMap.set(channel.attachedTo, channel.value);
+    }
+  }
+  return emailMap;
+});
+var findPersonBySocialIdentityEmail = (client, email3) => Effect_exports.gen(function* () {
+  const identity5 = yield* client.findOne(
+    contact.class.SocialIdentity,
+    {
+      type: import_core27.SocialIdType.EMAIL,
+      value: email3
+    }
+  );
+  if (identity5 === void 0) return void 0;
+  return yield* client.findOne(
+    contact.class.Person,
+    { _id: identity5.attachedTo }
+  );
+});
+var findPersonByExactEmail = (client, email3) => Effect_exports.gen(function* () {
+  const socialIdentities = yield* client.findAll(
+    contact.class.SocialIdentity,
+    {
+      type: import_core27.SocialIdType.EMAIL,
+      value: email3
+    }
+  );
+  const channels = yield* client.findAll(
+    contact.class.Channel,
+    {
+      value: email3,
+      provider: contact.channelProvider.Email
+    }
+  );
+  const personIds = [
+    .../* @__PURE__ */ new Set([
+      ...socialIdentities.map((identity5) => identity5.attachedTo),
+      ...channels.map((channel) => channel.attachedTo)
+    ])
+  ];
+  if (personIds.length === 0) {
+    return void 0;
+  }
+  const persons = yield* client.findAll(
+    contact.class.Person,
+    { _id: { $in: personIds.map(toRef) } }
+  );
+  if (persons.length === 0) {
+    return void 0;
+  }
+  if (persons.length > 1) {
+    return yield* new PersonIdentifierAmbiguousError({ identifier: email3, matches: persons.length });
+  }
+  return persons[0];
+});
+var findPersonByExactName = (client, name) => Effect_exports.gen(function* () {
+  const persons = yield* client.findAll(
+    contact.class.Person,
+    { name }
+  );
+  if (persons.length === 0) {
+    return void 0;
+  }
+  if (persons.length > 1) {
+    return yield* new PersonIdentifierAmbiguousError({ identifier: name, matches: persons.length });
+  }
+  return persons[0];
+});
+var findPersonByExactEmailOrName = (client, identifier2) => isEmailIdentifier(identifier2) ? findPersonByExactEmail(client, identifier2) : findPersonByExactName(client, identifier2);
+var findPersonByEmailOrName = (client, emailOrName) => Effect_exports.gen(function* () {
+  const socialIdentityPerson = yield* findPersonBySocialIdentityEmail(client, emailOrName);
+  if (socialIdentityPerson !== void 0) return socialIdentityPerson;
+  const exactChannel = yield* client.findOne(
+    contact.class.Channel,
+    {
+      value: emailOrName,
+      provider: contact.channelProvider.Email
+    }
+  );
+  if (exactChannel !== void 0) {
+    const person = yield* client.findOne(
+      contact.class.Person,
+      { _id: toRef(exactChannel.attachedTo) }
+    );
+    if (person !== void 0) return person;
+  }
+  const exactPerson = yield* client.findOne(
+    contact.class.Person,
+    { name: emailOrName }
+  );
+  if (exactPerson !== void 0) return exactPerson;
+  const escaped = escapeLikeWildcards(emailOrName);
+  const likeChannel = yield* client.findOne(
+    contact.class.Channel,
+    {
+      value: { $like: `%${escaped}%` },
+      provider: contact.channelProvider.Email
+    }
+  );
+  if (likeChannel !== void 0) {
+    const person = yield* client.findOne(
+      contact.class.Person,
+      { _id: toRef(likeChannel.attachedTo) }
+    );
+    if (person !== void 0) return person;
+  }
+  const likePerson = yield* client.findOne(
+    contact.class.Person,
+    { name: { $like: `%${escaped}%` } }
+  );
+  return likePerson;
+});
+
+// src/huly/operations/direct-messages.ts
+var sortedMemberPair = (first2, second) => [first2, second].sort();
+var hasExactMembers = (dm, sortedMembers) => {
+  const dmMembers = [...dm.members].sort();
+  return dmMembers.length === sortedMembers.length && sortedMembers.every((member, index) => dmMembers[index] === member);
+};
 var findDirectMessage = (identifier2) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
   const byId = yield* client.findOne(
@@ -178233,9 +178438,8 @@ var findDirectMessage = (identifier2) => Effect_exports.gen(function* () {
     chunter.class.DirectMessage,
     { members: accountUuid }
   );
-  const matches = directMessages.filter(
-    (dm) => dm.members.length === ONE_TO_ONE_DM_MEMBER_COUNT && dm.members.includes(accountUuid) && accountUuids.some((candidate) => dm.members.includes(candidate))
-  );
+  const memberPairs = accountUuids.map((candidate) => sortedMemberPair(accountUuid, candidate));
+  const matches = directMessages.filter((dm) => memberPairs.some((members) => hasExactMembers(dm, members)));
   if (matches.length === 0) {
     return yield* new DirectMessageNotFoundError({ identifier: identifier2 });
   }
@@ -178270,7 +178474,7 @@ var listDirectMessageMessages = (params) => Effect_exports.gen(function* () {
     { space: dm._id },
     {
       limit,
-      sort: { createdOn: import_core27.SortingOrder.Descending }
+      sort: { createdOn: import_core28.SortingOrder.Descending }
     }
   );
   const total = messages.total;
@@ -178296,7 +178500,7 @@ var listDirectMessageMessages = (params) => Effect_exports.gen(function* () {
 var sendDirectMessage = (params) => Effect_exports.gen(function* () {
   const { client, dm } = yield* findDirectMessage(params.dm);
   const markupUrlConfig = client.markupUrlConfig;
-  const messageId = (0, import_core27.generateId)();
+  const messageId = (0, import_core28.generateId)();
   const markup = markdownToMarkupString(params.body, markupUrlConfig);
   const messageData = {
     message: markup,
@@ -178339,9 +178543,56 @@ var deleteDirectMessage = (params) => Effect_exports.gen(function* () {
   );
   return { id: MessageId.make(message._id), deleted: true };
 });
+var resolveEmployeeAccount = (identifier2) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const person = yield* findPersonByExactEmailOrName(client, identifier2);
+  if (person === void 0) {
+    return yield* new PersonNotFoundError({ identifier: identifier2 });
+  }
+  const employee = yield* client.findOne(
+    contact.mixin.Employee,
+    { _id: toRef(person._id) }
+  );
+  if (employee?.personUuid === void 0) {
+    return yield* new PersonNotAnEmployeeError({ identifier: identifier2 });
+  }
+  return employee.personUuid;
+});
+var createDirectMessage = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const me = client.getAccountUuid();
+  const other = yield* resolveEmployeeAccount(params.person);
+  if (other === me) {
+    return yield* new CannotDirectMessageSelfError({ identifier: params.person });
+  }
+  const existingDms = yield* client.findAll(
+    chunter.class.DirectMessage,
+    { members: me }
+  );
+  const members = sortedMemberPair(me, other);
+  const existing = existingDms.find((dm) => hasExactMembers(dm, members));
+  if (existing !== void 0) {
+    return { id: ChannelId.make(existing._id), created: false };
+  }
+  const dmId = (0, import_core28.generateId)();
+  const dmData = {
+    name: "",
+    description: "",
+    private: true,
+    archived: false,
+    members
+  };
+  yield* client.createDoc(
+    chunter.class.DirectMessage,
+    toRef(core.space.Space),
+    dmData,
+    dmId
+  );
+  return { id: ChannelId.make(dmId), created: true };
+});
 
 // src/huly/operations/threads.ts
-var import_core28 = __toESM(require_lib4(), 1);
+var import_core29 = __toESM(require_lib4(), 1);
 var findReply = (client, channel, message, replyId) => Effect_exports.gen(function* () {
   const reply = yield* client.findOne(
     chunter.class.ThreadMessage,
@@ -178372,7 +178623,7 @@ var listThreadReplies = (params) => Effect_exports.gen(function* () {
     {
       limit,
       sort: {
-        createdOn: import_core28.SortingOrder.Ascending
+        createdOn: import_core29.SortingOrder.Ascending
       }
     }
   );
@@ -178400,7 +178651,7 @@ var listThreadReplies = (params) => Effect_exports.gen(function* () {
 var addThreadReply = (params) => Effect_exports.gen(function* () {
   const { channel, client, message } = yield* findChannelMessage(params);
   const markupUrlConfig = client.markupUrlConfig;
-  const replyId = (0, import_core28.generateId)();
+  const replyId = (0, import_core29.generateId)();
   const markup = markdownToMarkupString(params.body, markupUrlConfig);
   const replyData = {
     message: markup,
@@ -178565,6 +178816,17 @@ var channelTools = [
       listDirectMessages
     )
   },
+  {
+    name: "create_direct_message",
+    description: "Open a one-to-one direct-message conversation with a workspace member. The `person` argument accepts an email or exact display name (e.g. `Smith,Bill`). Idempotent: if a DM with that participant already exists, returns it (`created: false`); otherwise creates a new DM (`created: true`). The returned `id` can be passed as `dm` to send_dm_message, list_dm_messages, etc.",
+    category: CATEGORY5,
+    inputSchema: createDirectMessageParamsJsonSchema,
+    handler: createToolHandler(
+      "create_direct_message",
+      parseCreateDirectMessageParams,
+      createDirectMessage
+    )
+  },
   {
     name: "list_dm_messages",
     description: "List messages in a direct-message conversation, newest first. The `dm` argument accepts either the DM `_id` or a participant display name (e.g. `Kerr,Shannon`); a name resolves only to a one-to-one DM with the authenticated account.",
@@ -178656,7 +178918,7 @@ var channelTools = [
 ];
 
 // src/huly/operations/comments.ts
-var import_core29 = __toESM(require_lib4(), 1);
+var import_core30 = __toESM(require_lib4(), 1);
 var findProjectAndIssue2 = (params) => findProjectAndIssue({ project: params.project, identifier: params.issueIdentifier });
 var findComment = (params) => Effect_exports.gen(function* () {
   const { client, issue: issue2, project: project3 } = yield* findProjectAndIssue2({
@@ -178695,7 +178957,7 @@ var listComments = (params) => Effect_exports.gen(function* () {
     {
       limit,
       sort: {
-        createdOn: import_core29.SortingOrder.Ascending
+        createdOn: import_core30.SortingOrder.Ascending
       }
     }
   );
@@ -178724,7 +178986,7 @@ var addComment = (params) => Effect_exports.gen(function* () {
     issueIdentifier: params.issueIdentifier
   });
   const markupUrlConfig = client.markupUrlConfig;
-  const commentId = (0, import_core29.generateId)();
+  const commentId = (0, import_core30.generateId)();
   const commentData = {
     message: markdownToMarkupString(params.body, markupUrlConfig)
   };
@@ -178850,106 +179112,6 @@ var leadClassIds = {
   }
 };
 
-// src/huly/operations/contacts-shared.ts
-var import_core30 = __toESM(require_lib4(), 1);
-var findPersonById = (client, personId) => client.findOne(
-  contact.class.Person,
-  { _id: toRef(personId) }
-);
-var findPersonByEmail = (client, email3) => Effect_exports.gen(function* () {
-  const channels = yield* client.findAll(
-    contact.class.Channel,
-    {
-      value: email3,
-      provider: contact.channelProvider.Email
-    }
-  );
-  if (channels.length === 0) {
-    return void 0;
-  }
-  const channel = channels[0];
-  return yield* client.findOne(
-    contact.class.Person,
-    { _id: toRef(channel.attachedTo) }
-  );
-});
-var batchGetEmailsForPersons = (client, personIds) => Effect_exports.gen(function* () {
-  if (personIds.length === 0) {
-    return /* @__PURE__ */ new Map();
-  }
-  const channels = yield* client.findAll(
-    contact.class.Channel,
-    {
-      attachedTo: { $in: personIds },
-      provider: contact.channelProvider.Email
-    }
-  );
-  const emailMap = /* @__PURE__ */ new Map();
-  for (const channel of channels) {
-    if (!emailMap.has(channel.attachedTo)) {
-      emailMap.set(channel.attachedTo, channel.value);
-    }
-  }
-  return emailMap;
-});
-var findPersonBySocialIdentityEmail = (client, email3) => Effect_exports.gen(function* () {
-  const identity5 = yield* client.findOne(
-    contact.class.SocialIdentity,
-    {
-      type: import_core30.SocialIdType.EMAIL,
-      value: email3
-    }
-  );
-  if (identity5 === void 0) return void 0;
-  return yield* client.findOne(
-    contact.class.Person,
-    { _id: identity5.attachedTo }
-  );
-});
-var findPersonByEmailOrName = (client, emailOrName) => Effect_exports.gen(function* () {
-  const socialIdentityPerson = yield* findPersonBySocialIdentityEmail(client, emailOrName);
-  if (socialIdentityPerson !== void 0) return socialIdentityPerson;
-  const exactChannel = yield* client.findOne(
-    contact.class.Channel,
-    {
-      value: emailOrName,
-      provider: contact.channelProvider.Email
-    }
-  );
-  if (exactChannel !== void 0) {
-    const person = yield* client.findOne(
-      contact.class.Person,
-      { _id: toRef(exactChannel.attachedTo) }
-    );
-    if (person !== void 0) return person;
-  }
-  const exactPerson = yield* client.findOne(
-    contact.class.Person,
-    { name: emailOrName }
-  );
-  if (exactPerson !== void 0) return exactPerson;
-  const escaped = escapeLikeWildcards(emailOrName);
-  const likeChannel = yield* client.findOne(
-    contact.class.Channel,
-    {
-      value: { $like: `%${escaped}%` },
-      provider: contact.channelProvider.Email
-    }
-  );
-  if (likeChannel !== void 0) {
-    const person = yield* client.findOne(
-      contact.class.Person,
-      { _id: toRef(likeChannel.attachedTo) }
-    );
-    if (person !== void 0) return person;
-  }
-  const likePerson = yield* client.findOne(
-    contact.class.Person,
-    { name: { $like: `%${escaped}%` } }
-  );
-  return likePerson;
-});
-
 // src/huly/operations/organizations.ts
 var findOrganizationByIdentifier = (client, identifier2) => Effect_exports.gen(function* () {
   const byId = yield* client.findOne(

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@firfi/huly-mcp",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "MCP server for Huly integration",
   "mcpName": "io.github.dearlordylord/huly-mcp",
   "type": "module",
   "main": "./dist/index.cjs",
   "files": [
-    "dist"
+    "dist/index.cjs"
   ],
   "publishConfig": {
     "access": "public"