@copado/agentia-cli 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/lib/local-quality-gates.js

@@ -1,13 +1,16 @@
 import {modules} from './runtime.js';
+const AGENTIA_APEX_RERUN_FAILED_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_ENV"]
+const AGENTIA_APEX_RERUN_FAILED_FLAG = modules["local-quality-gates.js"]["AGENTIA_APEX_RERUN_FAILED_FLAG"]
 const AGENTIA_APEX_TEST_CLASSES_ENV = modules["local-quality-gates.js"]["AGENTIA_APEX_TEST_CLASSES_ENV"]
 const LocalQualityGatesError = modules["local-quality-gates.js"]["LocalQualityGatesError"]
 const QUALITY_GATES_SCRIPT_UNIX = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_UNIX"]
 const QUALITY_GATES_SCRIPT_WINDOWS = modules["local-quality-gates.js"]["QUALITY_GATES_SCRIPT_WINDOWS"]
 const buildQualityGatesCommand = modules["local-quality-gates.js"]["buildQualityGatesCommand"]
+const parseQualityGatesEnvAssignments = modules["local-quality-gates.js"]["parseQualityGatesEnvAssignments"]
 const qualityGatesScriptName = modules["local-quality-gates.js"]["qualityGatesScriptName"]
 const resetLocalQualityGatesForTests = modules["local-quality-gates.js"]["resetLocalQualityGatesForTests"]
 const resolveLocalQualityGatesScript = modules["local-quality-gates.js"]["resolveLocalQualityGatesScript"]
 const runLocalQualityGates = modules["local-quality-gates.js"]["runLocalQualityGates"]
 const setLocalQualityGatesExistsSyncForTests = modules["local-quality-gates.js"]["setLocalQualityGatesExistsSyncForTests"]
 const setLocalQualityGatesSpawnForTests = modules["local-quality-gates.js"]["setLocalQualityGatesSpawnForTests"]
-export {AGENTIA_APEX_TEST_CLASSES_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};
+export {AGENTIA_APEX_RERUN_FAILED_ENV, AGENTIA_APEX_RERUN_FAILED_FLAG, AGENTIA_APEX_TEST_CLASSES_ENV, LocalQualityGatesError, QUALITY_GATES_SCRIPT_UNIX, QUALITY_GATES_SCRIPT_WINDOWS, buildQualityGatesCommand, parseQualityGatesEnvAssignments, qualityGatesScriptName, resetLocalQualityGatesForTests, resolveLocalQualityGatesScript, runLocalQualityGates, setLocalQualityGatesExistsSyncForTests, setLocalQualityGatesSpawnForTests};

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

