@aifabrix/builder 2.53.1 → 2.55.0

package/lib/programmatic/openapi-channel-install-schemas.js

@@ -0,0 +1,289 @@
+/**
+ * OpenAPI request/result schemas for generic channel install.
+ *
+ * @fileoverview Default HTTP is help markdown plus phase and userActions
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { frozenObject, schemaRef } = require('./openapi-schema-helpers');
+
+/** @type {Record<string, Object>} */
+const OPENAPI_CHANNEL_INSTALL_REQUEST_SCHEMAS = {
+  ChannelInstallRequest: frozenObject(
+    {
+      name: { type: 'string', minLength: 1 },
+      systemKey: { type: 'string' },
+      configuration: { type: 'object', additionalProperties: { type: 'string' } },
+      runtimeSystemKey: { type: 'string' },
+      force: { type: 'boolean' },
+      probe: { type: 'boolean' },
+      dryRun: { type: 'boolean' },
+      allowExperimental: { type: 'boolean' },
+      onboardUsers: { type: 'boolean' },
+      profile: { type: 'string' },
+      token: { type: 'string', minLength: 1 }
+    },
+    ['name']
+  ),
+  ChannelInstallContinueRequest: frozenObject({
+    token: { type: 'string', minLength: 1 },
+    retryLogin: { type: 'string' }
+  }),
+  ChannelPackageRequest: frozenObject({
+    name: { type: 'string' },
+    description: { type: 'string' },
+    baseName: { type: 'string' },
+    environment: { type: 'string' },
+    dataplaneUrl: { type: 'string', format: 'uri' },
+    dryRun: { type: 'boolean' },
+    branding: schemaRef('ChannelBrandingFields')
+  }),
+  ChannelBrandingPatchRequest: frozenObject({
+    displayName: { type: 'string' },
+    description: { type: 'string' },
+    iconColorPath: { type: 'string' },
+    iconOutlinePath: { type: 'string' }
+  })
+};
+
+/** @type {Record<string, Object>} */
+const OPENAPI_CHANNEL_INSTALL_RESULT_SCHEMAS = {
+  ChannelProvisioning: frozenObject(
+    {
+      mode: { type: 'string', enum: ['automatic', 'guided', 'cli'] }
+    },
+    ['mode']
+  ),
+  ChannelRuntimeTarget: frozenObject(
+    {
+      defaultSystemKey: { type: 'string' },
+      configurable: { type: 'boolean' },
+      systemKey: { type: 'string' }
+    },
+    ['defaultSystemKey']
+  ),
+  ChannelInstallationSummary: frozenObject(
+    {
+      count: { type: 'integer', minimum: 0 },
+      statusRollup: { type: 'string' }
+    },
+    ['count']
+  ),
+  ChannelInstallationRow: frozenObject(
+    {
+      key: { type: 'string' },
+      displayName: { type: 'string' },
+      version: { type: ['string', 'null'] },
+      lifecycle: { type: ['string', 'null'] },
+      availability: { type: ['string', 'null'] },
+      authenticationStatus: { type: ['string', 'null'] },
+      connectedSystemKey: { type: 'string' },
+      runtimeTarget: { type: 'object', additionalProperties: { type: 'string' } }
+    },
+    ['key', 'connectedSystemKey']
+  ),
+  ChannelDefinitionChannel: frozenObject({
+    definitionKey: { type: 'string' },
+    provisioning: schemaRef('ChannelProvisioning'),
+    runtimeTarget: schemaRef('ChannelRuntimeTarget'),
+    experimental: { type: 'boolean' },
+    status: { type: 'string', enum: ['visible', 'hide', 'coming-soon'] },
+    maxInstances: { type: 'integer', minimum: 1 },
+    profiles: { type: 'array', items: schemaRef('ChannelTargetProfile') }
+  }),
+  ChannelDefinitionDetailData: frozenObject(
+    {
+      key: { type: 'string' },
+      displayName: { type: 'string' },
+      description: { type: 'string' },
+      type: { type: 'string' },
+      systemKind: { type: 'string' },
+      configuration: { type: 'array', items: { type: 'object' } },
+      channel: schemaRef('ChannelDefinitionChannel'),
+      cliInstructions: { type: 'string' },
+      iconHref: { type: 'string' },
+      installations: { type: 'array', items: schemaRef('ChannelInstallationRow') },
+      maxInstances: { type: 'integer', minimum: 1 },
+      installationCount: { type: 'integer', minimum: 0 },
+      canInstall: { type: 'boolean' },
+      blockedReason: { type: 'string' },
+      status: { type: 'string', enum: ['visible', 'hide', 'coming-soon'] }
+    },
+    ['key', 'displayName', 'channel', 'installations']
+  ),
+  ChannelInstallationDetailData: frozenObject(
+    {
+      definition: {
+        type: 'object',
+        properties: {
+          key: { type: 'string' },
+          displayName: { type: 'string' },
+          provisioning: schemaRef('ChannelProvisioning')
+        },
+        additionalProperties: false
+      },
+      installation: schemaRef('ChannelInstallationRow')
+    },
+    ['definition', 'installation']
+  ),
+  ChannelTargetProfile: frozenObject(
+    {
+      key: { type: 'string' },
+      displayLabel: { type: 'string' }
+    },
+    ['key', 'displayLabel']
+  ),
+  ChannelTargetRow: frozenObject(
+    {
+      key: { type: 'string' },
+      displayLabel: { type: 'string' },
+      description: { type: 'string' },
+      experimental: { type: 'boolean' },
+      status: { type: 'string', enum: ['visible', 'hide', 'coming-soon'] },
+      provisioning: schemaRef('ChannelProvisioning'),
+      runtimeTarget: schemaRef('ChannelRuntimeTarget'),
+      installationSummary: schemaRef('ChannelInstallationSummary'),
+      installations: { type: 'array', items: schemaRef('ChannelInstallationRow') },
+      profiles: { type: 'array', items: schemaRef('ChannelTargetProfile') },
+      configuration: { type: 'array', items: { type: 'object' } },
+      cliInstructions: { type: 'string' },
+      iconHref: { type: 'string' },
+      maxInstances: { type: 'integer', minimum: 1 },
+      installationCount: { type: 'integer', minimum: 0 },
+      canInstall: { type: 'boolean' },
+      blockedReason: { type: 'string' }
+    },
+    ['key', 'displayLabel', 'description', 'experimental']
+  ),
+  ListChannelTargetsData: frozenObject(
+    {
+      channels: { type: 'array', items: schemaRef('ChannelTargetRow') }
+    },
+    ['channels']
+  ),
+  ChannelUserAction: frozenObject(
+    {
+      id: { type: 'string' },
+      kind: { type: 'string' },
+      label: { type: 'string' },
+      required: { type: 'boolean' },
+      resume: { type: 'string' },
+      href: { type: 'string' },
+      field: { type: 'string' },
+      artifactId: { type: 'string' },
+      command: { type: 'string' },
+      value: { type: 'string' },
+      text: { type: 'string' }
+    },
+    ['id', 'kind', 'label']
+  ),
+  ChannelInstallVerdict: frozenObject(
+    {
+      ok: { type: 'boolean' },
+      label: { type: 'string' }
+    },
+    ['ok']
+  ),
+  ChannelInstallVerdicts: frozenObject({
+    runtime: schemaRef('ChannelInstallVerdict'),
+    oauth: schemaRef('ChannelInstallVerdict'),
+    vendorSession: schemaRef('ChannelInstallVerdict')
+  }),
+  ChannelInstallHelpData: frozenObject(
+    {
+      helpMarkdown: { type: 'string' },
+      helpMarkdownContentType: { type: 'string', enum: ['text/markdown'] },
+      refreshHintSeconds: { type: 'integer', minimum: 1 },
+      phase: { type: 'string' },
+      userActions: { type: 'array', items: schemaRef('ChannelUserAction') },
+      verdicts: schemaRef('ChannelInstallVerdicts'),
+      definitionKey: { type: 'string' },
+      installationKey: { type: 'string' },
+      systemKey: { type: 'string' }
+    },
+    ['helpMarkdown', 'helpMarkdownContentType', 'phase']
+  ),
+  AuthPermissionsData: frozenObject(
+    {
+      permissions: { type: 'array', items: { type: 'string' } }
+    },
+    ['permissions']
+  ),
+  ChannelArtifactRow: frozenObject(
+    {
+      id: { type: 'string' },
+      kind: { type: 'string' },
+      fileName: { type: 'string' },
+      contentType: { type: 'string' },
+      href: { type: 'string' }
+    },
+    ['id', 'href']
+  ),
+  ListChannelArtifactsData: frozenObject(
+    {
+      artifacts: { type: 'array', items: schemaRef('ChannelArtifactRow') }
+    },
+    ['artifacts']
+  ),
+  ChannelArtifactBytesData: frozenObject(
+    {
+      fileName: { type: 'string' },
+      contentType: { type: 'string' },
+      byteLength: { type: 'integer', minimum: 0 }
+    },
+    ['fileName', 'contentType', 'byteLength']
+  ),
+  ChannelPackageLinks: frozenObject({
+    readme: { type: 'string' },
+    zip: { type: ['string', 'null'] }
+  }),
+  ChannelPackageData: frozenObject(
+    {
+      channelTarget: { type: 'string' },
+      installReady: { type: 'boolean' },
+      blocker: { type: ['string', 'null'] },
+      artifactHash: { type: 'string' },
+      links: schemaRef('ChannelPackageLinks')
+    },
+    ['channelTarget', 'installReady']
+  ),
+  ChannelPackageSummaryData: frozenObject(
+    {
+      channelTarget: { type: 'string' },
+      installReady: { type: 'boolean' },
+      blocker: { type: ['string', 'null'] },
+      links: schemaRef('ChannelPackageLinks')
+    },
+    ['channelTarget', 'installReady']
+  ),
+  ChannelPackageZipData: frozenObject(
+    {
+      fileName: { type: 'string' },
+      contentType: { type: 'string' },
+      byteLength: { type: 'integer', minimum: 0 },
+      zipBase64: { type: 'string' }
+    },
+    ['fileName', 'contentType', 'byteLength', 'zipBase64']
+  ),
+  ChannelBrandingFields: frozenObject({
+    displayName: { type: 'string' },
+    description: { type: 'string' },
+    iconColorPath: { type: 'string' },
+    iconOutlinePath: { type: 'string' }
+  }),
+  ChannelBrandingData: frozenObject(
+    {
+      systemKey: { type: 'string' },
+      branding: schemaRef('ChannelBrandingFields')
+    },
+    ['systemKey', 'branding']
+  )
+};
+
+module.exports = {
+  OPENAPI_CHANNEL_INSTALL_REQUEST_SCHEMAS,
+  OPENAPI_CHANNEL_INSTALL_RESULT_SCHEMAS
+};

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

