@gestell/zowe-mcp 0.1.0

package/dist/src/services/zowe-async-tasks.js

@@ -0,0 +1,169 @@
+import { executeZowe } from '../services/zowe-executor.js';
+import { randomUUID } from 'crypto';
+const tasks = new Map();
+const DEFAULT_INLINE_WAIT_MS = 10_000;
+const DEFAULT_WAIT_TOOL_MAX_WAIT_MS = 55_000;
+const DEFAULT_WAIT_TOOL_POLL_INTERVAL_MS = 2_000;
+const DEFAULT_TASK_TTL_MS = 60 * 60 * 1000;
+const DEFAULT_MAX_TASKS = 300;
+export async function executeZoweManaged(command, args = []) {
+    cleanupTasks();
+    const task = startTask(command, args);
+    const waitMs = getPositiveInt(process.env.ZOWE_MCP_INLINE_WAIT_MS, DEFAULT_INLINE_WAIT_MS);
+    const completed = await waitForTask(task.id, waitMs);
+    if (!completed) {
+        return {
+            pending: true,
+            taskId: task.id
+        };
+    }
+    return {
+        pending: false,
+        taskId: task.id,
+        result: task.result || {
+            success: false,
+            stdout: '',
+            stderr: 'Async task finished without result payload.',
+            exitCode: 1
+        }
+    };
+}
+export function getAsyncTask(taskId) {
+    cleanupTasks();
+    const task = tasks.get(taskId);
+    if (!task)
+        return undefined;
+    return toPublicTask(task);
+}
+export function listAsyncTasks(status) {
+    cleanupTasks();
+    const all = Array.from(tasks.values())
+        .filter((task) => !status || task.status === status)
+        .sort((a, b) => (a.startedAt < b.startedAt ? 1 : -1));
+    return all.map(toPublicTask);
+}
+export function formatPendingTaskMessage(toolName, taskId) {
+    return [
+        `Command queued for async completion from \`${toolName}\`.`,
+        `task_id: ${taskId}`,
+        'Use `zowe_wait_async_task` (recommended) or `zowe_get_async_task` to poll for completion.'
+    ].join('\n');
+}
+export async function waitOnAsyncTask(taskId, maxWaitMs, pollIntervalMs) {
+    cleanupTasks();
+    const task = tasks.get(taskId);
+    if (!task) {
+        return { found: false, timedOut: false };
+    }
+    if (isCompleted(task)) {
+        return { found: true, timedOut: false, task: toPublicTask(task) };
+    }
+    const resolvedMaxWait = normalizePositiveInt(maxWaitMs, getPositiveInt(process.env.ZOWE_MCP_WAIT_TOOL_MAX_WAIT_MS, DEFAULT_WAIT_TOOL_MAX_WAIT_MS));
+    const resolvedPoll = normalizePositiveInt(pollIntervalMs, getPositiveInt(process.env.ZOWE_MCP_WAIT_TOOL_POLL_INTERVAL_MS, DEFAULT_WAIT_TOOL_POLL_INTERVAL_MS));
+    const started = Date.now();
+    while (Date.now() - started < resolvedMaxWait) {
+        const remaining = resolvedMaxWait - (Date.now() - started);
+        await Promise.race([
+            task.promise,
+            delay(Math.min(resolvedPoll, remaining))
+        ]);
+        if (isCompleted(task)) {
+            return { found: true, timedOut: false, task: toPublicTask(task) };
+        }
+    }
+    return { found: true, timedOut: true, task: toPublicTask(task) };
+}
+function startTask(command, args) {
+    const id = randomUUID();
+    const startedAt = new Date().toISOString();
+    const task = {
+        id,
+        command,
+        args: [...args],
+        status: 'running',
+        startedAt,
+        promise: Promise.resolve()
+    };
+    task.promise = executeZowe(command, args)
+        .then((result) => {
+        task.status = 'completed';
+        task.completedAt = new Date().toISOString();
+        task.result = result;
+    })
+        .catch((error) => {
+        task.status = 'completed';
+        task.completedAt = new Date().toISOString();
+        task.result = {
+            success: false,
+            stdout: '',
+            stderr: String(error),
+            exitCode: 1
+        };
+    });
+    tasks.set(id, task);
+    return task;
+}
+async function waitForTask(taskId, waitMs) {
+    const task = tasks.get(taskId);
+    if (!task)
+        return false;
+    if (task.status === 'completed')
+        return true;
+    const timeoutReached = await Promise.race([
+        task.promise.then(() => false),
+        delay(waitMs).then(() => true)
+    ]);
+    return !timeoutReached;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function cleanupTasks() {
+    const ttlMs = getPositiveInt(process.env.ZOWE_MCP_TASK_TTL_MS, DEFAULT_TASK_TTL_MS);
+    const maxTasks = getPositiveInt(process.env.ZOWE_MCP_MAX_TASKS, DEFAULT_MAX_TASKS);
+    const cutoff = Date.now() - ttlMs;
+    for (const [taskId, task] of tasks.entries()) {
+        if (task.status !== 'completed')
+            continue;
+        const completedAt = task.completedAt ? Date.parse(task.completedAt) : 0;
+        if (!completedAt || completedAt < cutoff) {
+            tasks.delete(taskId);
+        }
+    }
+    if (tasks.size <= maxTasks)
+        return;
+    const completed = Array.from(tasks.values())
+        .filter((task) => task.status === 'completed')
+        .sort((a, b) => (a.completedAt || '') < (b.completedAt || '') ? -1 : 1);
+    while (tasks.size > maxTasks && completed.length > 0) {
+        const oldest = completed.shift();
+        if (oldest)
+            tasks.delete(oldest.id);
+    }
+}
+function toPublicTask(task) {
+    return {
+        id: task.id,
+        command: task.command,
+        args: [...task.args],
+        status: task.status,
+        startedAt: task.startedAt,
+        completedAt: task.completedAt,
+        result: task.result
+    };
+}
+function getPositiveInt(value, fallback) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0)
+        return fallback;
+    return parsed;
+}
+function normalizePositiveInt(value, fallback) {
+    if (!Number.isInteger(value) || !value || value <= 0)
+        return fallback;
+    return value;
+}
+function isCompleted(task) {
+    return task.status === 'completed';
+}
+//# sourceMappingURL=zowe-async-tasks.js.map

