@copado/agentia-cli 0.62.0-alpha.0 → 0.64.0-alpha.0

package/dist/lib/mcp/deployment-step-tools.js

@@ -0,0 +1,205 @@
+import { z } from 'zod';
+import { CicdGateway } from '../cicd-gateway.js';
+import { buildFriendlyDeploymentStepConfig, hasFriendlyDeploymentStepConfig, } from '../deployment-step-config.js';
+import { buildDeploymentStepCreatePayload, buildDeploymentStepUpdatePayload, DEPLOYMENT_STEP_STANDARD_TYPES, deploymentStepTypesEndpoint, normalizeDeploymentSteps, normalizeDeploymentStepTypes, userStoryDeploymentStepEndpoint, userStoryDeploymentStepOrderEndpoint, userStoryDeploymentStepsEndpoint, validateCompleteDeploymentStepOrder, } from '../deployment-step-types.js';
+import { resolveWorkItemId } from '../work-active.js';
+import { safelyHandleTool } from './result.js';
+async function deploymentStepTypes() {
+    const response = await CicdGateway.call({
+        endpoint: deploymentStepTypesEndpoint(),
+        method: 'GET',
+    });
+    return { deploymentStepTypes: normalizeDeploymentStepTypes(response) };
+}
+async function deploymentStepList(args = {}) {
+    const userStoryId = await resolveWorkItemId(args.userStoryId);
+    const response = await CicdGateway.call({
+        endpoint: userStoryDeploymentStepsEndpoint(userStoryId),
+        method: 'GET',
+    });
+    return { deploymentSteps: normalizeDeploymentSteps(response), userStoryId };
+}
+async function deploymentStepCreate(args) {
+    const userStoryId = await resolveWorkItemId(args.userStoryId);
+    const friendlyFlags = {
+        'apex-script': args.apexScript,
+        'assignee-id': args.assigneeId,
+        'assignee-name': args.assigneeName,
+        'crt-run-on': args.crtRunOn,
+        'crt-test-id': args.crtTestId,
+        'data-set-id': args.dataSetId,
+        'data-template-id': args.dataTemplateId,
+        environment: args.environment,
+        'flow-name': args.flowName,
+        'function-name': args.functionName,
+        instructions: args.instructions,
+        parameter: args.parameters?.map(({ name, value }) => `${name}=${value}`),
+    };
+    const friendly = hasFriendlyDeploymentStepConfig(friendlyFlags);
+    if (friendly && args.configJson !== undefined) {
+        throw new Error('Type-specific configuration fields cannot be combined with configJson.');
+    }
+    if (friendly && args.type === undefined) {
+        throw new Error('Type-specific configuration fields require type.');
+    }
+    const configJson = friendly && args.type !== undefined
+        ? buildFriendlyDeploymentStepConfig(args.type, friendlyFlags)
+        : args.configJson;
+    if (configJson === undefined) {
+        throw new Error('Provide configJson or the type-specific configuration fields.');
+    }
+    const body = buildDeploymentStepCreatePayload({
+        ...(args.customStepApiName === undefined ? {} : { 'custom-step-api-name': args.customStepApiName }),
+        'config-json': JSON.stringify(configJson),
+        name: args.name,
+        ...(args.queueName === undefined ? {} : { 'queue-name': args.queueName }),
+        ...(args.runOnValidation === undefined ? {} : { 'run-on-validation': args.runOnValidation }),
+        ...(args.sequence === undefined ? {} : { sequence: args.sequence }),
+        ...(args.skipBackPromotion === undefined ? {} : { 'skip-back-promotion': args.skipBackPromotion }),
+        ...(args.skipCondition === undefined ? {} : { 'skip-condition': args.skipCondition }),
+        ...(args.type === undefined ? {} : { type: args.type }),
+    });
+    const deploymentStep = await CicdGateway.call({
+        body,
+        endpoint: userStoryDeploymentStepsEndpoint(userStoryId),
+        headers: { 'Content-Type': 'application/json' },
+        method: 'POST',
+    });
+    return { deploymentStep, userStoryId };
+}
+async function deploymentStepUpdate(args) {
+    const userStoryId = await resolveWorkItemId(args.userStoryId);
+    const body = buildDeploymentStepUpdatePayload({
+        ...(args.configJson === undefined ? {} : { 'config-json': JSON.stringify(args.configJson) }),
+        ...(args.name === undefined ? {} : { name: args.name }),
+        ...(args.queueName === null
+            ? { 'clear-queue-name': true }
+            : args.queueName === undefined
+                ? {}
+                : { 'queue-name': args.queueName }),
+        ...(args.runOnValidation === undefined ? {} : { 'run-on-validation': args.runOnValidation }),
+        ...(args.skipBackPromotion === undefined ? {} : { 'skip-back-promotion': args.skipBackPromotion }),
+        ...(args.skipCondition === null
+            ? { 'clear-skip-condition': true }
+            : args.skipCondition === undefined
+                ? {}
+                : { 'skip-condition': args.skipCondition }),
+    });
+    const deploymentStep = await CicdGateway.call({
+        body,
+        endpoint: userStoryDeploymentStepEndpoint(userStoryId, args.stepId),
+        headers: { 'Content-Type': 'application/json' },
+        method: 'PATCH',
+    });
+    return { deploymentStep, userStoryId };
+}
+async function deploymentStepReorder(args) {
+    const userStoryId = await resolveWorkItemId(args.userStoryId);
+    const currentResponse = await CicdGateway.call({
+        endpoint: userStoryDeploymentStepsEndpoint(userStoryId),
+        method: 'GET',
+    });
+    const current = normalizeDeploymentSteps(currentResponse);
+    const order = { after: args.after, before: args.before };
+    validateCompleteDeploymentStepOrder(order, current);
+    const response = await CicdGateway.call({
+        body: order,
+        endpoint: userStoryDeploymentStepOrderEndpoint(userStoryId),
+        headers: { 'Content-Type': 'application/json' },
+        method: 'PUT',
+    });
+    return { deploymentSteps: normalizeDeploymentSteps(response), userStoryId };
+}
+async function deploymentStepDelete(args) {
+    const userStoryId = await resolveWorkItemId(args.userStoryId);
+    await CicdGateway.call({
+        endpoint: userStoryDeploymentStepEndpoint(userStoryId, args.stepId),
+        method: 'DELETE',
+    });
+    return { deleted: true, stepId: args.stepId, userStoryId };
+}
+export const agentiaMcpDeploymentStepToolHandlers = {
+    deploymentStepCreate,
+    deploymentStepDelete,
+    deploymentStepList,
+    deploymentStepReorder,
+    deploymentStepTypes,
+    deploymentStepUpdate,
+};
+const userStoryIdSchema = z.string().optional().describe('User story ID. Defaults to the active work item.');
+const configJsonSchema = z.record(z.string(), z.unknown()).describe('Resolved inner ConfigJson object.');
+export function registerAgentiaMcpDeploymentStepTools(server) {
+    server.registerTool('agentia_work_deployment_step_types', {
+        description: 'List standard and custom metadata-backed deployment-step types.',
+        inputSchema: {},
+        title: 'Agentia Work Deployment Step Types',
+    }, () => safelyHandleTool(() => deploymentStepTypes()));
+    server.registerTool('agentia_work_deployment_step_list', {
+        description: 'List persisted deployment steps for an explicit or active user story.',
+        inputSchema: { userStoryId: userStoryIdSchema },
+        title: 'Agentia Work Deployment Step List',
+    }, (args) => safelyHandleTool(() => deploymentStepList(args || {})));
+    server.registerTool('agentia_work_deployment_step_create', {
+        description: 'Create a standard or custom metadata-backed deployment step on a user story.',
+        inputSchema: {
+            apexScript: z.string().optional().describe('Apex script for an Apex step.'),
+            assigneeId: z.string().optional().describe('Manual Task assignee Salesforce user ID.'),
+            assigneeName: z.string().optional().describe('Manual Task assignee display name.'),
+            configJson: configJsonSchema.optional().describe('Resolved expert ConfigJson object.'),
+            crtRunOn: z.enum(['source', 'destination']).optional().describe('Environment where the Robotic Test runs.'),
+            crtTestId: z.string().optional().describe('Robotic Test Salesforce ID.'),
+            customStepApiName: z.string().optional().describe('Custom metadata developerName. Mutually exclusive with type.'),
+            dataSetId: z.string().optional().describe('Salesforce Data Set ID.'),
+            dataTemplateId: z.string().optional().describe('Salesforce Data Template ID.'),
+            environment: z.enum(['source', 'destination', 'both']).optional().describe('Manual Task environment.'),
+            flowName: z.string().optional().describe('Salesforce Flow API name.'),
+            functionName: z.string().optional().describe('Function name.'),
+            instructions: z.string().optional().describe('Manual Task instructions.'),
+            name: z.string().describe('Step name, up to 80 characters.'),
+            parameters: z
+                .array(z.object({ name: z.string(), value: z.string() }))
+                .optional()
+                .describe('Flow or Function parameters.'),
+            queueName: z.string().optional(),
+            runOnValidation: z.boolean().optional(),
+            sequence: z.enum(['before', 'after']).optional(),
+            skipBackPromotion: z.boolean().optional(),
+            skipCondition: z.string().optional(),
+            type: z.enum(DEPLOYMENT_STEP_STANDARD_TYPES).optional().describe('Standard deployment-step type.'),
+            userStoryId: userStoryIdSchema,
+        },
+        title: 'Agentia Work Deployment Step Create',
+    }, (args) => safelyHandleTool(() => deploymentStepCreate(args)));
+    server.registerTool('agentia_work_deployment_step_update', {
+        description: 'Partially update a persisted deployment step. Null clears queueName or skipCondition.',
+        inputSchema: {
+            configJson: configJsonSchema.optional(),
+            name: z.string().optional(),
+            queueName: z.string().nullable().optional(),
+            runOnValidation: z.boolean().optional(),
+            skipBackPromotion: z.boolean().optional(),
+            skipCondition: z.string().nullable().optional(),
+            stepId: z.string().describe('Deployment-step ID.'),
+            userStoryId: userStoryIdSchema,
+        },
+        title: 'Agentia Work Deployment Step Update',
+    }, (args) => safelyHandleTool(() => deploymentStepUpdate(args)));
+    server.registerTool('agentia_work_deployment_step_reorder', {
+        description: 'Replace the complete before/after deployment-step order for a user story.',
+        inputSchema: {
+            after: z.array(z.string()).describe('Complete ordered after-step IDs.'),
+            before: z.array(z.string()).describe('Complete ordered before-step IDs.'),
+            userStoryId: userStoryIdSchema,
+        },
+        title: 'Agentia Work Deployment Step Reorder',
+    }, (args) => safelyHandleTool(() => deploymentStepReorder(args)));
+    server.registerTool('agentia_work_deployment_step_delete', {
+        description: 'Delete a persisted deployment step owned by a user story.',
+        inputSchema: {
+            stepId: z.string().describe('Deployment-step ID.'),
+            userStoryId: userStoryIdSchema,
+        },
+        title: 'Agentia Work Deployment Step Delete',
+    }, (args) => safelyHandleTool(() => deploymentStepDelete(args)));
+}
+//# sourceMappingURL=deployment-step-tools.js.map

