@aifabrix/builder 2.51.1 → 2.52.1

package/lib/integration-definition/system-kind-enum.js

@@ -0,0 +1,40 @@
+/**
+ * Enterprise systemKind enum shared with external-system.schema.json.
+ * @fileoverview Load allowed systemKind values for BID product rules
+ */
+
+'use strict';
+
+const externalSystemSchema = require('../schema/external-system.schema.json');
+
+/** @type {Set<string>|null} */
+let cachedKinds = null;
+
+/**
+ * @returns {Set<string>}
+ */
+function getAllowedSystemKinds() {
+  if (cachedKinds) {
+    return cachedKinds;
+  }
+  const values = externalSystemSchema?.properties?.systemKind?.enum;
+  cachedKinds = new Set(Array.isArray(values) ? values.map(String) : []);
+  return cachedKinds;
+}
+
+/**
+ * @param {string} kind
+ * @returns {boolean}
+ */
+function isAllowedSystemKind(kind) {
+  const normalized = String(kind || '').trim();
+  if (!normalized) {
+    return false;
+  }
+  return getAllowedSystemKinds().has(normalized);
+}
+
+module.exports = {
+  getAllowedSystemKinds,
+  isAllowedSystemKind
+};

package/lib/integration-definition/validate.js

@@ -0,0 +1,148 @@
+/**
+ * Validate Builder Integration Definition (BID) v1.0.0.
+ * @fileoverview AJV + hash + product rules for BID
+ */
+
+'use strict';
+
+const Ajv = require('ajv');
+const addFormats = require('ajv-formats');
+const schema = require('../schema/integration-definition.schema.json');
+const { computeDefinitionHash } = require('./hash');
+const { isActiveResourceTypeKey } = require('./resource-type-catalog');
+const { isAllowedSystemKind } = require('./system-kind-enum');
+
+const GOLD_PATH_RE = /test-e2e-hubspot|knownPlatform|builder-hp-goal/i;
+
+let cachedValidator = null;
+
+/**
+ * @returns {import('ajv').ValidateFunction}
+ */
+function getValidator() {
+  if (cachedValidator) {
+    return cachedValidator;
+  }
+  const ajv = new Ajv({ allErrors: true, strict: false });
+  addFormats(ajv);
+  cachedValidator = ajv.compile(schema);
+  return cachedValidator;
+}
+
+/**
+ * Reset validator cache (tests).
+ */
+function resetIntegrationDefinitionValidator() {
+  cachedValidator = null;
+}
+
+/**
+ * @param {Record<string, unknown>} doc
+ * @param {string[]} errors
+ * @returns {void}
+ */
+function appendAjvErrors(doc, errors) {
+  const validate = getValidator();
+  if (validate(doc)) {
+    return;
+  }
+  for (const err of validate.errors || []) {
+    errors.push(`${err.instancePath || '/'} ${err.message}`);
+  }
+}
+
+/**
+ * @param {Record<string, unknown>} doc
+ * @param {string[]} errors
+ * @returns {void}
+ */
+function appendIdentityAndHashErrors(doc, errors) {
+  if (doc.schemaVersion !== '1.0.0') {
+    errors.push(`Unsupported schemaVersion ${String(doc.schemaVersion)}; expected 1.0.0`);
+  }
+  const expectedHash = computeDefinitionHash(doc);
+  if (doc.definitionHash !== expectedHash) {
+    errors.push(`definitionHash mismatch: expected ${expectedHash}`);
+  }
+  const identity = /** @type {Record<string, unknown>} */ (doc.packageIdentity || {});
+  const system = /** @type {Record<string, unknown>} */ (doc.system || {});
+  if (identity.systemKey && system.key && identity.systemKey !== system.key) {
+    errors.push('packageIdentity.systemKey must match system.key');
+  }
+}
+
+/**
+ * @param {Record<string, unknown>} doc
+ * @param {string[]} errors
+ * @returns {void}
+ */
+function appendProductRuleErrors(doc, errors) {
+  const blob = JSON.stringify(doc);
+  if (GOLD_PATH_RE.test(blob)) {
+    errors.push(
+      'BID must not embed gold package paths or knownPlatform generation sources'
+    );
+  }
+  if (typeof doc.sync === 'object' && doc.sync && /** @type {any} */ (doc.sync).mode !== 'incremental') {
+    errors.push('sync.mode must be incremental');
+  }
+}
+
+/**
+ * @param {Record<string, unknown>} doc
+ * @param {string[]} errors
+ * @returns {void}
+ */
+function appendCatalogAndKindErrors(doc, errors) {
+  const system = /** @type {Record<string, unknown>} */ (doc.system || {});
+  if (system.systemKind !== undefined && system.systemKind !== null && system.systemKind !== '') {
+    if (!isAllowedSystemKind(String(system.systemKind))) {
+      errors.push(
+        `system.systemKind '${String(system.systemKind)}' is not an enterprise catalog value (see external-system.schema.json)`
+      );
+    }
+  }
+  const datasources = Array.isArray(doc.datasources) ? doc.datasources : [];
+  datasources.forEach((row, index) => {
+    if (!row || typeof row !== 'object') {
+      return;
+    }
+    const resourceType = /** @type {Record<string, unknown>} */ (row).resourceType;
+    if (resourceType === undefined || resourceType === null || resourceType === '') {
+      return;
+    }
+    const key = String(resourceType);
+    if (!isActiveResourceTypeKey(key)) {
+      errors.push(
+        `datasources[${index}].resourceType '${key}' is not an active catalog key (GET /help?topic=resourceTypeCatalog)`
+      );
+    }
+  });
+}
+
+/**
+ * @param {unknown} bid
+ * @returns {{ valid: true, bid: Record<string, unknown> } | { valid: false, errors: string[] }}
+ */
+function validateIntegrationDefinition(bid) {
+  const errors = [];
+  if (!bid || typeof bid !== 'object') {
+    return { valid: false, errors: ['BID must be an object'] };
+  }
+  const doc = /** @type {Record<string, unknown>} */ (bid);
+  appendAjvErrors(doc, errors);
+  appendIdentityAndHashErrors(doc, errors);
+  appendProductRuleErrors(doc, errors);
+  appendCatalogAndKindErrors(doc, errors);
+  if (errors.length) {
+    return { valid: false, errors };
+  }
+  return { valid: true, bid: doc };
+}
+
+module.exports = {
+  validateIntegrationDefinition,
+  resetIntegrationDefinitionValidator,
+  INTEGRATION_DEFINITION_SCHEMA_NAME: 'aifabrix.builder.integrationDefinition',
+  INTEGRATION_DEFINITION_SCHEMA_VERSION: '1.0.0'
+};

