@aifabrix/builder 2.53.0 → 2.54.1

package/lib/channels/vendor-dataplane-url.js

@@ -0,0 +1,249 @@
+/**
+ * Vendor-facing dataplane and controller bases for channel webhooks and packages.
+ *
+ * @fileoverview Keep DATAPLANE_URL / MISO_CONTROLLER_URL internal for API calls
+ */
+
+'use strict';
+
+/**
+ * @param {unknown} value
+ * @returns {string}
+ */
+function trimBase(value) {
+  return String(value || '').trim().replace(/\/$/, '');
+}
+
+/**
+ * @param {string} host
+ * @returns {boolean}
+ */
+function isLoopbackHost(host) {
+  const hostname = String(host || '').toLowerCase();
+  return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1';
+}
+
+/**
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+function isPublicHttpsUrl(value) {
+  const raw = trimBase(value);
+  if (!raw) {
+    return false;
+  }
+  try {
+    const parsed = new URL(raw);
+    if (parsed.protocol !== 'https:') {
+      return false;
+    }
+    const host = parsed.hostname.toLowerCase();
+    return Boolean(host) && !isLoopbackHost(host) && host.includes('.');
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * @param {string} internalUrl
+ * @returns {string}
+ */
+function pathVdir(internalUrl) {
+  try {
+    const pathName = new URL(internalUrl).pathname.replace(/\/$/, '');
+    return pathName && pathName !== '/' ? pathName : '';
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * @param {string} origin
+ * @param {string} vdir
+ * @returns {string}
+ */
+function joinOriginAndVdir(origin, vdir) {
+  const base = trimBase(origin);
+  if (!base) {
+    return '';
+  }
+  if (!vdir) {
+    return base;
+  }
+  if (base.endsWith(vdir)) {
+    return base;
+  }
+  return `${base}${vdir.startsWith('/') ? vdir : `/${vdir}`}`;
+}
+
+/**
+ * Browser Origin / Referer that vendors can reach (portal host, not builder-api).
+ * @param {import('http').IncomingMessage|null|undefined} req
+ * @returns {string}
+ */
+function publicOriginFromRequest(req) {
+  const headers = (req && req.headers) || {};
+  const origin = trimBase(headers.origin);
+  if (isPublicHttpsUrl(origin)) {
+    return new URL(origin).origin;
+  }
+  try {
+    const referer = new URL(String(headers.referer || ''));
+    if (isPublicHttpsUrl(referer.origin)) {
+      return referer.origin;
+    }
+  } catch {
+    // ignore invalid Referer
+  }
+  return '';
+}
+
+/**
+ * @param {NodeJS.ProcessEnv} [env]
+ * @returns {string}
+ */
+function publicOriginFromAllowlist(env = process.env) {
+  for (const raw of String(env.ALLOWED_ORIGINS || '').split(',')) {
+    const candidate = trimBase(raw);
+    if (!candidate || candidate.includes('*')) {
+      continue;
+    }
+    try {
+      const parsed = new URL(candidate);
+      if (parsed.port && parsed.port !== '443') {
+        continue;
+      }
+      if (isPublicHttpsUrl(candidate)) {
+        return parsed.origin;
+      }
+    } catch {
+      // skip malformed allowlist entries
+    }
+  }
+  return '';
+}
+
+/**
+ * @param {string} [controllerUrl]
+ * @returns {string}
+ */
+function publicOriginFromController(controllerUrl) {
+  const raw = trimBase(controllerUrl);
+  if (!isPublicHttpsUrl(raw)) {
+    return '';
+  }
+  try {
+    return new URL(raw).origin;
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * @param {string} [internalUrl]
+ * @param {string} envKey
+ * @param {NodeJS.ProcessEnv} env
+ * @param {{ publicOrigin?: string, siblingPublicUrl?: string, defaultVdir?: string }} extras
+ * @returns {string}
+ */
+function resolveVendorFacingBase(internalUrl, envKey, env, extras = {}) {
+  const internal = trimBase(internalUrl);
+  if (isPublicHttpsUrl(internal)) {
+    return internal;
+  }
+  const envUrl = trimBase(env[envKey]);
+  if (isPublicHttpsUrl(envUrl)) {
+    return envUrl;
+  }
+  const vdir = pathVdir(internal) || extras.defaultVdir || '';
+  const fromOrigin = joinOriginAndVdir(extras.publicOrigin, vdir);
+  if (isPublicHttpsUrl(fromOrigin)) {
+    return fromOrigin;
+  }
+  const fromAllow = joinOriginAndVdir(publicOriginFromAllowlist(env), vdir);
+  if (isPublicHttpsUrl(fromAllow)) {
+    return fromAllow;
+  }
+  const siblingOrigin = publicOriginFromController(extras.siblingPublicUrl);
+  const fromSibling = joinOriginAndVdir(siblingOrigin, vdir);
+  if (isPublicHttpsUrl(fromSibling)) {
+    return fromSibling;
+  }
+  return internal;
+}
+
+/**
+ * @param {NodeJS.ProcessEnv} env
+ * @param {string[]} keys
+ * @returns {string}
+ */
+function firstPublicEnvUrl(env, keys) {
+  for (const key of keys) {
+    const value = trimBase(env[key]);
+    if (isPublicHttpsUrl(value)) {
+      return value;
+    }
+  }
+  return '';
+}
+
+/**
+ * @param {string} [internalUrl]
+ * @param {{ publicOrigin?: string, env?: NodeJS.ProcessEnv, controllerUrl?: string }} [options]
+ * @returns {string}
+ */
+function resolveVendorFacingDataplaneUrl(internalUrl, options = {}) {
+  return resolveVendorFacingBase(internalUrl, 'DATAPLANE_PUBLIC_URL', options.env || process.env, {
+    publicOrigin: options.publicOrigin,
+    siblingPublicUrl: options.controllerUrl
+  });
+}
+
+/**
+ * @param {string} [internalUrl]
+ * @param {{ publicOrigin?: string, env?: NodeJS.ProcessEnv, dataplanePublicUrl?: string }} [options]
+ * @returns {string}
+ */
+function resolveVendorFacingControllerUrl(internalUrl, options = {}) {
+  const env = options.env || process.env;
+  const dedicated = firstPublicEnvUrl(env, [
+    'MISO_CONTROLLER_PUBLIC_URL',
+    'CONTROLLER_PUBLIC_URL'
+  ]);
+  if (dedicated) {
+    return dedicated;
+  }
+  return resolveVendorFacingBase(internalUrl, 'MISO_CONTROLLER_PUBLIC_URL', env, {
+    publicOrigin: options.publicOrigin,
+    siblingPublicUrl: options.dataplanePublicUrl
+  });
+}
+
+/**
+ * @param {Object|null|undefined} ctx
+ * @param {NodeJS.ProcessEnv} [env]
+ * @returns {{ dataplaneBaseUrl: string, controllerUrl: string }}
+ */
+function vendorFacingUrlsFromCtx(ctx, env) {
+  const options = {
+    publicOrigin: ctx && ctx.publicOrigin,
+    controllerUrl: ctx && ctx.controllerUrl,
+    env: env || process.env
+  };
+  const dataplaneBaseUrl = resolveVendorFacingDataplaneUrl(ctx && ctx.dataplaneUrl, options);
+  const controllerUrl = resolveVendorFacingControllerUrl(ctx && ctx.controllerUrl, {
+    publicOrigin: options.publicOrigin,
+    env: options.env,
+    dataplanePublicUrl: dataplaneBaseUrl
+  });
+  return { dataplaneBaseUrl, controllerUrl };
+}
+
+module.exports = {
+  isPublicHttpsUrl,
+  publicOriginFromRequest,
+  publicOriginFromAllowlist,
+  resolveVendorFacingDataplaneUrl,
+  resolveVendorFacingControllerUrl,
+  vendorFacingUrlsFromCtx
+};

package/lib/cli/setup-certification.help.js

@@ -78,6 +78,8 @@ Examples:
 
 Notes:
   - Expert path: pushes integration/<systemKey>/scenarios/*.yaml to the dataplane.
+  - Each file is stored on the datasource named by the filename (scenarios/<datasourceKey>.yaml).
+  - Search datasourceKeys in the YAML are what verification searches; they may differ for views (carrier storage datasource).
   - Packs must satisfy the 424.0 schema (spec.coverage, metadata.generationState). Use governance generate
     or verify-governance for dataplane-first packs.
 `;

package/lib/cli/setup-external-system-help.js

@@ -29,6 +29,7 @@ Notes:
   - --probe runs dataplane runtime checks after publish (slower).
   - --timeout sets publish budget in ms (HTTP client and dataplane); default 300000.
   - --env selects role-assistant.yaml section (dev|tst|pro) for digital workers; default dev.
+  - Role Assistant packages under role-assistant/ do not use application.yaml; upload applies settings and Evidence only.
   - test-e2e and test-integration publish local files first by default; use --no-publish on those commands to skip.
   - After dimension/FK edits on active datasources, use --force (or test-e2e / test-integration / datasource test-* with --sync --force).
   - For one datasource only: aifabrix datasource upload <datasourceKey>
@@ -45,6 +46,7 @@ Examples:
 
 Notes:
   - Requires login and a system that already exists on the dataplane.
+  - Omit --format to use the developer default from aifabrix dev set-format (else yaml).
   - Overwrite prompts apply when integration/<systemKey>/ already exists (--force for README).
 `;
 

package/lib/cli/setup-external-system.js

@@ -63,7 +63,7 @@ function setupDownloadCommand(program) {
   program.command('download <systemKey>')
     .description('Pull external system from dataplane into integration/<key>/')
     .addHelpText('after', DOWNLOAD_HELP_AFTER)
-    .option('--format <format>', 'Output format: json | yaml (default: yaml or config format)')
+    .option('--format <format>', 'Output format: json | yaml (default: aifabrix dev set-format, else yaml)')
     .option('--dry-run', 'Show what would be downloaded without actually downloading')
     .option('--force', 'Overwrite existing README.md without prompting')
     .option(

package/lib/commands/channel-add-help.js

@@ -0,0 +1,366 @@
+/**
+ * Target-scoped help for `aifabrix channel add`.
+ *
+ * `channel add -h` is the full catalog. `channel add chatgpt -h` lists ChatGPT
+ * flags and examples only (no Slack, Copilot, or MCP-client leftovers).
+ *
+ * @fileoverview Channel add help — catalog vs named-target options
+ */
+
+'use strict';
+
+const { Help } = require('commander');
+const {
+  formatSupportedChannelTargetsHelp,
+  isChannelTargetKey
+} = require('../channels/channel-targets');
+
+const SHARED_OPTION_LONG = new Set([
+  '--name',
+  '--description',
+  '--icon',
+  '--template',
+  '--dry-run',
+  '--force',
+  '--system-key',
+  '--probe',
+  '--verbose',
+  '--json',
+  '--help'
+]);
+
+const TARGET_OPTION_LONG = {
+  slack: new Set(['--command-prefix', '--onboard-users', '--no-onboard-users']),
+  'microsoft-copilot': new Set(['--oauth-plugin-vault-reference-id', '--package-version']),
+  chatgpt: new Set(['--callback-url']),
+  claude: new Set(['--callback-url']),
+  'mcp-client': new Set(['--target', '--profile']),
+  'teams-bot': new Set(),
+  'web-embed': new Set(['--allow-experimental'])
+};
+
+const VALUE_FLAGS = new Set([
+  '-n',
+  '--name',
+  '-d',
+  '--description',
+  '--icon',
+  '--template',
+  '--command-prefix',
+  '--oauth-plugin-vault-reference-id',
+  '--package-version',
+  '--callback-url',
+  '--target',
+  '--profile'
+]);
+
+const CHANNEL_ADD_HELP_AFTER = `
+${formatSupportedChannelTargetsHelp()}
+
+One command covers scaffold → upload → install:
+  $ aifabrix channel add slack --name "Elsa" --probe
+
+Examples:
+  $ aifabrix channel add
+  $ aifabrix channel add slack --name "Elsa"
+  $ aifabrix channel add teams-bot --name "Elsa" --description "Enterprise AI assistant for employees"
+  $ aifabrix channel add chatgpt --name "Your Assistant"
+  $ aifabrix channel add chatgpt --name "Your Assistant" \\
+      --callback-url "https://chatgpt.com/connector/oauth/callback"
+  $ aifabrix channel configure chatgpt --callback-url "https://chatgpt.com/connector/oauth/callback"
+  $ aifabrix channel add claude --name "Onni"
+  $ aifabrix channel configure claude --callback-url "https://claude.ai/api/mcp/auth_callback"
+  $ aifabrix channel add mcp-client --target cursor --name "Onni"
+  $ aifabrix channel add mcp-client --target vscode --name "Onni"
+  $ aifabrix channel add mcp-client --target github-copilot --name "Onni"
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+
+  # Slack slash-command prefix (registers /{prefix}-help in manifest)
+  $ aifabrix channel add slack --name "Elsa" --command-prefix af
+
+  # Generate artifacts only; no dataplane patch / upload
+  $ aifabrix channel add slack --name "Elsa" --dry-run
+
+  # Refresh local integration from the channel template, re-upload, regenerate config
+  $ aifabrix channel add slack --name "Elsa" --force
+
+  # Copilot: after MCP URL / Entra change — regenerate ZIP (bumps Teams version 1.0.0 → 1.1.0)
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" --force \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+
+  # Optional: pin Teams manifest version instead of auto minor bump
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" --force --package-version 1.2.0 \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+
+  # Validate callbacks and assistant catalog after install
+  $ aifabrix channel add slack --name "Elsa" --probe
+
+  # Slack onboard (email match) without a TTY prompt
+  $ aifabrix channel add slack --name "Elsa" --onboard-users
+  $ aifabrix channel add slack --name "Elsa" --no-onboard-users
+
+Behavior:
+  - Omit the target in a terminal to choose name and channel interactively
+  - --name is required when the target is specified (scripts and CI)
+  - -name is the same as --name; quoted names may contain spaces
+  - Scaffolds integration/<target>/ when missing, empty, or incomplete
+  - With --force, refreshes integration/<target>/ from the channel template, then uploads every time
+  - Uploads when the system is not on the dataplane
+  - Then configures the channel install (artifacts, credentials, admin guide)
+  - slack may ask **Onboard users?** and match Slack profile email to platform user email.
+    Non-interactive: --onboard-users or --no-onboard-users. Default is skip when not asked.
+  - chatgpt registers the ChatGPT callback URL when provided (--callback-url or TTY prompt).
+    It does not rotate the client secret. Remaining ChatGPT steps: Create with logo (cannot change later), Publish, Connect.
+  - claude registers the Claude callback URL (https://claude.ai/api/mcp/auth_callback) and prints
+    Name and Server URL. Open https://claude.ai/new#settings/customize-connectors and add a
+    custom connector with those two values. Use channel configure claude --callback-url only if
+    Claude shows a callback that is not already registered.
+  - mcp-client writes the Runtime MCP URL into the editor MCP config. Pass --target (or --profile)
+    with cursor, vscode, or github-copilot. It creates or reuses the Integration Client and never
+    rotates the client secret. Remaining step: Reload the editor.
+  - microsoft-copilot uses Entra SSO (trustedIssuer). Agents Toolkit (atk) creates or reuses
+    the Teams Entra SSO auth-config when you are signed in to the matching tenant. Pass
+    --oauth-plugin-vault-reference-id only when you already have the id or toolkit cannot
+    create it. Does not create Fabrix oauth2 channel credentials. Re-run with --force after
+    Runtime MCP URL or SSO changes; Teams manifest version auto-bumps minor (1.0.0 → 1.1.0)
+    unless --package-version is set. --force reuses the existing auth-config id.
+  - teams-bot uses Teams Developer CLI (teams app create --azure) around the existing
+    AI Fabrix messages URL. Azure subscription, resource group, and Entra tenant come
+    from the controller environment (same as Copilot Entra SSO). Remaining Microsoft
+    steps are tenant policy only. --force reuses the Azure-managed bot for this
+    environment and tenant.
+
+Requires: aifabrix login
+`;
+
+const SHARED_TARGET_BEHAVIOR = `Behavior:
+  - --name is required when the target is specified (scripts and CI)
+  - Quoted names may contain spaces
+  - Scaffolds integration/<target>/ when missing, empty, or incomplete
+  - With --force, refreshes integration/<target>/ from the channel template, then uploads every time
+  - Uploads when the system is not on the dataplane
+  - Then configures the channel install (artifacts, credentials, admin guide)`;
+
+const TARGET_HELP_AFTER = {
+  chatgpt: `
+Examples:
+  $ aifabrix channel add chatgpt --name "Your Assistant"
+  $ aifabrix channel add chatgpt --name "Your Assistant" \\
+      --callback-url "https://chatgpt.com/connector/oauth/callback"
+  $ aifabrix channel add chatgpt --name "Your Assistant" --force
+  $ aifabrix channel add chatgpt --name "Your Assistant" --probe
+  $ aifabrix channel configure chatgpt --callback-url "https://chatgpt.com/connector/oauth/callback"
+
+${SHARED_TARGET_BEHAVIOR}
+  - chatgpt registers the ChatGPT callback URL when provided (--callback-url or TTY prompt).
+    It does not rotate the client secret. Remaining ChatGPT steps: Create with logo (cannot change later), Publish, Connect.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  claude: `
+Examples:
+  $ aifabrix channel add claude --name "Onni"
+  $ aifabrix channel add claude --name "Onni" --force
+  $ aifabrix channel configure claude --callback-url "https://claude.ai/api/mcp/auth_callback"
+
+${SHARED_TARGET_BEHAVIOR}
+  - claude registers the Claude callback URL (https://claude.ai/api/mcp/auth_callback) and prints
+    Name and Server URL. Open https://claude.ai/new#settings/customize-connectors and add a
+    custom connector with those two values.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  slack: `
+Examples:
+  $ aifabrix channel add slack --name "Elsa"
+  $ aifabrix channel add slack --name "Elsa" --command-prefix af
+  $ aifabrix channel add slack --name "Elsa" --force --probe
+  $ aifabrix channel add slack --name "Elsa" --onboard-users
+  $ aifabrix channel add slack --name "Elsa" --no-onboard-users
+
+${SHARED_TARGET_BEHAVIOR}
+  - slack may ask **Onboard users?** and match Slack profile email to platform user email.
+    Non-interactive: --onboard-users or --no-onboard-users. Default is skip when not asked.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  'microsoft-copilot': `
+Examples:
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" --force \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+  $ aifabrix channel add microsoft-copilot --name "Your Assistant" --force --package-version 1.2.0 \\
+      --oauth-plugin-vault-reference-id "<Teams-Entra-SSO-auth-config-id>"
+
+${SHARED_TARGET_BEHAVIOR}
+  - microsoft-copilot uses Entra SSO (trustedIssuer). Pass --oauth-plugin-vault-reference-id
+    only when you already have the Teams Entra SSO auth-config id or toolkit cannot create it.
+    --force reuses the existing auth-config id. Teams manifest version auto-bumps minor
+    unless --package-version is set.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  'mcp-client': `
+Examples:
+  $ aifabrix channel add mcp-client --target cursor --name "Onni"
+  $ aifabrix channel add mcp-client --target vscode --name "Onni"
+  $ aifabrix channel add mcp-client --target github-copilot --name "Onni"
+
+${SHARED_TARGET_BEHAVIOR}
+  - mcp-client writes the Runtime MCP URL into the editor MCP config. Pass --target (or --profile)
+    with cursor, vscode, or github-copilot. Remaining step: Reload the editor.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  'teams-bot': `
+Examples:
+  $ aifabrix channel add teams-bot --name "Elsa" --description "Enterprise AI assistant for employees"
+  $ aifabrix channel add teams-bot --name "Elsa" --force
+
+${SHARED_TARGET_BEHAVIOR}
+  - teams-bot uses Teams Developer CLI (teams app create --azure) around the existing
+    AI Fabrix messages URL. Azure subscription, resource group, and Entra tenant come
+    from the controller environment. Remaining Microsoft steps are tenant policy only.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`,
+  'web-embed': `
+Examples:
+  $ aifabrix channel add web-embed --name "Onni" --allow-experimental
+
+${SHARED_TARGET_BEHAVIOR}
+  - web-embed is experimental. Pass --allow-experimental to install.
+
+Requires: aifabrix login
+
+See all channels:
+  $ aifabrix channel add -h
+`
+};
+
+/**
+ * Read the named channel target from `channel add` argv (help runs before parse).
+ * @param {string[]} [argv]
+ * @returns {string|null}
+ */
+function resolveChannelAddHelpTarget(argv = process.argv) {
+  const start = channelAddArgStart(argv);
+  for (let i = start; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--') {
+      break;
+    }
+    if (arg.startsWith('-')) {
+      i += skipOptionValue(arg, argv[i + 1]);
+      continue;
+    }
+    if (isChannelTargetKey(arg)) {
+      return arg;
+    }
+  }
+  return null;
+}
+
+/**
+ * @param {string[]} argv
+ * @returns {number}
+ */
+function channelAddArgStart(argv) {
+  for (let i = 1; i < argv.length; i += 1) {
+    if (argv[i] === 'add' && argv[i - 1] === 'channel') {
+      return i + 1;
+    }
+  }
+  return argv.length;
+}
+
+/**
+ * @param {string} arg
+ * @param {string|undefined} next
+ * @returns {number} extra indexes consumed
+ */
+function skipOptionValue(arg, next) {
+  const eq = arg.indexOf('=');
+  if (eq !== -1) {
+    return 0;
+  }
+  const flag = arg;
+  if (VALUE_FLAGS.has(flag) && next && !next.startsWith('-')) {
+    return 1;
+  }
+  return 0;
+}
+
+/**
+ * @param {import('commander').Option} option
+ * @param {string|null} target
+ * @returns {boolean}
+ */
+function isChannelAddOptionVisible(option, target) {
+  if (!target) {
+    return true;
+  }
+  const long = option.long;
+  if (!long || SHARED_OPTION_LONG.has(long)) {
+    return true;
+  }
+  const extra = TARGET_OPTION_LONG[target];
+  return Boolean(extra && extra.has(long));
+}
+
+/**
+ * @param {string|null} [target]
+ * @returns {string}
+ */
+function channelAddHelpAfter(target) {
+  if (target && TARGET_HELP_AFTER[target]) {
+    return TARGET_HELP_AFTER[target];
+  }
+  return CHANNEL_ADD_HELP_AFTER;
+}
+
+/**
+ * @param {import('commander').Command} cmd
+ * @returns {import('commander').Command}
+ */
+function configureChannelAddHelp(cmd) {
+  if (typeof cmd.configureHelp !== 'function') {
+    return cmd;
+  }
+  cmd.configureHelp({
+    visibleOptions(command) {
+      const listed = Help.prototype.visibleOptions.call(this, command);
+      const target = resolveChannelAddHelpTarget();
+      return listed.filter((option) => isChannelAddOptionVisible(option, target));
+    }
+  });
+  return cmd;
+}
+
+module.exports = {
+  CHANNEL_ADD_HELP_AFTER,
+  channelAddHelpAfter,
+  configureChannelAddHelp,
+  isChannelAddOptionVisible,
+  resolveChannelAddHelpTarget
+};