@firfi/huly-mcp 0.29.0 → 0.30.0

package/README.md

@@ -449,13 +449,21 @@ SDK upgrade revisit:
 | `update_person` | Update fields on an existing person. Only provided fields are modified. |
 | `delete_person` | Permanently delete a person from Huly. This action cannot be undone. |
 | `list_employees` | List employees (persons who are team members). Returns employees sorted by modification date (newest first). |
+| `list_contact_channel_providers` | List supported contact channel provider labels for person and organization channel tools. |
+| `list_person_channels` | List contact channels for a person. Person accepts person ID, exact email address, or exact Huly display name; ambiguous names fail and should be retried with email or person ID. |
+| `add_person_channel` | Idempotently add a contact channel to a person. Person accepts person ID, exact email address, or exact Huly display name. Provider labels match list_contact_channel_providers. Returns added=false and the existing channel when the exact provider+value already exists. |
+| `update_person_channel` | Update one contact channel on a person. Person accepts person ID, exact email, or exact display name. Identify the channel with exactly one locator: channelId, or provider plus value. Provide newProvider, newValue, or both. Updating to an existing provider+value on the same person fails with a conflict. |
+| `remove_person_channel` | Remove one contact channel from a person. Person accepts person ID, exact email, or exact display name. Identify the channel with exactly one locator: channelId, or provider plus value. Returns removed=false when the locator is absent for that person. |
 | `list_organizations` | List all organizations in the Huly workspace. Returns organizations sorted by modification date (newest first). |
 | `create_organization` | Create a new organization in Huly. Optionally add members by person ID or email. Fails if any requested member cannot be resolved. Returns the created organization ID. |
 | `get_organization` | Retrieve full details for an organization by ID or exact name when that name is unique - including city, description, member count, and modification timestamp. If multiple organizations share the same name, use the organization ID. |
 | `update_organization` | Update fields on an existing organization identified by ID or exact name when that name is unique. Only provided fields are modified. Description supports multi-line plain text and is the right place to store CRM notes / revenue summaries / context. Pass null to clear city or description. If multiple organizations share the same name, use the organization ID. |
 | `delete_organization` | Permanently delete an organization identified by ID or exact name when that name is unique. Use with care - this cannot be undone. Useful for cleaning up duplicate organizations after merging their data elsewhere. If multiple organizations share the same name, use the organization ID. |
 | `make_organization_customer` | Apply the Customer mixin to an organization so it appears in the Huly Leads > Customers view. Idempotent - safe to call on organizations that are already customers. Takes the organization ID or exact name when that name is unique. |
-| `add_organization_channel` | Add a contact channel (phone, email, website/homepage, LinkedIn, Twitter, GitHub, Facebook, Telegram) to an organization identified by ID or exact unique name. Provider names: email, phone, linkedin, twitter, github, facebook, telegram, homepage. |
+| `add_organization_channel` | Idempotently add a contact channel to an organization identified by ID or exact unique name. Provider labels: email, phone, linkedin, twitter, github, facebook, telegram, homepage, whatsapp, skype, profile, viber. Returns added=false and the existing channel when the exact provider+value already exists. |
+| `list_organization_channels` | List contact channels for an organization identified by ID or exact unique organization name. Returns channelId, provider label, value, and optional activity metadata. |
+| `update_organization_channel` | Update one contact channel on an organization identified by ID or exact unique name. Identify the channel with exactly one locator: channelId, or provider plus value. Provide newProvider, newValue, or both. Updating to an existing provider+value on the same organization fails with a conflict. |
+| `remove_organization_channel` | Remove one contact channel from an organization identified by ID or exact unique name. Identify the channel with exactly one locator: channelId, or provider plus value. Returns removed=false when the locator is absent for that organization. |
 | `add_organization_member` | Link a person as a member of an organization. The person appears under the org's Members tab in Huly. Use person ID or email to identify the person. Idempotent: returns added=false if that person is already a member. |
 | `list_organization_members` | List all persons who are members of an organization. Returns each member's person ID, name, and primary email (if any). When using a name instead of an ID, that name must identify exactly one organization. |
 | `list_person_organizations` | List all organizations that a person is a member of. Provide personId or email. Returns each organization's ID and name. |

package/dist/index.cjs

@@ -81771,7 +81771,7 @@ var require_connection2 = __commonJS({
     });
     module2.exports = __toCommonJS2(connection_exports);
     var import_analytics = require_lib2();
-    var import_client65 = __toESM2(require_lib6());
+    var import_client66 = __toESM2(require_lib6());
     var import_core80 = __toESM2(require_lib4());
     var import_platform4 = __toESM2(require_lib());
     var import_rpc = require_lib18();