package/lib/programmatic/builder-api-request.js

@@ -19,7 +19,11 @@ const { withRequestTimeout } = require('./request-timeout');
  * @returns {boolean}
  */
 function requiresAuth(capability) {
-  return capability.handlerId !== 'health' && capability.handlerId !== 'ready';
+  return (
+    capability.handlerId !== 'health' &&
+    capability.handlerId !== 'ready' &&
+    capability.handlerId !== 'getBuilderHelp'
+  );
 }
 
 /**

package/lib/programmatic/builder-help-governance.js

@@ -8,7 +8,7 @@
 
 'use strict';
 
-const fs = require('fs');
+const fs = require('../internal/fs-real-sync');
 const path = require('path');
 const { buildHelpEnvelope } = require('./builder-help-envelope');
 const { listPlatformRoles } = require('./platform-rbac-catalog');
@@ -168,5 +168,6 @@ module.exports = {
   buildPlatformRolesTopic,
   buildResourceTypeCatalogTopic,
   buildDimensionsGuideTopic,
-  buildChannelOnboardingTopic
+  buildChannelOnboardingTopic,
+  loadResourceTypeCatalog
 };

package/lib/programmatic/capability-registry.js

@@ -15,6 +15,13 @@ const CAPABILITIES = Object.freeze([
   { method: 'GET', route: '/workspaces/me/systems/:systemKey', handlerId: 'getSystemManifest', operationType: 'workspace.read', mutating: false },
   { method: 'DELETE', route: '/workspaces/me/systems/:systemKey', handlerId: 'deleteSystem', operationType: 'workspace.write', mutating: true },
   { method: 'POST', route: '/systems/:systemKey/wizard', handlerId: 'runWizard', operationType: 'plan', mutating: true },
+  {
+    method: 'POST',
+    route: '/systems/:systemKey/integration-definition/apply',
+    handlerId: 'applyIntegrationDefinition',
+    operationType: 'plan',
+    mutating: true
+  },
   { method: 'POST', route: '/systems/:systemKey/repair', handlerId: 'runRepair', operationType: 'plan', mutating: true },
   { method: 'GET', route: '/systems/:systemKey/manifest/sections', handlerId: 'listManifestSections', operationType: 'workspace.read', mutating: false },
   { method: 'GET', route: '/systems/:systemKey/manifest/section/:sectionKey', handlerId: 'getManifestSection', operationType: 'workspace.read', mutating: false },
@@ -63,8 +70,20 @@ const CAPABILITIES = Object.freeze([
   { method: 'POST', route: '/systems/:systemKey/repository/create-review', handlerId: 'runRepositoryCreateReview', operationType: 'repository', mutating: true },
   { method: 'GET', route: '/systems/:systemKey/repository/status', handlerId: 'getRepositoryStatus', operationType: 'repository.read', mutating: false },
   { method: 'POST', route: '/systems/:systemKey/repository/dispatch-pipeline', handlerId: 'runRepositoryDispatchPipeline', operationType: 'repository', mutating: true },
+  { method: 'POST', route: '/systems/:systemKey/channels/package', handlerId: 'buildChannelPackage', operationType: 'channel', mutating: true },
+  { method: 'GET', route: '/systems/:systemKey/channels/package', handlerId: 'getChannelPackageSummary', operationType: 'channel.read', mutating: false },
+  { method: 'GET', route: '/systems/:systemKey/channels/package/zip', handlerId: 'getChannelPackageZip', operationType: 'channel.read', mutating: false },
+  { method: 'GET', route: '/systems/:systemKey/channels/branding', handlerId: 'getChannelBranding', operationType: 'channel.read', mutating: false },
+  { method: 'PATCH', route: '/systems/:systemKey/channels/branding', handlerId: 'patchChannelBranding', operationType: 'channel', mutating: true },
   { method: 'GET', route: '/health', handlerId: 'health', operationType: 'infra', mutating: false },
   { method: 'GET', route: '/health/ready', handlerId: 'ready', operationType: 'infra', mutating: false },
+  {
+    method: 'GET',
+    route: '/help',
+    handlerId: 'getBuilderHelp',
+    operationType: 'help.read',
+    mutating: false
+  },
   { method: 'GET', route: '/evidence/:roleKey/metadata', handlerId: 'getEvidenceMetadata', operationType: 'evidence.read', mutating: false },
   { method: 'GET', route: '/evidence/:roleKey/download', handlerId: 'downloadEvidence', operationType: 'evidence.read', mutating: false },
   { method: 'POST', route: '/evidence/:roleKey/upload', handlerId: 'uploadEvidenceCandidates', operationType: 'evidence.write', mutating: true },

package/lib/programmatic/openapi-component-schemas.js

@@ -21,6 +21,7 @@ const {
   OPENAPI_EVIDENCE_REQUEST_SCHEMAS,
   OPENAPI_EVIDENCE_RESULT_SCHEMAS
 } = require('./openapi-evidence-schemas');
+const { OPENAPI_HELP_RESULT_SCHEMAS } = require('./openapi-help-schemas');
 
 const RESPONSE_ENVELOPES = [
   ['ListSystemsResponse', 'ListSystemsData'],
@@ -28,6 +29,7 @@ const RESPONSE_ENVELOPES = [
   ['SystemManifestResponse', 'SystemManifestData'],
   ['DeleteSystemResponse', 'DeleteSystemData'],
   ['WizardRunResponse', 'WizardRunData'],
+  ['IntegrationDefinitionApplyResponse', 'IntegrationDefinitionApplyData'],
   ['RepairResultResponse', 'RepairResultData'],
   ['ValidateResultResponse', 'ValidateResultData'],
   ['PreviewUploadResponse', 'PreviewUploadData'],
@@ -51,7 +53,8 @@ const RESPONSE_ENVELOPES = [
   ['EvidenceAuthoringMetadataResponse', 'EvidenceAuthoringMetadataData'],
   ['EvidenceDownloadResponse', 'EvidenceDownloadData'],
   ['EvidenceUploadResponse', 'EvidenceUploadData'],
-  ['EvidenceActivateResponse', 'EvidenceActivateData']
+  ['EvidenceActivateResponse', 'EvidenceActivateData'],
+  ['BuilderHelpResponse', 'BuilderHelpData']
 ];
 
 /**
@@ -70,6 +73,7 @@ function buildOpenApiComponentSchemas() {
     ...OPENAPI_APPLY_RESULT_SCHEMAS,
     ...OPENAPI_MANIFEST_RESULT_SCHEMAS,
     ...OPENAPI_EVIDENCE_RESULT_SCHEMAS,
+    ...OPENAPI_HELP_RESULT_SCHEMAS,
     EmptyResultData: { type: 'object', properties: {}, additionalProperties: false },
     ...envelopes
   });
@@ -78,6 +82,7 @@ function buildOpenApiComponentSchemas() {
 module.exports = {
   buildOpenApiComponentSchemas,
   buildSuccessEnvelopeSchema,
+  RESPONSE_ENVELOPES,
   OPENAPI_REQUEST_SCHEMAS,
   OPENAPI_RESULT_SCHEMAS
 };

package/lib/programmatic/openapi-descriptions.js

@@ -39,6 +39,12 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
       'Run headless wizard to materialize system and datasource JSON under the workspace. Mutating; may take up to MAX_REQUEST_TIMEOUT_MS. Retry with the same Idempotency-Key.',
     tags: ['build']
   },
+  applyIntegrationDefinition: {
+    summary: 'Apply Builder Integration Definition (BID) into workspace',
+    description:
+      'Materialize system and datasource package files from an aifabrix.builder.integrationDefinition document. Prefer this over wizard when OpenAPI is not yet available. Mutating; retry with the same Idempotency-Key.',
+    tags: ['build']
+  },
   runRepair: {
     summary: 'Repair workspace manifest drift',
     description:
@@ -194,6 +200,12 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
     description: 'Returns ready with configured dataplaneUrl. Does not verify Dataplane connectivity in V1.',
     tags: ['infra']
   },
+  getBuilderHelp: {
+    summary: 'LLM help topics',
+    description:
+      'Deterministic product help for agents (no tenant data). Required topic enum includes resourceTypeCatalog for BID resourceType keys. No authentication.',
+    tags: ['help']
+  },
   getEvidenceMetadata: {
     summary: 'Evidence authoring metadata',
     description:
@@ -217,6 +229,34 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
     description:
       'Activate one or many human-approved certified Evidence ids. Organizational gate after technical certification. Mutating; use Idempotency-Key.',
     tags: ['evidence']
+  },
+  buildChannelPackage: {
+    summary: 'Build channel package',
+    description:
+      'Build vendor channel package from External AI Discovery plus optional workspace branding. Returns summary, README/ZIP links, and installReady. Mutating.',
+    tags: ['channel']
+  },
+  getChannelPackageSummary: {
+    summary: 'Get channel package summary',
+    description: 'Return last built channel package summary and README/ZIP links. Read-only.',
+    tags: ['channel']
+  },
+  getChannelPackageZip: {
+    summary: 'Download channel package ZIP',
+    description:
+      'Return the built app package as zipBase64 (application/zip). Build package first. Read-only.',
+    tags: ['channel']
+  },
+  getChannelBranding: {
+    summary: 'Get channel branding',
+    description: 'Return optional workspace branding (displayName, description, icon paths). Read-only.',
+    tags: ['channel']
+  },
+  patchChannelBranding: {
+    summary: 'Patch channel branding',
+    description:
+      'Update optional package branding overrides stored in the Builder API workspace. Mutating.',
+    tags: ['channel']
   }
 });
 

package/lib/programmatic/openapi-envelope-examples.js

@@ -0,0 +1,269 @@
+/**
+ * Minimal valid `data` examples for builder-api success envelopes (OAPI-136).
+ *
+ * @fileoverview Envelope data examples keyed by data schema name
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const SAMPLE_SYSTEM_KEY = 'hubspot-demo';
+const SAMPLE_DATASOURCE_KEY = 'hubspot-demo-companies';
+const SAMPLE_UUID = '00000000-0000-4000-8000-000000000010';
+const SAMPLE_ISO = '2026-01-15T12:00:00.000Z';
+
+const SAMPLE_META = {
+  ownerUserId: 'user-demo',
+  systemKey: SAMPLE_SYSTEM_KEY,
+  createdAt: SAMPLE_ISO,
+  lastModifiedAt: SAMPLE_ISO,
+  lastOperation: 'validate'
+};
+
+const SAMPLE_QUALITY = {
+  score: 100,
+  blockingIssues: [],
+  warnings: [],
+  missingInputs: [],
+  assumptions: []
+};
+
+const SAMPLE_MCP_RESULT = {
+  success: true,
+  status: 'ok',
+  message: 'completed'
+};
+
+const SAMPLE_SYSTEM_MANIFEST = {
+  systemKey: SAMPLE_SYSTEM_KEY,
+  meta: SAMPLE_META,
+  files: [{ path: 'application.json', isDirectory: false, sizeBytes: 128, redacted: false }]
+};
+
+const SAMPLE_VALIDATION_STEP = {
+  valid: true,
+  errors: [],
+  warnings: []
+};
+
+/** @type {Record<string, Object>} */
+const OPENAPI_ENVELOPE_DATA_EXAMPLES = {
+  HealthData: { status: 'ok' },
+  ReadyData: { status: 'ready', dataplaneUrl: 'http://localhost:3601' },
+  BuilderHelpData: {
+    version: '1.0.0',
+    schemaVersion: '1.0.0',
+    topic: 'resourceTypeCatalog',
+    key: 'all',
+    title: 'Resource type catalog',
+    summary: 'Taxonomy-only catalog keys for datasource.resourceType.',
+    data: {
+      schemaVersion: '1.0.0',
+      minimumSystemKeys: ['customer'],
+      resourceTypes: [
+        {
+          key: 'customer',
+          displayName: 'Customer',
+          description: 'Customer organization.',
+          category: 'business',
+          defaultRiskLevel: 'medium',
+          status: 'active'
+        }
+      ]
+    },
+    related: ['schemaCatalog'],
+    recommendedNext: ['topic=section&sectionKey=datasource.resourceType']
+  },
+  EmptyResultData: {},
+  ListSystemsData: { systems: [{ systemKey: SAMPLE_SYSTEM_KEY, meta: SAMPLE_META }] },
+  CreateSystemData: { systemKey: SAMPLE_SYSTEM_KEY, meta: SAMPLE_META },
+  SystemManifestData: SAMPLE_SYSTEM_MANIFEST,
+  DeleteSystemData: { systemKey: SAMPLE_SYSTEM_KEY, deleted: true },
+  WizardRunData: { systemKey: SAMPLE_SYSTEM_KEY, status: 'completed' },
+  IntegrationDefinitionApplyData: {
+    status: 'updated',
+    systemKey: SAMPLE_SYSTEM_KEY,
+    outputDir: `/workspace/integration/${SAMPLE_SYSTEM_KEY}`,
+    definitionId: 'bid-demo',
+    definitionHash: 'sha256:demo',
+    packageVersion: '1.0.0',
+    files: ['application.json']
+  },
+  RepairResultData: {
+    updated: true,
+    changes: ['synced dataSources'],
+    warnings: [],
+    changedFiles: ['application.json']
+  },
+  ValidateResultData: {
+    validationResult: {
+      valid: true,
+      errors: [],
+      warnings: [],
+      steps: {
+        application: SAMPLE_VALIDATION_STEP,
+        components: SAMPLE_VALIDATION_STEP,
+        manifest: SAMPLE_VALIDATION_STEP
+      }
+    },
+    pipelineValidation: null
+  },
+  PreviewUploadData: {
+    manifest: { key: SAMPLE_SYSTEM_KEY, version: '1.0.0', type: 'external' },
+    payload: {
+      version: '1.0.0',
+      application: { key: SAMPLE_SYSTEM_KEY, displayName: 'Demo', type: 'external' },
+      dataSources: [{ key: SAMPLE_DATASOURCE_KEY }]
+    }
+  },
+  UploadResultData: {
+    dataplaneUrl: 'http://localhost:3601',
+    environment: 'dev',
+    uploadSkipped: false
+  },
+  DeployResultData: {
+    deployed: true,
+    deploymentId: SAMPLE_UUID,
+    environment: 'dev',
+    systemKey: SAMPLE_SYSTEM_KEY
+  },
+  ProtectionUploadData: {
+    datasourceKey: SAMPLE_DATASOURCE_KEY,
+    uploaded: true,
+    dryRun: false
+  },
+  ProtectionCreateData: {
+    datasourceKey: SAMPLE_DATASOURCE_KEY,
+    created: true,
+    dryRun: false
+  },
+  TestResultData: {
+    runType: 'unit',
+    valid: true,
+    errors: [],
+    warnings: [],
+    systemResults: [{ file: 'hubspot-demo-system.json', valid: true, errors: [] }],
+    datasourceResults: [
+      {
+        key: SAMPLE_DATASOURCE_KEY,
+        file: 'hubspot-demo-datasource-companies.json',
+        valid: true,
+        errors: [],
+        warnings: []
+      }
+    ],
+    systemKey: SAMPLE_SYSTEM_KEY,
+    appName: SAMPLE_SYSTEM_KEY
+  },
+  CertifyResultData: {
+    command: 'verify-operations',
+    systemKey: SAMPLE_SYSTEM_KEY,
+    verdict: 'VERIFIED',
+    operationalReadinessPercent: 100,
+    certification: { level: 'SILVER', status: 'AI_READY' },
+    warnings: [],
+    details: [],
+    stepResults: []
+  },
+  LifecycleReportData: {
+    systemKey: SAMPLE_SYSTEM_KEY,
+    certification: { level: 'SILVER', status: 'AI_READY' },
+    operationalReadinessPercent: 100,
+    summary: true,
+    details: false
+  },
+  EnterpriseMcpInvocationData: {
+    capabilityKey: 'repository.status',
+    result: SAMPLE_MCP_RESULT
+  },
+  WorkspaceStatusData: {
+    local: SAMPLE_SYSTEM_MANIFEST,
+    remote: null
+  },
+  RepositoryStatusData: {
+    capabilityKey: 'repository.status',
+    result: SAMPLE_MCP_RESULT
+  },
+  ManifestSectionViewData: {
+    sectionKey: 'system.authentication',
+    target: 'system',
+    datasourceKey: null,
+    currentValue: {},
+    schemaFragment: {},
+    required: true,
+    mutable: true,
+    sourceOfTruth: true,
+    dependencyGraph: { downstreamFromThis: [] },
+    repairHooks: [],
+    recommendedNextActions: [],
+    sectionReadToken: SAMPLE_UUID,
+    quality: SAMPLE_QUALITY
+  },
+  ManifestPatchResultData: {
+    sectionKey: 'system.authentication',
+    datasourceKey: null,
+    intent: 'align auth method',
+    changedPaths: ['authentication.method'],
+    beforeHash: 'sha256:before',
+    afterHash: 'sha256:after',
+    derivedSectionsAffected: [],
+    repairRecommended: false,
+    repairHooks: [],
+    validationPreview: {},
+    riskHints: [],
+    nextActions: [],
+    dryRun: false,
+    quality: SAMPLE_QUALITY
+  },
+  ManifestSectionsListData: {
+    systemKey: SAMPLE_SYSTEM_KEY,
+    sections: [{ sectionKey: 'system.authentication', target: 'system' }],
+    datasourceKeys: [SAMPLE_DATASOURCE_KEY]
+  },
+  ManifestRepairResultData: {
+    hooksRun: ['sync-datasources'],
+    derivedSectionsUpdated: [],
+    repairResult: {},
+    dryRun: false,
+    quality: SAMPLE_QUALITY
+  },
+  EvidenceAuthoringMetadataData: {
+    roleKey: 'aifabrix-business-transformation',
+    evidenceKinds: [],
+    aspects: [],
+    resourceTypes: [],
+    assistantCapabilities: [],
+    writableFields: [],
+    requiredFields: [],
+    constraints: {
+      certification: {},
+      activation: { requiresCertified: true, requiresAuthority: false }
+    }
+  },
+  EvidenceDownloadData: {
+    roleKey: 'aifabrix-business-transformation',
+    count: 0,
+    data: []
+  },
+  EvidenceUploadData: {
+    roleKey: 'aifabrix-business-transformation',
+    inserted: 0,
+    updated: 0,
+    accepted: [],
+    rejected: [],
+    warnings: [],
+    certified: [],
+    readyToActivate: false
+  },
+  EvidenceActivateData: {
+    requested: 0,
+    activated: [],
+    failed: [],
+    success: true
+  }
+};
+
+module.exports = {
+  OPENAPI_ENVELOPE_DATA_EXAMPLES
+};