@@ -22,6 +22,10 @@ const {
   OPENAPI_EVIDENCE_RESULT_SCHEMAS
 } = require('./openapi-evidence-schemas');
 const { OPENAPI_HELP_RESULT_SCHEMAS } = require('./openapi-help-schemas');
+const {
+  OPENAPI_CHANNEL_INSTALL_REQUEST_SCHEMAS,
+  OPENAPI_CHANNEL_INSTALL_RESULT_SCHEMAS
+} = require('./openapi-channel-install-schemas');
 
 const RESPONSE_ENVELOPES = [
   ['ListSystemsResponse', 'ListSystemsData'],
@@ -36,6 +40,7 @@ const RESPONSE_ENVELOPES = [
   ['PreviewUploadResponse', 'PreviewUploadData'],
   ['UploadResultResponse', 'UploadResultData'],
   ['DeployResultResponse', 'DeployResultData'],
+  ['DownloadResultResponse', 'DownloadResultData'],
   ['ProtectionUploadResponse', 'ProtectionUploadData'],
   ['ProtectionCreateResponse', 'ProtectionCreateData'],
   ['TestResultResponse', 'TestResultData'],
@@ -55,7 +60,18 @@ const RESPONSE_ENVELOPES = [
   ['EvidenceDownloadResponse', 'EvidenceDownloadData'],
   ['EvidenceUploadResponse', 'EvidenceUploadData'],
   ['EvidenceActivateResponse', 'EvidenceActivateData'],
-  ['BuilderHelpResponse', 'BuilderHelpData']
+  ['BuilderHelpResponse', 'BuilderHelpData'],
+  ['ListChannelTargetsResponse', 'ListChannelTargetsData'],
+  ['ChannelDefinitionDetailResponse', 'ChannelDefinitionDetailData'],
+  ['ChannelInstallationDetailResponse', 'ChannelInstallationDetailData'],
+  ['ChannelInstallHelpResponse', 'ChannelInstallHelpData'],
+  ['ListChannelArtifactsResponse', 'ListChannelArtifactsData'],
+  ['ChannelArtifactBytesResponse', 'ChannelArtifactBytesData'],
+  ['ChannelPackageResponse', 'ChannelPackageData'],
+  ['ChannelPackageSummaryResponse', 'ChannelPackageSummaryData'],
+  ['ChannelPackageZipResponse', 'ChannelPackageZipData'],
+  ['ChannelBrandingResponse', 'ChannelBrandingData'],
+  ['AuthPermissionsResponse', 'AuthPermissionsData']
 ];
 
 /**
@@ -70,11 +86,13 @@ function buildOpenApiComponentSchemas() {
     ...OPENAPI_REQUEST_SCHEMAS,
     ...OPENAPI_MANIFEST_REQUEST_SCHEMAS,
     ...OPENAPI_EVIDENCE_REQUEST_SCHEMAS,
+    ...OPENAPI_CHANNEL_INSTALL_REQUEST_SCHEMAS,
     ...OPENAPI_RESULT_SCHEMAS,
     ...OPENAPI_APPLY_RESULT_SCHEMAS,
     ...OPENAPI_MANIFEST_RESULT_SCHEMAS,
     ...OPENAPI_EVIDENCE_RESULT_SCHEMAS,
     ...OPENAPI_HELP_RESULT_SCHEMAS,
+    ...OPENAPI_CHANNEL_INSTALL_RESULT_SCHEMAS,
     EmptyResultData: { type: 'object', properties: {}, additionalProperties: false },
     ...envelopes
   });

package/lib/programmatic/openapi-description-enricher.js

@@ -15,6 +15,7 @@ const { MANIFEST_SCHEMA_DESCRIPTIONS } = require('./openapi-schema-descriptions-
 const { MCP_SCHEMA_DESCRIPTIONS } = require('./openapi-schema-descriptions-mcp');
 const { HELP_SCHEMA_DESCRIPTIONS } = require('./openapi-schema-descriptions-help');
 const { EVIDENCE_SCHEMA_DESCRIPTIONS } = require('./openapi-schema-descriptions-evidence');
+const { CHANNEL_INSTALL_SCHEMA_DESCRIPTIONS } = require('./openapi-schema-descriptions-channel');
 
 /** @type {Record<string, Object>} */
 const MERGED_SCHEMA_DESCRIPTIONS = {
@@ -24,7 +25,8 @@ const MERGED_SCHEMA_DESCRIPTIONS = {
   ...MANIFEST_SCHEMA_DESCRIPTIONS,
   ...MCP_SCHEMA_DESCRIPTIONS,
   ...HELP_SCHEMA_DESCRIPTIONS,
-  ...EVIDENCE_SCHEMA_DESCRIPTIONS
+  ...EVIDENCE_SCHEMA_DESCRIPTIONS,
+  ...CHANNEL_INSTALL_SCHEMA_DESCRIPTIONS
 };
 
 /**

package/lib/programmatic/openapi-descriptions.js

@@ -140,6 +140,12 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
       'Controller deploy for external systems (CLI aifabrix deploy parity). Optional body.gate matches CLI --gate (operations,trust,governance,full). Certificate seal is a platform side-effect of published Deploy — not a separate certificates issue call. Mutating; use Idempotency-Key.',
     tags: ['apply']
   },
+  runDownload: {
+    summary: 'Download system package into the workspace',
+    description:
+      'Fetch the published system from Dataplane into the workspace (CLI aifabrix download parity). Role Assistant packages also pull Evidence, Knowledge, and tests. Mutating; use Idempotency-Key.',
+    tags: ['workspace']
+  },
   runProtectionUpload: {
     summary: 'Upload protection manifest for a datasource',
     description:
@@ -198,7 +204,8 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
   },
   health: {
     summary: 'Liveness probe',
-    description: 'Returns ok when the builder-api process is running. No authentication.',
+    description:
+      'Returns ok when the builder-api process is running. Portal availability probe. Empty channel catalog is not a down signal. No authentication.',
     tags: ['infra']
   },
   ready: {
@@ -239,12 +246,13 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
   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.',
+      'Build vendor channel package from External AI Discovery plus optional workspace branding. Returns summary, README/ZIP links, and installReady (package-import readiness, not channel-installed). Mutating.',
     tags: ['channel']
   },
   getChannelPackageSummary: {
     summary: 'Get channel package summary',
-    description: 'Return last built channel package summary and README/ZIP links. Read-only.',
+    description:
+      'Return last built channel package summary and README/ZIP links. installReady is package-import readiness, not channel-installed. Read-only.',
     tags: ['channel']
   },
   getChannelPackageZip: {
@@ -263,6 +271,75 @@ const OPERATION_DESCRIPTIONS = Object.freeze({
     description:
       'Update optional package branding overrides stored in the Builder API workspace. Mutating.',
     tags: ['channel']
+  },
+  listChannelTargets: {
+    summary: 'List live channel definitions',
+    description:
+      'List live Channel Definitions. Each row has key, displayLabel, description, experimental, status, provisioning, runtimeTarget, installationSummary, installationCount, and canInstall. Optional maxInstances and blockedReason when capped or coming-soon. hide definitions are omitted. Catalog is information-only; publishing uses POST install. Read-only.',
+    tags: ['infra']
+  },
+  getChannelDefinitionDetail: {
+    summary: 'Get a Channel Definition',
+    description:
+      'Return a safe Channel Definition (identity, configuration, provisioning, runtimeTarget, profiles, optional maxInstances, status) plus installations projected from Dataplane Connected Systems. Includes canInstall. Unknown or hide definition keys return 404. Known definitions with no instances return installations []. Read-only.',
+    tags: ['infra']
+  },
+  getChannelInstallation: {
+    summary: 'Get a Channel installation',
+    description:
+      'Return one Channel installation projected from a Dataplane Connected System. 404 only when that instance does not exist for the definition. Read-only.',
+    tags: ['infra']
+  },
+  runChannelInstall: {
+    summary: 'Install a channel',
+    description:
+      'Scaffold, upload, and configure a channel from a Channel Definition. Path systemKey is the definition key. Body name is required; optional systemKey is the Connected System instance key; configuration is a generic propertyKey map. hide and coming-soon definitions return 403; --force does not override. Returns help markdown plus phase, safe userActions, definitionKey, installationKey, and systemKey (the instance). Mutating.',
+    tags: ['infra']
+  },
+  getChannelInstall: {
+    summary: 'Get channel install help',
+    description:
+      'Return install help markdown plus phase and safe userActions for this path systemKey. Help is generated from the current envelope on each GET. The definition key returns the last install session (continue). An instance key returns that installation’s help, from its session or generated from the instance package. verbose=true returns the full machine envelope. Read-only.',
+    tags: ['infra']
+  },
+  getChannelInstallHelp: {
+    summary: 'Download channel install help.md',
+    description: 'Return the current install help document as text/markdown. Human-only; no userActions. Read-only.',
+    tags: ['infra']
+  },
+  continueChannelInstall: {
+    summary: 'Continue channel install',
+    description:
+      'Resume install after the human follows the help document. Path systemKey may be the catalog definition key or the Connected System instance key. Empty body is valid and continues Microsoft device-code login without issuing a new code. Optional token is used once and not stored. retryLogin=true restarts vendor login and issues a new handshake. Returns the same default HTTP as POST install (help markdown, phase, safe userActions). Mutating.',
+    tags: ['infra']
+  },
+  listChannelArtifacts: {
+    summary: 'List channel install artifacts',
+    description: 'List downloadable files linked from the install help document. Read-only.',
+    tags: ['infra']
+  },
+  getChannelArtifact: {
+    summary: 'Download a channel install artifact',
+    description: 'Return artifact bytes (ZIP as application/zip). Read-only.',
+    tags: ['infra']
+  },
+  getChannelCallback: {
+    summary: 'Resume channel install from vendor redirect',
+    description:
+      'Vendor callback (GET). Stores access through existing credentials. Never echoes tokens. Mutating.',
+    tags: ['infra']
+  },
+  postChannelCallback: {
+    summary: 'Resume channel install from vendor POST',
+    description:
+      'Vendor callback (POST). Stores access through existing credentials. Never echoes tokens. Mutating.',
+    tags: ['infra']
+  },
+  getAuthPermissions: {
+    summary: 'Read current-user permissions',
+    description:
+      'Thin forward of the controller current-user permissions list. Used to preflight Integration Client installs. Read-only.',
+    tags: ['infra']
   }
 });
 

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

@@ -8,6 +8,8 @@
 
 'use strict';
 
+const { CHATGPT_APPS_CREATE_URL } = require('../channels/chatgpt-runtime-contract');
+
 const SAMPLE_SYSTEM_KEY = 'hubspot-demo';
 const SAMPLE_DATASOURCE_KEY = 'hubspot-demo-companies';
 const SAMPLE_UUID = '00000000-0000-4000-8000-000000000010';
@@ -139,6 +141,11 @@ const OPENAPI_ENVELOPE_DATA_EXAMPLES = {
     environment: 'dev',
     systemKey: SAMPLE_SYSTEM_KEY
   },
+  DownloadResultData: {
+    downloaded: true,
+    dryRun: false,
+    systemKey: SAMPLE_SYSTEM_KEY
+  },
   ProtectionUploadData: {
     datasourceKey: SAMPLE_DATASOURCE_KEY,
     uploaded: true,
@@ -272,6 +279,123 @@ const OPENAPI_ENVELOPE_DATA_EXAMPLES = {
     activated: [],
     failed: [],
     success: true
+  },
+  ListChannelTargetsData: {
+    channels: [
+      {
+        key: 'chatgpt',
+        displayLabel: 'ChatGPT',
+        description: 'ChatGPT channel',
+        experimental: false,
+        status: 'visible',
+        provisioning: { mode: 'guided' },
+        runtimeTarget: { defaultSystemKey: 'runtime-orchestration', configurable: true },
+        installationSummary: { count: 0, statusRollup: 'none' },
+        installations: [],
+        configuration: [
+          {
+            name: 'CHANNEL_APP_DESCRIPTION',
+            propertyKey: 'appDescription',
+            location: 'variable',
+            required: false,
+            portalInput: { field: 'text', label: 'Description' }
+          }
+        ]
+      }
+    ]
+  },
+  ChannelDefinitionDetailData: {
+    key: 'slack',
+    displayName: 'Slack communication channel',
+    description: 'Slack channel',
+    type: 'custom',
+    systemKind: 'communication',
+    configuration: [],
+    channel: {
+      definitionKey: 'slack',
+      provisioning: { mode: 'guided' },
+      runtimeTarget: { defaultSystemKey: 'runtime-orchestration', configurable: true },
+      experimental: false,
+      status: 'visible',
+      profiles: []
+    },
+    installations: []
+  },
+  ChannelInstallationDetailData: {
+    definition: {
+      key: 'slack',
+      displayName: 'Slack',
+      provisioning: { mode: 'guided' }
+    },
+    installation: {
+      key: 'slack-finance',
+      displayName: 'Finance',
+      version: '1.0.0',
+      lifecycle: 'published',
+      availability: 'available',
+      authenticationStatus: 'online',
+      connectedSystemKey: 'slack-finance',
+      runtimeTarget: { systemKey: 'runtime-orchestration' }
+    }
+  },
+  ChannelInstallHelpData: {
+    helpMarkdown: '# Onni — ChatGPT\n\nStatus: Ready\n',
+    helpMarkdownContentType: 'text/markdown',
+    phase: 'waitingForUser',
+    userActions: [
+      {
+        id: 'open-vendor',
+        kind: 'openUrl',
+        label: 'Open ChatGPT apps',
+        required: true,
+        href: CHATGPT_APPS_CREATE_URL
+      }
+    ],
+    definitionKey: 'chatgpt',
+    installationKey: 'chatgpt-onni',
+    systemKey: 'chatgpt-onni'
+  },
+  AuthPermissionsData: {
+    permissions: ['integration-client:read', 'integration-client:create']
+  },
+  ListChannelArtifactsData: {
+    artifacts: [
+      {
+        id: 'appPackage',
+        kind: 'zip',
+        fileName: 'appPackage.dev.zip',
+        contentType: 'application/zip',
+        href: '/api/v1/builder/systems/microsoft-copilot/channels/artifacts/appPackage'
+      }
+    ]
+  },
+  ChannelArtifactBytesData: {
+    fileName: 'appPackage.dev.zip',
+    contentType: 'application/zip',
+    byteLength: 128
+  },
+  ChannelPackageData: {
+    channelTarget: 'microsoft-copilot',
+    installReady: false,
+    blocker: 'discoveryUnavailable',
+    artifactHash: 'sha256:demo',
+    links: { readme: 'dist/channels/microsoft-copilot/INSTALL.md', zip: null }
+  },
+  ChannelPackageSummaryData: {
+    channelTarget: 'microsoft-copilot',
+    installReady: false,
+    blocker: 'discoveryUnavailable',
+    links: { readme: 'dist/channels/microsoft-copilot/INSTALL.md', zip: null }
+  },
+  ChannelPackageZipData: {
+    fileName: 'appPackage.dev.zip',
+    contentType: 'application/zip',
+    byteLength: 128,
+    zipBase64: 'UEsDBBQAAAA='
+  },
+  ChannelBrandingData: {
+    systemKey: 'microsoft-copilot',
+    branding: { displayName: 'Acme Copilot', description: 'Preview' }
   }
 };
 

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

@@ -8,6 +8,8 @@
 
 'use strict';
 
+const { CHANNEL_INSTALL_BINDINGS } = require('./openapi-channel-install-bindings');
+
 const SYSTEM_KEY_PARAM = {
   name: 'systemKey',
   in: 'path',
@@ -231,6 +233,11 @@ const OPERATION_BINDINGS = Object.freeze({
     requestBody: jsonRequestBody('DeployRequest'),
     successResponse: 'DeployResultResponse'
   },
+  runDownload: {
+    parameters: [SYSTEM_KEY_PARAM],
+    requestBody: jsonRequestBody('DownloadRequest'),
+    successResponse: 'DownloadResultResponse'
+  },
   runProtectionUpload: {
     parameters: [SYSTEM_KEY_PARAM, DATASOURCE_KEY_PARAM],
     requestBody: jsonRequestBody('ProtectionUploadRequest'),
@@ -400,7 +407,8 @@ const OPERATION_BINDINGS = Object.freeze({
     parameters: [ROLE_KEY_PARAM],
     requestBody: jsonRequestBody('EvidenceActivateRequest'),
     successResponse: 'EvidenceActivateResponse'
-  }
+  },
+  ...CHANNEL_INSTALL_BINDINGS
 });
 
 /**

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

@@ -147,6 +147,11 @@ const OPENAPI_REQUEST_SCHEMAS = {
     sync: { type: 'boolean' },
     verbose: { type: 'boolean' }
   }),
+  DownloadRequest: frozenObject({
+    force: { type: 'boolean' },
+    dryRun: { type: 'boolean' },
+    format: { type: 'string', enum: ['json', 'yaml'] }
+  }),
   ProtectionUploadRequest: frozenObject({
     dryRun: { type: 'boolean' },
     sync: { type: 'boolean' },