@copado/agentia-cli 1.0.0 → 1.2.0

package/dist/lib/mcp/tool-annotations.js

@@ -37,17 +37,20 @@ const ACTION_TOOLS = [
     'agentia_job_pause',
     'agentia_job_resume',
     'agentia_job_run',
+    'agentia_metadata_explore',
     'agentia_metadata_refresh_deleted',
     'agentia_metadata_refresh_run',
+    'agentia_pipeline_automation_activate',
+    'agentia_pipeline_automation_deactivate',
+    'agentia_pipeline_quality_gate_activate',
+    'agentia_pipeline_quality_gate_deactivate',
     'agentia_promotion_run',
-    'agentia_testing_build_abort',
-    'agentia_testing_build_run',
+    'agentia_testing_job_runs_abort',
     'agentia_testing_job_run',
     'agentia_testing_live_continue',
     'agentia_testing_live_execute',
     'agentia_testing_live_interrupt',
     'agentia_testing_live_stop',
-    'agentia_testing_run',
     'agentia_work_commit',
     'agentia_work_done',
     'agentia_work_publish',
@@ -57,9 +60,7 @@ const ACTION_TOOLS = [
     'agentia_work_test_apex',
 ];
 /** Read-only, non-repeatable model calls. */
-const ASK_TOOLS = [
-    'agentia_ai_ask',
-];
+const ASK_TOOLS = ['agentia_ai_ask'];
 /** Additive writes. */
 const CREATE_TOOLS = [
     'agentia_adv_deployment_create',
@@ -70,16 +71,17 @@ const CREATE_TOOLS = [
     'agentia_data_template_convert_old',
     'agentia_data_template_create',
     'agentia_environment_create',
+    'agentia_pipeline_automation_create',
     'agentia_pipeline_connection_create',
     'agentia_pipeline_create',
+    'agentia_pipeline_quality_gate_create',
     'agentia_pipeline_stage_connection_create',
     'agentia_project_create',
     'agentia_repository_create',
     'agentia_stage_create',
-    'agentia_testing_create',
     'agentia_testing_data_table_create',
     'agentia_testing_job_create',
-    'agentia_testing_job_download',
+    'agentia_testing_job_files_download',
     'agentia_testing_live_start',
     'agentia_testing_project_create',
     'agentia_testing_robot_create',
@@ -94,7 +96,9 @@ const DELETE_TOOLS = [
     'agentia_data_template_delete',
     'agentia_function_delete',
     'agentia_template_delete',
+    'agentia_pipeline_automation_delete',
     'agentia_pipeline_connection_delete',
+    'agentia_pipeline_quality_gate_delete',
     'agentia_pipeline_stage_connection_delete',
     'agentia_project_delete',
     'agentia_repository_delete',
@@ -125,6 +129,7 @@ const READ_TOOLS = [
     'agentia_adv_organization_validate',
     'agentia_adv_deployment_get',
     'agentia_adv_deployment_list',
+    'agentia_credential_auth_status',
     'agentia_credential_list',
     'agentia_data_commit_list',
     'agentia_data_dataset_file_content',
@@ -142,6 +147,8 @@ const READ_TOOLS = [
     'agentia_environment_auth_status',
     'agentia_environment_get',
     'agentia_environment_list',
+    'agentia_extension_configuration_get',
+    'agentia_extension_configuration_list',
     'agentia_function_defaults',
     'agentia_function_get',
     'agentia_function_list',
@@ -164,9 +171,13 @@ const READ_TOOLS = [
     'agentia_metadata_refresh_status',
     'agentia_navigation_resolve',
     'agentia_notification_get',
+    'agentia_pipeline_automation_get',
+    'agentia_pipeline_automation_list',
     'agentia_pipeline_connection_list',
     'agentia_pipeline_get',
     'agentia_pipeline_list',
+    'agentia_pipeline_quality_gate_get',
+    'agentia_pipeline_quality_gate_list',
     'agentia_pipeline_stage_connection_list',
     'agentia_project_default_get',
     'agentia_project_get',
@@ -180,14 +191,13 @@ const READ_TOOLS = [
     'agentia_repository_validate',
     'agentia_stage_get',
     'agentia_stage_list',
-    'agentia_testing_build_get',
-    'agentia_testing_build_latest',
-    'agentia_testing_build_list',
-    'agentia_testing_build_logs',
-    'agentia_testing_build_search',
+    'agentia_testing_job_runs_get',
+    'agentia_testing_job_runs_list',
+    'agentia_testing_job_runs_logs',
+    'agentia_testing_job_runs_search',
     'agentia_testing_data_table_get',
     'agentia_testing_data_table_list',
-    'agentia_testing_job_files',
+    'agentia_testing_job_files_list',
     'agentia_testing_job_get',
     'agentia_testing_job_list',
     'agentia_testing_job_refs',
@@ -197,14 +207,12 @@ const READ_TOOLS = [
     'agentia_testing_live_reports',
     'agentia_testing_live_screenshot',
     'agentia_testing_live_status',
-    'agentia_testing_logs',
     'agentia_testing_project_get',
     'agentia_testing_project_list',
     'agentia_testing_project_permission_get',
     'agentia_testing_project_permission_list',
     'agentia_testing_robot_get',
     'agentia_testing_robot_list',
-    'agentia_testing_status',
     'agentia_testing_user_parameter_get',
     'agentia_testing_user_parameter_list',
     'agentia_testing_variable_get',
@@ -231,7 +239,9 @@ const UPDATE_TOOLS = [
     'agentia_environment_update',
     'agentia_function_upsert',
     'agentia_template_upsert',
+    'agentia_pipeline_automation_update',
     'agentia_pipeline_connection_update',
+    'agentia_pipeline_quality_gate_update',
     'agentia_pipeline_stage_connection_update',
     'agentia_pipeline_update',
     'agentia_project_default_set',
@@ -247,13 +257,12 @@ const UPDATE_TOOLS = [
     'agentia_testing_data_table_update',
     'agentia_testing_job_schedule_set',
     'agentia_testing_job_update',
-    'agentia_testing_job_upload',
+    'agentia_testing_job_files_upload',
     'agentia_testing_live_set_options',
     'agentia_testing_project_permission_set',
     'agentia_testing_project_permission_update',
     'agentia_testing_project_update',
     'agentia_testing_robot_update',
-    'agentia_testing_update',
     'agentia_testing_user_parameter_update',
     'agentia_testing_variable_update',
     'agentia_work_deployment_step_reorder',

package/dist/lib/mcp/tools.js

@@ -4,15 +4,16 @@ import { buildMetadataCompareFileRequests } from '../../commands/cicd/metadata/c
 import { buildMetadataContentRequest } from '../../commands/cicd/metadata/content/get.js';
 import { buildMetadataCompareRequest } from '../../commands/cicd/metadata/index/compare.js';
 import { buildMetadataIndexRequest } from '../../commands/cicd/metadata/list.js';
+import { AI_METADATA_ACTIONS, buildAiMetadataToolRequest, callAiMetadataTool, } from '../metadata-explore.js';
 import { assertRequired } from '../assert.js';
 import { applyAuthSet, getAiAuthStatus, getCicdAuthStatus, getCrtAuthStatus } from '../auth-config.js';
 import { CicdGateway } from '../cicd-gateway.js';
 import { CICD_REGIONS } from '../cicd-region.js';
 import { credentialLabel, } from '../credential-store.js';
 import { readDefaults, readLastWorkItem, resolveDefaults, unsetDefaults, writeDefaults, } from '../defaults-store.js';
-import { runEnvironmentAuthStatus } from '../environment-auth-status.js';
+import { runCredentialAuthStatus, runEnvironmentAuthStatus } from '../environment-auth-status.js';
 import { collectCredentialUpdateFlagKeys, validateCredentialName } from '../environment-credential-flags.js';
-import { createEnvironmentCredential, listEnvironmentCredentials, resolveEnvironmentOrgType, sanitizeEnvironment, updateEnvironmentCredential, } from '../environment-credential-operations.js';
+import { createEnvironmentCredential, listCredentials, resolveEnvironmentOrgType, sanitizeCredentialListItem, sanitizeEnvironment, updateCredentialById, } from '../environment-credential-operations.js';
 import { buildCreatePayload, buildMutationPayload, ENVIRONMENT_STRING_VALIDATION_KEYS, validateNonEmptyStringFields, } from '../environment-flags.js';
 import { fetchEnvironment, fetchEnvironments } from '../environment-get.js';
 import { DEFAULT_ENVIRONMENT_PLATFORM, DEFAULT_ENVIRONMENT_TYPE, ENVIRONMENT_TYPES, environmentEndpoint, } from '../environment-types.js';
@@ -58,6 +59,7 @@ import { agentiaMcpAiToolHandlers, registerAgentiaMcpAiTools } from './ai-tools.
 import { agentiaMcpDataToolHandlers, registerAgentiaMcpDataTools } from './data-tools.js';
 import { agentiaMcpDeploymentStepToolHandlers, registerAgentiaMcpDeploymentStepTools } from './deployment-step-tools.js';
 import { agentiaMcpHealthCheckToolHandlers, registerAgentiaMcpHealthCheckTools } from './health-check-tools.js';
+import { agentiaMcpPipelineAutomationQualityToolHandlers, registerAgentiaMcpPipelineAutomationQualityTools, } from './pipeline-automation-quality-tools.js';
 import { safelyHandleTool, wrapMcpToolHandlers } from './result.js';
 import { agentiaMcpTestingToolHandlers, registerAgentiaMcpTestingTools } from './testing-tools.js';
 import { agentiaMcpWorkToolHandlers, registerAgentiaMcpWorkTools } from './work-tools.js';
@@ -203,9 +205,12 @@ async function credentialCreate(args) {
     });
     return { credential };
 }
-async function credentialList(args) {
-    const credentials = await listEnvironmentCredentials(assertRequired(args.environmentId, 'environmentId'));
-    return { credentials };
+async function credentialList(args = {}) {
+    const page = await listCredentials(args);
+    return mcpPaginatedListPayload('credentials', {
+        ...page,
+        data: page.data.map((credential) => sanitizeCredentialListItem(credential)),
+    });
 }
 async function credentialUpdate(args) {
     const selectedKeys = collectCredentialUpdateFlagKeys({
@@ -219,15 +224,17 @@ async function credentialUpdate(args) {
     if (nameError !== undefined) {
         throw new Error(nameError);
     }
-    const orgType = await resolveEnvironmentOrgType(assertRequired(args.environmentId, 'environmentId'));
-    const credential = await updateEnvironmentCredential({
+    const credential = await updateCredentialById({
         credentialId: assertRequired(args.id, 'id'),
         defaultCredential: args.default,
-        environmentId: args.environmentId,
         name: args.name,
-        orgType,
     });
-    return { credential };
+    return { credential: sanitizeCredentialListItem(credential) };
+}
+async function credentialAuthStatus(args) {
+    return runCredentialAuthStatus({
+        credentialId: assertRequired(args.id, 'id'),
+    });
 }
 async function jobList(args) {
     const filters = {
@@ -969,6 +976,29 @@ async function metadataContentCompare(args) {
         target: targetSide,
     };
 }
+async function metadataExplore(args) {
+    const body = await buildAiMetadataToolRequest({
+        action: assertRequired(args.action, 'action'),
+        'apex-unit-tests': args.apexUnitTests,
+        // Deferred write/deploy flags:
+        // 'async-id': args.asyncId,
+        // 'metadata-files': args.metadataFiles,
+        // 'organization-name': args.organizationName,
+        // 'test-level': args.testLevel,
+        // 'validate-only': args.validateOnly,
+        'credential-id': args.credentialId,
+        endpoint: args.endpoint,
+        'full-name': args.fullName,
+        'object-type': args.objectType,
+        pattern: args.pattern,
+        'session-id': args.sessionId,
+    });
+    const output = await callAiMetadataTool(body);
+    return {
+        ...(body.credentialId === undefined ? {} : { credentialId: body.credentialId }),
+        output,
+    };
+}
 async function metadataDependencyList(args) {
     const selection = {
         name: assertRequired(args.metadataName, 'metadataName'),
@@ -1048,9 +1078,14 @@ async function authSet(args) {
     return { ...(result.baseUrl === undefined ? {} : { baseUrl: result.baseUrl }), stored: result.stored };
 }
 async function environmentAuthStatus(args) {
+    const environmentId = typeof args.id === 'string' ? args.id.trim() : '';
+    const credentialId = typeof args.credentialId === 'string' ? args.credentialId.trim() : '';
+    if (environmentId.length === 0 && credentialId.length === 0) {
+        throw new Error('Provide id (environment ID) or credentialId.');
+    }
     return runEnvironmentAuthStatus({
-        credentialId: args.credentialId,
-        environmentId: assertRequired(args.id, 'id'),
+        credentialId: credentialId.length > 0 ? credentialId : undefined,
+        environmentId: environmentId.length > 0 ? environmentId : undefined,
     });
 }
 async function jobLogGet(args) {
@@ -1249,8 +1284,10 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     ...agentiaMcpDataToolHandlers,
     ...agentiaMcpDeploymentStepToolHandlers,
     ...agentiaMcpHealthCheckToolHandlers,
+    ...agentiaMcpPipelineAutomationQualityToolHandlers,
     authGet,
     authSet,
+    credentialAuthStatus,
     credentialCreate,
     credentialList,
     credentialUpdate,
@@ -1280,6 +1317,7 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     metadataContentCompare,
     metadataContentGet,
     metadataDependencyList,
+    metadataExplore,
     metadataIndexCompare,
     metadataList,
     metadataRefreshDeleted,
@@ -1426,6 +1464,7 @@ export function registerAgentiaMcpTools(server) {
     registerAgentiaMcpDataTools(server);
     registerAgentiaMcpDeploymentStepTools(server);
     registerAgentiaMcpHealthCheckTools(server);
+    registerAgentiaMcpPipelineAutomationQualityTools(server);
     registerAgentiaMcpTestingTools(server);
     server.registerTool('agentia_environment_list', {
         description: 'List Copado environments via the CICD gateway.',
@@ -1472,22 +1511,29 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Credential Create',
     }, (args) => safelyHandleTool(() => credentialCreate(args)));
     server.registerTool('agentia_credential_list', {
-        description: 'List credentials for a Copado environment via the CICD gateway.',
+        description: 'List Copado credentials via the CICD gateway, optionally filtered by name.',
         inputSchema: {
-            environmentId: z.string().describe('Copado environment Id or name.'),
+            name: z.string().optional().describe('Filter credentials by name (partial match).'),
+            ...listPaginationZodFields,
         },
         title: 'Agentia Credential List',
-    }, (args) => safelyHandleTool(() => credentialList(args)));
+    }, (args) => safelyHandleTool(() => credentialList(args || {})));
     server.registerTool('agentia_credential_update', {
-        description: 'Update a Copado environment credential by Id via the CICD gateway.',
+        description: 'Update a Copado credential by Id via the CICD gateway.',
         inputSchema: {
             default: z.boolean().optional().describe('Mark this credential as the environment default.'),
-            environmentId: z.string().describe('Copado environment Id.'),
             id: z.string().describe('Copado credential Id.'),
             name: z.string().optional().describe('Credential name.'),
         },
         title: 'Agentia Credential Update',
     }, (args) => safelyHandleTool(() => credentialUpdate(args)));
+    server.registerTool('agentia_credential_auth_status', {
+        description: 'Validate a Copado credential by Id through the CICD gateway.',
+        inputSchema: {
+            id: z.string().describe('Copado credential Id.'),
+        },
+        title: 'Agentia Credential Auth Status',
+    }, (args) => safelyHandleTool(() => credentialAuthStatus(args)));
     server.registerTool('agentia_promotion_list', {
         description: 'List Copado promotions via the CICD gateway.',
         inputSchema: promotionListSchema,
@@ -1801,12 +1847,12 @@ export function registerAgentiaMcpTools(server) {
     }, (args) => safelyHandleTool(() => projectDefaultUnset(args || {})));
     registerAgentiaMcpWorkTools(server);
     server.registerTool('agentia_metadata_list', {
-        description: 'Search the Copado metadata index via the CICD gateway.',
+        description: 'Search the Copado metadata index.',
         inputSchema: {
             avoidSourceTracking: z
                 .boolean()
                 .optional()
-                .describe('Pass avoidSourceTracking=true to the gateway index route.'),
+                .describe('Pass avoidSourceTracking=true to the index route.'),
             changeDateFrom: z
                 .string()
                 .optional()
@@ -1820,7 +1866,7 @@ export function registerAgentiaMcpTools(server) {
             moduleType: z.enum(MODULE_TYPES).optional().describe('Optional addon module type.'),
             orderDirection: z.enum(ORDER_DIRECTIONS).optional().describe('Sort direction for last modified date.'),
             pipelineId: z.string().describe('Pipeline Id.'),
-            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Gateway platform experience header.'),
+            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Platform experience header.'),
             source: z.enum(INDEX_SOURCES).optional().describe('Index source filter.'),
             sourceCredentialId: z.string().describe('Source org credential Id.'),
             sourceOrgId: z.string().describe('Source org Id.'),
@@ -1828,8 +1874,44 @@ export function registerAgentiaMcpTools(server) {
         },
         title: 'Agentia Metadata List',
     }, (args) => safelyHandleTool(() => metadataList(args)));
+    server.registerTool('agentia_metadata_explore', {
+        description: 'Explore Salesforce metadata through Org Intelligence. Uses the project default credential when credentialId is omitted; otherwise pass credentialId, or both sessionId and endpoint. Returns YAML tool output.',
+        inputSchema: {
+            action: z
+                .enum(AI_METADATA_ACTIONS)
+                .describe('Metadata action: list, search, read_documentation, describe_type, read, find_references, run_apex_tests.'),
+            apexUnitTests: z
+                .string()
+                .optional()
+                .describe('Comma-separated Apex test classes. Required for run_apex_tests.'),
+            // Deferred write/deploy MCP fields (re-add with AI_METADATA_ACTIONS when shipping mutate):
+            // asyncId, metadataFiles, organizationName, testLevel, validateOnly
+            credentialId: z
+                .string()
+                .optional()
+                .describe('Copado credential Id. Defaults to the CICD project default credential when set. Exclusive with sessionId+endpoint.'),
+            endpoint: z
+                .string()
+                .optional()
+                .describe('Salesforce instance URL used with sessionId when credentialId is omitted.'),
+            fullName: z
+                .string()
+                .optional()
+                .describe('Fully qualified metadata name (required for read).'),
+            objectType: z.string().optional().describe('Metadata type, for example ApexClass or CustomObject.'),
+            pattern: z
+                .string()
+                .optional()
+                .describe('Wildcard pattern for list/search (name without namespace). Defaults to *.'),
+            sessionId: z
+                .string()
+                .optional()
+                .describe('Salesforce session Id used with endpoint when credentialId is omitted.'),
+        },
+        title: 'Agentia Metadata Explore',
+    }, (args) => safelyHandleTool(() => metadataExplore(args)));
     server.registerTool('agentia_metadata_content_get', {
-        description: 'Retrieve metadata file content via the CICD gateway.',
+        description: 'Retrieve metadata file content.',
         inputSchema: {
             apiName: z.string().describe('Metadata API name.'),
             branch: z.string().optional().describe('Git branch when source is REPOSITORY or GIT_MIRROR.'),
@@ -1844,7 +1926,7 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Metadata Content Get',
     }, (args) => safelyHandleTool(() => metadataContentGet(args)));
     server.registerTool('agentia_metadata_index_compare', {
-        description: 'Compare metadata between orgs or Git branches via the CICD gateway.',
+        description: 'Compare metadata between orgs or Git branches.',
         inputSchema: {
             comparisonMode: z.enum(COMPARISON_MODES).describe('Comparison mode.'),
             filterType: z.string().optional().describe('Optional metadata type filter, for example ApexClass.'),
@@ -1874,14 +1956,14 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Metadata Content Compare',
     }, (args) => safelyHandleTool(() => metadataContentCompare(args)));
     server.registerTool('agentia_metadata_dependency_list', {
-        description: 'Retrieve metadata dependencies via the CICD gateway.',
+        description: 'Retrieve metadata dependencies.',
         inputSchema: {
             metadataCategory: z.string().optional().describe('Optional metadata category.'),
             metadataName: z.string().describe('Metadata API name.'),
             metadataType: z.string().describe('Metadata type, for example ApexClass.'),
             moduleType: z.enum(MODULE_TYPES).optional().describe('Optional addon module type.'),
             pipelineId: z.string().describe('Pipeline Id.'),
-            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Gateway platform experience header.'),
+            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Platform experience header.'),
             resultId: z.string().optional().describe('Optional result Id from a prior metadata operation.'),
             retrieveMode: z.enum(RETRIEVE_MODES).optional().describe('Dependency retrieve mode.'),
             sourceCredentialId: z.string().describe('Source org credential Id.'),
@@ -1918,10 +2000,13 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Auth Set',
     }, (args) => safelyHandleTool(() => authSet(args)));
     server.registerTool('agentia_environment_auth_status', {
-        description: 'Validate an environment credential through the CICD gateway.',
+        description: 'Validate an environment credential through the CICD gateway. Provide id, or credentialId alone to resolve the environment from the credential.',
         inputSchema: {
-            credentialId: z.string().optional().describe('Credential ID when selection is ambiguous.'),
-            id: z.string().describe('Copado environment ID.'),
+            credentialId: z
+                .string()
+                .optional()
+                .describe('Credential ID; when id is omitted, resolves the environment from the credential.'),
+            id: z.string().optional().describe('Copado environment ID (optional when credentialId is provided).'),
         },
         title: 'Agentia Environment Auth Status',
     }, (args) => safelyHandleTool(() => environmentAuthStatus(args)));
@@ -2267,14 +2352,14 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Promotion Conflict Unresolve',
     }, (args) => safelyHandleTool(() => promotionConflictUnresolve(args)));
     server.registerTool('agentia_metadata_refresh_run', {
-        description: 'Trigger a metadata index refresh via the CICD gateway.',
+        description: 'Trigger a metadata index refresh.',
         inputSchema: {
             all: z.boolean().optional().describe('Replace the metadata index instead of merging it.'),
             env: z.string().describe('Environment ID used to resolve source configuration.'),
             gitFiles: z.array(z.string()).optional().describe('Git file paths to refresh.'),
             moduleType: z.enum(MODULE_TYPES).optional().describe('Optional addon module type.'),
             pipelineId: z.string().optional().describe('Optional pipeline ID.'),
-            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Gateway platform experience header.'),
+            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Platform experience header.'),
             refreshMode: z.string().optional().describe('Optional refresh mode.'),
             selectedName: z.string().optional().describe('Selected metadata API name.'),
             selectedType: z.string().optional().describe('Selected metadata type.'),
@@ -2285,16 +2370,16 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Metadata Refresh Run',
     }, (args) => safelyHandleTool(() => metadataRefreshRun(args)));
     server.registerTool('agentia_metadata_refresh_status', {
-        description: 'Get metadata index refresh status via the CICD gateway.',
+        description: 'Get metadata index refresh status.',
         inputSchema: {
             jobId: z.string().describe('Metadata refresh event ID.'),
             moduleType: z.enum(MODULE_TYPES).optional().describe('Addon module type used by the refresh.'),
-            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Gateway platform experience header.'),
+            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Platform experience header.'),
         },
         title: 'Agentia Metadata Refresh Status',
     }, (args) => safelyHandleTool(() => metadataRefreshStatus(args)));
     server.registerTool('agentia_metadata_refresh_deleted', {
-        description: 'Refresh deleted metadata index entries via the CICD gateway.',
+        description: 'Refresh deleted metadata index entries.',
         inputSchema: {
             env: z.string().describe('Environment ID used to resolve the source credential.'),
             moduleType: z.enum(MODULE_TYPES).optional().describe('Optional addon module type.'),

package/dist/lib/mcp/work-tools.js

@@ -17,8 +17,8 @@ import { planWorkApexTestRun, recordWorkApexTestOutcome } from '../work-apex-tes
 import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTests, skippedWorkApexTestResult, validateApexTestWaitMinutes, WorkApexTestError, } from '../work-apex-test.js';
 import { buildWorkCommitRequest, normalizeWorkCommitInput, performWorkCommit, resolveWorkCommitPlatformExperience, WORK_COMMIT_ACTIONS, WORK_COMMIT_CHANGES_HELP, WORK_COMMIT_DEFAULT_TIMEOUT_SECONDS, WORK_COMMIT_METADATA_CATEGORY_HELP, } from '../work-commit.js';
 import { buildWorkCreatePayload } from '../work-defaults.js';
-import { validateWorkMutationPayload, WORK_LONG_TEXT_MAX_LENGTH, WORK_SHORT_TEXT_MAX_LENGTH, } from '../work-flags.js';
-import { fetchWorkItem, fetchWorkItems } from '../work-get.js';
+import { normalizeWorkCustomFields, validateWorkMutationPayload, WORK_LONG_TEXT_MAX_LENGTH, WORK_SHORT_TEXT_MAX_LENGTH, } from '../work-flags.js';
+import { fetchWorkItems, fetchWorkItemWithOptions } from '../work-get.js';
 import { performWorkLocalCommit } from '../work-local-commit.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../work-local-run-tests.js';
 import { capturingWorkPushHooks, performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, uploadCapturedPublishLogsBestEffort, } from '../work-push.js';
@@ -54,6 +54,7 @@ const WORK_MUTATION_PAYLOAD_KEYS = [
     'assignee',
     'cancellationReason',
     'closeDate',
+    'customFields',
     'epic',
     'excludedFromCbm',
     'feature',
@@ -80,7 +81,12 @@ function buildWorkMutationPayloadFromArgs(args) {
     for (const key of WORK_MUTATION_PAYLOAD_KEYS) {
         const value = args[key];
         if (value !== undefined) {
-            Object.assign(payload, { [key]: value });
+            if (key === 'customFields') {
+                Object.assign(payload, { customFields: normalizeWorkCustomFields(value) });
+            }
+            else {
+                Object.assign(payload, { [key]: value });
+            }
         }
     }
     return applySourceCredentialEnvironmentRule(payload);
@@ -126,8 +132,13 @@ async function workList(args = {}) {
     return mcpPaginatedListPayload('userStories', await fetchWorkItems(filters));
 }
 async function workGet(args = {}) {
-    const userStory = await fetchWorkItem(args.id);
-    return { userStory };
+    const { committedMetadata, userStory } = await fetchWorkItemWithOptions(args.id, {
+        committedMetadata: args.committedMetadata === true,
+    });
+    return {
+        userStory,
+        ...(committedMetadata === undefined ? {} : { committedMetadata }),
+    };
 }
 async function workCreate(args = {}) {
     const explicitPayload = buildWorkMutationPayloadFromArgs(args);
@@ -522,7 +533,11 @@ async function cloudCommit(args = {}) {
         throw new Error('Use changes or simple metadata fields, not both.');
     }
     if (args.changes === undefined && !hasMcpSimpleCommitArgs(args)) {
-        throw new Error('Requires simple metadata fields such as metadataName and metadataType, or changes input.');
+        throw new Error('Requires simple metadata fields such as metadataName, metadataType, and metadataCategory, or changes input.');
+    }
+    if (args.changes === undefined &&
+        (args.metadataCategory === undefined || args.metadataCategory.trim().length === 0)) {
+        throw new Error('metadataCategory is required.');
     }
     const workItemId = await resolveWorkItemId(args.id);
     const request = buildWorkCommitRequest(buildMcpWorkCommitInput(args), {
@@ -608,6 +623,10 @@ const skipNestedMetadataDetectionSchema = z
     .boolean()
     .optional()
     .describe('Do not detect the nested metadata changed across the branch. Also configurable via skipNestedMetadataDetection in .agentia/config.json or .agentia/config.user.json.');
+const workCustomFieldWriteSchema = z.object({
+    apiName: z.string().min(1).describe('Salesforce subscriber custom field API name (for example JIRA_Key__c).'),
+    value: z.unknown().optional().describe('Field value to write (string, number, boolean, null, or multipicklist string).'),
+});
 const workMutationSchema = {
     acceptanceCriteria: z.string().max(WORK_SHORT_TEXT_MAX_LENGTH).optional().describe('Acceptance criteria (maximum 255 characters).'),
     actualPoints: z.number().int().optional().describe('Actual points.'),
@@ -615,6 +634,10 @@ const workMutationSchema = {
     assignee: z.string().optional().describe('Assignee ID.'),
     cancellationReason: z.string().optional().describe('Cancellation reason.'),
     closeDate: z.string().optional().describe('Close date.'),
+    customFields: z
+        .array(workCustomFieldWriteSchema)
+        .optional()
+        .describe('Subscriber custom fields to write as [{ apiName, value }]. Omit for packaged-only create/update. Duplicate apiNames are rejected.'),
     epic: z.string().optional().describe('Epic.'),
     excludedFromCbm: z.boolean().optional().describe('Exclude from CBM.'),
     feature: z.string().optional().describe('Feature.'),
@@ -657,8 +680,12 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work List',
     }, (args) => safelyHandleTool(() => workList(args || {})));
     server.registerTool('agentia_work_get', {
-        description: 'Get a Copado user story by Id via the CICD gateway. Omit Id to use the active work item from work set.',
+        description: 'Get a Copado user story by Id via the CICD gateway. Omit Id to use the active work item from work set. Set committedMetadata=true to also include the Story committed metadata list.',
         inputSchema: {
+            committedMetadata: z
+                .boolean()
+                .optional()
+                .describe('When true, also include the Story committed metadata list as committedMetadata in the result.'),
             id: z.string().optional().describe('User story Id. Defaults to the active work item from work set.'),
         },
         title: 'Agentia Work Get',
@@ -684,7 +711,7 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Delete',
     }, (args) => safelyHandleTool(() => workDelete(args)));
     server.registerTool('agentia_work_set', {
-        description: 'Set the active Copado work item and prepare a local feature/<user-story-name> branch. Requires a clean tracked working tree. Fetches the base branch from origin, fetches the feature branch when it exists on origin, then creates or checks out the feature branch from the remote feature when present, otherwise from the base. A gateway warning prints the message, skips git, clears lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl, and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from the returned work item. After work/set returns, compares the Story source credential with the CICD project default: warns when the default or Story credential is missing, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With none=true, clears every last* key from config.user.json and checks out the previous lastBaseBranch when present, else main, else master, else stays put.',
+        description: 'Set the active Copado work item and prepare a local feature/<user-story-name> branch. Requires a clean tracked working tree. Fetches the base branch from origin, fetches the feature branch when it exists on origin, then creates or checks out the feature branch from the remote feature when present, otherwise from the base. A gateway warning prints the message, skips git, clears lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl, and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from the returned work item. After work/set returns, compares the Story source credential with the CICD project default: warns when the Story credential is missing, skips comparison when a bound Story has no project default, and warns without changing the Story when they differ (shows the current credential and environment; use work update to change it). With none=true, clears every last* key from config.user.json and checks out the previous lastBaseBranch when present, else main, else master, else stays put.',
         inputSchema: {
             baseBranch: z
                 .string()
@@ -714,7 +741,7 @@ export function registerAgentiaMcpWorkTools(server) {
         skipNestedMetadataDetection: skipNestedMetadataDetectionSchema,
     };
     server.registerTool('agentia_work_publish', {
-        description: 'Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, lastBaseBranch, and lastDevOrgBranch from config.user.json. Applies Copado environment-variable then yaml replacements when needed (yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, sends one headless push changeListUpdate list of Action:MetadataType:MetadataName corrections (lastPermissionSelected and the permissions argument plus the nested metadata of the changed profiles and permission sets as RetrieveOnly so Copado registers that metadata with the Retrieve Only commit action, lastFullMetadataSelected and the fullMetadata argument plus brand-new nested parent files as fullMetadata, the ignored nested parents as unchanged, the nested metadata the branch deleted as Del, and the remaining nested metadata as Add). The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select; brand-new nested parent files are sent as fullMetadata instead. Merges the feature branch into the recorded dev org branch after headless push. With dryRun=true, previews replacements and changeListUpdate, restores dirtied tracked files, and skips commit/push/lock/register/dev-org sync. Prefer this over agentia_work_push.',
+        description: 'Publish the current feature/<lastWorkItem> branch and register commits with Copado. Requires a clean working tree, lastBaseBranch, and lastDevOrgBranch from config.user.json. Applies Copado environment-variable then yaml replacements when needed (yaml `-b` is the feature branch, matching Copado Commit), commits both as a single follow-up commit, sends one headless push changeListUpdate list of Action:MetadataType:MetadataName corrections (lastPermissionSelected and the permissions argument plus the nested metadata of the changed profiles and permission sets as RetrieveOnly so Copado registers that metadata with the Retrieve Only commit action, lastFullMetadataSelected and the fullMetadata argument plus brand-new nested parent files as fullMetadata, the ignored nested parents as unchanged, the nested metadata the branch deleted as Delete, and the remaining nested metadata as Add). The changed profiles and permission sets themselves are never sent as corrections, so they stay in the change list and deploy only the permissions their RetrieveOnly entries select; brand-new nested parent files are sent as fullMetadata instead. Merges the feature branch into the recorded dev org branch after headless push. With dryRun=true, previews replacements and changeListUpdate, restores dirtied tracked files, and skips commit/push/lock/register/dev-org sync. Prefer this over agentia_work_push.',
         inputSchema: workPublishInputSchema,
         title: 'Agentia Work Publish',
     }, (args) => safelyHandleTool(() => workPublish(args || {})));
@@ -782,7 +809,7 @@ export function registerAgentiaMcpWorkTools(server) {
             .describe(`Maximum total wait in seconds. Defaults to ${PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS}.`),
     };
     server.registerTool('agentia_cloud_commit', {
-        description: 'Create a Copado cloud metadata commit. Preflights the user story, submits POST /release/commit, and optionally waits for the job. Use simple metadata fields for one change or changes for multi-change requests. For Salesforce metadata, set metadataCategory to SFDX (or c: "SFDX" on each changes entry); Copado SFDX deploy skips entries that omit that field. For local Git work, use git commit then agentia_work_publish; pass permissions and fullMetadata on agentia_work_publish.',
+        description: 'Create a Copado cloud metadata commit. Preflights the user story, submits POST /release/commit, and optionally waits for the job. Use simple metadata fields for one change or changes for multi-change requests. metadataCategory is required for simple input; each changes entry requires c (or category). For Salesforce metadata, set metadataCategory/c to SFDX; Copado SFDX deploy skips entries that omit that field. For local Git work, use git commit then agentia_work_publish; pass permissions and fullMetadata on agentia_work_publish.',
         inputSchema: cloudCommitInputSchema,
         title: 'Agentia Cloud Commit',
     }, (args) => safelyHandleTool(() => cloudCommit(args || {})));

package/dist/lib/metadata-explore.js

@@ -0,0 +1,8 @@
+import {modules} from './runtime.js';
+const AI_METADATA_ACTIONS = modules["metadata-explore.js"]["AI_METADATA_ACTIONS"]
+const AI_METADATA_TOOL_ENDPOINT = modules["metadata-explore.js"]["AI_METADATA_TOOL_ENDPOINT"]
+const buildAiMetadataToolRequest = modules["metadata-explore.js"]["buildAiMetadataToolRequest"]
+const callAiMetadataTool = modules["metadata-explore.js"]["callAiMetadataTool"]
+const missingExploreCredentialError = modules["metadata-explore.js"]["missingExploreCredentialError"]
+const resolveExploreCredentialId = modules["metadata-explore.js"]["resolveExploreCredentialId"]
+export {AI_METADATA_ACTIONS, AI_METADATA_TOOL_ENDPOINT, buildAiMetadataToolRequest, callAiMetadataTool, missingExploreCredentialError, resolveExploreCredentialId};

package/dist/lib/network-error.js

@@ -0,0 +1,8 @@
+import {modules} from './runtime.js';
+const formatTransportNetworkError = modules["network-error.js"]["formatTransportNetworkError"]
+const gatewayTimeoutError = modules["network-error.js"]["gatewayTimeoutError"]
+const getTransportNetworkInfo = modules["network-error.js"]["getTransportNetworkInfo"]
+const isHttpGatewaySoftMiss = modules["network-error.js"]["isHttpGatewaySoftMiss"]
+const isTransportNetworkError = modules["network-error.js"]["isTransportNetworkError"]
+const throwFormattedTransportNetworkError = modules["network-error.js"]["throwFormattedTransportNetworkError"]
+export {formatTransportNetworkError, gatewayTimeoutError, getTransportNetworkInfo, isHttpGatewaySoftMiss, isTransportNetworkError, throwFormattedTransportNetworkError};

package/dist/lib/pipeline-automation-flags.js

@@ -0,0 +1,12 @@
+import {modules} from './runtime.js';
+const AUTOMATION_FILTER_CRITERIA_FLAG_DESCRIPTION = modules["pipeline-automation-flags.js"]["AUTOMATION_FILTER_CRITERIA_FLAG_DESCRIPTION"]
+const buildPipelineAutomationCreatePayload = modules["pipeline-automation-flags.js"]["buildPipelineAutomationCreatePayload"]
+const buildPipelineAutomationUpdatePayload = modules["pipeline-automation-flags.js"]["buildPipelineAutomationUpdatePayload"]
+const normalizeAutomationFilterCriteria = modules["pipeline-automation-flags.js"]["normalizeAutomationFilterCriteria"]
+const parseAutomationFilterCriteria = modules["pipeline-automation-flags.js"]["parseAutomationFilterCriteria"]
+const pipelineAutomationListFlags = modules["pipeline-automation-flags.js"]["pipelineAutomationListFlags"]
+const pipelineAutomationMutationFlags = modules["pipeline-automation-flags.js"]["pipelineAutomationMutationFlags"]
+const readAutomationFilterCriteriaFromFile = modules["pipeline-automation-flags.js"]["readAutomationFilterCriteriaFromFile"]
+const resolveAutomationFilterCriteria = modules["pipeline-automation-flags.js"]["resolveAutomationFilterCriteria"]
+const validateAutomationCreateControls = modules["pipeline-automation-flags.js"]["validateAutomationCreateControls"]
+export {AUTOMATION_FILTER_CRITERIA_FLAG_DESCRIPTION, buildPipelineAutomationCreatePayload, buildPipelineAutomationUpdatePayload, normalizeAutomationFilterCriteria, parseAutomationFilterCriteria, pipelineAutomationListFlags, pipelineAutomationMutationFlags, readAutomationFilterCriteriaFromFile, resolveAutomationFilterCriteria, validateAutomationCreateControls};