package/dist/lib/mcp/deployment-step-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-step-tools.js","sourceRoot":"","sources":["../../../src/lib/mcp/deployment-step-tools.ts"],"names":[],"mappings":"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"}

package/dist/lib/mcp/result.d.ts

@@ -1,3 +1,5 @@
+export declare function mcpToolNameFromHandler(handlerName: string): string;
+export declare function wrapMcpToolHandlers<T extends Record<string, (...args: never[]) => Promise<unknown>>>(handlers: T): T;
 export declare function toolResult(data: Record<string, unknown>): {
     content: {
         text: string;

package/dist/lib/mcp/result.js

@@ -1,4 +1,14 @@
+import { createTransactionId, runWithGatewayTransactionContext } from '../cicd-gateway.js';
 import { redactErrorMessage, redactSecrets } from './redaction.js';
+export function mcpToolNameFromHandler(handlerName) {
+    return `agentia_${handlerName.replaceAll(/[A-Z]/gu, (letter) => `_${letter.toLowerCase()}`)}`;
+}
+export function wrapMcpToolHandlers(handlers) {
+    return Object.fromEntries(Object.entries(handlers).map(([name, handler]) => [
+        name,
+        (...args) => runWithGatewayTransactionContext({ referer: mcpToolNameFromHandler(name), transactionId: createTransactionId() }, () => handler(...args)),
+    ]));
+}
 export function toolResult(data) {
     const redacted = redactSecrets(data);
     return {

package/dist/lib/mcp/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/mcp/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AAEhE,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,UAAU,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAC,CAAC;YACnF,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;YAClC,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAC,CAAC;SACxE;KACF,CAAA;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA+C;IACpF,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/lib/mcp/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAE,gCAAgC,EAAC,MAAM,oBAAoB,CAAA;AACxF,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,gBAAgB,CAAA;AAEhE,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,WAAW,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAA;AAC/F,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAmE,QAAW;IAC/G,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QAChD,IAAI;QACJ,CAAC,GAAG,IAAa,EAAE,EAAE,CACnB,gCAAgC,CAC9B,EAAC,OAAO,EAAE,sBAAsB,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,mBAAmB,EAAE,EAAC,EAC7E,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CACvB;KACJ,CAAC,CACE,CAAA;AACR,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAA6B;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAEpC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,UAAU,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/F,MAAM,OAAO,GAAG;QACd,KAAK,EAAE;YACL,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,UAAU,EAAE,UAAU,CAAC,UAAU,EAAC,CAAC;YACnF,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;YAClC,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAC,CAAC;SACxE;KACF,CAAA;IACD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAEvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAe;aACtB;SACF;QACD,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA+C;IACpF,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/lib/mcp/server.js

@@ -1,6 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createRequire } from 'node:module';
+import { createTransactionId, runWithGatewayTransactionContext } from '../cicd-gateway.js';
 import { registerAgentiaMcpTools } from './tools.js';
 const require = createRequire(import.meta.url);
 const packageJson = require('../../../package.json');
@@ -9,9 +10,14 @@ export function createAgentiaMcpServer() {
         name: packageJson.name ?? 'agentia-cli',
         version: packageJson.version,
     });
+    wrapMcpToolRegistration(server);
     registerAgentiaMcpTools(server);
     return server;
 }
+function wrapMcpToolRegistration(server) {
+    const registerTool = server.registerTool.bind(server);
+    server.registerTool = ((name, config, handler) => registerTool(name, config, (...args) => runWithGatewayTransactionContext({ referer: name, transactionId: createTransactionId() }, async () => handler(...args))));
+}
 export async function startAgentiaMcpServer(transport = new StdioServerTransport()) {
     const server = createAgentiaMcpServer();
     await server.connect(transport);

package/dist/lib/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/lib/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAA;AACjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAA;AAC9E,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAA;AAElD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAqC,CAAA;AAExF,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,aAAa;QACvC,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC,CAAA;IAEF,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE;IAChF,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAA;IACvC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,KAAK,GAAI,MAAkE,CAAC,gBAAgB,CAAA;IAClG,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACxC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/lib/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAA;AACjE,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAA;AAC9E,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAC,mBAAmB,EAAE,gCAAgC,EAAC,MAAM,oBAAoB,CAAA;AACxF,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAA;AAElD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAqC,CAAA;AAExF,MAAM,UAAU,sBAAsB;IACpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,aAAa;QACvC,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC,CAAA;IAEF,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAiB;IAChD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAIxC,CAAA;IAEZ,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,IAAY,EAAE,MAAe,EAAE,OAAsC,EAAE,EAAE,CAC/F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAa,EAAE,EAAE,CAC9C,gCAAgC,CAC9B,EAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,mBAAmB,EAAE,EAAC,EACrD,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAC7B,CACF,CAA+B,CAAA;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE;IAChF,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAA;IACvC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,KAAK,GAAI,MAAkE,CAAC,gBAAgB,CAAA;IAClG,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACxC,CAAC"}

package/dist/lib/mcp/tools.d.ts

@@ -113,6 +113,8 @@ type RepositoryUpdateArgs = RepositoryMutationArgs & {
 };
 type MetadataListArgs = {
     avoidSourceTracking?: boolean;
+    changeDateFrom?: string;
+    changeDateTo?: string;
     filterType?: string;
     findManagedPackages?: boolean;
     limit?: number;
@@ -1107,6 +1109,69 @@ export declare const agentiaMcpToolHandlers: {
     repositoryValidate: typeof repositoryValidate;
     userGet: typeof userGet;
     workStatus: typeof workStatus;
+    deploymentStepCreate: (args: {
+        apexScript?: string;
+        assigneeId?: string;
+        assigneeName?: string;
+        configJson?: Record<string, unknown>;
+        crtRunOn?: import("../deployment-step-config.js").CrtRunOn;
+        crtTestId?: string;
+        customStepApiName?: string;
+        dataSetId?: string;
+        dataTemplateId?: string;
+        environment?: import("../deployment-step-config.js").DeploymentStepEnvironment;
+        flowName?: string;
+        functionName?: string;
+        instructions?: string;
+        name: string;
+        parameters?: import("../deployment-step-config.js").DeploymentStepParameter[];
+        queueName?: string;
+        runOnValidation?: boolean;
+        sequence?: import("../deployment-step-types.js").DeploymentStepSequence;
+        skipBackPromotion?: boolean;
+        skipCondition?: string;
+        type?: import("../deployment-step-types.js").DeploymentStepStandardType;
+        userStoryId?: string;
+    }) => Promise<{
+        deploymentStep: import("../deployment-step-types.js").DeploymentStep;
+        userStoryId: string;
+    }>;
+    deploymentStepDelete: (args: {
+        stepId: string;
+        userStoryId?: string;
+    }) => Promise<{
+        deleted: boolean;
+        stepId: string;
+        userStoryId: string;
+    }>;
+    deploymentStepList: (args?: {
+        userStoryId?: string;
+    }) => Promise<{
+        deploymentSteps: import("../deployment-step-types.js").DeploymentStep[];
+        userStoryId: string;
+    }>;
+    deploymentStepReorder: (args: import("../deployment-step-types.js").DeploymentStepOrder & {
+        userStoryId?: string;
+    }) => Promise<{
+        deploymentSteps: import("../deployment-step-types.js").DeploymentStep[];
+        userStoryId: string;
+    }>;
+    deploymentStepTypes: () => Promise<{
+        deploymentStepTypes: import("../deployment-step-types.js").DeploymentStepType[];
+    }>;
+    deploymentStepUpdate: (args: {
+        configJson?: Record<string, unknown>;
+        name?: string;
+        queueName?: null | string;
+        runOnValidation?: boolean;
+        skipBackPromotion?: boolean;
+        skipCondition?: null | string;
+        stepId: string;
+        userStoryId?: string;
+    }) => Promise<{
+        deploymentStep: import("../deployment-step-types.js").DeploymentStep;
+        userStoryId: string;
+    }>;
     dataCommitCreate: (args: import("../data-types.js").DataCommitApiRequest) => Promise<{
         result: import("../data-types.js").DataCommitResponse;
     }>;

package/dist/lib/mcp/tools.js

@@ -12,7 +12,7 @@ import { CICD_REGIONS } from '../cicd-region.js';
 import { ALL_CREDENTIAL_TYPES, credentialLabel, getCicdBaseUrl, getCredential, maskSecret, } from '../credential-store.js';
 import { readDefaults, readLastWorkItem, resolveDefaults, unsetDefaults, writeDefaults } from '../defaults-store.js';
 import { runEnvironmentAuthStatus } from '../environment-auth-status.js';
-import { collectCredentialUpdateFlagKeys, validateCredentialName, } from '../environment-credential-flags.js';
+import { collectCredentialUpdateFlagKeys, validateCredentialName } from '../environment-credential-flags.js';
 import { createEnvironmentCredential, resolveEnvironmentOrgType, updateEnvironmentCredential, } from '../environment-credential-operations.js';
 import { buildCreatePayload, buildMutationPayload, ENVIRONMENT_STRING_VALIDATION_KEYS, validateNonEmptyStringFields, } from '../environment-flags.js';
 import { DEFAULT_ENVIRONMENT_PLATFORM, DEFAULT_ENVIRONMENT_TYPE, ENVIRONMENT_TYPES, environmentEndpoint, environmentsListEndpoint, } from '../environment-types.js';
@@ -38,7 +38,8 @@ import { DEFAULT_USER_ID, resolveUserId, userEndpoint } from '../user-types.js';
 import { workStatusEndpoint } from '../work-types.js';
 import { agentiaMcpAiToolHandlers, registerAgentiaMcpAiTools } from './ai-tools.js';
 import { agentiaMcpDataToolHandlers, registerAgentiaMcpDataTools } from './data-tools.js';
-import { safelyHandleTool } from './result.js';
+import { agentiaMcpDeploymentStepToolHandlers, registerAgentiaMcpDeploymentStepTools } from './deployment-step-tools.js';
+import { safelyHandleTool, wrapMcpToolHandlers } from './result.js';
 import { agentiaMcpTestingToolHandlers, registerAgentiaMcpTestingTools } from './testing-tools.js';
 import { agentiaMcpWorkToolHandlers, registerAgentiaMcpWorkTools } from './work-tools.js';
 const MAX_LIMIT = 2000;
@@ -486,9 +487,7 @@ async function functionResultLogGet(args) {
     };
 }
 async function functionRunLocal(args) {
-    const parameter = args.parameters === undefined
-        ? undefined
-        : Object.entries(args.parameters).map(([key, value]) => `${key}=${value}`);
+    const parameter = args.parameters === undefined ? undefined : Object.entries(args.parameters).map(([key, value]) => `${key}=${value}`);
     return executeLocalFunctionRun({
         cwd: args.cwd,
         image: args.image,
@@ -587,6 +586,8 @@ async function metadataList(args) {
     const platformExperience = args.platformExperience ?? 'salesforce';
     const body = buildMetadataIndexRequest({
         'avoid-source-tracking': Boolean(args.avoidSourceTracking),
+        'change-date-from': args.changeDateFrom,
+        'change-date-to': args.changeDateTo,
         'filter-type': args.filterType,
         'find-managed-packages': Boolean(args.findManagedPackages),
         limit: args.limit,
@@ -883,9 +884,10 @@ async function navigationResolve(args) {
         resourceType: args.resourceType,
     });
 }
-export const agentiaMcpToolHandlers = {
+export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     ...agentiaMcpAiToolHandlers,
     ...agentiaMcpDataToolHandlers,
+    ...agentiaMcpDeploymentStepToolHandlers,
     authGet,
     authSet,
     credentialCreate,
@@ -946,7 +948,7 @@ export const agentiaMcpToolHandlers = {
     workStatus,
     ...agentiaMcpTestingToolHandlers,
     ...agentiaMcpWorkToolHandlers,
-};
+});
 const environmentMutationSchema = {
     apexTestLevel: z.string().optional().describe('Apex test level.'),
     enableRollback: z.boolean().optional().describe('Enable rollback.'),
@@ -1005,6 +1007,7 @@ const promotionListSchema = {
 export function registerAgentiaMcpTools(server) {
     registerAgentiaMcpAiTools(server);
     registerAgentiaMcpDataTools(server);
+    registerAgentiaMcpDeploymentStepTools(server);
     registerAgentiaMcpTestingTools(server);
     server.registerTool('agentia_environment_list', {
         description: 'List Copado environments via the CICD gateway.',
@@ -1083,14 +1086,20 @@ export function registerAgentiaMcpTools(server) {
                 .array(z.string())
                 .optional()
                 .describe('Ordered deployment-step Salesforce IDs. The gateway order is used when omitted.'),
-            ignoredMetadata: z.array(z.unknown()).optional().describe('Ignored metadata persisted before starting the run.'),
+            ignoredMetadata: z
+                .array(z.unknown())
+                .optional()
+                .describe('Ignored metadata persisted before starting the run.'),
             operation: z
                 .enum(PROMOTION_OPERATIONS)
                 .optional()
                 .describe('Promotion operation. Required unless resumeJobExecutionId is supplied.'),
             promotionId: z.string().describe('18-character Salesforce Promotion ID.'),
             recreatePromotionBranch: z.boolean().optional().describe('Recreate the promotion branch before execution.'),
-            resumeJobExecutionId: z.string().optional().describe('Resume this existing promotion execution instead of /run.'),
+            resumeJobExecutionId: z
+                .string()
+                .optional()
+                .describe('Resume this existing promotion execution instead of /run.'),
             wait: z.boolean().optional().describe('Poll all created executions to terminal status. Defaults to true.'),
             waitTimeout: z
                 .number()
@@ -1229,6 +1238,11 @@ export function registerAgentiaMcpTools(server) {
                 .boolean()
                 .optional()
                 .describe('Pass avoidSourceTracking=true to the gateway index route.'),
+            changeDateFrom: z
+                .string()
+                .optional()
+                .describe('Optional change-date-from filter (ISO datetime).'),
+            changeDateTo: z.string().optional().describe('Optional change-date-to filter (ISO datetime).'),
             filterType: z.string().optional().describe('Optional metadata type name filter, for example ApexClass.'),
             findManagedPackages: z.boolean().optional().describe('Include managed package metadata in the search.'),
             limit: z.number().int().min(1).max(MAX_LIMIT).optional().describe('Maximum number of records to return.'),