@tankpkg/mcp-server 0.4.2 → 0.5.0

package/dist/tools/doctor.js

@@ -0,0 +1,158 @@
+import fs from 'node:fs';
+import { getConfigPath, getConfig } from '../lib/config.js';
+import { TankApiClient } from '../lib/api-client.js';
+const MIN_NODE_MAJOR = 24;
+function checkConfigFile() {
+    const configPath = getConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return {
+            name: 'Configuration File',
+            status: 'FAIL',
+            message: `Configuration file not found at ${configPath}. Run the login tool to create it.`,
+        };
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        JSON.parse(raw);
+        return {
+            name: 'Configuration File',
+            status: 'PASS',
+            message: `Configuration file exists and is valid JSON (${configPath}).`,
+        };
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Configuration File',
+            status: 'FAIL',
+            message: `Configuration file at ${configPath} is malformed: ${detail}`,
+        };
+    }
+}
+async function checkAuthentication() {
+    const client = new TankApiClient();
+    if (!client.isAuthenticated) {
+        return {
+            name: 'Authentication',
+            status: 'FAIL',
+            message: 'Not authenticated. Use the login tool to authenticate with Tank.',
+        };
+    }
+    const authCheck = await client.verifyAuth();
+    if (authCheck.valid) {
+        const name = authCheck.user.name ?? 'unknown';
+        return {
+            name: 'Authentication',
+            status: 'PASS',
+            message: `Authenticated as ${name}.`,
+        };
+    }
+    if (authCheck.reason === 'network-error') {
+        return {
+            name: 'Authentication',
+            status: 'FAIL',
+            message: `Could not verify credentials (network error). ${authCheck.error ?? ''}`.trim(),
+        };
+    }
+    return {
+        name: 'Authentication',
+        status: 'FAIL',
+        message: 'Credentials are expired or invalid. Use the login tool to re-authenticate.',
+    };
+}
+async function checkRegistryConnectivity() {
+    const config = getConfig();
+    const registryUrl = config.registry;
+    try {
+        const healthUrl = `${registryUrl}/api/health`;
+        const response = await fetch(healthUrl, {
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (response.ok) {
+            return {
+                name: 'Registry Connectivity',
+                status: 'PASS',
+                message: `Registry at ${registryUrl} is reachable.`,
+            };
+        }
+        return {
+            name: 'Registry Connectivity',
+            status: 'FAIL',
+            message: `Registry at ${registryUrl} returned HTTP ${response.status}.`,
+        };
+    }
+    catch {
+        return {
+            name: 'Registry Connectivity',
+            status: 'FAIL',
+            message: `Cannot reach registry at ${registryUrl}. Check your network connection.`,
+        };
+    }
+}
+function checkNodeVersion() {
+    const raw = process.version;
+    const match = raw.match(/^v(\d+)/);
+    const major = match ? parseInt(match[1], 10) : 0;
+    if (major >= MIN_NODE_MAJOR) {
+        return {
+            name: 'Node.js Version',
+            status: 'PASS',
+            message: `Node.js ${raw} meets the minimum requirement (v${MIN_NODE_MAJOR}.0.0).`,
+        };
+    }
+    return {
+        name: 'Node.js Version',
+        status: 'FAIL',
+        message: `Node.js ${raw} is below the minimum required version v${MIN_NODE_MAJOR}.0.0. Please upgrade Node.js.`,
+    };
+}
+function formatChecks(checks) {
+    const lines = [];
+    lines.push('Tank Doctor Report');
+    lines.push('==================');
+    lines.push('');
+    for (const check of checks) {
+        const icon = check.status === 'PASS' ? 'PASS' : 'FAIL';
+        lines.push(`[${icon}] ${check.name}`);
+        lines.push(`      ${check.message}`);
+    }
+    lines.push('');
+    const failedChecks = checks.filter((c) => c.status === 'FAIL');
+    const allPassed = failedChecks.length === 0;
+    if (allPassed) {
+        lines.push('All checks passed. Your Tank environment is ready to use.');
+    }
+    else {
+        lines.push('Suggestions:');
+        for (const check of failedChecks) {
+            if (check.name === 'Authentication') {
+                lines.push('  - Use the login tool to authenticate with Tank.');
+            }
+            else if (check.name === 'Registry Connectivity') {
+                lines.push('  - Check your network connection and verify the registry URL.');
+            }
+            else if (check.name === 'Node.js Version') {
+                lines.push(`  - Upgrade Node.js to v${MIN_NODE_MAJOR}.0.0 or later.`);
+            }
+            else if (check.name === 'Configuration File') {
+                lines.push('  - Use the login tool to create a valid configuration file.');
+            }
+        }
+        lines.push('');
+        lines.push('The environment is not healthy. Please address the issues above.');
+    }
+    return lines.join('\n');
+}
+export function registerDoctorTool(server) {
+    server.tool('doctor', 'Diagnose Tank setup and environment.', {}, async () => {
+        const checks = [];
+        checks.push(checkConfigFile());
+        checks.push(await checkAuthentication());
+        checks.push(await checkRegistryConnectivity());
+        checks.push(checkNodeVersion());
+        return {
+            content: [{ type: 'text', text: formatChecks(checks) }],
+        };
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/tools/doctor.js.map

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

package/dist/tools/init-skill.d.ts

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

package/dist/tools/init-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-skill.d.ts","sourceRoot":"","sources":["../../src/tools/init-skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+E7D"}

package/dist/tools/init-skill.js

@@ -0,0 +1,72 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { skillsJsonSchema } from '@tank/shared';
+import { z } from 'zod';
+const SCOPED_NAME_PATTERN = /^@[a-z0-9-]+\/[a-z0-9][a-z0-9-]*$/;
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?(\+[a-zA-Z0-9.-]+)?$/;
+export function registerInitSkillTool(server) {
+    server.tool('init-skill', 'Create a new skills.json and SKILL.md template for a Tank skill.', {
+        name: z.string().regex(SCOPED_NAME_PATTERN, 'Name must be in @org/name format'),
+        version: z.string().regex(SEMVER_PATTERN, 'Version must be valid semver').optional().default('0.1.0'),
+        description: z.string().optional().default(''),
+        directory: z.string().optional().default('.'),
+    }, async ({ name, version = '0.1.0', description = '', directory = '.' }) => {
+        const targetDir = path.resolve(directory);
+        if (!fs.existsSync(targetDir)) {
+            return {
+                content: [{ type: 'text', text: `Directory does not exist: ${targetDir}` }],
+            };
+        }
+        if (!fs.statSync(targetDir).isDirectory()) {
+            return {
+                content: [{ type: 'text', text: `Path is not a directory: ${targetDir}` }],
+            };
+        }
+        const skillsJsonPath = path.join(targetDir, 'skills.json');
+        if (fs.existsSync(skillsJsonPath)) {
+            return {
+                content: [{ type: 'text', text: `skills.json already exists at ${skillsJsonPath}. Aborting to avoid overwrite.` }],
+            };
+        }
+        const manifest = {
+            name,
+            version,
+            description,
+            skills: {},
+            permissions: {
+                network: { outbound: [] },
+                filesystem: { read: [], write: [] },
+                subprocess: false,
+            },
+        };
+        const parseResult = skillsJsonSchema.safeParse(manifest);
+        if (!parseResult.success) {
+            const details = parseResult.error.issues
+                .map((issue) => `${issue.path.join('.') || 'root'}: ${issue.message}`)
+                .join('; ');
+            return {
+                content: [{ type: 'text', text: `Failed to create skills.json: ${details}` }],
+            };
+        }
+        fs.writeFileSync(skillsJsonPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+        const skillMdPath = path.join(targetDir, 'SKILL.md');
+        let createdSkillMd = false;
+        if (!fs.existsSync(skillMdPath)) {
+            const skillMd = `# ${name}\n\n${description || 'Description here.'}\n`;
+            fs.writeFileSync(skillMdPath, skillMd, 'utf-8');
+            createdSkillMd = true;
+        }
+        const skillMdLine = createdSkillMd
+            ? `Created: ${skillMdPath}`
+            : `Skipped existing: ${skillMdPath}`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Initialized skill in ${targetDir}\nCreated: ${skillsJsonPath}\n${skillMdLine}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=init-skill.js.map

package/dist/tools/init-skill.js.map

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

package/dist/tools/install-skill.d.ts

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

package/dist/tools/install-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../src/tools/install-skill.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2CzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4NhE"}

package/dist/tools/install-skill.js

@@ -0,0 +1,206 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { resolve, LOCKFILE_VERSION } from '@tank/shared';
+import { extract } from 'tar';
+import { z } from 'zod';
+import { TankApiClient } from '../lib/api-client.js';
+const SCOPED_NAME_PATTERN = /^@[a-z0-9-]+\/[a-z0-9][a-z0-9-]*$/;
+function textResult(text, isError) {
+    return {
+        content: [{ type: 'text', text }],
+        ...(isError ? { isError: true } : {}),
+    };
+}
+function getSkillDir(projectDir, skillName) {
+    if (skillName.startsWith('@')) {
+        const [scope, name] = skillName.split('/');
+        return path.join(projectDir, '.tank', 'skills', scope, name);
+    }
+    return path.join(projectDir, '.tank', 'skills', skillName);
+}
+export function registerInstallSkillTool(server) {
+    server.tool('install-skill', 'Install a skill from the Tank registry. Resolves version, downloads tarball, verifies SHA-512 integrity, extracts files, and updates skills.json + skills.lock.', {
+        name: z.string().describe('Skill name in @org/name format'),
+        version: z.string().optional().describe('Specific version or semver range (default: latest)'),
+        directory: z.string().optional().describe('Project directory (defaults to current working directory)'),
+    }, async ({ name, version: versionRange, directory }) => {
+        // 1. Validate scoped name
+        if (!SCOPED_NAME_PATTERN.test(name)) {
+            return textResult(`Validation error: Skill name "${name}" must use the @org/name format (e.g. @acme/my-skill).`, true);
+        }
+        const client = new TankApiClient();
+        // 2. Check authentication
+        if (!client.isAuthenticated) {
+            return textResult('Not authenticated. Use the "login" tool first to authenticate with Tank.', true);
+        }
+        const dir = directory ? path.resolve(directory) : process.cwd();
+        const range = versionRange ?? '*';
+        // 3. Read or create skills.json
+        const skillsJsonPath = path.join(dir, 'skills.json');
+        let skillsJson = { skills: {} };
+        if (fs.existsSync(skillsJsonPath)) {
+            try {
+                const raw = fs.readFileSync(skillsJsonPath, 'utf-8');
+                skillsJson = JSON.parse(raw);
+            }
+            catch {
+                return textResult('Failed to read or parse skills.json.', true);
+            }
+        }
+        else {
+            skillsJson = { skills: {} };
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(skillsJsonPath, JSON.stringify(skillsJson, null, 2) + '\n');
+        }
+        // 4. Read existing lockfile
+        const lockPath = path.join(dir, 'skills.lock');
+        let lock = { lockfileVersion: LOCKFILE_VERSION, skills: {} };
+        if (fs.existsSync(lockPath)) {
+            try {
+                const raw = fs.readFileSync(lockPath, 'utf-8');
+                lock = JSON.parse(raw);
+            }
+            catch {
+                lock = { lockfileVersion: LOCKFILE_VERSION, skills: {} };
+            }
+        }
+        // 5. Fetch available versions
+        const encodedName = encodeURIComponent(name);
+        const versionsResult = await client.fetch(`/api/v1/skills/${encodedName}/versions`);
+        if (!versionsResult.ok) {
+            if (versionsResult.status === 401 || versionsResult.status === 403) {
+                return textResult('Authentication failed. Use the "login" tool to authenticate with Tank.', true);
+            }
+            if (versionsResult.status === 404) {
+                return textResult(`Skill not found: "${name}" does not exist in the Tank registry.`, true);
+            }
+            if (versionsResult.status === 0) {
+                return textResult(`Cannot reach the Tank registry. Check your network connection and try again.\nError: ${versionsResult.error}`, true);
+            }
+            return textResult(`Failed to fetch versions for ${name}: ${versionsResult.error}`, true);
+        }
+        const availableVersions = versionsResult.data.versions.map((v) => v.version);
+        // 6. Resolve best version
+        const resolved = resolve(range, availableVersions);
+        if (!resolved) {
+            return textResult(`No version of ${name} satisfies range "${range}". Available versions: ${availableVersions.join(', ')}`, true);
+        }
+        // 7. Check if already installed
+        const lockKey = `${name}@${resolved}`;
+        if (lock.skills[lockKey]) {
+            return textResult(`${name}@${resolved} is already installed. No changes needed.`);
+        }
+        // 8. Fetch version metadata
+        const metaResult = await client.fetch(`/api/v1/skills/${encodedName}/${resolved}`);
+        if (!metaResult.ok) {
+            if (metaResult.status === 404) {
+                return textResult(`Version ${resolved} of ${name} not found in the registry.`, true);
+            }
+            return textResult(`Failed to fetch metadata for ${name}@${resolved}: ${metaResult.error}`, true);
+        }
+        const metadata = metaResult.data;
+        // 9. Download tarball
+        let tarballBuffer;
+        try {
+            const downloadRes = await fetch(metadata.downloadUrl);
+            if (!downloadRes.ok) {
+                return textResult(`Failed to download tarball for ${name}@${resolved}: ${downloadRes.status} ${downloadRes.statusText}`, true);
+            }
+            tarballBuffer = Buffer.from(await downloadRes.arrayBuffer());
+        }
+        catch (err) {
+            return textResult(`Network error downloading tarball for ${name}@${resolved}: ${err instanceof Error ? err.message : String(err)}`, true);
+        }
+        // 10. Verify SHA-512 integrity
+        const hash = crypto.createHash('sha512').update(tarballBuffer).digest('base64');
+        const computedIntegrity = `sha512-${hash}`;
+        if (computedIntegrity !== metadata.integrity) {
+            return textResult(`Integrity verification failed for ${name}@${resolved}.\n` +
+                `Expected: ${metadata.integrity}\n` +
+                `Got: ${computedIntegrity}\n\n` +
+                'The tarball may have been tampered with. No files were extracted.', true);
+        }
+        // 11. Extract tarball safely
+        const extractDir = getSkillDir(dir, name);
+        fs.mkdirSync(extractDir, { recursive: true });
+        try {
+            await extractSafely(tarballBuffer, extractDir);
+        }
+        catch (err) {
+            // Clean up on extraction failure
+            fs.rmSync(extractDir, { recursive: true, force: true });
+            return textResult(`Failed to extract tarball for ${name}@${resolved}: ${err instanceof Error ? err.message : String(err)}`, true);
+        }
+        // 12. Update skills.json
+        const skills = (skillsJson.skills ?? {});
+        skills[name] = range === '*' ? `^${resolved}` : range;
+        skillsJson.skills = skills;
+        fs.writeFileSync(skillsJsonPath, JSON.stringify(skillsJson, null, 2) + '\n');
+        // 13. Update skills.lock
+        lock.skills[lockKey] = {
+            resolved: metadata.downloadUrl,
+            integrity: computedIntegrity,
+            permissions: metadata.permissions ?? {},
+            audit_score: metadata.auditScore ?? null,
+        };
+        // Sort keys alphabetically for determinism
+        const sortedSkills = {};
+        for (const key of Object.keys(lock.skills).sort()) {
+            sortedSkills[key] = lock.skills[key];
+        }
+        lock.skills = sortedSkills;
+        fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+        fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2) + '\n');
+        // Build response
+        const score = metadata.auditScore !== null && metadata.auditScore !== undefined
+            ? `${metadata.auditScore.toFixed(1)}/10`
+            : 'pending';
+        const lines = [
+            `## Installed ${name}@${resolved}`,
+            '',
+            `**Integrity:** SHA-512 verified`,
+            `**Audit Score:** ${score}`,
+            `**Extracted to:** ${extractDir}`,
+            '',
+            '### Updated files',
+            `- skills.json: added "${name}": "${skills[name]}"`,
+            `- skills.lock: added ${lockKey}`,
+        ];
+        return textResult(lines.join('\n'));
+    });
+}
+/**
+ * Extract a tarball safely with security checks.
+ * Rejects: absolute paths, path traversal (..), symlinks/hardlinks.
+ */
+async function extractSafely(tarball, destDir) {
+    const tmpTarball = path.join(destDir, '.tmp-tarball.tgz');
+    fs.writeFileSync(tmpTarball, tarball);
+    try {
+        await extract({
+            file: tmpTarball,
+            cwd: destDir,
+            filter: (entryPath) => {
+                if (path.isAbsolute(entryPath)) {
+                    throw new Error(`Absolute path in tarball: ${entryPath}`);
+                }
+                if (entryPath.split('/').includes('..') || entryPath.split(path.sep).includes('..')) {
+                    throw new Error(`Path traversal in tarball: ${entryPath}`);
+                }
+                return true;
+            },
+            onReadEntry: (entry) => {
+                if (entry.type === 'SymbolicLink' || entry.type === 'Link') {
+                    throw new Error(`Symlink/hardlink in tarball: ${entry.path}`);
+                }
+            },
+        });
+    }
+    finally {
+        if (fs.existsSync(tmpTarball)) {
+            fs.unlinkSync(tmpTarball);
+        }
+    }
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/tools/install-skill.js.map

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

package/dist/tools/link-skill.d.ts

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

package/dist/tools/link-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-skill.d.ts","sourceRoot":"","sources":["../../src/tools/link-skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiF7D"}

package/dist/tools/link-skill.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+const SCOPED_NAME_PATTERN = /^@[a-z0-9-]+\/[a-z0-9][a-z0-9-]*$/;
+export function registerLinkSkillTool(server) {
+    server.tool('link-skill', 'Link an installed skill into an agent workspace. Creates a symlink from the workspace .skills directory to the installed skill.', {
+        name: z.string().describe('Skill name in @org/name format'),
+        workspace: z.string().describe('Agent workspace directory path'),
+        directory: z.string().optional().describe('Project directory where skills are installed (defaults to current working directory)'),
+    }, async ({ name, workspace, directory }) => {
+        if (!SCOPED_NAME_PATTERN.test(name)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Validation error: Skill name "${name}" must use the @org/name format (e.g. @acme/my-skill).`,
+                    }],
+                isError: true,
+            };
+        }
+        const projectDir = directory ? path.resolve(directory) : process.cwd();
+        const workspaceDir = path.resolve(workspace);
+        if (!fs.existsSync(workspaceDir)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error: Workspace directory does not exist: ${workspaceDir}`,
+                    }],
+                isError: true,
+            };
+        }
+        const skillDir = getSkillDir(projectDir, name);
+        if (!fs.existsSync(skillDir)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Skill "${name}" is not installed. Install it first with "install-skill" before linking.`,
+                    }],
+                isError: true,
+            };
+        }
+        const [scope, skillName] = name.split('/');
+        const skillsLinkDir = path.join(workspaceDir, '.skills', scope);
+        const symlinkPath = path.join(skillsLinkDir, skillName);
+        try {
+            const stats = fs.lstatSync(symlinkPath);
+            if (stats.isSymbolicLink()) {
+                const currentTarget = fs.readlinkSync(symlinkPath);
+                const resolvedTarget = path.isAbsolute(currentTarget)
+                    ? currentTarget
+                    : path.resolve(path.dirname(symlinkPath), currentTarget);
+                if (path.resolve(resolvedTarget) === path.resolve(skillDir)) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Skill "${name}" is already linked in ${workspaceDir}.`,
+                            }],
+                    };
+                }
+                fs.unlinkSync(symlinkPath);
+            }
+        }
+        catch {
+        }
+        fs.mkdirSync(skillsLinkDir, { recursive: true });
+        fs.symlinkSync(skillDir, symlinkPath, 'dir');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Successfully linked "${name}" into ${workspaceDir}.\nSymlink: ${symlinkPath} → ${skillDir}`,
+                }],
+        };
+    });
+}
+function getSkillDir(projectDir, skillName) {
+    if (skillName.startsWith('@')) {
+        const [scope, name] = skillName.split('/');
+        return path.join(projectDir, '.tank', 'skills', scope, name);
+    }
+    return path.join(projectDir, '.tank', 'skills', skillName);
+}
+//# sourceMappingURL=link-skill.js.map

package/dist/tools/link-skill.js.map

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

package/dist/tools/logout.d.ts

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

package/dist/tools/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/tools/logout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0B1D"}

package/dist/tools/logout.js

@@ -0,0 +1,19 @@
+import { getConfig, setConfig } from '../lib/config.js';
+export function registerLogoutTool(server) {
+    server.tool('logout', 'Log out of Tank by clearing local credentials.', {}, async () => {
+        const config = getConfig();
+        if (!config.token) {
+            return {
+                content: [{ type: 'text', text: 'Not logged in. No credentials to clear.' }],
+            };
+        }
+        setConfig({ token: undefined, user: undefined });
+        // Also clear env-based token so subsequent tool calls in this
+        // process don't re-read it via getConfig().
+        delete process.env.TANK_TOKEN;
+        return {
+            content: [{ type: 'text', text: 'Successfully logged out.' }],
+        };
+    });
+}
+//# sourceMappingURL=logout.js.map

package/dist/tools/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/tools/logout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,gDAAgD,EAChD,EAAE,EACF,KAAK,IAAI,EAAE;QAET,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC;aACtF,CAAC;QACJ,CAAC;QAED,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAEjD,8DAA8D;QAC9D,4CAA4C;QAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAE9B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;SACvE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/remove-skill.d.ts

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

package/dist/tools/remove-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-skill.d.ts","sourceRoot":"","sources":["../../src/tools/remove-skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4G/D"}