@copado/agentia-cli 1.2.0 → 1.3.0

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

@@ -7,6 +7,7 @@
  * Every tool is classified here explicitly. `test/lib/mcp/tool-annotations.test.ts` fails when a
  * registered tool is missing from the table, so new tools must be classified when they are added.
  */
+import { z } from 'zod';
 /** MCP spec: destructive means the tool may overwrite or remove existing state, not only add. */
 const CLASS_ANNOTATIONS = {
     // Runs or triggers something with side effects; repeating it repeats the effect.
@@ -47,10 +48,8 @@ const ACTION_TOOLS = [
     'agentia_promotion_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_browser_execute',
+    'agentia_testing_browser_stop',
     'agentia_work_commit',
     'agentia_work_done',
     'agentia_work_publish',
@@ -82,7 +81,7 @@ const CREATE_TOOLS = [
     'agentia_testing_data_table_create',
     'agentia_testing_job_create',
     'agentia_testing_job_files_download',
-    'agentia_testing_live_start',
+    'agentia_testing_browser_start',
     'agentia_testing_project_create',
     'agentia_testing_robot_create',
     'agentia_testing_user_parameter_create',
@@ -103,6 +102,7 @@ const DELETE_TOOLS = [
     'agentia_project_delete',
     'agentia_repository_delete',
     'agentia_repository_reset',
+    'agentia_promotion_queue_remove',
     'agentia_stage_delete',
     'agentia_testing_data_table_delete',
     'agentia_testing_job_delete',
@@ -161,6 +161,7 @@ const READ_TOOLS = [
     'agentia_job_get',
     'agentia_job_list',
     'agentia_job_log_get',
+    'agentia_promotion_queue_list',
     'agentia_job_result_file_get',
     'agentia_job_result_file_list',
     'agentia_metadata_content_compare',
@@ -202,11 +203,11 @@ const READ_TOOLS = [
     'agentia_testing_job_list',
     'agentia_testing_job_refs',
     'agentia_testing_job_schedule_get',
-    'agentia_testing_live_history',
-    'agentia_testing_live_inspect',
-    'agentia_testing_live_reports',
-    'agentia_testing_live_screenshot',
-    'agentia_testing_live_status',
+    'agentia_testing_browser_history',
+    'agentia_testing_browser_inspect',
+    'agentia_testing_browser_reports',
+    'agentia_testing_browser_screenshot',
+    'agentia_testing_browser_status',
     'agentia_testing_project_get',
     'agentia_testing_project_list',
     'agentia_testing_project_permission_get',
@@ -258,7 +259,7 @@ const UPDATE_TOOLS = [
     'agentia_testing_job_schedule_set',
     'agentia_testing_job_update',
     'agentia_testing_job_files_upload',
-    'agentia_testing_live_set_options',
+    'agentia_testing_browser_set_options',
     'agentia_testing_project_permission_set',
     'agentia_testing_project_permission_update',
     'agentia_testing_project_update',
@@ -294,12 +295,31 @@ export function getToolAnnotations(toolName) {
         return undefined;
     return { ...CLASS_ANNOTATIONS[toolClass], openWorldHint: !LOCAL_ONLY_TOOLS.has(toolName) };
 }
+const cicdConnectionSchemaField = z
+    .string()
+    .optional()
+    .describe('Named CICD connection for this call only (see agentia auth set --connection). Does not change stored default auth.');
+function usesCicdGateway(toolName) {
+    if (LOCAL_ONLY_TOOLS.has(toolName))
+        return false;
+    if (toolName.startsWith('agentia_testing_'))
+        return false;
+    if (toolName.startsWith('agentia_ai_'))
+        return false;
+    if (toolName.startsWith('agentia_adv_'))
+        return false;
+    return true;
+}
 /** Returns the tool config with default annotations; annotations already set on the tool win. */
 export function withToolAnnotations(toolName, config) {
     const defaults = getToolAnnotations(toolName);
     if (defaults === undefined || typeof config !== 'object' || config === null)
         return config;
     const existing = config.annotations;
-    return { ...config, annotations: { ...defaults, ...existing } };
+    const inputSchema = config.inputSchema;
+    const withConnection = usesCicdGateway(toolName) && inputSchema !== undefined && inputSchema.cicdConnection === undefined
+        ? { inputSchema: { ...inputSchema, cicdConnection: cicdConnectionSchemaField } }
+        : {};
+    return { ...config, ...withConnection, annotations: { ...defaults, ...existing } };
 }
 //# sourceMappingURL=tool-annotations.js.map

package/dist/lib/mcp/tools.js

@@ -2,6 +2,7 @@
 import { z } from 'zod';
 import { buildMetadataCompareFileRequests } from '../../commands/cicd/metadata/content/compare.js';
 import { buildMetadataContentRequest } from '../../commands/cicd/metadata/content/get.js';
+import { buildDependencyRequest, enrichDependencyResult, } from '../../commands/cicd/metadata/dependency/list.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';
@@ -20,6 +21,7 @@ import { DEFAULT_ENVIRONMENT_PLATFORM, DEFAULT_ENVIRONMENT_TYPE, ENVIRONMENT_TYP
 import { executeLocalFunctionRun } from '../function-local-run.js';
 import { FUNCTION_LIST_TYPES, FUNCTION_RUNTIMES, functionEndpoint, functionResultEndpoint, functionResultLogEndpoint, functionRunEndpoint, functionsEndpoint, normalizeFunction, normalizeFunctionResultStatus, normalizeFunctionRunResult, normalizeFunctionsListPage, normalizeFunctionUpsertPayload, } from '../function-types.js';
 import { fetchJob, fetchJobs } from '../job-get.js';
+import { fetchPromotionQueue, removePromotionQueueItems } from '../promotion-queue.js';
 import { jobEndpoint, jobKillEndpoint, jobPauseEndpoint, jobResultFileContentEndpoint, jobResultFilesEndpoint, jobResultLogEndpoint, jobResumeEndpoint, jobRunEndpoint, normalizeJob, normalizeJobOperation, normalizeJobResultFileContent, normalizeJobResultFiles, resolveJobStepForLog, } from '../job-types.js';
 import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagination.js';
 import { COMPARISON_MODES, CONTENT_SOURCES, contentResultToCompareSide, createUnifiedDiff, INDEX_SOURCES, MODULE_TYPES, ORDER_DIRECTIONS, PLATFORM_EXPERIENCES, RETRIEVE_MODES, sourceSideLabel, } from '../metadata-common.js';
@@ -287,6 +289,12 @@ async function jobPause(args) {
     });
     return { result: normalizeJobOperation(result) };
 }
+async function promotionQueueList(args) {
+    return { queue: await fetchPromotionQueue(assertRequired(args.promotion, 'promotion')) };
+}
+async function promotionQueueRemove(args) {
+    return { queue: await removePromotionQueueItems(assertRequired(args.promotion, 'promotion'), args.itemIds) };
+}
 async function pipelineList(args = {}) {
     return mcpPaginatedListPayload('pipelines', await fetchPipelines(args));
 }
@@ -999,44 +1007,47 @@ async function metadataExplore(args) {
         output,
     };
 }
-async function metadataDependencyList(args) {
-    const selection = {
-        name: assertRequired(args.metadataName, 'metadataName'),
-        type: assertRequired(args.metadataType, 'metadataType'),
-    };
-    if (args.metadataCategory) {
-        selection.category = args.metadataCategory;
+function normalizeDependencyPathArg(path) {
+    if (path === undefined) {
+        return undefined;
     }
-    const body = {
-        compareOptions: {
-            sourceCredentialId: assertRequired(args.sourceCredentialId, 'sourceCredentialId'),
-            sourceOrgId: assertRequired(args.sourceOrgId, 'sourceOrgId'),
-        },
-        metadataSelections: [selection],
-        pipelineId: assertRequired(args.pipelineId, 'pipelineId'),
-    };
-    if (args.targetOrgId) {
-        body.compareOptions.targetOrgId = args.targetOrgId;
-    }
-    if (args.retrieveMode) {
-        body.compareOptions.retrieveMode = args.retrieveMode;
-    }
-    if (args.moduleType) {
-        body.moduleType = args.moduleType;
-    }
-    if (args.resultId) {
-        body.resultId = args.resultId;
+    const paths = (Array.isArray(path) ? path : [path]).map((entry) => entry.trim()).filter(Boolean);
+    return paths.length > 0 ? paths : undefined;
+}
+async function metadataDependencyList(args) {
+    const paths = normalizeDependencyPathArg(args.path);
+    if (paths && (args.metadataName || args.metadataType)) {
+        throw new Error('Use either path or metadataName/metadataType, not both.');
     }
-    const platformExperience = args.platformExperience ?? 'salesforce';
-    const result = await CicdGateway.call({
+    const { body, localPathsBySelection, platformExperience } = await buildDependencyRequest({
+        'base-ref': 'origin/main',
+        'from-changes': false,
+        'metadata-category': args.metadataCategory,
+        'metadata-name': args.metadataName,
+        'metadata-type': args.metadataType,
+        'module-type': args.moduleType,
+        path: paths,
+        'pipeline-id': args.pipelineId,
+        'platform-experience': args.platformExperience,
+        'result-id': args.resultId,
+        'retrieve-mode': args.retrieveMode,
+        'source-credential-id': args.sourceCredentialId,
+        'source-org-id': args.sourceOrgId,
+        stdin: false,
+        'target-org-id': args.targetOrgId,
+    });
+    const gatewayResult = await CicdGateway.call({
         body,
         endpoint: '/release/metadata/dependencies',
         headers: {
             'Content-Type': 'application/json',
-            'platform-experience': platformExperience,
+            ...(platformExperience === undefined ? {} : { 'platform-experience': platformExperience }),
         },
         method: 'POST',
     });
+    const result = localPathsBySelection
+        ? await enrichDependencyResult(gatewayResult, localPathsBySelection, args.moduleType)
+        : gatewayResult;
     return { result };
 }
 function authCredentialResult(type) {
@@ -1310,6 +1321,8 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     jobList,
     jobLogGet,
     jobPause,
+    promotionQueueList,
+    promotionQueueRemove,
     jobResultFileGet,
     jobResultFileList,
     jobResume,
@@ -1643,6 +1656,19 @@ export function registerAgentiaMcpTools(server) {
         },
         title: 'Agentia Job Pause',
     }, (args) => safelyHandleTool(() => jobPause(args)));
+    server.registerTool('agentia_promotion_queue_list', {
+        description: 'List the promotion queue for a Copado promotion via the CICD gateway.',
+        inputSchema: { promotion: z.string().describe('Copado promotion ID or name.') },
+        title: 'Agentia Promotion Queue List',
+    }, (args) => safelyHandleTool(() => promotionQueueList(args)));
+    server.registerTool('agentia_promotion_queue_remove', {
+        description: 'Remove items from a Copado promotion promotion queue via the CICD gateway (requires the Manage Queue permission).',
+        inputSchema: {
+            itemIds: z.array(z.string()).min(1).describe('Queue item IDs to remove (from agentia_promotion_queue_list).'),
+            promotion: z.string().describe('Copado promotion ID or name.'),
+        },
+        title: 'Agentia Promotion Queue Remove',
+    }, (args) => safelyHandleTool(() => promotionQueueRemove(args)));
     server.registerTool('agentia_pipeline_list', {
         description: 'List Copado pipelines via the CICD gateway.',
         inputSchema: {
@@ -1956,19 +1982,44 @@ export function registerAgentiaMcpTools(server) {
         title: 'Agentia Metadata Content Compare',
     }, (args) => safelyHandleTool(() => metadataContentCompare(args)));
     server.registerTool('agentia_metadata_dependency_list', {
-        description: 'Retrieve metadata dependencies.',
+        description: 'Retrieve metadata dependencies. Provide either path (one or more local Salesforce source files) or both metadataName and metadataType. pipelineId, sourceCredentialId, sourceOrgId, and platformExperience default from the active work item or project defaults when omitted; targetOrgId is never inferred.',
         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.'),
+            metadataName: z
+                .string()
+                .optional()
+                .describe('Metadata API name. Required with metadataType when path is omitted.'),
+            metadataType: z
+                .string()
+                .optional()
+                .describe('Metadata type, for example ApexClass. Required with metadataName when path is omitted.'),
             moduleType: z.enum(MODULE_TYPES).optional().describe('Optional addon module type.'),
-            pipelineId: z.string().describe('Pipeline Id.'),
-            platformExperience: z.enum(PLATFORM_EXPERIENCES).optional().describe('Platform experience header.'),
+            path: z
+                .union([z.string(), z.array(z.string())])
+                .optional()
+                .describe('Local Salesforce source file path(s) resolved into metadata selections. Mutually exclusive with metadataName/metadataType.'),
+            pipelineId: z
+                .string()
+                .optional()
+                .describe('Pipeline Id. Defaults to the active work item pipelineId or the project default pipeline.'),
+            platformExperience: z
+                .enum(PLATFORM_EXPERIENCES)
+                .optional()
+                .describe('Platform experience header. Defaults to the active work item platform, then sfdx.'),
             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.'),
-            sourceOrgId: z.string().describe('Source org Id.'),
-            targetOrgId: z.string().optional().describe('Optional target org Id.'),
+            sourceCredentialId: z
+                .string()
+                .optional()
+                .describe('Source org credential Id. Defaults to the active work item source credential or the project default credential.'),
+            sourceOrgId: z
+                .string()
+                .optional()
+                .describe('Source org Id. Defaults to the active work item sourceOrgId or orgId from the resolved credential/environment.'),
+            targetOrgId: z
+                .string()
+                .optional()
+                .describe('Optional target org Id. Not inferred from work item or project defaults.'),
         },
         title: 'Agentia Metadata Dependency List',
     }, (args) => safelyHandleTool(() => metadataDependencyList(args)));

package/dist/lib/promotion-queue.js

@@ -0,0 +1,5 @@
+import {modules} from './runtime.js';
+const fetchPromotionQueue = modules["promotion-queue.js"]["fetchPromotionQueue"]
+const formatPromotionQueueTable = modules["promotion-queue.js"]["formatPromotionQueueTable"]
+const removePromotionQueueItems = modules["promotion-queue.js"]["removePromotionQueueItems"]
+export {fetchPromotionQueue, formatPromotionQueueTable, removePromotionQueueItems};

package/dist/lib/promotion-run.js

@@ -1,4 +1,5 @@
 import {modules} from './runtime.js';
+const NoPromotionForUserStoryError = modules["promotion-run.js"]["NoPromotionForUserStoryError"]
 const PROMOTION_OPERATIONS = modules["promotion-run.js"]["PROMOTION_OPERATIONS"]
 const PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS = modules["promotion-run.js"]["PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS"]
 const PromotionRunIncompleteResponseError = modules["promotion-run.js"]["PromotionRunIncompleteResponseError"]
@@ -24,4 +25,4 @@ const requirePromotionId = modules["promotion-run.js"]["requirePromotionId"]
 const resetPromotionRunSleepForTests = modules["promotion-run.js"]["resetPromotionRunSleepForTests"]
 const resolvePromotionIdForWorkItem = modules["promotion-run.js"]["resolvePromotionIdForWorkItem"]
 const setPromotionRunSleepForTests = modules["promotion-run.js"]["setPromotionRunSleepForTests"]
-export {PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, PromotionRunIncompleteResponseError, PromotionRunJobFailedError, PromotionRunTimeoutError, PromotionRunValidationError, assertPromotionContextReady, formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionResume, performPromotionRun, promotionContextEndpoint, promotionDeploymentStepsEndpoint, promotionIgnoredMetadataEndpoint, promotionJobMonitorEndpoint, promotionResumeEndpoint, promotionRunDetailEndpoint, promotionRunEndpoint, promotionRunErrorJson, promotionValidateResolutionEndpoint, requirePromotionId, resetPromotionRunSleepForTests, resolvePromotionIdForWorkItem, setPromotionRunSleepForTests};
+export {NoPromotionForUserStoryError, PROMOTION_OPERATIONS, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, PromotionRunIncompleteResponseError, PromotionRunJobFailedError, PromotionRunTimeoutError, PromotionRunValidationError, assertPromotionContextReady, formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionResume, performPromotionRun, promotionContextEndpoint, promotionDeploymentStepsEndpoint, promotionIgnoredMetadataEndpoint, promotionJobMonitorEndpoint, promotionResumeEndpoint, promotionRunDetailEndpoint, promotionRunEndpoint, promotionRunErrorJson, promotionValidateResolutionEndpoint, requirePromotionId, resetPromotionRunSleepForTests, resolvePromotionIdForWorkItem, setPromotionRunSleepForTests};