@firfi/huly-mcp 0.10.2 → 0.11.0

package/README.md

@@ -371,6 +371,7 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | `get_user_profile` | Get the current user's profile information including bio, location, and social links. |
 | `update_user_profile` | Update the current user's profile. Supports bio, city, country, website, social links, and public visibility. |
 | `update_guest_settings` | Update workspace guest settings. Control read-only guest access and guest sign-up permissions. |
+| `create_access_link` | 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. |
 | `get_regions` | Get available regions for workspace creation. Returns region codes and display names. |
 
 ### Cards

package/dist/index.cjs

@@ -151493,6 +151493,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 +151606,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 +151620,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 +151704,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 +152032,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 +152055,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 +152082,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 +171366,7 @@ var PostHog = class extends PostHogBackendClient {
 };
 
 // src/version.ts
-var VERSION = true ? "0.10.1" : "0.0.0-dev";
+var VERSION = true ? "0.11.0" : "0.0.0-dev";
 
 // src/telemetry/posthog.ts
 var POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
@@ -172303,22 +172343,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);
-
 // src/huly/operations/documents-edit.ts
 var editDocument = (params) => Effect_exports.gen(function* () {
   const { client, doc, teamspace } = yield* findTeamspaceAndDocument(params);
@@ -172383,7 +172407,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 };
   }
@@ -172980,7 +173004,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 {
@@ -173005,7 +173029,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
   };
@@ -173058,7 +173082,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* () {
@@ -177238,6 +177262,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);
@@ -177245,6 +177350,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);
@@ -177252,6 +177358,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,
@@ -177314,6 +177421,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);
@@ -178888,13 +179001,17 @@ var listOrganizations = (params) => Effect_exports.gen(function* () {
       sort: { modifiedOn: import_core31.SortingOrder.Descending }
     }
   );
-  return orgs.map((org) => ({
-    id: OrganizationId.make(org._id),
-    name: org.name,
-    city: org.city,
-    members: org.members,
-    modifiedOn: org.modifiedOn
-  }));
+  return orgs.map((org) => {
+    const id = OrganizationId.make(org._id);
+    return {
+      id,
+      name: org.name,
+      city: org.city,
+      members: org.members,
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
+      modifiedOn: org.modifiedOn
+    };
+  });
 });
 var createOrganization = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
@@ -178940,12 +179057,14 @@ var getOrganization = (params) => Effect_exports.gen(function* () {
     org.description,
     "markdown"
   ) : void 0;
+  const id = OrganizationId.make(org._id);
   return {
-    id: OrganizationId.make(org._id),
+    id,
     name: org.name,
     city: org.city || void 0,
     description: descriptionText,
     members: org.members,
+    url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: org.modifiedOn
   };
 });
@@ -179199,11 +179318,13 @@ var listPersons = (params) => Effect_exports.gen(function* () {
   const emailMap = yield* batchGetEmailsForPersons(client, personIds);
   return persons.map((person) => {
     const emailValue = emailMap.get(person._id);
+    const id = PersonId.make(person._id);
     return {
-      id: PersonId.make(person._id),
+      id,
       name: PersonName.make(person.name),
       city: person.city,
       email: emailValue !== void 0 ? Email.make(emailValue) : void 0,
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
       modifiedOn: person.modifiedOn
     };
   });
@@ -179225,8 +179346,9 @@ var getPerson = (params) => Effect_exports.gen(function* () {
   const organizations = yield* findOrganizationsForPerson(client, person._id);
   const { firstName, lastName } = parseName(person.name);
   const emailChannel = channels.find((c) => c.provider === contact.channelProvider.Email);
+  const id = PersonId.make(person._id);
   return {
-    id: PersonId.make(person._id),
+    id,
     name: PersonName.make(person.name),
     firstName,
     lastName,
@@ -179237,6 +179359,7 @@ var getPerson = (params) => Effect_exports.gen(function* () {
       value: c.value
     })),
     organizations: organizations.length > 0 ? organizations : void 0,
+    url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: person.modifiedOn,
     createdOn: person.createdOn
   };
@@ -179326,12 +179449,14 @@ var listEmployees = (params) => Effect_exports.gen(function* () {
   const emailMap = yield* batchGetEmailsForPersons(client, employeeIds);
   return employees.map((emp) => {
     const emailValue = emailMap.get(emp._id);
+    const id = PersonId.make(emp._id);
     return {
-      id: PersonId.make(emp._id),
+      id,
       name: PersonName.make(emp.name),
       email: emailValue !== void 0 ? Email.make(emailValue) : void 0,
       position: emp.position ?? void 0,
       active: emp.active,
+      url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
       modifiedOn: emp.modifiedOn
     };
   });
@@ -185115,6 +185240,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);
@@ -185253,6 +185389,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();
@@ -185370,6 +185517,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.",