@@ -0,0 +1,221 @@
+import { z } from 'zod';
+import { addAdvComponents, cancelAdvDeployment, createAdvDeployment, getAdvAuthStatus, getAdvDeployment, getAdvJob, getAdvOrganization, listAdvComponents, listAdvComponentTypes, listAdvDeployments, listAdvJobs, listAdvOrganizations, parseAdvComponentSpec, refreshAdvComponents, removeAdvComponents, runAdvDeploymentAction, selectedAdvComponents, updateAdvDeploymentOptions, validateAdvOrganization, waitForAdvJob, } from '../adv-operations.js';
+import { safelyHandleTool } from './result.js';
+const componentReferenceSchema = z.union([
+    z.string().min(1).describe('Component in Type/Name format.'),
+    z.object({
+        excluded: z.boolean().optional().describe('Whether the component is excluded from deployment.'),
+        fullName: z.string().min(1).describe('Component full name.'),
+        type: z.string().min(1).describe('Metadata type name.'),
+    }),
+]);
+const componentInputSchema = z.array(componentReferenceSchema).min(1).describe('Components as Type/Name strings or {type, fullName, excluded} objects.');
+function componentList(components) {
+    return components.map((component) => {
+        if (typeof component === 'string')
+            return parseAdvComponentSpec(component);
+        return component;
+    });
+}
+function componentAddMode(components) {
+    return components.some((component) => typeof component !== 'string') ? 'json' : 'import';
+}
+function requireConfirm(confirm, action) {
+    if (confirm !== true)
+        throw new Error(`${action} requires confirm: true.`);
+}
+async function deploymentAction(args) {
+    if (args.kind !== 'validate')
+        requireConfirm(args.confirm, 'Pipelines Advanced deployment action');
+    return {
+        result: await runAdvDeploymentAction({
+            backup: args.backup,
+            id: args.id,
+            kind: args.kind,
+            wait: args.wait,
+            waitIntervalSeconds: args.interval,
+            waitTimeoutSeconds: args.timeout,
+        }),
+    };
+}
+export function registerAgentiaMcpAdvTools(server) {
+    server.registerTool('agentia_adv_auth_status', {
+        description: 'Check the configured Copado Pipelines Advanced PAT.',
+        inputSchema: {},
+        title: 'Agentia ADV Auth Status',
+    }, () => safelyHandleTool(async () => ({ result: await getAdvAuthStatus() })));
+    server.registerTool('agentia_adv_organization_list', {
+        description: 'List Copado Pipelines Advanced organizations visible to the PAT user.',
+        inputSchema: {},
+        title: 'Agentia ADV Organization List',
+    }, () => safelyHandleTool(async () => ({ result: await listAdvOrganizations() })));
+    server.registerTool('agentia_adv_organization_get', {
+        description: 'Get one Copado Pipelines Advanced organization.',
+        inputSchema: { id: z.number().int().positive().describe('Organization ID.') },
+        title: 'Agentia ADV Organization Get',
+    }, (args) => safelyHandleTool(async () => ({ result: await getAdvOrganization(args.id) })));
+    server.registerTool('agentia_adv_organization_validate', {
+        description: 'Validate Copado Pipelines Advanced connectivity to an organization.',
+        inputSchema: { id: z.number().int().positive().describe('Organization ID.') },
+        title: 'Agentia ADV Organization Validate',
+    }, (args) => safelyHandleTool(async () => ({ result: await validateAdvOrganization(args.id) })));
+    server.registerTool('agentia_adv_deployment_list', {
+        description: 'List Copado Pipelines Advanced deployments.',
+        inputSchema: { includeArchived: z.boolean().optional().describe('Include archived deployments.') },
+        title: 'Agentia ADV Deployment List',
+    }, (args) => safelyHandleTool(async () => ({ result: await listAdvDeployments({ includeArchived: args.includeArchived }) })));
+    server.registerTool('agentia_adv_deployment_get', {
+        description: 'Get one Copado Pipelines Advanced deployment.',
+        inputSchema: { id: z.number().int().positive().describe('Deployment ID.') },
+        title: 'Agentia ADV Deployment Get',
+    }, (args) => safelyHandleTool(async () => ({ result: await getAdvDeployment(args.id) })));
+    server.registerTool('agentia_adv_deployment_create', {
+        description: 'Create a Copado Pipelines Advanced deployment.',
+        inputSchema: {
+            name: z.string().min(1).describe('Deployment name.'),
+            sourceOrg: z.number().int().positive().describe('Source organization ID.'),
+            targetOrg: z.number().int().positive().describe('Target organization ID.'),
+        },
+        title: 'Agentia ADV Deployment Create',
+    }, (args) => safelyHandleTool(async () => ({ result: await createAdvDeployment(args) })));
+    server.registerTool('agentia_adv_deployment_options', {
+        description: 'Update Copado Pipelines Advanced deployment options.',
+        inputSchema: {
+            id: z.number().int().positive().describe('Deployment ID.'),
+            set: z.array(z.string()).optional().describe('Options as name=value entries.'),
+        },
+        title: 'Agentia ADV Deployment Options',
+    }, (args) => safelyHandleTool(async () => ({ result: await updateAdvDeploymentOptions({ id: args.id, set: args.set }) })));
+    server.registerTool('agentia_adv_deployment_validate', {
+        description: 'Start a check-only Copado Pipelines Advanced validation run.',
+        inputSchema: {
+            id: z.number().int().positive().describe('Deployment ID.'),
+            interval: z.number().positive().optional().describe('Seconds between polls when wait is true.'),
+            timeout: z.number().positive().optional().describe('Maximum seconds to wait.'),
+            wait: z.boolean().optional().describe('Wait for the run to finish.'),
+        },
+        title: 'Agentia ADV Deployment Validate',
+    }, (args) => safelyHandleTool(() => deploymentAction({ ...args, kind: 'validate' })));
+    server.registerTool('agentia_adv_deployment_deploy', {
+        description: 'Start a real Copado Pipelines Advanced deployment run.',
+        inputSchema: {
+            confirm: z.boolean().optional().describe('Required true to start a deployment.'),
+            id: z.number().int().positive().describe('Deployment ID.'),
+            interval: z.number().positive().optional().describe('Seconds between polls when wait is true.'),
+            timeout: z.number().positive().optional().describe('Maximum seconds to wait.'),
+            wait: z.boolean().optional().describe('Wait for the run to finish.'),
+        },
+        title: 'Agentia ADV Deployment Deploy',
+    }, (args) => safelyHandleTool(() => deploymentAction({ ...args, kind: 'deploy' })));
+    server.registerTool('agentia_adv_deployment_quick_deploy', {
+        description: 'Start a Copado Pipelines Advanced quick deploy run.',
+        inputSchema: {
+            backup: z.boolean().optional().describe('Request backup before deploying.'),
+            confirm: z.boolean().optional().describe('Required true to start a quick deploy.'),
+            id: z.number().int().positive().describe('Deployment ID.'),
+            interval: z.number().positive().optional().describe('Seconds between polls when wait is true.'),
+            timeout: z.number().positive().optional().describe('Maximum seconds to wait.'),
+            wait: z.boolean().optional().describe('Wait for the run to finish.'),
+        },
+        title: 'Agentia ADV Deployment Quick Deploy',
+    }, (args) => safelyHandleTool(() => deploymentAction({ ...args, kind: 'quick-deploy' })));
+    server.registerTool('agentia_adv_deployment_cancel', {
+        description: 'Cancel the current Copado Pipelines Advanced run.',
+        inputSchema: {
+            confirm: z.boolean().optional().describe('Required true to request cancellation.'),
+            id: z.number().int().positive().describe('Deployment ID.'),
+            interval: z.number().positive().optional().describe('Seconds between polls when wait is true.'),
+            timeout: z.number().positive().optional().describe('Maximum seconds to wait.'),
+            wait: z.boolean().optional().describe('Wait for the run to finish.'),
+        },
+        title: 'Agentia ADV Deployment Cancel',
+    }, (args) => safelyHandleTool(async () => {
+        requireConfirm(args.confirm, 'Pipelines Advanced deployment cancellation');
+        return {
+            result: await cancelAdvDeployment({
+                id: args.id,
+                wait: args.wait,
+                waitIntervalSeconds: args.interval,
+                waitTimeoutSeconds: args.timeout,
+            }),
+        };
+    }));
+    server.registerTool('agentia_adv_component_types', {
+        description: 'List Copado Pipelines Advanced component type views.',
+        inputSchema: {},
+        title: 'Agentia ADV Component Types',
+    }, () => safelyHandleTool(async () => ({ result: await listAdvComponentTypes() })));
+    server.registerTool('agentia_adv_component_list', {
+        description: 'List source components for a Copado Pipelines Advanced deployment.',
+        inputSchema: {
+            flow: z.number().int().positive().describe('Deployment ID.'),
+            includeManagedPackage: z.boolean().optional().describe('Include managed package components.'),
+            type: z.string().describe('Comma-separated component type names.'),
+        },
+        title: 'Agentia ADV Component List',
+    }, (args) => safelyHandleTool(async () => ({ result: await listAdvComponents(args) })));
+    server.registerTool('agentia_adv_component_refresh', {
+        description: 'Refresh Copado Pipelines Advanced component comparison cache.',
+        inputSchema: {
+            flow: z.number().int().positive().describe('Deployment ID.'),
+            full: z.boolean().optional().describe('Delete cached comparison data before refreshing.'),
+            type: z.string().describe('Comma-separated component type names.'),
+        },
+        title: 'Agentia ADV Component Refresh',
+    }, (args) => safelyHandleTool(async () => ({ result: await refreshAdvComponents(args) })));
+    server.registerTool('agentia_adv_component_selected', {
+        description: 'List selected components for a Copado Pipelines Advanced deployment.',
+        inputSchema: { deploymentId: z.number().int().positive().describe('Deployment ID.') },
+        title: 'Agentia ADV Component Selected',
+    }, (args) => safelyHandleTool(async () => ({ result: await selectedAdvComponents(args.deploymentId) })));
+    server.registerTool('agentia_adv_component_add', {
+        description: 'Add components to a Copado Pipelines Advanced deployment selection.',
+        inputSchema: {
+            components: componentInputSchema,
+            deploymentId: z.number().int().positive().describe('Deployment ID.'),
+        },
+        title: 'Agentia ADV Component Add',
+    }, (args) => safelyHandleTool(async () => ({
+        result: await addAdvComponents({
+            components: componentList(args.components),
+            deploymentId: args.deploymentId,
+            mode: componentAddMode(args.components),
+        }),
+    })));
+    server.registerTool('agentia_adv_component_remove', {
+        description: 'Remove components from a Copado Pipelines Advanced deployment selection.',
+        inputSchema: {
+            components: componentInputSchema,
+            deploymentId: z.number().int().positive().describe('Deployment ID.'),
+        },
+        title: 'Agentia ADV Component Remove',
+    }, (args) => safelyHandleTool(async () => ({
+        result: await removeAdvComponents({ components: componentList(args.components), deploymentId: args.deploymentId }),
+    })));
+    server.registerTool('agentia_adv_job_get', {
+        description: 'Get the latest Copado Pipelines Advanced run for a deployment.',
+        inputSchema: { deploymentId: z.number().int().positive().describe('Deployment ID.') },
+        title: 'Agentia ADV Job Get',
+    }, (args) => safelyHandleTool(async () => ({ result: await getAdvJob(args.deploymentId) })));
+    server.registerTool('agentia_adv_job_list', {
+        description: 'List Copado Pipelines Advanced run history for a deployment.',
+        inputSchema: {
+            deploymentId: z.number().int().positive().describe('Deployment ID.'),
+            page: z.number().int().min(0).optional().describe('Page number starting at 0.'),
+            pageSize: z.number().int().positive().optional().describe('Rows per page.'),
+        },
+        title: 'Agentia ADV Job List',
+    }, (args) => safelyHandleTool(async () => ({ result: await listAdvJobs(args) })));
+    server.registerTool('agentia_adv_job_wait', {
+        description: 'Wait for the latest Copado Pipelines Advanced run to finish.',
+        inputSchema: {
+            deploymentId: z.number().int().positive().describe('Deployment ID.'),
+            interval: z.number().positive().optional().describe('Seconds between polls.'),
+            timeout: z.number().positive().optional().describe('Maximum seconds to wait.'),
+        },
+        title: 'Agentia ADV Job Wait',
+    }, (args) => safelyHandleTool(async () => ({
+        result: await waitForAdvJob({ deploymentId: args.deploymentId, intervalSeconds: args.interval, timeoutSeconds: args.timeout }),
+    })));
+}
+//# sourceMappingURL=adv-tools.js.map

