agent-tempo 1.2.0 → 1.4.0

package/dist/tools/shutdown.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerShutdownTool = registerShutdownTool;
+exports.buildShutdownTool = buildShutdownTool;
 /**
  * `shutdown` — graceful ensemble-wide teardown (#287).
  *
@@ -14,41 +14,46 @@ exports.registerShutdownTool = registerShutdownTool;
  */
 const zod_1 = require("zod");
 const signals_1 = require("../workflows/signals");
-const helpers_1 = require("./helpers");
+const descriptor_1 = require("./descriptor");
 const validation_1 = require("../utils/validation");
 const ensemble_ops_1 = require("../utils/ensemble-ops");
 const log = (...args) => console.error('[agent-tempo:shutdown]', ...args);
-function registerShutdownTool(server, client, config, getPlayerId) {
-    (0, helpers_1.defineTool)(server, 'shutdown', 'Gracefully shut down the ensemble: request detach on every session, pause the scheduler, and pause the maestro. Workflows survive in `detached` phase. Pair with `restore` to come back up, or `destroy` (no player arg) to terminate. Does not touch your own session.', {
-        deadlineMs: zod_1.z.number().min(0).max(validation_1.MAX_DETACH_DEADLINE_MS).optional().describe(`Max drain time per session before force-detach (default ${validation_1.DEFAULT_RESTART_DETACH_DEADLINE_MS}, max ${validation_1.MAX_DETACH_DEADLINE_MS}).`),
-    }, async (args) => {
-        const { deadlineMs = validation_1.DEFAULT_RESTART_DETACH_DEADLINE_MS } = args;
-        const callerId = getPlayerId();
-        try {
-            // Pause maestro + scheduler in parallel with the session fan-out —
-            // they're independent and draining adapters won't mind if the
-            // scheduler keeps firing for a few ms longer.
-            const [toggle, fanout] = await Promise.all([
-                (0, ensemble_ops_1.pauseMaestroAndScheduler)(client, config.ensemble),
-                (0, ensemble_ops_1.signalAllSessions)(client, config.ensemble, signals_1.requestDetachSignal.name, { reason: 'user-stop', deadlineMs }, { skip: (playerId) => playerId === callerId }),
-            ]);
-            const summaryLine = `${fanout.sent} detaching, ${fanout.skipped} skipped, ${fanout.failed} failed`;
-            const bits = [`Ensemble **${config.ensemble}** shutting down.`, summaryLine];
-            if (toggle.maestro)
-                bits.push('maestro paused');
-            if (toggle.scheduler)
-                bits.push('scheduler paused');
-            if (fanout.failed > 0) {
-                const errs = fanout.perSession
-                    .filter((p) => p.outcome === 'failed')
-                    .map((p) => `  - ${p.playerId}: ${'error' in p ? p.error : ''}`);
-                bits.push(`Errors:\n${errs.join('\n')}`);
+function buildShutdownTool(client, config, getPlayerId) {
+    return {
+        name: 'shutdown',
+        description: 'Gracefully shut down the ensemble: request detach on every session, pause the scheduler, and pause the maestro. Workflows survive in `detached` phase. Pair with `restore` to come back up, or `destroy` (no player arg) to terminate. Does not touch your own session.',
+        params: {
+            deadlineMs: zod_1.z.number().min(0).max(validation_1.MAX_DETACH_DEADLINE_MS).optional().describe(`Max drain time per session before force-detach (default ${validation_1.DEFAULT_RESTART_DETACH_DEADLINE_MS}, max ${validation_1.MAX_DETACH_DEADLINE_MS}).`),
+        },
+        handler: async (args) => {
+            const { deadlineMs = validation_1.DEFAULT_RESTART_DETACH_DEADLINE_MS } = args;
+            const callerId = getPlayerId();
+            try {
+                // Pause maestro + scheduler in parallel with the session fan-out —
+                // they're independent and draining adapters won't mind if the
+                // scheduler keeps firing for a few ms longer.
+                const [toggle, fanout] = await Promise.all([
+                    (0, ensemble_ops_1.pauseMaestroAndScheduler)(client, config.ensemble),
+                    (0, ensemble_ops_1.signalAllSessions)(client, config.ensemble, signals_1.requestDetachSignal.name, { reason: 'user-stop', deadlineMs }, { skip: (playerId) => playerId === callerId }),
+                ]);
+                const summaryLine = `${fanout.sent} detaching, ${fanout.skipped} skipped, ${fanout.failed} failed`;
+                const bits = [`Ensemble **${config.ensemble}** shutting down.`, summaryLine];
+                if (toggle.maestro)
+                    bits.push('maestro paused');
+                if (toggle.scheduler)
+                    bits.push('scheduler paused');
+                if (fanout.failed > 0) {
+                    const errs = fanout.perSession
+                        .filter((p) => p.outcome === 'failed')
+                        .map((p) => `  - ${p.playerId}: ${'error' in p ? p.error : ''}`);
+                    bits.push(`Errors:\n${errs.join('\n')}`);
+                }
+                log(`Shutdown requested by ${callerId} in "${config.ensemble}": ${summaryLine}`);
+                return (0, descriptor_1.ok)(bits.join('\n'));
             }
-            log(`Shutdown requested by ${callerId} in "${config.ensemble}": ${summaryLine}`);
-            return (0, helpers_1.ok)(bits.join('\n'));
-        }
-        catch (err) {
-            return (0, helpers_1.fail)(`Failed to shut down ensemble: ${(0, helpers_1.formatError)(err)}`);
-        }
-    });
+            catch (err) {
+                return (0, descriptor_1.fail)(`Failed to shut down ensemble: ${(0, descriptor_1.formatError)(err)}`);
+            }
+        },
+    };
 }

package/dist/tools/stage.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { WorkflowHandle } from '@temporalio/client';
-export declare function registerStageTool(server: McpServer, handle: WorkflowHandle, getPlayerId: () => string): void;
+import { type TempoToolDescriptor } from './descriptor';
+export declare function buildStageTool(handle: WorkflowHandle, getPlayerId: () => string): TempoToolDescriptor;

package/dist/tools/stage.js

@@ -1,28 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerStageTool = registerStageTool;
+exports.buildStageTool = buildStageTool;
 const zod_1 = require("zod");
-const helpers_1 = require("./helpers");
+const descriptor_1 = require("./descriptor");
 const validation_1 = require("../utils/validation");
-function registerStageTool(server, handle, getPlayerId) {
-    (0, helpers_1.defineTool)(server, 'stage', 'Create a pipeline stage tracking N players. When all players report, a completion message is auto-injected. Conductor only.', {
-        name: zod_1.z.string().max(validation_1.STAGE_NAME_MAX).describe('Unique stage name (e.g. "code-review", "testing")'),
-        players: zod_1.z.array(zod_1.z.string().regex(validation_1.PLAYER_NAME_REGEX)).min(1).max(validation_1.STAGE_PLAYERS_MAX).describe('Player names to track in this stage'),
-        failurePolicy: zod_1.z.enum(['halt', 'continue']).optional().describe('What to do when a player reports a blocker. "halt" (default) fails the stage immediately; "continue" waits for all players.'),
-    }, async (args) => {
-        const { name, players, failurePolicy } = args;
-        try {
-            await handle.signal('setStage', {
-                name,
-                players,
-                failurePolicy,
-                createdBy: getPlayerId(),
-            });
-            const playerList = players.map((p) => `  - ${p}`).join('\n');
-            return (0, helpers_1.ok)(`Stage **${name}** created tracking ${players.length} player(s) [policy: ${failurePolicy || 'halt'}]:\n${playerList}`);
-        }
-        catch (err) {
-            return (0, helpers_1.fail)(`Failed to create stage: ${(0, helpers_1.formatError)(err)}`);
-        }
-    });
+function buildStageTool(handle, getPlayerId) {
+    return {
+        name: 'stage',
+        description: 'Create a pipeline stage tracking N players. When all players report, a completion message is auto-injected. Conductor only.',
+        params: {
+            name: zod_1.z.string().max(validation_1.STAGE_NAME_MAX).describe('Unique stage name (e.g. "code-review", "testing")'),
+            players: zod_1.z.array(zod_1.z.string().regex(validation_1.PLAYER_NAME_REGEX)).min(1).max(validation_1.STAGE_PLAYERS_MAX).describe('Player names to track in this stage'),
+            failurePolicy: zod_1.z.enum(['halt', 'continue']).optional().describe('What to do when a player reports a blocker. "halt" (default) fails the stage immediately; "continue" waits for all players.'),
+        },
+        handler: async (args) => {
+            const { name, players, failurePolicy } = args;
+            try {
+                await handle.signal('setStage', {
+                    name,
+                    players,
+                    failurePolicy,
+                    createdBy: getPlayerId(),
+                });
+                const playerList = players.map((p) => `  - ${p}`).join('\n');
+                return (0, descriptor_1.ok)(`Stage **${name}** created tracking ${players.length} player(s) [policy: ${failurePolicy || 'halt'}]:\n${playerList}`);
+            }
+            catch (err) {
+                return (0, descriptor_1.fail)(`Failed to create stage: ${(0, descriptor_1.formatError)(err)}`);
+            }
+        },
+    };
 }

package/dist/tools/stages.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { WorkflowHandle } from '@temporalio/client';
-export declare function registerStagesTool(server: McpServer, handle: WorkflowHandle): void;
+import { type TempoToolDescriptor } from './descriptor';
+export declare function buildStagesTool(handle: WorkflowHandle): TempoToolDescriptor;

package/dist/tools/stages.js

@@ -1,35 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerStagesTool = registerStagesTool;
-const helpers_1 = require("./helpers");
-function registerStagesTool(server, handle) {
-    (0, helpers_1.defineTool)(server, 'stages', 'List all pipeline stages and their status. Shows which players have reported, who is still waiting, and stage completion status. Conductor only.', {}, async () => {
-        try {
-            const stages = await handle.query('stages');
-            if (stages.length === 0) {
-                return (0, helpers_1.ok)('No stages defined.');
-            }
-            const lines = stages.map((s) => {
-                const statusIcon = s.status === 'complete' ? '\u2714'
-                    : s.status === 'failed' ? '\u2718'
-                        : s.status === 'cancelled' ? '\u2212'
-                            : '\u25CB';
-                const playerLines = s.players.map((p) => {
-                    const pIcon = p.status === 'reported' ? '\u2714'
-                        : p.status === 'blocked' ? '\u2718'
-                            : '\u25CB';
-                    const detail = p.reportedAt ? ` (${p.reportType})` : '';
-                    return `    ${pIcon} ${p.playerId}${detail}`;
+exports.buildStagesTool = buildStagesTool;
+const descriptor_1 = require("./descriptor");
+function buildStagesTool(handle) {
+    return {
+        name: 'stages',
+        description: 'List all pipeline stages and their status. Shows which players have reported, who is still waiting, and stage completion status. Conductor only.',
+        params: {},
+        handler: async () => {
+            try {
+                const stages = await handle.query('stages');
+                if (stages.length === 0) {
+                    return (0, descriptor_1.ok)('No stages defined.');
+                }
+                const lines = stages.map((s) => {
+                    const statusIcon = s.status === 'complete' ? '\u2714'
+                        : s.status === 'failed' ? '\u2718'
+                            : s.status === 'cancelled' ? '\u2212'
+                                : '\u25CB';
+                    const playerLines = s.players.map((p) => {
+                        const pIcon = p.status === 'reported' ? '\u2714'
+                            : p.status === 'blocked' ? '\u2718'
+                                : '\u25CB';
+                        const detail = p.reportedAt ? ` (${p.reportType})` : '';
+                        return `    ${pIcon} ${p.playerId}${detail}`;
+                    });
+                    return [
+                        `${statusIcon} **${s.name}** [${s.status}] (policy: ${s.failurePolicy})`,
+                        ...playerLines,
+                    ].join('\n');
                 });
-                return [
-                    `${statusIcon} **${s.name}** [${s.status}] (policy: ${s.failurePolicy})`,
-                    ...playerLines,
-                ].join('\n');
-            });
-            return (0, helpers_1.ok)(lines.join('\n\n'));
-        }
-        catch (err) {
-            return (0, helpers_1.fail)(`Failed to query stages: ${(0, helpers_1.formatError)(err)}`);
-        }
-    });
+                return (0, descriptor_1.ok)(lines.join('\n\n'));
+            }
+            catch (err) {
+                return (0, descriptor_1.fail)(`Failed to query stages: ${(0, descriptor_1.formatError)(err)}`);
+            }
+        },
+    };
 }

package/dist/tools/unschedule.d.ts

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Client } from '@temporalio/client';
 import { Config } from '../config';
-export declare function registerUnscheduleTool(server: McpServer, client: Client, config: Config): void;
+import { type TempoToolDescriptor } from './descriptor';
+export declare function buildUnscheduleTool(client: Client, config: Config): TempoToolDescriptor;

package/dist/tools/unschedule.js

@@ -1,35 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerUnscheduleTool = registerUnscheduleTool;
+exports.buildUnscheduleTool = buildUnscheduleTool;
 const zod_1 = require("zod");
 const common_1 = require("@temporalio/common");
 const config_1 = require("../config");
-const helpers_1 = require("./helpers");
-function registerUnscheduleTool(server, client, config) {
-    (0, helpers_1.defineTool)(server, 'unschedule', 'Remove a named schedule. The schedule stops firing immediately.', {
-        name: zod_1.z.string().describe('Name of the schedule to remove'),
-    }, async (args) => {
-        const { name } = args;
-        try {
-            const wfId = (0, config_1.schedulerWorkflowId)(config.ensemble);
-            const handle = client.workflow.getHandle(wfId);
-            // Check if the scheduler workflow is running before signaling.
-            // Only treat WorkflowNotFoundError as "no scheduler" — other errors (network, etc.)
-            // should propagate so callers get an accurate error message.
+const descriptor_1 = require("./descriptor");
+function buildUnscheduleTool(client, config) {
+    return {
+        name: 'unschedule',
+        description: 'Remove a named schedule. The schedule stops firing immediately.',
+        params: {
+            name: zod_1.z.string().describe('Name of the schedule to remove'),
+        },
+        handler: async (args) => {
+            const { name } = args;
             try {
-                await handle.describe();
+                const wfId = (0, config_1.schedulerWorkflowId)(config.ensemble);
+                const handle = client.workflow.getHandle(wfId);
+                // Check if the scheduler workflow is running before signaling.
+                // Only treat WorkflowNotFoundError as "no scheduler" — other errors (network, etc.)
+                // should propagate so callers get an accurate error message.
+                try {
+                    await handle.describe();
+                }
+                catch (err) {
+                    if (err instanceof common_1.WorkflowNotFoundError) {
+                        return (0, descriptor_1.ok)('No scheduler is running — there are no schedules to remove.');
+                    }
+                    throw err;
+                }
+                await handle.signal('removeSchedule', name);
+                return (0, descriptor_1.ok)(`Schedule **${name}** removed.`);
             }
             catch (err) {
-                if (err instanceof common_1.WorkflowNotFoundError) {
-                    return (0, helpers_1.ok)('No scheduler is running — there are no schedules to remove.');
-                }
-                throw err;
+                return (0, descriptor_1.fail)(`Failed to remove schedule: ${(0, descriptor_1.formatError)(err)}`);
             }
-            await handle.signal('removeSchedule', name);
-            return (0, helpers_1.ok)(`Schedule **${name}** removed.`);
-        }
-        catch (err) {
-            return (0, helpers_1.fail)(`Failed to remove schedule: ${(0, helpers_1.formatError)(err)}`);
-        }
-    });
+        },
+    };
 }

package/dist/tools/who-am-i.d.ts

@@ -1,3 +1,3 @@
 import { WorkflowHandle } from '@temporalio/client';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerWhoAmITool(server: McpServer, handle: WorkflowHandle, getPlayerId: () => string): void;
+import { type TempoToolDescriptor } from './descriptor';
+export declare function buildWhoAmITool(handle: WorkflowHandle, getPlayerId: () => string): TempoToolDescriptor;

package/dist/tools/who-am-i.js

@@ -1,34 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerWhoAmITool = registerWhoAmITool;
-const helpers_1 = require("./helpers");
-function registerWhoAmITool(server, handle, getPlayerId) {
-    (0, helpers_1.defineTool)(server, 'who_am_i', 'Get your identity, role, and session details', {}, async () => {
-        const metadata = await handle.query('getMetadata');
-        const part = await handle.query('getPart');
-        // Attachment phase is authoritative post-#175/#176 (replaced legacy status).
-        let phase;
-        try {
-            const info = await handle.query('attachmentInfo');
-            phase = info.phase;
-        }
-        catch {
-            // Older workflows pre-dating the attachment lifecycle may not support this query.
-            phase = undefined;
-        }
-        const lines = [
-            `**Name:** ${metadata.playerId}`,
-            metadata.playerType ? `**Type:** ${metadata.playerType}` : null,
-            metadata.playerTypeDescription ? `**Description:** ${metadata.playerTypeDescription}` : null,
-            `**Ensemble:** ${metadata.ensemble}`,
-            `**Role:** ${metadata.isConductor ? 'Conductor' : 'Player'}`,
-            metadata.recruitedBy ? `**Recruited by:** ${metadata.recruitedBy}` : null,
-            `**Part:** ${part}`,
-            `**Directory:** ${metadata.workDir}`,
-            `**Host:** ${metadata.hostname}`,
-            metadata.gitBranch ? `**Branch:** ${metadata.gitBranch}` : null,
-            `**Phase:** ${phase ?? 'unknown'}`,
-        ].filter(Boolean);
-        return (0, helpers_1.ok)(lines.join('\n'));
-    });
+exports.buildWhoAmITool = buildWhoAmITool;
+const descriptor_1 = require("./descriptor");
+function buildWhoAmITool(handle, getPlayerId) {
+    return {
+        name: 'who_am_i',
+        description: 'Get your identity, role, and session details',
+        params: {},
+        handler: async () => {
+            const metadata = await handle.query('getMetadata');
+            const part = await handle.query('getPart');
+            // Attachment phase is authoritative post-#175/#176 (replaced legacy status).
+            let phase;
+            try {
+                const info = await handle.query('attachmentInfo');
+                phase = info.phase;
+            }
+            catch {
+                // Older workflows pre-dating the attachment lifecycle may not support this query.
+                phase = undefined;
+            }
+            const lines = [
+                `**Name:** ${metadata.playerId}`,
+                metadata.playerType ? `**Type:** ${metadata.playerType}` : null,
+                metadata.playerTypeDescription ? `**Description:** ${metadata.playerTypeDescription}` : null,
+                `**Ensemble:** ${metadata.ensemble}`,
+                `**Role:** ${metadata.isConductor ? 'Conductor' : 'Player'}`,
+                metadata.recruitedBy ? `**Recruited by:** ${metadata.recruitedBy}` : null,
+                `**Part:** ${part}`,
+                `**Directory:** ${metadata.workDir}`,
+                `**Host:** ${metadata.hostname}`,
+                metadata.gitBranch ? `**Branch:** ${metadata.gitBranch}` : null,
+                `**Phase:** ${phase ?? 'unknown'}`,
+            ].filter(Boolean);
+            return (0, descriptor_1.ok)(lines.join('\n'));
+        },
+    };
 }

package/dist/tools/worktree.d.ts

@@ -1,4 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Client, WorkflowHandle } from '@temporalio/client';
 import { Config } from '../config';
-export declare function registerWorktreeTool(server: McpServer, client: Client, config: Config, handle: WorkflowHandle, getPlayerId: () => string): void;
+import { type TempoToolDescriptor } from './descriptor';
+export declare function buildWorktreeTool(client: Client, config: Config, handle: WorkflowHandle, getPlayerId: () => string): TempoToolDescriptor;