@@ -81882,7 +81882,7 @@ var require_connection2 = __commonJS({
           }
           if (!this.closed) {
             void this.sendRequest({
-              method: import_client65.pingConst,
+              method: import_client66.pingConst,
               params: [],
               once: true,
               handleResult: /* @__PURE__ */ __name(async (result) => {
@@ -81915,7 +81915,7 @@ var require_connection2 = __commonJS({
         }
       }
       isConnected() {
-        return this.websocket != null && this.websocket.readyState === import_client65.ClientSocketReadyState.OPEN && this.helloReceived;
+        return this.websocket != null && this.websocket.readyState === import_client66.ClientSocketReadyState.OPEN && this.helloReceived;
       }
       delay = 0;
       onConnectHandlers = [];
@@ -82055,8 +82055,8 @@ var require_connection2 = __commonJS({
           }
           return;
         }
-        if (resp.result === import_client65.pingConst) {
-          void this.sendRequest({ method: import_client65.pingConst, params: [] }).catch((err) => {
+        if (resp.result === import_client66.pingConst) {
+          void this.sendRequest({ method: import_client66.pingConst, params: [] }).catch((err) => {
             this.ctx.error("failed to send ping", { err });
           });
           return;
@@ -82148,15 +82148,15 @@ var require_connection2 = __commonJS({
         }
       }
       checkArrayBufferPing(data) {
-        if (data.byteLength === import_client65.pingConst.length || data.byteLength === import_client65.pongConst.length) {
+        if (data.byteLength === import_client66.pingConst.length || data.byteLength === import_client66.pongConst.length) {
           const text = new TextDecoder().decode(data);
-          if (text === import_client65.pingConst) {
-            void this.sendRequest({ method: import_client65.pingConst, params: [] }).catch((err) => {
+          if (text === import_client66.pingConst) {
+            void this.sendRequest({ method: import_client66.pingConst, params: [] }).catch((err) => {
               this.ctx.error("failed to send ping", { err });
             });
             return true;
           }
-          if (text === import_client65.pongConst) {
+          if (text === import_client66.pongConst) {
             this.pingResponse = Date.now();
             return true;
           }
@@ -82166,7 +82166,7 @@ var require_connection2 = __commonJS({
       openConnection(ctx, socketId) {
         this.binaryMode = false;
         this.helloReceived = false;
-        const clientSocketFactory = this.opt?.socketFactory ?? (0, import_platform4.getMetadata)(import_client65.default.metadata.ClientSocketFactory) ?? ((url4) => {
+        const clientSocketFactory = this.opt?.socketFactory ?? (0, import_platform4.getMetadata)(import_client66.default.metadata.ClientSocketFactory) ?? ((url4) => {
           const s = new WebSocket(url4);
           return s;
         });
@@ -82201,12 +82201,12 @@ var require_connection2 = __commonJS({
           if (this.websocket !== wsocket) {
             return;
           }
-          if (event.data === import_client65.pongConst) {
+          if (event.data === import_client66.pongConst) {
             this.pingResponse = Date.now();
             return;
           }
-          if (event.data === import_client65.pingConst) {
-            void this.sendRequest({ method: import_client65.pingConst, params: [] }).catch((err) => {
+          if (event.data === import_client66.pingConst) {
+            void this.sendRequest({ method: import_client66.pingConst, params: [] }).catch((err) => {
               this.ctx.error("failed to send ping", { err });
             });
             return;
@@ -82271,8 +82271,8 @@ var require_connection2 = __commonJS({
           if (this.websocket !== wsocket) {
             return;
           }
-          const useBinary = this.opt?.useBinaryProtocol ?? (0, import_platform4.getMetadata)(import_client65.default.metadata.UseBinaryProtocol) ?? true;
-          this.compressionMode = this.opt?.useProtocolCompression ?? (0, import_platform4.getMetadata)(import_client65.default.metadata.UseProtocolCompression) ?? false;
+          const useBinary = this.opt?.useBinaryProtocol ?? (0, import_platform4.getMetadata)(import_client66.default.metadata.UseBinaryProtocol) ?? true;
+          this.compressionMode = this.opt?.useProtocolCompression ?? (0, import_platform4.getMetadata)(import_client66.default.metadata.UseProtocolCompression) ?? false;
           const helloRequest = {
             method: "hello",
             params: [],
@@ -82318,13 +82318,13 @@ var require_connection2 = __commonJS({
             if (w instanceof Promise) {
               await w;
             }
-            if (data.method !== import_client65.pingConst) {
+            if (data.method !== import_client66.pingConst) {
               this.requests.set(id, promise4);
             }
             promise4.sendData = () => {
-              if (this.websocket?.readyState === import_client65.ClientSocketReadyState.OPEN) {
+              if (this.websocket?.readyState === import_client66.ClientSocketReadyState.OPEN) {
                 promise4.startTime = Date.now();
-                if (data.method !== import_client65.pingConst) {
+                if (data.method !== import_client66.pingConst) {
                   const dta = this.rpcHandler.serialize(
                     {
                       method: data.method,
@@ -82337,7 +82337,7 @@ var require_connection2 = __commonJS({
                   );
                   this.websocket?.send(dta);
                 } else {
-                  this.websocket?.send(import_client65.pingConst);
+                  this.websocket?.send(import_client66.pingConst);
                 }
               }
             };
@@ -82351,7 +82351,7 @@ var require_connection2 = __commonJS({
               };
             }
             promise4.sendData();
-            if (data.method !== import_client65.pingConst) {
+            if (data.method !== import_client66.pingConst) {
               return await promise4.promise;
             }
           },
@@ -82517,7 +82517,7 @@ var require_lib19 = __commonJS({
       default: () => index_default
     });
     module2.exports = __toCommonJS2(index_exports2);
-    var import_client65 = __toESM2(require_lib6());
+    var import_client66 = __toESM2(require_lib6());
     var import_core80 = __toESM2(require_lib4());
     var import_platform4 = __toESM2(require_lib());
     var import_connection = require_connection2();
@@ -82561,8 +82561,8 @@ var require_lib19 = __commonJS({
       return {
         function: {
           GetClient: /* @__PURE__ */ __name(async (token, endpoint, opt) => {
-            const filterModel = (0, import_platform4.getMetadata)(import_client65.default.metadata.FilterModel) ?? "none";
-            const extraFilter = (0, import_platform4.getMetadata)(import_client65.default.metadata.ExtraFilter) ?? [];
+            const filterModel = (0, import_platform4.getMetadata)(import_client66.default.metadata.FilterModel) ?? "none";
+            const extraFilter = (0, import_platform4.getMetadata)(import_client66.default.metadata.ExtraFilter) ?? [];
             const handler = /* @__PURE__ */ __name(async (handler2) => {
               const url4 = (0, import_core80.concatLink)(endpoint, `/${token}`);
               const upgradeHandler = /* @__PURE__ */ __name((...txes) => {
@@ -82590,7 +82590,7 @@ var require_lib19 = __commonJS({
                 throw new Error("Workspace or account not found in token");
               }
               const newOpt = { ...opt };
-              const connectTimeout = opt?.connectionTimeout ?? (0, import_platform4.getMetadata)(import_client65.default.metadata.ConnectionTimeout);
+              const connectTimeout = opt?.connectionTimeout ?? (0, import_platform4.getMetadata)(import_client66.default.metadata.ConnectionTimeout);
               let connectPromise;
               if ((connectTimeout ?? 0) > 0) {
                 connectPromise = new Promise((resolve2, reject) => {
@@ -82642,7 +82642,7 @@ var require_lib19 = __commonJS({
     function returnUITxes(txes, extraFilter) {
       const configs = /* @__PURE__ */ new Map();
       (0, import_core80.fillConfiguration)(txes, configs);
-      const allowedPlugins = [...(0, import_platform4.getPlugins)(), ...(0, import_platform4.getMetadata)(import_client65.default.metadata.ExtraPlugins) ?? []];
+      const allowedPlugins = [...(0, import_platform4.getPlugins)(), ...(0, import_platform4.getMetadata)(import_client66.default.metadata.ExtraPlugins) ?? []];
       const excludedPlugins = Array.from(configs.values()).filter(
         (it) => !it.enabled || !allowedPlugins.includes(it.pluginId) || extraFilter.includes(it.pluginId)
       );
@@ -82690,7 +82690,7 @@ var require_lib19 = __commonJS({
     }
     __name(returnClientTxes, "returnClientTxes");
     function createModelPersistence(workspace) {
-      const overrideStore = (0, import_platform4.getMetadata)(import_client65.default.metadata.OverridePersistenceStore);
+      const overrideStore = (0, import_platform4.getMetadata)(import_client66.default.metadata.OverridePersistenceStore);
       if (overrideStore !== void 0) {
         return overrideStore;
       }
@@ -82787,7 +82787,7 @@ var require_client6 = __commonJS({
     });
     module2.exports = __toCommonJS2(client_exports);
     var import_account_client2 = require_lib5();
-    var import_client65 = __toESM2(require_lib6());
+    var import_client66 = __toESM2(require_lib6());
     var import_core80 = require_lib4();
     var import_platform4 = require_lib();
     var import_config9 = require_config();
@@ -82813,9 +82813,9 @@ var require_client6 = __commonJS({
     }
     __name(connect, "connect");
     async function createClient(url4, endpoint, token, workspaceUuid, account, config3, options) {
-      (0, import_platform4.addLocation)(import_client65.clientId, () => Promise.resolve().then(() => __toESM(require_lib19())));
+      (0, import_platform4.addLocation)(import_client66.clientId, () => Promise.resolve().then(() => __toESM(require_lib19())));
       const { socketFactory, connectionTimeout } = options;
-      const clientFactory = await (0, import_platform4.getResource)(import_client65.default.function.GetClient);
+      const clientFactory = await (0, import_platform4.getResource)(import_client66.default.function.GetClient);
       const connection = await clientFactory(token, endpoint, {
         socketFactory,
         connectionTimeout
@@ -83936,11 +83936,11 @@ var require_storage2 = __commonJS({
     var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
     var storage_exports = {};
     __export2(storage_exports, {
-      connectStorage: () => import_client65.connectStorage,
-      createStorageClient: () => import_client65.createStorageClient
+      connectStorage: () => import_client66.connectStorage,
+      createStorageClient: () => import_client66.createStorageClient
     });
     module2.exports = __toCommonJS2(storage_exports);
-    var import_client65 = require_client7();
+    var import_client66 = require_client7();
     __reExport2(storage_exports, require_error3(), module2.exports);
     __reExport2(storage_exports, require_types8(), module2.exports);
   }
@@ -152893,6 +152893,63 @@ var InvalidContactProviderError = class extends Schema_exports.TaggedError()(
     return `Invalid contact provider: '${this.provider}'`;
   }
 };
+var ContactChannelNotFoundError = class extends Schema_exports.TaggedError()(
+  "ContactChannelNotFoundError",
+  {
+    ownerIdentifier: Schema_exports.String,
+    channelIdentifier: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Contact channel '${this.channelIdentifier}' not found for '${this.ownerIdentifier}'`;
+  }
+};
+var ContactChannelIdentifierAmbiguousError = class extends Schema_exports.TaggedError()(
+  "ContactChannelIdentifierAmbiguousError",
+  {
+    ownerIdentifier: Schema_exports.String,
+    channelIdentifier: Schema_exports.String,
+    matches: AmbiguousMatchCount
+  }
+) {
+  get message() {
+    return `Contact channel '${this.channelIdentifier}' matched ${this.matches} channels for '${this.ownerIdentifier}'; use channelId instead`;
+  }
+};
+var InvalidContactChannelLocatorError = class extends Schema_exports.TaggedError()(
+  "InvalidContactChannelLocatorError",
+  {
+    ownerIdentifier: Schema_exports.String,
+    reason: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Invalid contact channel locator for '${this.ownerIdentifier}': ${this.reason}`;
+  }
+};
+var ContactChannelConflictError = class extends Schema_exports.TaggedError()(
+  "ContactChannelConflictError",
+  {
+    ownerIdentifier: Schema_exports.String,
+    provider: Schema_exports.String,
+    value: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Contact channel '${this.provider}:${this.value}' already exists for '${this.ownerIdentifier}'`;
+  }
+};
+var InvalidContactChannelValueError = class extends Schema_exports.TaggedError()(
+  "InvalidContactChannelValueError",
+  {
+    provider: Schema_exports.String,
+    value: Schema_exports.String
+  }
+) {
+  get message() {
+    return `Invalid value '${this.value}' for contact channel provider '${this.provider}'`;
+  }
+};
 var InvalidPersonUuidError = class extends Schema_exports.TaggedError()(
   "InvalidPersonUuidError",
   {
@@ -154731,6 +154788,11 @@ var HulyDomainError = Schema_exports.Union(
   IssueNotFoundError,
   ProjectNotFoundError,
   InvalidStatusError,
+  ContactChannelConflictError,
+  ContactChannelIdentifierAmbiguousError,
+  ContactChannelNotFoundError,
+  InvalidContactChannelLocatorError,
+  InvalidContactChannelValueError,
   PersonIdentifierAmbiguousError,
   PersonNotFoundError,
   OrganizationNotFoundError,
@@ -165692,6 +165754,11 @@ var INVALID_PARAMS_TAGS = /* @__PURE__ */ new Set([
   "OrganizationNotFoundError",
   "OrganizationIdentifierAmbiguousError",
   "InvalidContactProviderError",
+  "ContactChannelNotFoundError",
+  "ContactChannelIdentifierAmbiguousError",
+  "ContactChannelConflictError",
+  "InvalidContactChannelLocatorError",
+  "InvalidContactChannelValueError",
   "InvalidFileDataError",
   "FileNotFoundError",
   "TeamspaceNotFoundError",
@@ -169555,6 +169622,194 @@ var parseUpdateMilestoneParams = Schema_exports.decodeUnknown(UpdateMilestonePar
 var parseSetIssueMilestoneParams = Schema_exports.decodeUnknown(SetIssueMilestoneParamsSchema);
 var parseDeleteMilestoneParams = Schema_exports.decodeUnknown(DeleteMilestoneParamsSchema);
 
+// src/domain/schemas/contact-channels.ts
+var CHANNEL_UPDATE_FIELDS = ["newProvider", "newValue"];
+var ContactChannelProviderValues = [
+  "email",
+  "phone",
+  "linkedin",
+  "twitter",
+  "github",
+  "facebook",
+  "telegram",
+  "homepage",
+  "whatsapp",
+  "skype",
+  "profile",
+  "viber"
+];
+var ContactChannelProviderSdkKeys = {
+  email: "Email",
+  phone: "Phone",
+  linkedin: "LinkedIn",
+  twitter: "Twitter",
+  github: "GitHub",
+  facebook: "Facebook",
+  telegram: "Telegram",
+  homepage: "Homepage",
+  whatsapp: "Whatsapp",
+  skype: "Skype",
+  profile: "Profile",
+  viber: "Viber"
+};
+var ContactChannelProviderSchema = Schema_exports.Literal(...ContactChannelProviderValues);
+var ContactChannelSummarySchema = Schema_exports.Struct({
+  channelId: ChannelId,
+  provider: ContactChannelProviderSchema,
+  value: NonEmptyString2,
+  items: Schema_exports.optional(Count),
+  lastMessage: Schema_exports.optional(Timestamp)
+});
+var ListContactChannelProvidersParamsSchema = EmptyParamsSchema.annotations({
+  title: "ListContactChannelProvidersParams",
+  description: "Parameters for listing supported contact channel provider labels."
+});
+var providerDescription = `Channel provider label: ${enumValuesDescription(ContactChannelProviderValues)}.`;
+var validateEmailChannelValue = (provider, value3) => provider === "email" && !Schema_exports.is(Email)(value3) ? "email provider values must be valid email addresses." : void 0;
+var ChannelProviderValueSchema = Schema_exports.Struct({
+  provider: ContactChannelProviderSchema.annotations({ description: providerDescription }),
+  value: NonEmptyString2.annotations({
+    description: "Channel value. Email providers require a valid email address; all other providers require text."
+  })
+}).pipe(Schema_exports.filter((params) => validateEmailChannelValue(params.provider, params.value)));
+var hasProviderValueLocator = (params) => params.provider !== void 0 && params.value !== void 0;
+var channelLocatorMessage = "Provide exactly one channel locator: channelId, or provider plus value.";
+var validateChannelLocator = (params) => {
+  const hasChannelId = params.channelId !== void 0;
+  const hasAnyProviderValue = params.provider !== void 0 || params.value !== void 0;
+  const hasProviderValue = hasProviderValueLocator(params);
+  if (hasChannelId && !hasAnyProviderValue) return void 0;
+  if (!hasChannelId && hasProviderValue) return void 0;
+  return channelLocatorMessage;
+};
+var updateTargetValueMessage = "At least one update field must be provided: newProvider, newValue.";
+var validateUpdateTargetValue = (params) => {
+  if (!hasAtLeastOneDefined(params, CHANNEL_UPDATE_FIELDS)) return updateTargetValueMessage;
+  const targetProvider = params.newProvider ?? params.provider;
+  const targetValue = params.newValue ?? params.value;
+  return targetProvider !== void 0 && targetValue !== void 0 ? validateEmailChannelValue(targetProvider, targetValue) : void 0;
+};
+var ContactChannelLocatorFieldsSchema = Schema_exports.Struct({
+  channelId: Schema_exports.optional(ChannelId.annotations({
+    description: "Raw channel document ID returned by list/get/add channel tools."
+  })),
+  provider: Schema_exports.optional(ContactChannelProviderSchema.annotations({ description: providerDescription })),
+  value: Schema_exports.optional(NonEmptyString2.annotations({
+    description: "Existing channel value to pair with provider when channelId is not used."
+  }))
+}).pipe(
+  Schema_exports.filter(
+    (params) => params.provider !== void 0 && params.value !== void 0 ? validateEmailChannelValue(params.provider, params.value) : void 0
+  ),
+  Schema_exports.filter(validateChannelLocator)
+);
+var AddPersonChannelParamsSchema = ChannelProviderValueSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    person: NonEmptyString2.annotations({
+      description: "Person ID, exact email address, or exact Huly display name."
+    })
+  }))
+).annotations({
+  title: "AddPersonChannelParams",
+  description: "Add a contact channel to a person. Idempotent by exact provider plus value."
+});
+var ListPersonChannelsParamsSchema = Schema_exports.Struct({
+  person: NonEmptyString2.annotations({
+    description: "Person ID, exact email address, or exact Huly display name."
+  })
+}).annotations({
+  title: "ListPersonChannelsParams",
+  description: "List contact channels for a person."
+});
+var UpdatePersonChannelParamsSchema = ContactChannelLocatorFieldsSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    person: NonEmptyString2.annotations({
+      description: "Person ID, exact email address, or exact Huly display name."
+    }),
+    newProvider: Schema_exports.optional(ContactChannelProviderSchema.annotations({ description: providerDescription })),
+    newValue: Schema_exports.optional(NonEmptyString2.annotations({ description: "Replacement channel value." }))
+  })),
+  Schema_exports.filter(validateUpdateTargetValue)
+).annotations({
+  title: "UpdatePersonChannelParams",
+  description: `Update one contact channel on a person. ${channelLocatorMessage} ${updateTargetValueMessage}`
+});
+var RemovePersonChannelParamsSchema = ContactChannelLocatorFieldsSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    person: NonEmptyString2.annotations({
+      description: "Person ID, exact email address, or exact Huly display name."
+    })
+  }))
+).annotations({
+  title: "RemovePersonChannelParams",
+  description: `Remove one contact channel from a person. ${channelLocatorMessage}`
+});
+var ListOrganizationChannelsParamsSchema = Schema_exports.Struct({
+  organizationId: NonEmptyString2.annotations({
+    description: "Organization ID or exact unique organization name."
+  })
+}).annotations({
+  title: "ListOrganizationChannelsParams",
+  description: "List contact channels for an organization."
+});
+var AddOrganizationChannelParamsSchema = ChannelProviderValueSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    organizationId: NonEmptyString2.annotations({
+      description: "Organization ID or exact unique organization name."
+    })
+  }))
+).annotations({
+  title: "AddOrganizationChannelParams",
+  description: "Add a contact channel to an organization. Idempotent by exact provider plus value."
+});
+var UpdateOrganizationChannelParamsSchema = ContactChannelLocatorFieldsSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    organizationId: NonEmptyString2.annotations({
+      description: "Organization ID or exact unique organization name."
+    }),
+    newProvider: Schema_exports.optional(ContactChannelProviderSchema.annotations({ description: providerDescription })),
+    newValue: Schema_exports.optional(NonEmptyString2.annotations({ description: "Replacement channel value." }))
+  })),
+  Schema_exports.filter(validateUpdateTargetValue)
+).annotations({
+  title: "UpdateOrganizationChannelParams",
+  description: `Update one contact channel on an organization. ${channelLocatorMessage} ${updateTargetValueMessage}`
+});
+var RemoveOrganizationChannelParamsSchema = ContactChannelLocatorFieldsSchema.pipe(
+  Schema_exports.extend(Schema_exports.Struct({
+    organizationId: NonEmptyString2.annotations({
+      description: "Organization ID or exact unique organization name."
+    })
+  }))
+).annotations({
+  title: "RemoveOrganizationChannelParams",
+  description: `Remove one contact channel from an organization. ${channelLocatorMessage}`
+});
+var addPersonChannelParamsJsonSchema = JSONSchema_exports.make(AddPersonChannelParamsSchema);
+var listContactChannelProvidersParamsJsonSchema = JSONSchema_exports.make(ListContactChannelProvidersParamsSchema);
+var listPersonChannelsParamsJsonSchema = JSONSchema_exports.make(ListPersonChannelsParamsSchema);
+var updatePersonChannelParamsJsonSchema = withAtLeastOneRequired(
+  JSONSchema_exports.make(UpdatePersonChannelParamsSchema),
+  CHANNEL_UPDATE_FIELDS
+);
+var removePersonChannelParamsJsonSchema = JSONSchema_exports.make(RemovePersonChannelParamsSchema);
+var addOrganizationChannelParamsJsonSchema = JSONSchema_exports.make(AddOrganizationChannelParamsSchema);
+var listOrganizationChannelsParamsJsonSchema = JSONSchema_exports.make(ListOrganizationChannelsParamsSchema);
+var updateOrganizationChannelParamsJsonSchema = withAtLeastOneRequired(
+  JSONSchema_exports.make(UpdateOrganizationChannelParamsSchema),
+  CHANNEL_UPDATE_FIELDS
+);
+var removeOrganizationChannelParamsJsonSchema = JSONSchema_exports.make(RemoveOrganizationChannelParamsSchema);
+var parseAddPersonChannelParams = Schema_exports.decodeUnknown(AddPersonChannelParamsSchema);
+var parseListContactChannelProvidersParams = Schema_exports.decodeUnknown(ListContactChannelProvidersParamsSchema);
+var parseListPersonChannelsParams = Schema_exports.decodeUnknown(ListPersonChannelsParamsSchema);
+var parseUpdatePersonChannelParams = Schema_exports.decodeUnknown(UpdatePersonChannelParamsSchema);
+var parseRemovePersonChannelParams = Schema_exports.decodeUnknown(RemovePersonChannelParamsSchema);
+var parseAddOrganizationChannelParams = Schema_exports.decodeUnknown(AddOrganizationChannelParamsSchema);
+var parseListOrganizationChannelsParams = Schema_exports.decodeUnknown(ListOrganizationChannelsParamsSchema);
+var parseUpdateOrganizationChannelParams = Schema_exports.decodeUnknown(UpdateOrganizationChannelParamsSchema);
+var parseRemoveOrganizationChannelParams = Schema_exports.decodeUnknown(RemoveOrganizationChannelParamsSchema);
+
 // src/domain/schemas/contact-organizations.ts
 var OrganizationSummarySchema = Schema_exports.Struct({
   id: OrganizationId,
@@ -169660,21 +169915,6 @@ var ListPersonOrganizationsParamsSchema = Schema_exports.Union(
   title: "ListPersonOrganizationsParams",
   description: "List organizations a person is a member of (provide personId or email)"
 });
-var OrganizationChannelProviderValues = [
-  "email",
-  "phone",
-  "linkedin",
-  "twitter",
-  "github",
-  "facebook",
-  "telegram",
-  "homepage",
-  "whatsapp",
-  "skype",
-  "profile",
-  "viber"
-];
-var OrganizationChannelProviderSchema = Schema_exports.Literal(...OrganizationChannelProviderValues);
 var RemoveOrganizationMemberParamsSchema = Schema_exports.Struct({
   organizationId: NonEmptyString2.annotations({
     description: "Organization ID or exact name"
@@ -169686,20 +169926,6 @@ var RemoveOrganizationMemberParamsSchema = Schema_exports.Struct({
   title: "RemoveOrganizationMemberParams",
   description: "Parameters for removing a person from an organization"
 });
-var AddOrganizationChannelParamsSchema = Schema_exports.Struct({
-  organizationId: NonEmptyString2.annotations({
-    description: "Organization ID or exact name"
-  }),
-  provider: OrganizationChannelProviderSchema.annotations({
-    description: `Channel type: ${enumValuesDescription(OrganizationChannelProviderValues)}`
-  }),
-  value: NonEmptyString2.annotations({
-    description: "Channel value (email address, phone number, URL, username)"
-  })
-}).annotations({
-  title: "AddOrganizationChannelParams",
-  description: "Parameters for adding a contact channel to an organization"
-});
 var AddOrganizationMemberParamsSchema = Schema_exports.Struct({
   organizationId: NonEmptyString2.annotations({
     description: "Organization ID or exact name"
@@ -169711,7 +169937,6 @@ var AddOrganizationMemberParamsSchema = Schema_exports.Struct({
   title: "AddOrganizationMemberParams",
   description: "Parameters for adding a person as an organization member"
 });
-var addOrganizationChannelParamsJsonSchema = JSONSchema_exports.make(AddOrganizationChannelParamsSchema);
 var addOrganizationMemberParamsJsonSchema = JSONSchema_exports.make(AddOrganizationMemberParamsSchema);
 var listOrganizationMembersParamsJsonSchema = JSONSchema_exports.make(ListOrganizationMembersParamsSchema);
 var listPersonOrganizationsParamsJsonSchema = JSONSchema_exports.make(ListPersonOrganizationsParamsSchema);
@@ -169724,7 +169949,6 @@ var updateOrganizationParamsJsonSchema = withAtLeastOneRequired(
   UPDATE_ORGANIZATION_FIELDS
 );
 var deleteOrganizationParamsJsonSchema = JSONSchema_exports.make(DeleteOrganizationParamsSchema);
-var parseAddOrganizationChannelParams = Schema_exports.decodeUnknown(AddOrganizationChannelParamsSchema);
 var parseAddOrganizationMemberParams = Schema_exports.decodeUnknown(AddOrganizationMemberParamsSchema);
 var parseListOrganizationMembersParams = Schema_exports.decodeUnknown(ListOrganizationMembersParamsSchema);
 var parseListPersonOrganizationsParams = Schema_exports.decodeUnknown(ListPersonOrganizationsParamsSchema);
@@ -169739,6 +169963,7 @@ var GetOrganizationResultSchema = Schema_exports.Struct({
   name: NonEmptyString2,
   city: Schema_exports.optional(Schema_exports.String),
   description: Schema_exports.optional(Schema_exports.String),
+  channels: Schema_exports.optional(Schema_exports.Array(ContactChannelSummarySchema)),
   members: Count,
   url: UrlString,
   modifiedOn: Schema_exports.optional(Schema_exports.Number)
@@ -174278,7 +174503,7 @@ var parseDeleteDriveFileCommentParams = Schema_exports.decodeUnknown(DeleteDrive
 var parseListDriveFileActivityParams = Schema_exports.decodeUnknown(ListDriveFileActivityParamsSchema);
 
 // src/version.ts
-var VERSION = true ? "0.29.0" : "0.0.0-dev";
+var VERSION = true ? "0.30.0" : "0.0.0-dev";
 
 // src/mcp/tool-output-schema.ts
 var defaultToolOutputSchema = {
@@ -180065,6 +180290,321 @@ var commentTools = [
   }
 ];
 
+// src/huly/operations/contact-channel-providers.ts
+var CONTACT_CHANNEL_PROVIDER_SDK_KEYS = ContactChannelProviderSdkKeys;
+var exactChannelProviderSdkKeys = (value3) => value3;
+exactChannelProviderSdkKeys(true);
+var sdkKeyEntryForProvider = (provider) => [
+  CONTACT_CHANNEL_PROVIDER_SDK_KEYS[provider],
+  provider
+];
+var CONTACT_CHANNEL_PROVIDER_BY_SDK_KEY = Object.fromEntries(
+  ContactChannelProviderValues.map(sdkKeyEntryForProvider)
+);
+var listContactChannelProviderLabels = () => ContactChannelProviderValues;
+var toContactChannelProviderRef = (provider) => contact.channelProvider[CONTACT_CHANNEL_PROVIDER_SDK_KEYS[provider]];
+var fromContactChannelProviderRef = (providerRef) => {
+  const provider = ContactChannelProviderValues.find(
+    (candidate) => toContactChannelProviderRef(candidate) === providerRef
+  );
+  return provider ?? new InvalidContactProviderError({ provider: providerRef });
+};
+
+// src/huly/operations/contact-channel-mappers.ts
+var channelSummary = (channel) => Effect_exports.gen(function* () {
+  const provider = fromContactChannelProviderRef(channel.provider);
+  if (provider instanceof InvalidContactProviderError) {
+    return yield* provider;
+  }
+  return {
+    channelId: ChannelId.make(channel._id),
+    provider,
+    value: channel.value,
+    items: channel.items !== void 0 ? Count.make(channel.items) : void 0,
+    lastMessage: channel.lastMessage !== void 0 ? Timestamp.make(channel.lastMessage) : void 0
+  };
+});
+var channelSummaryWithValue = (channel, provider, value3) => ({
+  channelId: ChannelId.make(channel._id),
+  provider,
+  value: value3,
+  items: channel.items !== void 0 ? Count.make(channel.items) : void 0,
+  lastMessage: channel.lastMessage !== void 0 ? Timestamp.make(channel.lastMessage) : void 0
+});
+
+// src/huly/operations/organization-resolvers.ts
+var findOrganizationByIdentifier = (client, identifier2) => Effect_exports.gen(function* () {
+  const byId = Option_exports.fromNullable(
+    yield* client.findOne(
+      contact.class.Organization,
+      hulyQuery({ _id: toRef(identifier2) })
+    )
+  );
+  if (Option_exports.isSome(byId)) return byId;
+  const byName = yield* client.findAll(
+    contact.class.Organization,
+    hulyQuery({ name: identifier2 })
+  );
+  if (byName.length === 0) return Option_exports.none();
+  if (byName.length > 1) {
+    return yield* new OrganizationIdentifierAmbiguousError({
+      identifier: identifier2,
+      matches: Count.make(byName.length)
+    });
+  }
+  return Option_exports.some(byName[0]);
+});
+var resolveOrganizationByIdentifier = (client, identifier2) => Effect_exports.flatMap(findOrganizationByIdentifier(client, identifier2), (organization) => Option_exports.match(organization, {
+  onNone: () => Effect_exports.fail(new OrganizationNotFoundError({ identifier: identifier2 })),
+  onSome: Effect_exports.succeed
+}));
+
+// src/huly/operations/contact-channel-owners.ts
+var resolvePerson = (client, identifier2) => Effect_exports.gen(function* () {
+  const byId = Option_exports.fromNullable(yield* findPersonById(client, identifier2));
+  return yield* Option_exports.match(byId, {
+    onNone: () => Effect_exports.flatMap(
+      Effect_exports.map(
+        findPersonByExactEmailOrName(
+          client,
+          Schema_exports.is(Email)(identifier2) ? identifier2 : PersonName.make(identifier2)
+        ),
+        Option_exports.fromNullable
+      ),
+      (byEmailOrName) => Option_exports.match(byEmailOrName, {
+        onNone: () => Effect_exports.fail(new PersonNotFoundError({ identifier: identifier2 })),
+        onSome: Effect_exports.succeed
+      })
+    ),
+    onSome: Effect_exports.succeed
+  });
+});
+var resolvePersonOwner = (client, identifier2) => Effect_exports.map(resolvePerson(client, identifier2), (person) => ({
+  id: person._id,
+  ownerClass: contact.class.Person,
+  identifier: identifier2
+}));
+var resolveOrganizationOwner = (client, identifier2) => Effect_exports.gen(function* () {
+  const org = yield* resolveOrganizationByIdentifier(client, identifier2);
+  return { id: org._id, ownerClass: contact.class.Organization, identifier: identifier2 };
+});
+
+// src/huly/operations/contact-channels.ts
+var listContactChannelProviders = () => Effect_exports.succeed(listContactChannelProviderLabels());
+var channelIdentifier = (locator) => locator._tag === "channelId" ? locator.channelId : `${locator.provider}:${locator.value}`;
+var INVALID_CHANNEL_LOCATOR_REASON = "provide exactly one channel locator: channelId, or provider plus value";
+var validateProviderValue = (provider, value3) => value3.length === 0 || provider === "email" && !Schema_exports.is(Email)(value3) ? Effect_exports.fail(new InvalidContactChannelValueError({ provider, value: value3 })) : Effect_exports.void;
+var validateChannelLocator2 = (ownerIdentifier, locator) => Effect_exports.gen(function* () {
+  const hasChannelId = locator.channelId !== void 0;
+  const hasProvider = locator.provider !== void 0;
+  const hasValue = locator.value !== void 0;
+  if (hasChannelId && !hasProvider && !hasValue) {
+    return { _tag: "channelId", channelId: ChannelId.make(locator.channelId) };
+  }
+  if (!hasChannelId && hasProvider && hasValue) {
+    yield* validateProviderValue(locator.provider, locator.value);
+    return { _tag: "providerValue", provider: locator.provider, value: locator.value };
+  }
+  return yield* new InvalidContactChannelLocatorError({
+    ownerIdentifier,
+    reason: INVALID_CHANNEL_LOCATOR_REASON
+  });
+});
+var requireChannelUpdateFields = (params) => params.newProvider === void 0 && params.newValue === void 0 ? Effect_exports.fail(new NoUpdateFieldsError({ operation: "update_contact_channel", fields: ["newProvider", "newValue"] })) : Effect_exports.void;
+var findChannelsForOwner = (client, owner) => client.findAll(
+  contact.class.Channel,
+  hulyQuery({
+    attachedTo: owner.id,
+    attachedToClass: owner.ownerClass
+  })
+);
+var findExactChannels = (client, owner, provider, value3) => client.findAll(
+  contact.class.Channel,
+  hulyQuery({
+    attachedTo: owner.id,
+    attachedToClass: owner.ownerClass,
+    provider: toContactChannelProviderRef(provider),
+    value: value3
+  })
+);
+var findChannelByIdForOwner = (client, owner, channelId) => Effect_exports.map(
+  client.findOne(
+    contact.class.Channel,
+    hulyQuery({
+      _id: toRef(channelId),
+      attachedTo: owner.id,
+      attachedToClass: owner.ownerClass
+    })
+  ),
+  Option_exports.fromNullable
+);
+var resolveChannelByLocator = (client, owner, locator) => Effect_exports.gen(function* () {
+  if (locator._tag === "channelId") {
+    return yield* Effect_exports.flatMap(findChannelByIdForOwner(client, owner, locator.channelId), (channel) => Option_exports.match(channel, {
+      onNone: () => Effect_exports.fail(
+        new ContactChannelNotFoundError({
+          ownerIdentifier: owner.identifier,
+          channelIdentifier: locator.channelId
+        })
+      ),
+      onSome: Effect_exports.succeed
+    }));
+  }
+  const matches = yield* findExactChannels(client, owner, locator.provider, locator.value);
+  if (matches.length === 0) {
+    return yield* new ContactChannelNotFoundError({
+      ownerIdentifier: owner.identifier,
+      channelIdentifier: channelIdentifier(locator)
+    });
+  }
+  if (matches.length > 1) {
+    return yield* new ContactChannelIdentifierAmbiguousError({
+      ownerIdentifier: owner.identifier,
+      channelIdentifier: channelIdentifier(locator),
+      matches: Count.make(matches.length)
+    });
+  }
+  return matches[0];
+});
+var findRemovableChannel = (client, owner, locator) => Effect_exports.gen(function* () {
+  if (locator._tag === "channelId") {
+    return yield* findChannelByIdForOwner(client, owner, locator.channelId);
+  }
+  const matches = yield* findExactChannels(client, owner, locator.provider, locator.value);
+  if (matches.length > 1) {
+    return yield* new ContactChannelIdentifierAmbiguousError({
+      ownerIdentifier: owner.identifier,
+      channelIdentifier: channelIdentifier(locator),
+      matches: Count.make(matches.length)
+    });
+  }
+  return Option_exports.fromNullable(matches[0]);
+});
+var ensureNoTargetConflict = (client, owner, currentChannelId, provider, value3) => Effect_exports.gen(function* () {
+  const matches = yield* findExactChannels(client, owner, provider, value3);
+  const conflicting = matches.some((channel) => channel._id !== currentChannelId);
+  if (conflicting) {
+    return yield* new ContactChannelConflictError({
+      ownerIdentifier: owner.identifier,
+      provider,
+      value: value3
+    });
+  }
+});
+var listOwnerChannels = (client, owner) => Effect_exports.gen(function* () {
+  const channels = yield* findChannelsForOwner(client, owner);
+  return yield* Effect_exports.all(channels.map(channelSummary));
+});
+var addOwnerChannel = (client, owner, params) => Effect_exports.gen(function* () {
+  yield* validateProviderValue(params.provider, params.value);
+  const existing = yield* findExactChannels(client, owner, params.provider, params.value);
+  if (existing.length > 0) {
+    return { added: false, channel: yield* channelSummary(existing[0]) };
+  }
+  const channelId = yield* client.addCollection(
+    contact.class.Channel,
+    contact.space.Contacts,
+    owner.id,
+    owner.ownerClass,
+    "channels",
+    { provider: toContactChannelProviderRef(params.provider), value: params.value }
+  );
+  return {
+    added: true,
+    channel: {
+      channelId: ChannelId.make(channelId),
+      provider: params.provider,
+      value: params.value
+    }
+  };
+});
+var updateOwnerChannel = (client, owner, params) => Effect_exports.gen(function* () {
+  yield* requireChannelUpdateFields(params);
+  const locator = yield* validateChannelLocator2(owner.identifier, params);
+  const channel = yield* resolveChannelByLocator(client, owner, locator);
+  const currentProvider = fromContactChannelProviderRef(channel.provider);
+  if (currentProvider instanceof InvalidContactProviderError) {
+    return yield* currentProvider;
+  }
+  const nextProvider = params.newProvider ?? currentProvider;
+  const nextValue = params.newValue ?? channel.value;
+  yield* validateProviderValue(nextProvider, nextValue);
+  const nextProviderRef = toContactChannelProviderRef(nextProvider);
+  if (channel.provider === nextProviderRef && channel.value === nextValue) {
+    return { updated: false, channel: yield* channelSummary(channel) };
+  }
+  yield* ensureNoTargetConflict(client, owner, channel._id, nextProvider, nextValue);
+  const operations = {
+    provider: nextProviderRef,
+    value: nextValue
+  };
+  yield* client.updateDoc(contact.class.Channel, contact.space.Contacts, channel._id, operations);
+  return { updated: true, channel: channelSummaryWithValue(channel, nextProvider, nextValue) };
+});
+var removeOwnerChannel = (client, owner, params) => Effect_exports.gen(function* () {
+  const locator = yield* validateChannelLocator2(owner.identifier, params);
+  const channel = yield* findRemovableChannel(client, owner, locator);
+  if (Option_exports.isNone(channel)) {
+    return locator._tag === "channelId" ? { removed: false, channelId: locator.channelId } : { removed: false };
+  }
+  yield* client.removeDoc(contact.class.Channel, contact.space.Contacts, channel.value._id);
+  return { removed: true, channelId: ChannelId.make(channel.value._id) };
+});
+var listPersonChannels = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolvePersonOwner(client, params.person);
+  return {
+    personId: PersonId.make(owner.id),
+    channels: yield* listOwnerChannels(client, owner)
+  };
+});
+var addPersonChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolvePersonOwner(client, params.person);
+  const result = yield* addOwnerChannel(client, owner, params);
+  return { personId: PersonId.make(owner.id), ...result };
+});
+var updatePersonChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolvePersonOwner(client, params.person);
+  const result = yield* updateOwnerChannel(client, owner, params);
+  return { personId: PersonId.make(owner.id), ...result };
+});
+var removePersonChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolvePersonOwner(client, params.person);
+  const result = yield* removeOwnerChannel(client, owner, params);
+  const personId = PersonId.make(owner.id);
+  return "channelId" in result ? { personId, removed: result.removed, channelId: result.channelId } : { personId, removed: result.removed };
+});
+var listOrganizationChannels = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolveOrganizationOwner(client, params.organizationId);
+  return {
+    organizationId: OrganizationId.make(owner.id),
+    channels: yield* listOwnerChannels(client, owner)
+  };
+});
+var addOrganizationChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolveOrganizationOwner(client, params.organizationId);
+  const result = yield* addOwnerChannel(client, owner, params);
+  return { id: OrganizationId.make(owner.id), ...result };
+});
+var updateOrganizationChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolveOrganizationOwner(client, params.organizationId);
+  const result = yield* updateOwnerChannel(client, owner, params);
+  return { organizationId: OrganizationId.make(owner.id), ...result };
+});
+var removeOrganizationChannel = (params) => Effect_exports.gen(function* () {
+  const client = yield* HulyClient;
+  const owner = yield* resolveOrganizationOwner(client, params.organizationId);
+  const result = yield* removeOwnerChannel(client, owner, params);
+  const organizationId = OrganizationId.make(owner.id);
+  return "channelId" in result ? { organizationId, removed: result.removed, channelId: result.channelId } : { organizationId, removed: result.removed };
+});
+
 // src/huly/operations/organizations.ts
 var import_contact = __toESM(require_lib28(), 1);
 var import_core34 = __toESM(require_lib4(), 1);
@@ -180082,81 +180622,19 @@ var leadClassIds = {
   }
 };
 
-// src/huly/operations/organization-channel-providers.ts
-var CHANNEL_PROVIDER_REFS_BY_SDK_KEY = {
-  Email: contact.channelProvider.Email,
-  Phone: contact.channelProvider.Phone,
-  LinkedIn: contact.channelProvider.LinkedIn,
-  Twitter: contact.channelProvider.Twitter,
-  Telegram: contact.channelProvider.Telegram,
-  GitHub: contact.channelProvider.GitHub,
-  Facebook: contact.channelProvider.Facebook,
-  Homepage: contact.channelProvider.Homepage,
-  Whatsapp: contact.channelProvider.Whatsapp,
-  Skype: contact.channelProvider.Skype,
-  Profile: contact.channelProvider.Profile,
-  Viber: contact.channelProvider.Viber
-};
-var ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY = {
-  Email: "email",
-  Phone: "phone",
-  LinkedIn: "linkedin",
-  Twitter: "twitter",
-  Telegram: "telegram",
-  GitHub: "github",
-  Facebook: "facebook",
-  Homepage: "homepage",
-  Whatsapp: "whatsapp",
-  Skype: "skype",
-  Profile: "profile",
-  Viber: "viber"
-};
-var CHANNEL_PROVIDERS = {
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Email]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Email,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Phone]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Phone,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.LinkedIn]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.LinkedIn,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Twitter]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Twitter,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Telegram]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Telegram,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.GitHub]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.GitHub,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Facebook]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Facebook,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Homepage]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Homepage,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Whatsapp]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Whatsapp,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Skype]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Skype,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Profile]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Profile,
-  [ORGANIZATION_CHANNEL_PROVIDER_BY_SDK_KEY.Viber]: CHANNEL_PROVIDER_REFS_BY_SDK_KEY.Viber
-};
-var exactChannelProviderMapping = (value3) => value3;
-exactChannelProviderMapping(true);
-var toChannelProviderRef = (provider) => CHANNEL_PROVIDERS[provider];
-
 // src/huly/operations/organizations.ts
-var findOrganizationByIdentifier = (client, identifier2) => Effect_exports.gen(function* () {
-  const byId = yield* client.findOne(
-    contact.class.Organization,
-    { _id: toRef(identifier2) }
-  );
-  if (byId !== void 0) return byId;
-  const byName = yield* client.findAll(
-    contact.class.Organization,
-    { name: identifier2 }
-  );
-  if (byName.length === 0) {
-    return void 0;
-  }
-  if (byName.length > 1) {
-    return yield* new OrganizationIdentifierAmbiguousError({
-      identifier: identifier2,
-      matches: Count.make(byName.length)
-    });
-  }
-  return byName[0];
-});
 var resolvePersonIdentifier = (client, identifier2) => Effect_exports.gen(function* () {
-  const person = (yield* findPersonById(client, identifier2)) ?? (yield* findPersonByEmail(client, identifier2));
-  if (person === void 0) {
-    return yield* new PersonNotFoundError({ identifier: identifier2 });
-  }
-  return person;
+  const byId = Option_exports.fromNullable(yield* findPersonById(client, identifier2));
+  return yield* Option_exports.match(byId, {
+    onNone: () => Effect_exports.flatMap(
+      Effect_exports.map(findPersonByEmail(client, identifier2), Option_exports.fromNullable),
+      (byEmail) => Option_exports.match(byEmail, {
+        onNone: () => Effect_exports.fail(new PersonNotFoundError({ identifier: identifier2 })),
+        onSome: Effect_exports.succeed
+      })
+    ),
+    onSome: Effect_exports.succeed
+  });
 });
 var resolvePersonIdentifiers = (client, identifiers) => Effect_exports.gen(function* () {
   const resolvedPeople = [];
@@ -180225,10 +180703,7 @@ var createOrganization = (params) => Effect_exports.gen(function* () {
 });
 var getOrganization = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.identifier);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.identifier });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.identifier);
   const descriptionText = org.description !== null ? yield* client.fetchMarkup(
     contact.class.Organization,
     org._id,
@@ -180237,11 +180712,13 @@ var getOrganization = (params) => Effect_exports.gen(function* () {
     "markdown"
   ) : void 0;
   const id = OrganizationId.make(org._id);
+  const channelsResult = yield* listOrganizationChannels({ organizationId: org._id });
   return {
     id,
     name: org.name,
     city: org.city || void 0,
     description: descriptionText,
+    channels: channelsResult.channels,
     members: Count.make(org.members),
     url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: org.modifiedOn
@@ -180250,10 +180727,7 @@ var getOrganization = (params) => Effect_exports.gen(function* () {
 var updateOrganization = (params) => Effect_exports.gen(function* () {
   yield* requireUpdateFields("update_organization", params, UPDATE_ORGANIZATION_FIELDS);
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.identifier);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.identifier });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.identifier);
   const updateEntries = {
     name: Effect_exports.succeed(params.name === void 0 ? {} : { name: params.name }),
     city: Effect_exports.succeed(params.city === void 0 ? {} : { city: params.city === null ? "" : params.city }),
@@ -180292,10 +180766,7 @@ var updateOrganization = (params) => Effect_exports.gen(function* () {
 });
 var deleteOrganization = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.identifier);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.identifier });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.identifier);
   yield* client.removeDoc(
     contact.class.Organization,
     contact.space.Contacts,
@@ -180305,10 +180776,7 @@ var deleteOrganization = (params) => Effect_exports.gen(function* () {
 });
 var makeOrganizationCustomer = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.identifier);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.identifier });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.identifier);
   const alreadyCustomer = org[leadClassIds.mixin.Customer] !== void 0;
   if (alreadyCustomer) {
     return { id: OrganizationId.make(org._id), applied: false };
@@ -180322,29 +180790,9 @@ var makeOrganizationCustomer = (params) => Effect_exports.gen(function* () {
   );
   return { id: OrganizationId.make(org._id), applied: true };
 });
-var addOrganizationChannel = (params) => Effect_exports.gen(function* () {
-  const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.organizationId);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.organizationId });
-  }
-  const providerRef = toChannelProviderRef(params.provider);
-  yield* client.addCollection(
-    contact.class.Channel,
-    contact.space.Contacts,
-    org._id,
-    contact.class.Organization,
-    "channels",
-    { provider: providerRef, value: params.value }
-  );
-  return { id: OrganizationId.make(org._id), added: true };
-});
 var addOrganizationMember = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.organizationId);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.organizationId });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.organizationId);
   const person = yield* resolvePersonIdentifier(client, params.personIdentifier);
   const existingMemberships = yield* findOrganizationMemberships(client, org._id, person._id);
   if (existingMemberships.length > 0) {
@@ -180362,10 +180810,7 @@ var addOrganizationMember = (params) => Effect_exports.gen(function* () {
 });
 var listOrganizationMembers = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.organizationId);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.organizationId });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.organizationId);
   const members = yield* client.findAll(
     contact.class.Member,
     { attachedTo: org._id }
@@ -180381,11 +180826,14 @@ var listOrganizationMembers = (params) => Effect_exports.gen(function* () {
   const emails = yield* batchGetEmailsForPersons(client, personIds);
   const entries2 = persons.map((p) => {
     const email3 = emails.get(p._id);
-    return {
+    const entry = {
       personId: PersonId.make(p._id),
-      name: PersonName.make(p.name),
-      email: email3 !== void 0 ? Email.make(email3) : void 0
+      name: PersonName.make(p.name)
     };
+    return Option_exports.match(Option_exports.map(Option_exports.fromNullable(email3), Email.make), {
+      onNone: () => entry,
+      onSome: (memberEmail) => ({ ...entry, email: memberEmail })
+    });
   });
   return {
     organizationId: OrganizationId.make(org._id),
@@ -180394,10 +180842,7 @@ var listOrganizationMembers = (params) => Effect_exports.gen(function* () {
 });
 var removeOrganizationMember = (params) => Effect_exports.gen(function* () {
   const client = yield* HulyClient;
-  const org = yield* findOrganizationByIdentifier(client, params.organizationId);
-  if (org === void 0) {
-    return yield* new OrganizationNotFoundError({ identifier: params.organizationId });
-  }
+  const org = yield* resolveOrganizationByIdentifier(client, params.organizationId);
   const person = yield* resolvePersonIdentifier(client, params.personIdentifier);
   const memberDocs = yield* findOrganizationMemberships(client, org._id, person._id);
   if (memberDocs.length === 0) {
@@ -180501,16 +180946,10 @@ var getPerson = (params) => Effect_exports.gen(function* () {
     const identifier2 = "personId" in params ? params.personId : params.email;
     return yield* new PersonNotFoundError({ identifier: identifier2 });
   }
-  const channels = yield* client.findAll(
-    contact.class.Channel,
-    {
-      attachedTo: person._id,
-      attachedToClass: contact.class.Person
-    }
-  );
+  const channelsResult = yield* listPersonChannels({ person: person._id });
   const organizations = yield* findOrganizationsForPerson(client, person._id);
   const { firstName, lastName } = parseName(person.name);
-  const emailChannel = channels.find((c) => c.provider === contact.channelProvider.Email);
+  const emailChannel = channelsResult.channels.find((c) => c.provider === "email");
   const id = PersonId.make(person._id);
   return {
     id,
@@ -180519,10 +180958,7 @@ var getPerson = (params) => Effect_exports.gen(function* () {
     lastName,
     city: person.city,
     email: emailChannel?.value !== void 0 ? Email.make(emailChannel.value) : void 0,
-    channels: channels.map((c) => ({
-      provider: ContactProvider.make(c.provider),
-      value: c.value
-    })),
+    channels: channelsResult.channels,
     organizations: organizations.length > 0 ? organizations : void 0,
     url: buildContactUrlFromConfig(client.workbenchUrlConfig, id),
     modifiedOn: person.modifiedOn,
@@ -180713,6 +181149,61 @@ var contactTools = [
       listEmployees
     )
   },
+  {
+    name: "list_contact_channel_providers",
+    description: "List supported contact channel provider labels for person and organization channel tools.",
+    category: CATEGORY9,
+    inputSchema: listContactChannelProvidersParamsJsonSchema,
+    handler: createToolHandler(
+      "list_contact_channel_providers",
+      parseListContactChannelProvidersParams,
+      listContactChannelProviders
+    )
+  },
+  {
+    name: "list_person_channels",
+    description: "List contact channels for a person. Person accepts person ID, exact email address, or exact Huly display name; ambiguous names fail and should be retried with email or person ID.",
+    category: CATEGORY9,
+    inputSchema: listPersonChannelsParamsJsonSchema,
+    handler: createToolHandler(
+      "list_person_channels",
+      parseListPersonChannelsParams,
+      listPersonChannels
+    )
+  },
+  {
+    name: "add_person_channel",
+    description: "Idempotently add a contact channel to a person. Person accepts person ID, exact email address, or exact Huly display name. Provider labels match list_contact_channel_providers. Returns added=false and the existing channel when the exact provider+value already exists.",
+    category: CATEGORY9,
+    inputSchema: addPersonChannelParamsJsonSchema,
+    handler: createToolHandler(
+      "add_person_channel",
+      parseAddPersonChannelParams,
+      addPersonChannel
+    )
+  },
+  {
+    name: "update_person_channel",
+    description: "Update one contact channel on a person. Person accepts person ID, exact email, or exact display name. Identify the channel with exactly one locator: channelId, or provider plus value. Provide newProvider, newValue, or both. Updating to an existing provider+value on the same person fails with a conflict.",
+    category: CATEGORY9,
+    inputSchema: updatePersonChannelParamsJsonSchema,
+    handler: createToolHandler(
+      "update_person_channel",
+      parseUpdatePersonChannelParams,
+      updatePersonChannel
+    )
+  },
+  {
+    name: "remove_person_channel",
+    description: "Remove one contact channel from a person. Person accepts person ID, exact email, or exact display name. Identify the channel with exactly one locator: channelId, or provider plus value. Returns removed=false when the locator is absent for that person.",
+    category: CATEGORY9,
+    inputSchema: removePersonChannelParamsJsonSchema,
+    handler: createToolHandler(
+      "remove_person_channel",
+      parseRemovePersonChannelParams,
+      removePersonChannel
+    )
+  },
   {
     name: "list_organizations",
     description: "List all organizations in the Huly workspace. Returns organizations sorted by modification date (newest first).",
@@ -180781,7 +181272,7 @@ var contactTools = [
   },
   {
     name: "add_organization_channel",
-    description: "Add a contact channel (phone, email, website/homepage, LinkedIn, Twitter, GitHub, Facebook, Telegram) to an organization identified by ID or exact unique name. Provider names: email, phone, linkedin, twitter, github, facebook, telegram, homepage.",
+    description: "Idempotently add a contact channel to an organization identified by ID or exact unique name. Provider labels: email, phone, linkedin, twitter, github, facebook, telegram, homepage, whatsapp, skype, profile, viber. Returns added=false and the existing channel when the exact provider+value already exists.",
     category: CATEGORY9,
     inputSchema: addOrganizationChannelParamsJsonSchema,
     handler: createToolHandler(
@@ -180790,6 +181281,39 @@ var contactTools = [
       addOrganizationChannel
     )
   },
+  {
+    name: "list_organization_channels",
+    description: "List contact channels for an organization identified by ID or exact unique organization name. Returns channelId, provider label, value, and optional activity metadata.",
+    category: CATEGORY9,
+    inputSchema: listOrganizationChannelsParamsJsonSchema,
+    handler: createToolHandler(
+      "list_organization_channels",
+      parseListOrganizationChannelsParams,
+      listOrganizationChannels
+    )
+  },
+  {
+    name: "update_organization_channel",
+    description: "Update one contact channel on an organization identified by ID or exact unique name. Identify the channel with exactly one locator: channelId, or provider plus value. Provide newProvider, newValue, or both. Updating to an existing provider+value on the same organization fails with a conflict.",
+    category: CATEGORY9,
+    inputSchema: updateOrganizationChannelParamsJsonSchema,
+    handler: createToolHandler(
+      "update_organization_channel",
+      parseUpdateOrganizationChannelParams,
+      updateOrganizationChannel
+    )
+  },
+  {
+    name: "remove_organization_channel",
+    description: "Remove one contact channel from an organization identified by ID or exact unique name. Identify the channel with exactly one locator: channelId, or provider plus value. Returns removed=false when the locator is absent for that organization.",
+    category: CATEGORY9,
+    inputSchema: removeOrganizationChannelParamsJsonSchema,
+    handler: createToolHandler(
+      "remove_organization_channel",
+      parseRemoveOrganizationChannelParams,
+      removeOrganizationChannel
+    )
+  },
   {
     name: "add_organization_member",
     description: "Link a person as a member of an organization. The person appears under the org's Members tab in Huly. Use person ID or email to identify the person. Idempotent: returns added=false if that person is already a member.",

package/package.json

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