@copado/agentia-cli 1.0.0-beta.8 → 1.0.0-beta.9

package/dist/commands/adv/auth/status.js

@@ -8,6 +8,7 @@ export default class AdvAuthStatus extends AgentiaCommand {
         '<%= config.bin %> <%= command.id %> --json',
     ];
     async run() {
+        await this.parse(AdvAuthStatus);
         const result = await this.withSpinner('Checking Pipelines Advanced authentication', () => getAdvAuthStatus());
         this.display(() => {
             this.log(formatAdvRecord(result));

package/dist/commands/adv/component/add.js

@@ -29,6 +29,9 @@ export default class AdvComponentAdd extends AgentiaCommand {
     };
     async run() {
         const { args, flags } = await this.parse(AdvComponentAdd);
+        if (flags.component === undefined && flags.file === undefined && flags['json-file'] === undefined) {
+            this.error('Provide one component input: --component, --file, or --json-file.', { exit: 2 });
+        }
         const components = flags.file === undefined
             ? flags['json-file'] === undefined
                 ? (flags.component ?? []).map((component) => parseAdvComponentSpec(component))

package/dist/commands/adv/component/remove.js

@@ -24,6 +24,9 @@ export default class AdvComponentRemove extends AgentiaCommand {
     };
     async run() {
         const { args, flags } = await this.parse(AdvComponentRemove);
+        if (flags.component === undefined && flags['json-file'] === undefined) {
+            this.error('Provide one component input: --component or --json-file.', { exit: 2 });
+        }
         const components = flags['json-file'] === undefined
             ? (flags.component ?? []).map((component) => parseAdvComponentSpec(component))
             : readAdvComponentsFromJsonFile(flags['json-file']);

package/dist/commands/adv/component/types.js

@@ -8,6 +8,7 @@ export default class AdvComponentTypes extends AgentiaCommand {
         '<%= config.bin %> <%= command.id %> --json',
     ];
     async run() {
+        await this.parse(AdvComponentTypes);
         const result = await this.withSpinner('Fetching Pipelines Advanced component types', () => listAdvComponentTypes());
         this.display(() => this.log(formatAdvRecord({ views: result.views.length })));
         return result;

package/dist/commands/adv/job/wait.js

@@ -13,7 +13,7 @@ export default class AdvJobWait extends AgentiaCommand {
     ];
     static flags = {
         interval: Flags.integer({ description: 'Seconds between job status polls (default: 3).' }),
-        timeout: Flags.integer({ description: 'Maximum seconds to wait (default: 3600).' }),
+        timeout: Flags.integer({ description: 'Maximum seconds to wait; the remote run continues after timeout (default: 3600).' }),
     };
     async run() {
         const { args, flags } = await this.parse(AdvJobWait);

package/dist/commands/adv/organization/list.js

@@ -8,6 +8,7 @@ export default class AdvOrganizationList extends AgentiaCommand {
         '<%= config.bin %> <%= command.id %> --json',
     ];
     async run() {
+        await this.parse(AdvOrganizationList);
         const result = await this.withSpinner('Fetching Pipelines Advanced organizations', () => listAdvOrganizations());
         this.display(() => {
             if (result.organizations.length === 0)

package/dist/commands/cicd/template/defaults.js

@@ -0,0 +1,42 @@
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { buildTemplateDefaultsQuery, resolveTemplateWritePath, templateDefaultsFlags } from '../../../lib/template-flags.js';
+import { formatTemplateDetail, normalizeTemplate, templateDefaultsEndpoint, writeTemplateDiskFile, } from '../../../lib/template-types.js';
+export default class TemplateDefaults extends AgentiaCommand {
+    static description = 'Scaffold default Copado Job Template metadata without writing to Salesforce (legacy create ≈ defaults --write)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --name MyTemplate',
+        '<%= config.bin %> <%= command.id %> --name MyTemplate --api-name MyTemplate_1 --write',
+        '<%= config.bin %> <%= command.id %> --name MyTemplate --output ./copado/templates/MyTemplate_1.metadata.json --json',
+    ];
+    static flags = templateDefaultsFlags;
+    async run() {
+        const { flags } = await this.parse(TemplateDefaults);
+        let query;
+        try {
+            query = buildTemplateDefaultsQuery(flags);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const response = await this.withSpinner('Scaffolding template defaults', () => CicdGateway.call({
+            endpoint: templateDefaultsEndpoint(query),
+            method: 'GET',
+        }));
+        const template = normalizeTemplate(response);
+        let filePath;
+        const writePath = resolveTemplateWritePath(template.apiName, flags);
+        if (writePath !== undefined) {
+            filePath = await writeTemplateDiskFile(template, writePath);
+        }
+        this.display(() => {
+            this.log('Scaffolded template defaults (not persisted).');
+            this.log(formatTemplateDetail(template));
+            if (filePath !== undefined) {
+                this.log(`Wrote ${filePath}`);
+            }
+        });
+        return filePath === undefined ? template : { ...template, filePath };
+    }
+}
+//# sourceMappingURL=defaults.js.map

package/dist/commands/cicd/template/delete.js

@@ -0,0 +1,36 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { assertValidTemplateApiName, templateEndpoint } from '../../../lib/template-types.js';
+export default class TemplateDelete extends AgentiaCommand {
+    static args = {
+        'api-name': Args.string({
+            description: 'Template API name',
+            required: true,
+        }),
+    };
+    static description = 'Delete a Copado Job Template by API name';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyTemplate_1',
+        '<%= config.bin %> <%= command.id %> MyTemplate_1 --json',
+    ];
+    async run() {
+        const { args } = await this.parse(TemplateDelete);
+        let apiName;
+        try {
+            apiName = assertValidTemplateApiName(args['api-name']);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        await this.withSpinner('Deleting template', () => CicdGateway.call({
+            endpoint: templateEndpoint(apiName),
+            method: 'DELETE',
+        }));
+        this.display(() => {
+            this.log(`Deleted template ${apiName}.`);
+        });
+        return { apiName };
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/cicd/template/get.js

@@ -0,0 +1,48 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { resolveTemplateWritePath, templateGetFlags } from '../../../lib/template-flags.js';
+import { formatTemplateDetail, normalizeTemplate, templateEndpoint, writeTemplateDiskFile, } from '../../../lib/template-types.js';
+export default class TemplateGet extends AgentiaCommand {
+    static args = {
+        'api-name': Args.string({
+            description: 'Template API name',
+            required: true,
+        }),
+    };
+    static description = 'Get a Copado Job Template by API name (legacy retrieve ≈ get --write)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyTemplate_1',
+        '<%= config.bin %> <%= command.id %> MyTemplate_1 --write',
+        '<%= config.bin %> <%= command.id %> MyTemplate_1 --json',
+    ];
+    static flags = templateGetFlags;
+    async run() {
+        const { args, flags } = await this.parse(TemplateGet);
+        let endpoint;
+        try {
+            endpoint = templateEndpoint(args['api-name']);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const response = await this.withSpinner('Fetching template', () => CicdGateway.call({
+            endpoint,
+            method: 'GET',
+        }));
+        const template = normalizeTemplate(response);
+        let filePath;
+        const writePath = resolveTemplateWritePath(template.apiName, flags);
+        if (writePath !== undefined) {
+            filePath = await writeTemplateDiskFile(template, writePath);
+        }
+        this.display(() => {
+            this.log(formatTemplateDetail(template));
+            if (filePath !== undefined) {
+                this.log(`Wrote ${filePath}`);
+            }
+        });
+        return filePath === undefined ? template : { ...template, filePath };
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/cicd/template/list.js

@@ -0,0 +1,53 @@
+import { Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { buildListPaginationQuery, displayListPagination, listPaginationFlags, } from '../../../lib/list-pagination.js';
+import { formatTemplateTable, normalizeTemplatesListPage, TEMPLATE_LIST_TYPES, templatesEndpoint, } from '../../../lib/template-types.js';
+export default class TemplateList extends AgentiaCommand {
+    static description = 'List Copado Job Templates';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --type all',
+        '<%= config.bin %> <%= command.id %> --name Demo --page-size 50',
+        '<%= config.bin %> <%= command.id %> --fetch-all --json',
+    ];
+    static flags = {
+        ...listPaginationFlags,
+        'fetch-all': Flags.boolean({
+            default: false,
+            description: 'Fetch all matching templates (incompatible with --cursor on the gateway)',
+        }),
+        name: Flags.string({
+            description: 'Filter by name substring',
+        }),
+        type: Flags.string({
+            default: 'custom',
+            description: 'List Custom templates only, or all templates',
+            options: [...TEMPLATE_LIST_TYPES],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TemplateList);
+        const pagination = buildListPaginationQuery(flags);
+        const response = await this.withSpinner('Fetching templates', () => CicdGateway.call({
+            endpoint: templatesEndpoint({
+                ...pagination,
+                fetchAll: flags['fetch-all'] === true ? true : undefined,
+                name: flags.name,
+                type: flags.type,
+            }),
+            method: 'GET',
+        }));
+        const page = normalizeTemplatesListPage(response);
+        this.display(() => {
+            if (page.data.length === 0) {
+                this.log('No templates found.');
+                return;
+            }
+            this.log(formatTemplateTable(page.data));
+            displayListPagination(this.log.bind(this), page);
+        });
+        return page;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/cicd/template/upsert.js

@@ -0,0 +1,45 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdGateway } from '../../../lib/cicd-gateway.js';
+import { buildTemplateUpsertPayload, templateUpsertFlags } from '../../../lib/template-flags.js';
+import { formatTemplateDetail, normalizeTemplate, templateEndpoint, } from '../../../lib/template-types.js';
+export default class TemplateUpsert extends AgentiaCommand {
+    static args = {
+        'api-name': Args.string({
+            description: 'Template API name',
+            required: true,
+        }),
+    };
+    static description = 'Create or update a Copado Job Template by API name (legacy deploy ≈ upsert reading disk or --file)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> MyTemplate_1',
+        '<%= config.bin %> <%= command.id %> MyTemplate_1 --file ./copado/templates/MyTemplate_1.metadata.json',
+        '<%= config.bin %> <%= command.id %> MyTemplate_1 --name "My Template" --steps-file ./steps.json --json',
+    ];
+    static flags = templateUpsertFlags;
+    async run() {
+        const { args, flags } = await this.parse(TemplateUpsert);
+        let payload;
+        try {
+            payload = await buildTemplateUpsertPayload(args['api-name'], flags);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const response = await this.withSpinner('Upserting template', () => CicdGateway.call({
+            body: payload,
+            endpoint: templateEndpoint(args['api-name']),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'PUT',
+        }));
+        const template = normalizeTemplate(response);
+        this.display(() => {
+            this.log(`Upserted template ${template.apiName ?? args['api-name']} (ID: ${template.id ?? 'unknown id'}).`);
+            this.log(formatTemplateDetail(template));
+        });
+        return template;
+    }
+}
+//# sourceMappingURL=upsert.js.map

package/dist/lib/adv-operations.js

@@ -1,5 +1,7 @@
 import {modules} from './runtime.js';
+const AdvQuickDeployUnavailableError = modules["adv-operations.js"]["AdvQuickDeployUnavailableError"]
 const AdvRunFailedError = modules["adv-operations.js"]["AdvRunFailedError"]
+const AdvWaitTimeoutError = modules["adv-operations.js"]["AdvWaitTimeoutError"]
 const addAdvComponents = modules["adv-operations.js"]["addAdvComponents"]
 const advRunErrorJson = modules["adv-operations.js"]["advRunErrorJson"]
 const assertAdvJobSucceeded = modules["adv-operations.js"]["assertAdvJobSucceeded"]
@@ -26,4 +28,4 @@ const selectedAdvComponents = modules["adv-operations.js"]["selectedAdvComponent
 const updateAdvDeploymentOptions = modules["adv-operations.js"]["updateAdvDeploymentOptions"]
 const validateAdvOrganization = modules["adv-operations.js"]["validateAdvOrganization"]
 const waitForAdvJob = modules["adv-operations.js"]["waitForAdvJob"]
-export {AdvRunFailedError, addAdvComponents, advRunErrorJson, assertAdvJobSucceeded, cancelAdvDeployment, createAdvDeployment, deriveAdvJobResult, getAdvAuthStatus, getAdvDeployment, getAdvJob, getAdvOrganization, getStoredAdvAuthSummary, listAdvComponentTypes, listAdvComponents, listAdvDeployments, listAdvJobs, listAdvOrganizations, parseAdvComponentSpec, readAdvComponentsFromJsonFile, readAdvComponentsFromTextFile, refreshAdvComponents, removeAdvComponents, runAdvDeploymentAction, selectedAdvComponents, updateAdvDeploymentOptions, validateAdvOrganization, waitForAdvJob};
+export {AdvQuickDeployUnavailableError, AdvRunFailedError, AdvWaitTimeoutError, addAdvComponents, advRunErrorJson, assertAdvJobSucceeded, cancelAdvDeployment, createAdvDeployment, deriveAdvJobResult, getAdvAuthStatus, getAdvDeployment, getAdvJob, getAdvOrganization, getStoredAdvAuthSummary, listAdvComponentTypes, listAdvComponents, listAdvDeployments, listAdvJobs, listAdvOrganizations, parseAdvComponentSpec, readAdvComponentsFromJsonFile, readAdvComponentsFromTextFile, refreshAdvComponents, removeAdvComponents, runAdvDeploymentAction, selectedAdvComponents, updateAdvDeploymentOptions, validateAdvOrganization, waitForAdvJob};

package/dist/lib/agentia-command.js

@@ -4,8 +4,42 @@ import { createTransactionId, runWithGatewayTransactionContext } from './cicd-ga
 import { colorizeCliSeverityError, colorizeCliSeverityText } from './cli-severity-color.js';
 import { isCommandOutputCaptureActive } from './command-output-buffer.js';
 import { rememberIdeCommandError } from './ide-command-events.js';
+import { redactErrorMessage, redactSecrets } from './secret-redaction.js';
 const TRANSACTION_ID_REPORTED = Symbol('agentiaTransactionIdReported');
 const EXPERIMENTAL_COMMAND_WARNING = 'This command is experimental and may change without notice.';
+const SAFE_ERROR_FIELDS = [
+    'categories',
+    'code',
+    'requestMethod',
+    'requestUrl',
+    'retryAfterSeconds',
+    'statusCode',
+    'suggestions',
+];
+function recordValue(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+function safeErrorJson(err, base) {
+    const baseError = recordValue(base.error);
+    const source = recordValue(err);
+    const error = {
+        message: redactErrorMessage(err),
+        name: typeof baseError.name === 'string'
+            ? baseError.name
+            : err instanceof Error && err.name.length > 0
+                ? err.name
+                : 'Error',
+    };
+    for (const field of SAFE_ERROR_FIELDS) {
+        const value = source[field] ?? baseError[field];
+        if (value !== undefined)
+            error[field] = redactSecrets(value);
+    }
+    const oclif = recordValue(baseError.oclif);
+    if (typeof oclif.exit === 'number')
+        error.oclif = { exit: oclif.exit };
+    return error;
+}
 export function elapsedSecondsSince(startedAtMs, nowMs = Date.now()) {
     return Math.max(0, Math.floor((nowMs - startedAtMs) / 1000));
 }
@@ -76,6 +110,7 @@ export class AgentiaCommand extends Command {
         const warnings = this.jsonWarnings();
         return {
             ...base,
+            error: safeErrorJson(err, base),
             ...(warnings.length > 0 ? { warnings } : {}),
             transactionId: this.commandTransactionId,
         };

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

@@ -10,6 +10,20 @@ const componentReferenceSchema = z.union([
     }),
 ]);
 const componentInputSchema = z.array(componentReferenceSchema).min(1).describe('Components as Type/Name strings or {type, fullName, excluded} objects.');
+const deploymentIdSchema = z.number().int().positive().describe('Deployment ID.');
+const deploymentIdInputSchema = {
+    deploymentId: deploymentIdSchema.optional().describe('Canonical deployment ID.'),
+    flow: deploymentIdSchema.optional().describe('Deprecated alias for deploymentId.'),
+    id: deploymentIdSchema.optional().describe('Deprecated alias for deploymentId.'),
+};
+function resolveDeploymentId(input) {
+    const supplied = [input.deploymentId, input.id, input.flow].filter((value) => value !== undefined);
+    if (supplied.length === 0)
+        throw new Error('Provide deploymentId.');
+    if (new Set(supplied).size !== 1)
+        throw new Error('Deployment ID aliases must have the same value.');
+    return supplied[0];
+}
 function componentList(components) {
     return components.map((component) => {
         if (typeof component === 'string')
@@ -30,7 +44,7 @@ async function deploymentAction(args) {
     return {
         result: await runAdvDeploymentAction({
             backup: args.backup,
-            id: args.id,
+            id: resolveDeploymentId(args),
             kind: args.kind,
             wait: args.wait,
             waitIntervalSeconds: args.interval,
@@ -66,9 +80,9 @@ export function registerAgentiaMcpAdvTools(server) {
     }, (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.') },
+        inputSchema: deploymentIdInputSchema,
         title: 'Agentia ADV Deployment Get',
-    }, (args) => safelyHandleTool(async () => ({ result: await getAdvDeployment(args.id) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await getAdvDeployment(resolveDeploymentId(args)) })));
     server.registerTool('agentia_adv_deployment_create', {
         description: 'Create a Copado Pipelines Advanced deployment.',
         inputSchema: {
@@ -81,15 +95,15 @@ export function registerAgentiaMcpAdvTools(server) {
     server.registerTool('agentia_adv_deployment_options', {
         description: 'Update Copado Pipelines Advanced deployment options.',
         inputSchema: {
-            id: z.number().int().positive().describe('Deployment ID.'),
+            ...deploymentIdInputSchema,
             set: z.array(z.string()).optional().describe('Options as name=value entries; booleans, null, and finite JavaScript Number values are converted.'),
         },
         title: 'Agentia ADV Deployment Options',
-    }, (args) => safelyHandleTool(async () => ({ result: await updateAdvDeploymentOptions({ id: args.id, set: args.set }) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await updateAdvDeploymentOptions({ id: resolveDeploymentId(args), 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.'),
+            ...deploymentIdInputSchema,
             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.'),
@@ -100,7 +114,7 @@ export function registerAgentiaMcpAdvTools(server) {
         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.'),
+            ...deploymentIdInputSchema,
             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.'),
@@ -112,7 +126,7 @@ export function registerAgentiaMcpAdvTools(server) {
         inputSchema: {
             backup: z.boolean().optional().describe('Run backupThenDeploy instead of a quick deploy.'),
             confirm: z.boolean().optional().describe('Required true to start a quick deploy.'),
-            id: z.number().int().positive().describe('Deployment ID.'),
+            ...deploymentIdInputSchema,
             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.'),
@@ -123,7 +137,7 @@ export function registerAgentiaMcpAdvTools(server) {
         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.'),
+            ...deploymentIdInputSchema,
             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.'),
@@ -133,7 +147,7 @@ export function registerAgentiaMcpAdvTools(server) {
         requireConfirm(args.confirm, 'Pipelines Advanced deployment cancellation');
         return {
             result: await cancelAdvDeployment({
-                id: args.id,
+                id: resolveDeploymentId(args),
                 wait: args.wait,
                 waitIntervalSeconds: args.interval,
                 waitTimeoutSeconds: args.timeout,
@@ -148,37 +162,37 @@ export function registerAgentiaMcpAdvTools(server) {
     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.'),
+            ...deploymentIdInputSchema,
             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) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await listAdvComponents({ ...args, flow: resolveDeploymentId(args) }) })));
     server.registerTool('agentia_adv_component_refresh', {
         description: 'Refresh Copado Pipelines Advanced component comparison cache.',
         inputSchema: {
-            flow: z.number().int().positive().describe('Deployment ID.'),
+            ...deploymentIdInputSchema,
             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) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await refreshAdvComponents({ ...args, flow: resolveDeploymentId(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.') },
+        inputSchema: deploymentIdInputSchema,
         title: 'Agentia ADV Component Selected',
-    }, (args) => safelyHandleTool(async () => ({ result: await selectedAdvComponents(args.deploymentId) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await selectedAdvComponents(resolveDeploymentId(args)) })));
     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.'),
+            ...deploymentIdInputSchema,
         },
         title: 'Agentia ADV Component Add',
     }, (args) => safelyHandleTool(async () => ({
         result: await addAdvComponents({
             components: componentList(args.components),
-            deploymentId: args.deploymentId,
+            deploymentId: resolveDeploymentId(args),
             mode: componentAddMode(args.components),
         }),
     })));
@@ -186,37 +200,37 @@ export function registerAgentiaMcpAdvTools(server) {
         description: 'Remove components from a Copado Pipelines Advanced deployment selection.',
         inputSchema: {
             components: componentInputSchema,
-            deploymentId: z.number().int().positive().describe('Deployment ID.'),
+            ...deploymentIdInputSchema,
         },
         title: 'Agentia ADV Component Remove',
     }, (args) => safelyHandleTool(async () => ({
-        result: await removeAdvComponents({ components: componentList(args.components), deploymentId: args.deploymentId }),
+        result: await removeAdvComponents({ components: componentList(args.components), deploymentId: resolveDeploymentId(args) }),
     })));
     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.') },
+        inputSchema: deploymentIdInputSchema,
         title: 'Agentia ADV Job Get',
-    }, (args) => safelyHandleTool(async () => ({ result: await getAdvJob(args.deploymentId) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await getAdvJob(resolveDeploymentId(args)) })));
     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.'),
+            ...deploymentIdInputSchema,
             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) })));
+    }, (args) => safelyHandleTool(async () => ({ result: await listAdvJobs({ ...args, deploymentId: resolveDeploymentId(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.'),
+            ...deploymentIdInputSchema,
             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 () => {
         const result = await waitForAdvJob({
-            deploymentId: args.deploymentId,
+            deploymentId: resolveDeploymentId(args),
             intervalSeconds: args.interval,
             timeoutSeconds: args.timeout,
         });

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

@@ -93,6 +93,7 @@ const DELETE_TOOLS = [
     'agentia_data_filter_delete',
     'agentia_data_template_delete',
     'agentia_function_delete',
+    'agentia_template_delete',
     'agentia_pipeline_connection_delete',
     'agentia_pipeline_stage_connection_delete',
     'agentia_project_delete',
@@ -146,6 +147,9 @@ const READ_TOOLS = [
     'agentia_function_list',
     'agentia_function_result_get',
     'agentia_function_result_log_get',
+    'agentia_template_defaults',
+    'agentia_template_get',
+    'agentia_template_list',
     'agentia_health_check',
     'agentia_job_get',
     'agentia_job_list',
@@ -226,6 +230,7 @@ const UPDATE_TOOLS = [
     'agentia_data_template_save_detail',
     'agentia_environment_update',
     'agentia_function_upsert',
+    'agentia_template_upsert',
     'agentia_pipeline_connection_update',
     'agentia_pipeline_stage_connection_update',
     'agentia_pipeline_update',