package/dist/src/services/zowe-async-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zowe-async-tasks.js","sourceRoot":"","sources":["../../../src/services/zowe-async-tasks.ts"],"names":[],"mappings":"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"}

package/dist/src/services/zowe-executor.d.ts

@@ -0,0 +1,17 @@
+export interface ZoweResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    data?: unknown;
+    exitCode: number;
+}
+/**
+ * Execute a Zowe CLI command and return parsed results.
+ * In mock mode, returns realistic canned responses.
+ */
+export declare function executeZowe(command: string, args?: string[]): Promise<ZoweResult>;
+/**
+ * Execute a Zowe CLI command with --rfj (response format JSON) for structured output.
+ */
+export declare function executeZoweJson(command: string, args?: string[]): Promise<ZoweResult>;
+//# sourceMappingURL=zowe-executor.d.ts.map

package/dist/src/services/zowe-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zowe-executor.d.ts","sourceRoot":"","sources":["../../../src/services/zowe-executor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA8D3F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAE/F"}

package/dist/src/services/zowe-executor.js

@@ -0,0 +1,158 @@
+import { MOCK_MODE } from '../constants.js';
+import { getMockResponse } from '../services/mock-provider.js';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT_MS = 300_000;
+/**
+ * Execute a Zowe CLI command and return parsed results.
+ * In mock mode, returns realistic canned responses.
+ */
+export async function executeZowe(command, args = []) {
+    if (MOCK_MODE) {
+        return getMockResponse(command, args);
+    }
+    try {
+        const commandArgs = [...command.trim().split(/\s+/), ...args];
+        const timeoutMs = Number(process.env.ZOWE_MCP_EXEC_TIMEOUT_MS || DEFAULT_TIMEOUT_MS);
+        const { stdout, stderr } = await execFileAsync('zowe', commandArgs, {
+            timeout: Number.isFinite(timeoutMs) ? timeoutMs : DEFAULT_TIMEOUT_MS,
+            maxBuffer: 10 * 1024 * 1024,
+            env: { ...process.env }
+        });
+        // Try to parse JSON output (Zowe supports --rfj for JSON)
+        let data = undefined;
+        try {
+            data = JSON.parse(stdout);
+        }
+        catch {
+            // Not JSON, that's fine
+        }
+        return {
+            success: true,
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            data,
+            exitCode: 0
+        };
+    }
+    catch (error) {
+        const execError = error;
+        const stdout = asText(execError.stdout).trim();
+        const stderr = asText(execError.stderr).trim();
+        const stdoutJson = tryParseJson(stdout);
+        const stderrJson = tryParseJson(stderr);
+        return {
+            success: false,
+            stdout,
+            stderr: buildErrorMessage({
+                stderrText: stderr,
+                stdoutText: stdout,
+                stdoutJson,
+                stderrJson,
+                errorMessage: execError.message,
+                exitCode: execError.code,
+                signal: execError.signal,
+                killed: execError.killed,
+                cmd: execError.cmd
+            }),
+            data: stdoutJson || stderrJson,
+            exitCode: execError.code || 1
+        };
+    }
+}
+/**
+ * Execute a Zowe CLI command with --rfj (response format JSON) for structured output.
+ */
+export async function executeZoweJson(command, args = []) {
+    return executeZowe(command, [...args, '--rfj']);
+}
+function asText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Buffer.isBuffer(value))
+        return value.toString('utf8');
+    return '';
+}
+function tryParseJson(text) {
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildErrorMessage(input) {
+    const { stderrText, stdoutText, stdoutJson, stderrJson, errorMessage, exitCode, signal, killed, cmd } = input;
+    const parts = [];
+    if (stderrText) {
+        parts.push(stderrText);
+    }
+    const jsonMessages = [
+        ...extractMessages(stdoutJson),
+        ...extractMessages(stderrJson)
+    ];
+    for (const message of jsonMessages) {
+        parts.push(message);
+    }
+    if (!stderrText && !jsonMessages.length && stdoutText) {
+        parts.push(stdoutText);
+    }
+    if (errorMessage) {
+        parts.push(errorMessage);
+    }
+    if (typeof exitCode === 'number') {
+        parts.push(`Exit code: ${exitCode}`);
+    }
+    if (signal) {
+        parts.push(`Signal: ${signal}`);
+    }
+    if (killed) {
+        parts.push('Process was killed (likely timeout).');
+    }
+    if (cmd) {
+        parts.push(`CLI command: ${cmd}`);
+    }
+    if (!stderrText && !stdoutText && !jsonMessages.length) {
+        parts.push('No CLI output captured. This often means credentials/prompt/keychain issues in non-interactive sessions.');
+        parts.push(`Runtime env: HOME=${process.env.HOME || '<unset>'}, ZOWE_CLI_HOME=${process.env.ZOWE_CLI_HOME || '<unset>'}`);
+    }
+    const deduped = Array.from(new Set(parts.map((p) => p.trim()).filter(Boolean)));
+    return deduped.join('\n');
+}
+function extractMessages(value) {
+    const messages = [];
+    const seen = new Set();
+    const keys = ['message', 'msg', 'error', 'details', 'reason', 'stderr', 'stdout'];
+    const visit = (node) => {
+        if (!node || seen.has(node))
+            return;
+        if (typeof node === 'string') {
+            const trimmed = node.trim();
+            if (trimmed)
+                messages.push(trimmed);
+            return;
+        }
+        if (typeof node !== 'object')
+            return;
+        seen.add(node);
+        if (Array.isArray(node)) {
+            for (const item of node)
+                visit(item);
+            return;
+        }
+        const record = node;
+        for (const key of keys) {
+            if (key in record)
+                visit(record[key]);
+        }
+        // Some Zowe responses include an array of diagnostics under "messages".
+        if ('messages' in record)
+            visit(record.messages);
+    };
+    visit(value);
+    return messages;
+}
+//# sourceMappingURL=zowe-executor.js.map

package/dist/src/services/zowe-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zowe-executor.js","sourceRoot":"","sources":["../../../src/services/zowe-executor.ts"],"names":[],"mappings":"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"}

package/dist/src/services/zowe-options.d.ts

@@ -0,0 +1,13 @@
+export interface ZoweOptionOverrides {
+    account?: string;
+    base_profile?: string;
+    tso_profile?: string;
+    zosmf_profile?: string;
+}
+export interface ZoweOptionScope {
+    allowAccount?: boolean;
+    allowTsoProfile?: boolean;
+    allowZosmfProfile?: boolean;
+}
+export declare function withZoweOptions(args: string[], overrides: ZoweOptionOverrides, scope: ZoweOptionScope): string[];
+//# sourceMappingURL=zowe-options.d.ts.map

package/dist/src/services/zowe-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zowe-options.d.ts","sourceRoot":"","sources":["../../../src/services/zowe-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,eAAe,GACrB,MAAM,EAAE,CAwBV"}

package/dist/src/services/zowe-options.js

@@ -0,0 +1,34 @@
+export function withZoweOptions(args, overrides, scope) {
+    const resolved = [...args];
+    const baseProfile = normalize(overrides.base_profile ||
+        process.env.ZOWE_MCP_BASE_PROFILE ||
+        getLegacyBaseProfile());
+    const zosmfProfile = normalize(overrides.zosmf_profile || process.env.ZOWE_MCP_ZOSMF_PROFILE);
+    const tsoProfile = normalize(overrides.tso_profile || process.env.ZOWE_MCP_TSO_PROFILE);
+    const tsoAccount = normalize(overrides.account || process.env.ZOWE_MCP_TSO_ACCOUNT);
+    appendIfMissing(resolved, '--base-profile', baseProfile);
+    if (scope.allowZosmfProfile)
+        appendIfMissing(resolved, '--zosmf-profile', zosmfProfile);
+    if (scope.allowTsoProfile)
+        appendIfMissing(resolved, '--tso-profile', tsoProfile);
+    if (scope.allowAccount)
+        appendIfMissing(resolved, '--account', tsoAccount);
+    return resolved;
+}
+function appendIfMissing(args, flag, value) {
+    if (!value || args.includes(flag))
+        return;
+    args.push(flag, value);
+}
+function normalize(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function getLegacyBaseProfile() {
+    const legacy = normalize(process.env.ZOWE_PROFILE);
+    if (!legacy || legacy.toLowerCase() === 'default') {
+        return undefined;
+    }
+    return legacy;
+}
+//# sourceMappingURL=zowe-options.js.map

package/dist/src/services/zowe-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zowe-options.js","sourceRoot":"","sources":["../../../src/services/zowe-options.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,eAAe,CAC7B,IAAc,EACd,SAA8B,EAC9B,KAAsB;IAEtB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;IAE1B,MAAM,WAAW,GAAG,SAAS,CAC3B,SAAS,CAAC,YAAY;QACpB,OAAO,CAAC,GAAG,CAAC,qBAAqB;QACjC,oBAAoB,EAAE,CACzB,CAAA;IACD,MAAM,YAAY,GAAG,SAAS,CAC5B,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAC9D,CAAA;IACD,MAAM,UAAU,GAAG,SAAS,CAC1B,SAAS,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAC1D,CAAA;IACD,MAAM,UAAU,GAAG,SAAS,CAC1B,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CACtD,CAAA;IAED,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAA;IACxD,IAAI,KAAK,CAAC,iBAAiB;QAAE,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAA;IACvF,IAAI,KAAK,CAAC,eAAe;QAAE,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,CAAA;IACjF,IAAI,KAAK,CAAC,YAAY;QAAE,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;IAE1E,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,IAAY,EAAE,KAAc;IACnE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAM;IACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAA;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;AACtC,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/src/tools/async-tasks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAsyncTaskTools(server: McpServer): void;
+//# sourceMappingURL=async-tasks.d.ts.map

package/dist/src/tools/async-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-tasks.d.ts","sourceRoot":"","sources":["../../../src/tools/async-tasks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAInE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgM9D"}

package/dist/src/tools/async-tasks.js

@@ -0,0 +1,165 @@
+import { getAsyncTaskInputSchema, listAsyncTasksInputSchema, waitAsyncTaskInputSchema } from '../../schema/tools/async-tasks.js';
+import { listAsyncTasks, getAsyncTask, waitOnAsyncTask } from '../services/zowe-async-tasks.js';
+export function registerAsyncTaskTools(server) {
+    server.registerTool('zowe_get_async_task', {
+        title: 'Get Async Task Status',
+        description: 'Poll an async Zowe command task by task ID.',
+        inputSchema: getAsyncTaskInputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    }, async (params) => {
+        const task = getAsyncTask(params.task_id);
+        if (!task) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Task not found: ${params.task_id}`
+                    }]
+            };
+        }
+        if (task.status === 'running') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `Task ${task.id} is still running.`,
+                            `Started: ${task.startedAt}`,
+                            `Command: zowe ${task.command} ${task.args.join(' ')}`
+                        ].join('\n')
+                    }]
+            };
+        }
+        const result = task.result;
+        if (!result) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Task ${task.id} completed but has no result payload.`
+                    }]
+            };
+        }
+        const lines = [
+            `Task ${task.id} completed.`,
+            `Started: ${task.startedAt}`,
+            task.completedAt ? `Completed: ${task.completedAt}` : null,
+            `Command: zowe ${task.command} ${task.args.join(' ')}`,
+            `Success: ${result.success}`,
+            `Exit code: ${result.exitCode}`,
+            ''
+        ].filter(Boolean);
+        if (result.stdout) {
+            lines.push('**stdout**');
+            lines.push('```');
+            lines.push(result.stdout);
+            lines.push('```');
+        }
+        if (result.stderr) {
+            lines.push('**stderr**');
+            lines.push('```');
+            lines.push(result.stderr);
+            lines.push('```');
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: lines.join('\n')
+                }]
+        };
+    });
+    server.registerTool('zowe_wait_async_task', {
+        title: 'Wait for Async Task',
+        description: 'Wait for an async task to complete within this call window. This is the recommended polling tool for agents.',
+        inputSchema: waitAsyncTaskInputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    }, async (params) => {
+        const waitResult = await waitOnAsyncTask(params.task_id, params.max_wait_ms, params.poll_interval_ms);
+        if (!waitResult.found) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Task not found: ${params.task_id}`
+                    }]
+            };
+        }
+        const task = waitResult.task;
+        if (!task) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Task ${params.task_id} found but no task payload is available.`
+                    }]
+            };
+        }
+        if (waitResult.timedOut || task.status === 'running') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `Task ${task.id} is still running.`,
+                            `Started: ${task.startedAt}`,
+                            `Command: zowe ${task.command} ${task.args.join(' ')}`,
+                            'Call zowe_wait_async_task again with the same task_id.'
+                        ].join('\n')
+                    }]
+            };
+        }
+        const result = task.result;
+        if (!result) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Task ${task.id} completed but has no result payload.`
+                    }]
+            };
+        }
+        const lines = [
+            `Task ${task.id} completed.`,
+            `Started: ${task.startedAt}`,
+            task.completedAt ? `Completed: ${task.completedAt}` : null,
+            `Command: zowe ${task.command} ${task.args.join(' ')}`,
+            `Success: ${result.success}`,
+            `Exit code: ${result.exitCode}`,
+            ''
+        ].filter(Boolean);
+        if (result.stdout) {
+            lines.push('**stdout**');
+            lines.push('```');
+            lines.push(result.stdout);
+            lines.push('```');
+        }
+        if (result.stderr) {
+            lines.push('**stderr**');
+            lines.push('```');
+            lines.push(result.stderr);
+            lines.push('```');
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: lines.join('\n')
+                }]
+        };
+    });
+    server.registerTool('zowe_list_async_tasks', {
+        title: 'List Async Tasks',
+        description: 'List recent async Zowe command tasks with status.',
+        inputSchema: listAsyncTasksInputSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    }, async (params) => {
+        const tasks = listAsyncTasks(params.status);
+        if (tasks.length === 0) {
+            return { content: [{ type: 'text', text: 'No async tasks found.' }] };
+        }
+        const lines = tasks.map((task) => `${task.id} | ${task.status} | ${task.startedAt} | zowe ${task.command} ${task.args.join(' ')}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `Found ${tasks.length} async task(s):`,
+                        '',
+                        ...lines
+                    ].join('\n')
+                }]
+        };
+    });
+}
+//# sourceMappingURL=async-tasks.js.map

package/dist/src/tools/async-tasks.js.map

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

package/dist/src/tools/datasets.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDatasetTools(server: McpServer): void;
+//# sourceMappingURL=datasets.d.ts.map

package/dist/src/tools/datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../../src/tools/datasets.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAKnE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4P5D"}