package/lib/programmatic/openapi-operation-bindings.js

@@ -103,6 +103,11 @@ const OPERATION_BINDINGS = Object.freeze({
     requestBody: jsonRequestBody('WizardConfigRequest', true),
     successResponse: 'WizardRunResponse'
   },
+  applyIntegrationDefinition: {
+    parameters: [SYSTEM_KEY_PARAM],
+    requestBody: jsonRequestBody('IntegrationDefinitionApplyRequest', true),
+    successResponse: 'IntegrationDefinitionApplyResponse'
+  },
   runRepair: {
     parameters: [SYSTEM_KEY_PARAM],
     queryParameters: [
@@ -275,6 +280,46 @@ const OPERATION_BINDINGS = Object.freeze({
   ready: {
     successResponse: 'ReadyResponse'
   },
+  getBuilderHelp: {
+    queryParameters: [
+      {
+        name: 'topic',
+        in: 'query',
+        required: true,
+        schema: { $ref: '#/components/schemas/BuilderHelpTopic' },
+        description: 'Help topic. Use resourceTypeCatalog for taxonomy keys agents may set on BID datasources.'
+      },
+      {
+        name: 'sectionKey',
+        in: 'query',
+        required: false,
+        schema: { type: 'string' },
+        description: 'Required when topic=section.'
+      },
+      {
+        name: 'exampleKey',
+        in: 'query',
+        required: false,
+        schema: { type: 'string' },
+        description: 'Required when topic=goldenExample.'
+      },
+      {
+        name: 'category',
+        in: 'query',
+        required: false,
+        schema: { type: 'string' },
+        description: 'Optional filter for topic=resourceTypeCatalog.'
+      },
+      {
+        name: 'resourceType',
+        in: 'query',
+        required: false,
+        schema: { type: 'string' },
+        description: 'Optional key filter for resourceTypeCatalog or schemaCatalog target.'
+      }
+    ],
+    successResponse: 'BuilderHelpResponse'
+  },
   getEvidenceMetadata: {
     parameters: [ROLE_KEY_PARAM],
     successResponse: 'EvidenceAuthoringMetadataResponse'