@firfi/huly-mcp 0.10.3 → 0.12.0

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,
@@ -151493,6 +151528,31 @@ var HulySdk = class _HulySdk extends Context_exports.Tag("@hulymcp/HulySdk")() {
   });
 };
 
+// src/huly/url-builders.ts
+var testWorkbenchUrlConfig = {
+  baseUrl: UrlString.make("https://test.huly.local"),
+  workspaceUrlSlug: WorkspaceUrlSlug.make("test-workspace")
+};
+var slugifyTitle = (title) => {
+  const lowered = title.toLowerCase();
+  const stripped = lowered.replace(/[^a-z0-9.\-\s]/g, "");
+  const hyphenated = stripped.replace(/\s+/g, "-");
+  const collapsed = hyphenated.replace(/-+/g, "-");
+  return collapsed.replace(/^-+|-+$/g, "");
+};
+var buildDocumentUrl = (baseUrl, workspaceUrlSlug, title, id) => {
+  const trimmedBase = baseUrl.replace(/\/+$/, "");
+  const slug = slugifyTitle(title);
+  const pathSegment = slug === "" ? id : `${slug}-${id}`;
+  return UrlString.make(`${trimmedBase}/workbench/${workspaceUrlSlug}/document/${pathSegment}`);
+};
+var buildDocumentUrlFromConfig = (config3, title, id) => buildDocumentUrl(config3.baseUrl, config3.workspaceUrlSlug, title, id);
+var buildContactUrl = (baseUrl, workspaceUrlSlug, id) => {
+  const trimmedBase = baseUrl.replace(/\/+$/, "");
+  return UrlString.make(`${trimmedBase}/workbench/${workspaceUrlSlug}/contact/${id}`);
+};
+var buildContactUrlFromConfig = (config3, id) => buildContactUrl(config3.baseUrl, config3.workspaceUrlSlug, id);
+
 // src/huly/client.ts
 var AUTH_STATUS_CODES = /* @__PURE__ */ new Set([
   "platform:status:Unauthorized",
@@ -151581,7 +151641,7 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
         refUrl: UrlString.make(refUrl),
         imageUrl: UrlString.make(imageUrl)
       };
-      const documentUrlConfig = {
+      const workbenchUrlConfig = {
         baseUrl: UrlString.make(config3.url),
         workspaceUrlSlug
       };
@@ -151595,7 +151655,7 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       const operations = {
         getAccountUuid: () => accountUuid,
         getPrimarySocialId: () => primarySocialId,
-        documentUrlConfig,
+        workbenchUrlConfig,
         markupUrlConfig,
         findAll: (_class, query, options) => withClient(
           (client2) => client2.findAll(_class, query, options),
@@ -151679,11 +151739,8 @@ var HulyClient = class _HulyClient extends Context_exports.Tag("@hulymcp/HulyCli
       // PersonId is a branded string type with no public constructor
       // eslint-disable-next-line no-restricted-syntax -- see above
       getPrimarySocialId: () => "test-primary-social-id",
-      documentUrlConfig: {
-        baseUrl: UrlString.make("https://test.huly.local"),
-        workspaceUrlSlug: WorkspaceUrlSlug.make("test-workspace")
-      },
       markupUrlConfig: testMarkupUrlConfig,
+      workbenchUrlConfig: testWorkbenchUrlConfig,
       findAll: noopFindAll,
       findOne: noopFindOne,
       createDoc: notImplemented("createDoc"),
@@ -152010,6 +152067,19 @@ var WorkspaceClient = class _WorkspaceClient extends Context_exports.Tag("@hulym
           cause: e
         })
       });
+      const toAccountClientAccessLinkOptions = (options) => {
+        if (options === void 0) return void 0;
+        const result = {
+          ...options.firstName !== void 0 ? { firstName: options.firstName } : {},
+          ...options.lastName !== void 0 ? { lastName: options.lastName } : {},
+          ...options.navigateUrl !== void 0 ? { navigateUrl: options.navigateUrl } : {},
+          ...options.spaces !== void 0 ? { spaces: [...options.spaces] } : {},
+          ...options.notBefore !== void 0 ? { notBefore: options.notBefore } : {},
+          ...options.expiration !== void 0 ? { expiration: options.expiration } : {},
+          ...options.personalized !== void 0 ? { personalized: options.personalized } : {}
+        };
+        return result;
+      };
       const operations = {
         getWorkspaceMembers: () => withClient((c) => c.getWorkspaceMembers(), "Failed to get workspace members"),
         getPersonInfo: (account) => withClient((c) => c.getPersonInfo(account), "Failed to get person info"),
@@ -152020,6 +152090,10 @@ var WorkspaceClient = class _WorkspaceClient extends Context_exports.Tag("@hulym
         deleteWorkspace: () => withClient((c) => c.deleteWorkspace(), "Failed to delete workspace"),
         getUserProfile: (personUuid) => withClient((c) => c.getUserProfile(personUuid), "Failed to get user profile"),
         setMyProfile: (profile) => withClient((c) => c.setMyProfile(profile), "Failed to set my profile"),
+        createAccessLink: (role, options) => withClient(
+          (c) => c.createAccessLink(role, toAccountClientAccessLinkOptions(options)),
+          "Failed to create access link"
+        ),
         updateAllowReadOnlyGuests: (readOnlyGuestsAllowed) => withClient(
           (c) => c.updateAllowReadOnlyGuests(readOnlyGuestsAllowed),
           "Failed to update read-only guest setting"
@@ -152043,6 +152117,7 @@ var WorkspaceClient = class _WorkspaceClient extends Context_exports.Tag("@hulym
       deleteWorkspace: notImplemented("deleteWorkspace"),
       getUserProfile: () => Effect_exports.succeed(null),
       setMyProfile: notImplemented("setMyProfile"),
+      createAccessLink: notImplemented("createAccessLink"),
       updateAllowReadOnlyGuests: notImplemented("updateAllowReadOnlyGuests"),
       updateAllowGuestSignUp: notImplemented("updateAllowGuestSignUp"),
       getRegionInfo: () => Effect_exports.succeed([])
@@ -171326,7 +171401,7 @@ var PostHog = class extends PostHogBackendClient {
 };
 
 // src/version.ts
-var VERSION = true ? "0.10.3" : "0.0.0-dev";
+var VERSION = true ? "0.12.0" : "0.0.0-dev";
 
 // src/telemetry/posthog.ts
 var POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
@@ -171454,6 +171529,7 @@ var INVALID_PARAMS_TAGS = /* @__PURE__ */ new Set([
   "IssueNotFoundError",
   "ProjectNotFoundError",
   "InvalidStatusError",
+  "PersonIdentifierAmbiguousError",
   "PersonNotFoundError",
   "OrganizationNotFoundError",
   "OrganizationIdentifierAmbiguousError",
@@ -171470,6 +171546,8 @@ var INVALID_PARAMS_TAGS = /* @__PURE__ */ new Set([
   "ChannelNotFoundError",
   "DirectMessageIdentifierAmbiguousError",
   "DirectMessageNotFoundError",
+  "CannotDirectMessageSelfError",
+  "PersonNotAnEmployeeError",
   "MessageNotFoundError",
   "ThreadReplyNotFoundError",
   "CalendarNotAccessibleError",
@@ -172303,27 +172381,6 @@ var import_core23 = __toESM(require_lib4(), 1);
 var import_core22 = __toESM(require_lib4(), 1);
 var import_rank = __toESM(require_lib33(), 1);
 
-// src/huly/url-builders.ts
-var slugifyTitle = (title) => {
-  const lowered = title.toLowerCase();
-  const stripped = lowered.replace(/[^a-z0-9.\-\s]/g, "");
-  const hyphenated = stripped.replace(/\s+/g, "-");
-  const collapsed = hyphenated.replace(/-+/g, "-");
-  return collapsed.replace(/^-+|-+$/g, "");
-};
-var buildDocumentUrl = (baseUrl, workspaceUrlSlug, title, id) => {
-  const trimmedBase = baseUrl.replace(/\/+$/, "");
-  const slug = slugifyTitle(title);
-  const pathSegment = slug === "" ? id : `${slug}-${id}`;
-  return UrlString.make(`${trimmedBase}/workbench/${workspaceUrlSlug}/document/${pathSegment}`);
-};
-var buildDocumentUrlFromConfig = (config3, title, id) => buildDocumentUrl(config3.baseUrl, config3.workspaceUrlSlug, title, id);
-var buildContactUrl = (baseUrl, workspaceUrlSlug, id) => {
-  const trimmedBase = baseUrl.replace(/\/+$/, "");
-  return UrlString.make(`${trimmedBase}/workbench/${workspaceUrlSlug}/contact/${id}`);
-};
-var buildContactUrlFromConfig = (config3, id) => buildContactUrl(config3.baseUrl, config3.workspaceUrlSlug, id);
-
 // src/huly/operations/documents-edit.ts
 var editDocument = (params) => Effect_exports.gen(function* () {
   const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
@@ -172388,7 +172445,7 @@ var editDocument = (params) => Effect_exports.gen(function* () {
     contentUpdatedInPlace = true;
   }
   const finalTitle = updateOps.title ?? doc.title;
-  const url4 = buildDocumentUrlFromConfig(client.documentUrlConfig, finalTitle, DocumentId.make(doc._id));
+  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 };
   }
@@ -172985,7 +173042,7 @@ var listDocuments = (params) => Effect_exports.gen(function* () {
     id: DocumentId.make(doc._id),
     title: doc.title,
     teamspace: teamspace.name,
-    url: buildDocumentUrlFromConfig(client.documentUrlConfig, doc.title, DocumentId.make(doc._id)),
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
     modifiedOn: doc.modifiedOn
   }));
   return {
@@ -173010,7 +173067,7 @@ var getDocument = (params) => Effect_exports.gen(function* () {
     title: doc.title,
     content,
     teamspace: teamspace.name,
-    url: buildDocumentUrlFromConfig(client.documentUrlConfig, doc.title, DocumentId.make(doc._id)),
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, doc.title, DocumentId.make(doc._id)),
     modifiedOn: doc.modifiedOn,
     createdOn: doc.createdOn
   };
@@ -173063,7 +173120,7 @@ var createDocument = (params) => Effect_exports.gen(function* () {
   return {
     id: DocumentId.make(documentId),
     title: params.title,
-    url: buildDocumentUrlFromConfig(client.documentUrlConfig, params.title, DocumentId.make(documentId))
+    url: buildDocumentUrlFromConfig(client.workbenchUrlConfig, params.title, DocumentId.make(documentId))
   };
 });
 var deleteDocument = (params) => Effect_exports.gen(function* () {
@@ -176662,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({
@@ -177243,6 +177310,87 @@ var UpdateGuestSettingsParamsSchema = Schema_exports.Struct({
   title: "UpdateGuestSettingsParams",
   description: "Parameters for updating guest settings"
 });
+var MAX_UNIX_SECONDS_TIMESTAMP = 9999999999;
+var UnixSecondsTimestamp = Schema_exports.Number.pipe(
+  Schema_exports.int(),
+  Schema_exports.nonNegative(),
+  Schema_exports.lessThanOrEqualTo(MAX_UNIX_SECONDS_TIMESTAMP)
+).annotations({
+  identifier: "UnixSecondsTimestamp",
+  title: "UnixSecondsTimestamp",
+  description: "Unix timestamp in seconds (non-negative integer)"
+});
+var AccessLinkCommonParamsSchema = Schema_exports.Struct({
+  role: Schema_exports.optional(
+    AccountRoleSchema.annotations({
+      description: "Workspace role granted by the link. Defaults to GUEST."
+    })
+  ),
+  firstName: Schema_exports.optional(
+    NonEmptyString2.annotations({
+      description: "Optional first name for personalized links."
+    })
+  ),
+  lastName: Schema_exports.optional(
+    NonEmptyString2.annotations({
+      description: "Optional last name for personalized links."
+    })
+  ),
+  navigateUrl: Schema_exports.optional(
+    Schema_exports.String.annotations({
+      description: "Optional URL/path Huly should open after the link is used."
+    })
+  ),
+  spaces: Schema_exports.optional(
+    Schema_exports.Array(SpaceId).annotations({
+      description: "Optional Huly space IDs this link should grant access to. Use list_teamspaces, list_card_spaces, or other list tools to discover space IDs."
+    })
+  )
+});
+var PersonalizedAccessLinkParamsSchema = Schema_exports.Struct({
+  ...AccessLinkCommonParamsSchema.fields,
+  notBefore: Schema_exports.optional(
+    UnixSecondsTimestamp.annotations({
+      description: "Unix timestamp in seconds before which the link is invalid."
+    })
+  ),
+  expiration: Schema_exports.optional(
+    UnixSecondsTimestamp.annotations({
+      description: "Unix timestamp in seconds after which the link expires."
+    })
+  ),
+  personalized: Schema_exports.optional(
+    Schema_exports.Literal(true).annotations({
+      description: "Whether the link is bound to one person. Defaults to Huly's personalized-link behavior."
+    })
+  )
+});
+var AnonymousAccessLinkParamsSchema = Schema_exports.Struct({
+  ...AccessLinkCommonParamsSchema.fields,
+  notBefore: UnixSecondsTimestamp.annotations({
+    description: "Unix timestamp in seconds before which a non-personalized link is invalid."
+  }),
+  expiration: UnixSecondsTimestamp.annotations({
+    description: "Unix timestamp in seconds after which the link expires."
+  }),
+  personalized: Schema_exports.Literal(false).annotations({
+    description: "Set false for anonymous reusable guest links. Anonymous links require notBefore and expiration."
+  })
+});
+var CreateAccessLinkParamsSchema = Schema_exports.Union(
+  PersonalizedAccessLinkParamsSchema,
+  AnonymousAccessLinkParamsSchema
+).pipe(
+  Schema_exports.filter((params) => {
+    if (params.notBefore !== void 0 && params.expiration !== void 0 && params.expiration <= params.notBefore) {
+      return "expiration must be greater than notBefore.";
+    }
+    return void 0;
+  })
+).annotations({
+  title: "CreateAccessLinkParams",
+  description: "Parameters for creating a Huly workspace access link"
+});
 var GetRegionsParamsSchema = EmptyParamsSchema;
 var listWorkspaceMembersParamsJsonSchema = JSONSchema_exports.make(ListWorkspaceMembersParamsSchema);
 var updateMemberRoleParamsJsonSchema = JSONSchema_exports.make(UpdateMemberRoleParamsSchema);
@@ -177250,6 +177398,7 @@ var listWorkspacesParamsJsonSchema = JSONSchema_exports.make(ListWorkspacesParam
 var createWorkspaceParamsJsonSchema = JSONSchema_exports.make(CreateWorkspaceParamsSchema);
 var updateUserProfileParamsJsonSchema = JSONSchema_exports.make(UpdateUserProfileParamsSchema);
 var updateGuestSettingsParamsJsonSchema = JSONSchema_exports.make(UpdateGuestSettingsParamsSchema);
+var createAccessLinkParamsJsonSchema = JSONSchema_exports.make(CreateAccessLinkParamsSchema);
 var getRegionsParamsJsonSchema = JSONSchema_exports.make(GetRegionsParamsSchema);
 var parseListWorkspaceMembersParams = Schema_exports.decodeUnknown(ListWorkspaceMembersParamsSchema);
 var parseUpdateMemberRoleParams = Schema_exports.decodeUnknown(UpdateMemberRoleParamsSchema);
@@ -177257,6 +177406,7 @@ var parseListWorkspacesParams = Schema_exports.decodeUnknown(ListWorkspacesParam
 var parseCreateWorkspaceParams = Schema_exports.decodeUnknown(CreateWorkspaceParamsSchema);
 var parseUpdateUserProfileParams = Schema_exports.decodeUnknown(UpdateUserProfileParamsSchema);
 var parseUpdateGuestSettingsParams = Schema_exports.decodeUnknown(UpdateGuestSettingsParamsSchema);
+var parseCreateAccessLinkParams = Schema_exports.decodeUnknown(CreateAccessLinkParamsSchema);
 var parseGetRegionsParams = Schema_exports.decodeUnknown(GetRegionsParamsSchema);
 var WorkspaceMemberSchema = Schema_exports.Struct({
   personId: PersonUuid,
@@ -177319,6 +177469,12 @@ var UpdateGuestSettingsResultSchema = Schema_exports.Struct({
   allowReadOnly: Schema_exports.optional(Schema_exports.Boolean),
   allowSignUp: Schema_exports.optional(Schema_exports.Boolean)
 });
+var CreateAccessLinkResultSchema = Schema_exports.Struct({
+  link: UrlString,
+  role: AccountRoleSchema,
+  spaces: Schema_exports.optional(Schema_exports.Array(SpaceId)),
+  personalized: Schema_exports.optional(Schema_exports.Boolean)
+});
 var ListWorkspaceMembersResultSchema = Schema_exports.Array(WorkspaceMemberSchema);
 var ListWorkspacesResultSchema = Schema_exports.Array(WorkspaceSummarySchema);
 var GetRegionsResultSchema = Schema_exports.Array(RegionInfoSchema);
@@ -178094,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(
@@ -178125,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 });
   }
@@ -178162,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;
@@ -178188,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,
@@ -178231,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,
@@ -178264,7 +178623,7 @@ var listThreadReplies = (params) => Effect_exports.gen(function* () {
     {
       limit,
       sort: {
-        createdOn: import_core28.SortingOrder.Ascending
+        createdOn: import_core29.SortingOrder.Ascending
       }
     }
   );
@@ -178292,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,
@@ -178457,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.",
@@ -178548,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({
@@ -178587,7 +178957,7 @@ var listComments = (params) => Effect_exports.gen(function* () {
     {
       limit,
       sort: {
-        createdOn: import_core29.SortingOrder.Ascending
+        createdOn: import_core30.SortingOrder.Ascending
       }
     }
   );
@@ -178616,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)
   };
@@ -178742,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(
@@ -178900,7 +179170,7 @@ var listOrganizations = (params) => Effect_exports.gen(function* () {
       name: org.name,
       city: org.city,
       members: org.members,
-      url: buildContactUrlFromConfig(client.documentUrlConfig, id),
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
       modifiedOn: org.modifiedOn
     };
   });
@@ -178956,7 +179226,7 @@ var getOrganization = (params) => Effect_exports.gen(function* () {
     city: org.city || void 0,
     description: descriptionText,
     members: org.members,
-    url: buildContactUrlFromConfig(client.documentUrlConfig, id),
+    url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: org.modifiedOn
   };
 });
@@ -179216,7 +179486,7 @@ var listPersons = (params) => Effect_exports.gen(function* () {
       name: PersonName.make(person.name),
       city: person.city,
       email: emailValue !== void 0 ? Email.make(emailValue) : void 0,
-      url: buildContactUrlFromConfig(client.documentUrlConfig, id),
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
       modifiedOn: person.modifiedOn
     };
   });
@@ -179251,7 +179521,7 @@ var getPerson = (params) => Effect_exports.gen(function* () {
       value: c.value
     })),
     organizations: organizations.length > 0 ? organizations : void 0,
-    url: buildContactUrlFromConfig(client.documentUrlConfig, id),
+    url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: person.modifiedOn,
     createdOn: person.createdOn
   };
@@ -179348,7 +179618,7 @@ var listEmployees = (params) => Effect_exports.gen(function* () {
       email: emailValue !== void 0 ? Email.make(emailValue) : void 0,
       position: emp.position ?? void 0,
       active: emp.active,
-      url: buildContactUrlFromConfig(client.documentUrlConfig, id),
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
       modifiedOn: emp.modifiedOn
     };
   });
@@ -185132,6 +185402,17 @@ var accountRoleMap = {
 var toHulyAccountRole = (role) => accountRoleMap[role];
 var formatVersion = (info) => `${info.versionMajor}.${info.versionMinor}.${info.versionPatch}`;
 var nullToUndefined = (value3) => value3 ?? void 0;
+var toCreateAccessLinkOptions = (params) => {
+  return {
+    ...params.firstName !== void 0 ? { firstName: params.firstName } : {},
+    ...params.lastName !== void 0 ? { lastName: params.lastName } : {},
+    ...params.navigateUrl !== void 0 ? { navigateUrl: params.navigateUrl } : {},
+    ...params.spaces !== void 0 ? { spaces: params.spaces } : {},
+    ...params.notBefore !== void 0 ? { notBefore: params.notBefore } : {},
+    ...params.expiration !== void 0 ? { expiration: params.expiration } : {},
+    ...params.personalized !== void 0 ? { personalized: params.personalized } : {}
+  };
+};
 var listWorkspaceMembers = (params) => Effect_exports.gen(function* () {
   const ops = yield* WorkspaceClient;
   const limit = clampLimit(params.limit);
@@ -185270,6 +185551,17 @@ var updateGuestSettings = (params) => Effect_exports.gen(function* () {
     allowSignUp: params.allowSignUp
   };
 });
+var createAccessLink = (params) => Effect_exports.gen(function* () {
+  const ops = yield* WorkspaceClient;
+  const role = params.role ?? "GUEST";
+  const link = yield* ops.createAccessLink(toHulyAccountRole(role), toCreateAccessLinkOptions(params));
+  return {
+    link: UrlString.make(link),
+    role,
+    spaces: params.spaces,
+    personalized: params.personalized
+  };
+});
 var getRegions = () => Effect_exports.gen(function* () {
   const ops = yield* WorkspaceClient;
   const regions = yield* ops.getRegionInfo();
@@ -185387,6 +185679,18 @@ var workspaceTools = [
       UpdateGuestSettingsResultSchema
     )
   },
+  {
+    name: "create_access_link",
+    description: "Create a Huly workspace access link. Defaults to role GUEST. Supports anonymous reusable guest links by setting personalized=false with notBefore and expiration, and can restrict access to specific Huly space IDs via spaces.",
+    category: CATEGORY24,
+    inputSchema: createAccessLinkParamsJsonSchema,
+    handler: createEncodedWorkspaceToolHandler(
+      "create_access_link",
+      parseCreateAccessLinkParams,
+      createAccessLink,
+      CreateAccessLinkResultSchema
+    )
+  },
   {
     name: "get_regions",
     description: "Get available regions for workspace creation. Returns region codes and display names.",