package/dist/lib/mcp/command-id.js

@@ -1,7 +1,9 @@
 export const MCP_ONLY_TOOL_NAMES = new Set(['agentia_navigation_resolve']);
-const TOP_LEVEL_COMMAND_TOPICS = new Set(['auth', 'testing']);
+const TOP_LEVEL_COMMAND_TOPICS = new Set(['adv', 'auth', 'testing']);
 const TOOL_COMMAND_ID_OVERRIDES = Object.fromEntries([
     ['agentia_ai_ask', 'ai:agent:ask'],
+    ['agentia_repository_auth_https', 'cicd:repository:auth:https:configure'],
+    ['agentia_repository_auth_ssh', 'cicd:repository:auth:ssh:configure'],
 ]);
 const HANDLER_TOOL_NAME_OVERRIDES = {
     deploymentStepCreate: 'agentia_work_deployment_step_create',
@@ -29,6 +31,7 @@ const HYPHENATED_TOKEN_REPLACEMENTS = [
     ['stage_connection', 'stage-connection'],
     ['run_local', 'run-local'],
     ['set_options', 'set-options'],
+    ['quick_deploy', 'quick-deploy'],
 ].sort((left, right) => right[0].length - left[0].length);
 export function mcpCommandIdFromToolName(toolName) {
     const trimmed = toolName.trim();

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

@@ -23,6 +23,11 @@ const CLASS_ANNOTATIONS = {
 };
 /** Triggers side effects (commit, promote, run, kill, ...). */
 const ACTION_TOOLS = [
+    'agentia_adv_component_refresh',
+    'agentia_adv_deployment_cancel',
+    'agentia_adv_deployment_deploy',
+    'agentia_adv_deployment_quick_deploy',
+    'agentia_adv_deployment_validate',
     'agentia_cloud_commit',
     'agentia_cloud_promote',
     'agentia_data_sync_apply',
@@ -57,6 +62,7 @@ const ASK_TOOLS = [
 ];
 /** Additive writes. */
 const CREATE_TOOLS = [
+    'agentia_adv_deployment_create',
     'agentia_credential_create',
     'agentia_data_commit_create',
     'agentia_data_filter_add',
@@ -106,6 +112,18 @@ const DELETE_TOOLS = [
 /** Read-only lookups. */
 const READ_TOOLS = [
     'agentia_auth_get',
+    'agentia_adv_auth_status',
+    'agentia_adv_component_list',
+    'agentia_adv_component_selected',
+    'agentia_adv_component_types',
+    'agentia_adv_job_get',
+    'agentia_adv_job_list',
+    'agentia_adv_job_wait',
+    'agentia_adv_organization_get',
+    'agentia_adv_organization_list',
+    'agentia_adv_organization_validate',
+    'agentia_adv_deployment_get',
+    'agentia_adv_deployment_list',
     'agentia_credential_list',
     'agentia_data_commit_list',
     'agentia_data_dataset_file_content',
@@ -141,6 +159,7 @@ const READ_TOOLS = [
     'agentia_metadata_list',
     'agentia_metadata_refresh_status',
     'agentia_navigation_resolve',
+    'agentia_notification_get',
     'agentia_pipeline_connection_list',
     'agentia_pipeline_get',
     'agentia_pipeline_list',
@@ -197,6 +216,10 @@ const READ_TOOLS = [
 /** Overwrites existing state. */
 const UPDATE_TOOLS = [
     'agentia_auth_set',
+    'agentia_notification_configure',
+    'agentia_adv_component_add',
+    'agentia_adv_component_remove',
+    'agentia_adv_deployment_options',
     'agentia_credential_update',
     'agentia_data_filter_update',
     'agentia_data_formula_update',

package/dist/lib/mcp/tools.js

@@ -23,6 +23,8 @@ import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagina
 import { COMPARISON_MODES, CONTENT_SOURCES, contentResultToCompareSide, createUnifiedDiff, INDEX_SOURCES, MODULE_TYPES, ORDER_DIRECTIONS, PLATFORM_EXPERIENCES, RETRIEVE_MODES, sourceSideLabel, } from '../metadata-common.js';
 import { buildRefreshDeletedRequest, buildRefreshIndexRequest, refreshStatusEndpoint, resolveRefreshSourceFromEnv, } from '../metadata-refresh.js';
 import { NAVIGATION_RESOURCE_TYPES, resolveNavigationTarget } from '../navigation.js';
+import { configureNotification, NOTIFICATION_DESTINATION_TYPES, NOTIFICATION_EVENTS, NOTIFICATION_SUBSCRIPTIONS, withNotificationConfigureErrorTranslation, } from '../notifications-configure.js';
+import { getNotificationSubscriptions } from '../notifications-get.js';
 import { parsePipelineConnectionMutationObject, parsePipelineConnectionUpdateObject, validatePipelineConnectionCreatePayload, validatePipelineConnectionUpdatePayload, } from '../pipeline-connection-flags.js';
 import { validatePipelineMutationPayload, } from '../pipeline-flags.js';
 import { buildPipelineStageConnectionCreatePayload, buildPipelineStageConnectionUpdatePayload, } from '../pipeline-stage-connection-flags.js';
@@ -44,6 +46,7 @@ import { getUserContext } from '../user-context.js';
 import { DEFAULT_USER_ID, resolveUserId, userEndpoint } from '../user-types.js';
 import { resolveRecordedWorkBranchMetadata } from '../work-branch-metadata.js';
 import { workStatusEndpoint } from '../work-types.js';
+import { registerAgentiaMcpAdvTools } from './adv-tools.js';
 import { agentiaMcpAiToolHandlers, registerAgentiaMcpAiTools } from './ai-tools.js';
 import { agentiaMcpDataToolHandlers, registerAgentiaMcpDataTools } from './data-tools.js';
 import { agentiaMcpDeploymentStepToolHandlers, registerAgentiaMcpDeploymentStepTools } from './deployment-step-tools.js';
@@ -1221,6 +1224,20 @@ async function navigationResolve(args) {
         resourceType: args.resourceType,
     });
 }
+async function notificationConfigure(args) {
+    const result = await withNotificationConfigureErrorTranslation(() => configureNotification({
+        destinationId: assertRequired(args.destinationId, 'destinationId'),
+        destinationType: args.destinationType,
+        event: args.event,
+        pipelineId: assertRequired(args.pipelineId, 'pipelineId'),
+        subscription: args.subscription,
+    }));
+    return { result };
+}
+async function notificationGet(args) {
+    const result = await getNotificationSubscriptions(assertRequired(args.pipelineId, 'pipelineId'));
+    return { result };
+}
 export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     ...agentiaMcpAiToolHandlers,
     ...agentiaMcpDataToolHandlers,
@@ -1263,6 +1280,8 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     metadataRefreshRun,
     metadataRefreshStatus,
     navigationResolve,
+    notificationConfigure,
+    notificationGet,
     pipelineConnectionCreate,
     pipelineConnectionDelete,
     pipelineConnectionList,
@@ -1308,6 +1327,18 @@ export const agentiaMcpToolHandlers = wrapMcpToolHandlers({
     ...agentiaMcpTestingToolHandlers,
     ...agentiaMcpWorkToolHandlers,
 });
+const notificationConfigureSchema = {
+    destinationId: z.string().describe('Slack user or channel id or name.'),
+    destinationType: z.enum(NOTIFICATION_DESTINATION_TYPES).describe('Slack destination type.'),
+    event: z
+        .enum(NOTIFICATION_EVENTS)
+        .describe('Notification event.'),
+    pipelineId: z.string().describe('Copado pipeline Salesforce Id (15 or 18 characters).'),
+    subscription: z.enum(NOTIFICATION_SUBSCRIPTIONS).describe('Notification audience for this event.'),
+};
+const notificationGetSchema = {
+    pipelineId: z.string().describe('Copado pipeline Salesforce Id (15 or 18 characters).'),
+};
 const environmentMutationSchema = {
     apexTestLevel: z.string().optional().describe('Apex test level.'),
     enableRollback: z.boolean().optional().describe('Enable rollback.'),
@@ -1380,6 +1411,7 @@ const promotionListSchema = {
 };
 export function registerAgentiaMcpTools(server) {
     registerAgentiaMcpAiTools(server);
+    registerAgentiaMcpAdvTools(server);
     registerAgentiaMcpDataTools(server);
     registerAgentiaMcpDeploymentStepTools(server);
     registerAgentiaMcpHealthCheckTools(server);
@@ -1721,6 +1753,16 @@ export function registerAgentiaMcpTools(server) {
         },
         title: 'Agentia Navigation Resolve',
     }, (args) => safelyHandleTool(() => navigationResolve(args)));
+    server.registerTool('agentia_notification_configure', {
+        description: 'Configure one Slack notification subscription for the current user on a pipeline. Mirrors agentia cicd notification configure.',
+        inputSchema: notificationConfigureSchema,
+        title: 'Agentia Notification Configure',
+    }, (args) => safelyHandleTool(() => notificationConfigure(args)));
+    server.registerTool('agentia_notification_get', {
+        description: 'List Slack notification subscriptions for the current user on a pipeline. Mirrors agentia cicd notification get.',
+        inputSchema: notificationGetSchema,
+        title: 'Agentia Notification Get',
+    }, (args) => safelyHandleTool(() => notificationGet(args)));
     server.registerTool('agentia_project_default_get', {
         description: 'Show Agentia project default values for the current project or globally.',
         inputSchema: projectSelectorSchema,

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

@@ -6,18 +6,19 @@ import { reconcileWorkSetCredential, sanitizeWorkSetUserStory } from '../credent
 import { readDefaults, resolveDefaults, writeLastWorkSelection, } from '../defaults-store.js';
 import { checkoutFeatureBranch, fetchOriginBranch, fetchOriginBranchIfExists, listPendingChanges, } from '../git-worktree.js';
 import { listPaginationZodFields, mcpPaginatedListPayload } from '../list-pagination.js';
-import { LocalQualityGatesError, runLocalQualityGates } from '../local-quality-gates.js';
+import { LocalQualityGatesError, parseQualityGatesEnvAssignments, runLocalQualityGates, } from '../local-quality-gates.js';
 import { FULL_METADATA_SELECTION_TYPES_HELP } from '../nested-metadata-registry.js';
 import { PROJECT_DEFAULT_KEYS } from '../project-defaults.js';
 import { performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, resolvePromotionIdForWorkItem, } from '../promotion-run.js';
 import { runWorkTestLocalQualityGates } from '../stock-quality-gates.js';
 import { getUserContext } from '../user-context.js';
 import { resolveWorkItemId } from '../work-active.js';
-import { DEFAULT_APEX_TEST_WAIT_MINUTES, parseApexTestClassNames, runWorkApexTests, validateApexTestWaitMinutes, } from '../work-apex-test.js';
-import { fetchUserStory } from '../work-get.js';
+import { planWorkApexTestRun, recordWorkApexTestOutcome } from '../work-apex-test-failures.js';
+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 { fetchUserStory } 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, } from '../work-push.js';
@@ -250,6 +251,7 @@ async function workPublish(args = {}) {
         const context = await resolveWorkPushContext();
         return performWorkPush({
             ...context,
+            dryRun: args.dryRun === true,
             ...(args.fullMetadata === undefined ? {} : { fullMetadata: args.fullMetadata }),
             hooks: capturingWorkPushHooks,
             ...(args.permissions === undefined ? {} : { permissions: args.permissions }),
@@ -379,13 +381,16 @@ async function workTest(args = {}) {
     if (args.cloud === true) {
         throw new Error('Cloud quality gates are not implemented yet. Pass local: true or omit cloud to run project-root quality gates.');
     }
+    parseQualityGatesEnvAssignments(args.env);
     let qualityGates;
     try {
         qualityGates = await runWorkTestLocalQualityGates({
             apexTestClasses: args.apexTestClasses,
+            env: args.env,
             onOutput() {
                 // Capture output for the tool result/error; do not stream to the MCP stdio transport.
             },
+            rerunFailed: args.rerunFailedApexTests === true,
         });
     }
     catch (error) {
@@ -417,9 +422,26 @@ async function workTest(args = {}) {
     };
 }
 async function workTestApex(args) {
-    const classNames = parseApexTestClassNames(assertRequired(args.apexTestClasses, 'apexTestClasses'));
+    const classNames = parseApexTestClassNames(args.apexTestClasses);
     const waitMinutes = validateApexTestWaitMinutes(args.wait ?? DEFAULT_APEX_TEST_WAIT_MINUTES);
-    return runWorkApexTests({ classNames, waitMinutes });
+    const plan = await planWorkApexTestRun({
+        requestedClassNames: classNames,
+        rerunFailed: args.rerunFailedApexTests === true,
+    });
+    if (plan.kind === 'skip') {
+        return skippedWorkApexTestResult(waitMinutes);
+    }
+    try {
+        const result = await runWorkApexTests({ classNames: plan.classNames, waitMinutes });
+        await recordWorkApexTestOutcome({ failed: false, result, userStory: plan.userStory });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof WorkApexTestError) {
+            await recordWorkApexTestOutcome({ failed: true, result: error.result, userStory: plan.userStory });
+        }
+        throw error;
+    }
 }
 function hasMcpSimpleCommitArgs(args) {
     return (args.action !== undefined ||
@@ -667,6 +689,10 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Set',
     }, (args) => safelyHandleTool(() => workSet(args || {})));
     const workPublishInputSchema = {
+        dryRun: z
+            .boolean()
+            .optional()
+            .describe('Preview publish: run commit collection, Copado replacements, and nested metadata detection; return the changeListUpdate that would be registered; do not commit, push, lock, register, or sync the dev org branch. Restores dirtied tracked files afterward. Requires a clean tracked working tree.'),
         fullMetadata: z
             .string()
             .optional()
@@ -678,7 +704,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. 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 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.',
         inputSchema: workPublishInputSchema,
         title: 'Agentia Work Publish',
     }, (args) => safelyHandleTool(() => workPublish(args || {})));
@@ -790,7 +816,7 @@ export function registerAgentiaMcpWorkTools(server) {
         title: 'Agentia Work Submit',
     }, (args) => safelyHandleTool(() => workSubmit(args || {})));
     server.registerTool('agentia_work_test', {
-        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet).',
+        description: 'Run quality gates for the current work item. With local=true (the default when cloud is omitted), runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present. When no project script exists, warns and runs the stock Agentia setup sample from a temporary file. With cloud=true, runs remote Copado quality gates (not implemented yet). Optional env is an array of NAME=value strings injected into the quality-gate script environment (same as CLI -e/--env).',
         inputSchema: {
             apexTestClasses: z
                 .string()
@@ -800,19 +826,32 @@ export function registerAgentiaMcpWorkTools(server) {
                 .boolean()
                 .optional()
                 .describe('Run remote Copado quality gates (not implemented yet).'),
+            env: z
+                .array(z.string())
+                .optional()
+                .describe('Extra environment variables for the quality-gate script as NAME=value strings (same as CLI -e/--env). Applied before reserved AGENTIA_APEX_* variables.'),
             local: z
                 .boolean()
                 .optional()
                 .describe('Run local project-root quality gates scripts. Used by default when cloud is omitted.'),
+            rerunFailedApexTests: z
+                .boolean()
+                .optional()
+                .describe('Pass AGENTIA_APEX_RERUN_FAILED=--rerun-failed-apex-tests to local quality gates so sample scripts forward that flag to work test apex.'),
         },
         title: 'Agentia Work Test',
     }, (args) => safelyHandleTool(() => workTest(args || {})));
     server.registerTool('agentia_work_test_apex', {
-        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
+        description: 'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage. Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured. When apexTestClasses is omitted or empty, skips Salesforce CLI and returns skipped=true. Failed runs save `.agentia/apex.tests.<user-story>.json`; successful runs delete that file. rerunFailedApexTests runs the previously failed classes. Returns the test-run summary when the run passes. Failed runs include failing tests with Message and StackTrace.',
         inputSchema: {
             apexTestClasses: z
                 .string()
-                .describe('Comma-separated Apex test class names to run.'),
+                .optional()
+                .describe('Comma-separated Apex test class names to run. Omit or leave empty to skip without running Salesforce CLI.'),
+            rerunFailedApexTests: z
+                .boolean()
+                .optional()
+                .describe('Rerun Apex classes saved from the last failure for this user story. Combined with apexTestClasses, only matching failed classes run.'),
             wait: z
                 .number()
                 .int()

package/dist/lib/notifications-get.js

@@ -0,0 +1,10 @@
+import {modules} from './runtime.js';
+const NOTIFICATION_SYSTEM_PROPERTIES_ENDPOINT = modules["notifications-get.js"]["NOTIFICATION_SYSTEM_PROPERTIES_ENDPOINT"]
+const NotificationGetUserUnavailableError = modules["notifications-get.js"]["NotificationGetUserUnavailableError"]
+const formatNotificationSubscriptionsTable = modules["notifications-get.js"]["formatNotificationSubscriptionsTable"]
+const getNotificationSubscriptions = modules["notifications-get.js"]["getNotificationSubscriptions"]
+const notificationSystemPropertiesEndpoint = modules["notifications-get.js"]["notificationSystemPropertiesEndpoint"]
+const notificationSystemPropertyApiName = modules["notifications-get.js"]["notificationSystemPropertyApiName"]
+const parseStoredNotificationSubscriptions = modules["notifications-get.js"]["parseStoredNotificationSubscriptions"]
+const subscriptionsFromSystemProperties = modules["notifications-get.js"]["subscriptionsFromSystemProperties"]
+export {NOTIFICATION_SYSTEM_PROPERTIES_ENDPOINT, NotificationGetUserUnavailableError, formatNotificationSubscriptionsTable, getNotificationSubscriptions, notificationSystemPropertiesEndpoint, notificationSystemPropertyApiName, parseStoredNotificationSubscriptions, subscriptionsFromSystemProperties};

package/dist/lib/plugin-host/event-log.js

@@ -0,0 +1,3 @@
+import {modules} from '../runtime.js';
+const schedulePluginHostEvent = modules["plugin-host/event-log.js"]["schedulePluginHostEvent"]
+export {schedulePluginHostEvent};