@vibecodetown/mcp-server 1.3.1 → 1.5.0

package/build/mcp/tools/vibe_pm/agent.js

@@ -0,0 +1,973 @@
+// vibe_pm.agent - Agent lifecycle management tool
+//
+// Unified entry point for AI agent scaffold, registration, listing, and status.
+// Modes: scaffold, list, status, register, pack
+// Uses FAIL-SAFE pattern (never throws, returns structured output).
+import { z } from "zod";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { validateAgentManifest } from "../../agents/manifest_validator.js";
+import { verifyAllChecksums } from "../../agents/checksum.js";
+const execFileAsync = promisify(execFile);
+// ============================================================================
+// Input Schema
+// ============================================================================
+export const AgentInputSchema = z.object({
+    mode: z.enum(["scaffold", "list", "status", "register", "pack", "deploy", "verify", "release"])
+        .describe("작업 모드: scaffold(생성), list(목록), status(상태), register(등록), pack(패키징), deploy(배포), verify(체크섬 검증), release(전체 릴리즈)"),
+    agent_id: z.string().optional()
+        .describe("에이전트 ID (scaffold/status/register/pack/deploy 모드에서 사용)"),
+    agent_type: z.enum(["mcp-tool", "cli-agent", "http-service", "worker-agent"])
+        .optional()
+        .describe("에이전트 타입 (scaffold 모드에서 사용)"),
+    display_name: z.string().optional()
+        .describe("에이전트 표시 이름 (scaffold 모드)"),
+    description: z.string().optional()
+        .describe("에이전트 설명 (scaffold 모드)"),
+    target_dir: z.string().optional()
+        .describe("대상 디렉토리 (생략 시 현재 폴더)"),
+    deploy_target: z.enum(["local", "container", "npm", "mesh"]).optional()
+        .describe("배포 타겟 (deploy 모드): local(로컬), container(Containerfile+빌드), npm(npm publish), mesh(Gateway 분산배포)"),
+    prime_url: z.string().optional()
+        .describe("Prime API URL (mesh 모드, 기본: http://127.0.0.1:8791)"),
+    output_dir: z.string().optional()
+        .describe("번들 출력 디렉토리 (pack 모드, 생략 시 현재 폴더)"),
+    bump_version: z.enum(["patch", "minor", "major"]).optional()
+        .describe("버전 범프 (pack 모드): patch(0.0.X), minor(0.X.0), major(X.0.0)"),
+}).strict();
+// ============================================================================
+// Output Schema
+// ============================================================================
+export const AgentOutputSchema = z.object({
+    status: z.enum(["OK", "ERROR"]),
+    mode: z.string(),
+    agent_id: z.string().optional(),
+    message: z.string(),
+    data: z.any().optional(),
+    error: z.string().optional(),
+});
+function getTemplatesDir() {
+    // Templates are bundled with the package
+    return path.resolve(__dirname, "../../../../templates/agents");
+}
+async function loadTemplate(agentType) {
+    const templatesDir = getTemplatesDir();
+    const templateDir = path.join(templatesDir, agentType);
+    try {
+        await fs.access(templateDir);
+    }
+    catch {
+        return null;
+    }
+    const files = {};
+    async function readDir(dir, prefix) {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.name === "manifest.json")
+                continue; // handled separately
+            if (entry.isDirectory()) {
+                await readDir(path.join(dir, entry.name), relPath);
+            }
+            else {
+                files[relPath] = await fs.readFile(path.join(dir, entry.name), "utf-8");
+            }
+        }
+    }
+    await readDir(templateDir, "");
+    // Read manifest overrides
+    let manifestOverrides = {};
+    try {
+        const manifestContent = await fs.readFile(path.join(templateDir, "manifest.json"), "utf-8");
+        manifestOverrides = JSON.parse(manifestContent);
+    }
+    catch {
+        // No manifest template, use defaults
+    }
+    const lang = agentType === "cli-agent" || agentType === "worker-agent" ? "rust" : "ts";
+    return { lang, files, manifest_overrides: manifestOverrides };
+}
+// ============================================================================
+// Manifest Builder
+// ============================================================================
+function buildManifest(agentId, agentType, displayName, description, overrides) {
+    const isRust = agentType === "cli-agent" || agentType === "worker-agent";
+    const base = {
+        schema_version: "agent-manifest.v1",
+        agent_id: agentId,
+        display_name: displayName,
+        version: "0.1.0",
+        role: "executor",
+        description,
+        runtime: {
+            type: isRust ? "rust" : "node",
+            entry: isRust ? undefined : "src/index.ts",
+            port: 0,
+            health_check: "/health",
+            env: {},
+        },
+        capabilities: [],
+        constraints: {
+            timeout_secs: 300,
+            max_memory_mb: 512,
+            max_cpu_cores: 2,
+        },
+        a2a: {
+            can_delegate_to: [],
+            reports_to: [],
+            tools_exposed: [],
+        },
+    };
+    // Apply overrides from template
+    if (overrides.role)
+        base.role = overrides.role;
+    if (overrides.runtime) {
+        base.runtime = { ...base.runtime, ...overrides.runtime };
+    }
+    if (overrides.capabilities)
+        base.capabilities = overrides.capabilities;
+    if (overrides.constraints) {
+        base.constraints = { ...base.constraints, ...overrides.constraints };
+    }
+    if (overrides.a2a) {
+        base.a2a = { ...base.a2a, ...overrides.a2a };
+    }
+    return base;
+}
+// ============================================================================
+// Agents State Directory
+// ============================================================================
+function agentsDir(baseDir) {
+    return path.join(baseDir, ".musu", "agents");
+}
+async function readAgentState(baseDir, agentId) {
+    try {
+        const manifestPath = path.join(agentsDir(baseDir), agentId, "manifest.json");
+        const content = await fs.readFile(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeAgentState(baseDir, manifest) {
+    try {
+        const dir = path.join(agentsDir(baseDir), manifest.agent_id);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
+        await fs.writeFile(path.join(dir, "state.json"), JSON.stringify({ status: "registered", registered_at: new Date().toISOString() }, null, 2), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function listAgents(baseDir) {
+    const dir = agentsDir(baseDir);
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        const agents = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const manifest = await readAgentState(baseDir, entry.name);
+                agents.push({ agent_id: entry.name, manifest });
+            }
+        }
+        return agents;
+    }
+    catch {
+        return [];
+    }
+}
+// ============================================================================
+// Mode Handlers
+// ============================================================================
+async function handleScaffold(input) {
+    const agentId = input.agent_id;
+    const agentType = input.agent_type ?? "mcp-tool";
+    const displayName = input.display_name ?? agentId ?? "New Agent";
+    const description = input.description ?? "";
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    if (!agentId) {
+        return {
+            status: "ERROR",
+            mode: "scaffold",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    // Target directory for the new agent
+    const agentDir = path.join(baseDir, agentId);
+    // Check if already exists
+    try {
+        await fs.access(agentDir);
+        return {
+            status: "ERROR",
+            mode: "scaffold",
+            agent_id: agentId,
+            message: `'${agentId}' 디렉토리가 이미 존재합니다.`,
+            error: "agent_exists",
+        };
+    }
+    catch {
+        // Good, doesn't exist
+    }
+    // Load template
+    const template = await loadTemplate(agentType);
+    // Build manifest
+    const manifest = buildManifest(agentId, agentType, displayName, description, template?.manifest_overrides ?? {});
+    const createdPaths = [];
+    try {
+        // Create agent directory
+        await fs.mkdir(agentDir, { recursive: true });
+        // Write manifest.json
+        await fs.writeFile(path.join(agentDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
+        createdPaths.push("manifest.json");
+        // Write template files
+        if (template) {
+            for (const [relPath, content] of Object.entries(template.files)) {
+                const fullPath = path.join(agentDir, relPath);
+                await fs.mkdir(path.dirname(fullPath), { recursive: true });
+                // Replace {{AGENT_ID}} and {{DISPLAY_NAME}} placeholders
+                const processed = content
+                    .replace(/\{\{AGENT_ID\}\}/g, agentId)
+                    .replace(/\{\{DISPLAY_NAME\}\}/g, displayName)
+                    .replace(/\{\{DESCRIPTION\}\}/g, description);
+                await fs.writeFile(fullPath, processed, "utf-8");
+                createdPaths.push(relPath);
+            }
+        }
+        else {
+            // Fallback: minimal structure
+            const srcDir = path.join(agentDir, "src");
+            await fs.mkdir(srcDir, { recursive: true });
+            if (agentType === "cli-agent" || agentType === "worker-agent") {
+                await fs.writeFile(path.join(agentDir, "Cargo.toml"), `[package]\nname = "${agentId}"\nversion = "0.1.0"\nedition = "2021"\n\n[dependencies]\ntokio = { version = "1", features = ["full"] }\nserde = { version = "1", features = ["derive"] }\nserde_json = "1"\n`, "utf-8");
+                createdPaths.push("Cargo.toml");
+                await fs.writeFile(path.join(srcDir, "main.rs"), `//! ${displayName}\n\n#[tokio::main]\nasync fn main() {\n    println!("${displayName} starting...");\n}\n`, "utf-8");
+                createdPaths.push("src/main.rs");
+            }
+            else {
+                await fs.writeFile(path.join(agentDir, "package.json"), JSON.stringify({
+                    name: agentId,
+                    version: "0.1.0",
+                    type: "module",
+                    scripts: { start: "tsx src/index.ts", build: "tsc" },
+                    dependencies: {},
+                }, null, 2), "utf-8");
+                createdPaths.push("package.json");
+                await fs.writeFile(path.join(srcDir, "index.ts"), `// ${displayName}\n\nconsole.log("${displayName} starting...");\n`, "utf-8");
+                createdPaths.push("src/index.ts");
+            }
+        }
+        // Create .musu/state.json
+        const musuDir = path.join(agentDir, ".musu");
+        await fs.mkdir(musuDir, { recursive: true });
+        await fs.writeFile(path.join(musuDir, "state.json"), JSON.stringify({ status: "registered", registered_at: new Date().toISOString() }, null, 2), "utf-8");
+        createdPaths.push(".musu/state.json");
+        // Register in local agent state
+        await writeAgentState(baseDir, manifest);
+        const tree = createdPaths.map(p => `├── ${p}`).join("\n");
+        return {
+            status: "OK",
+            mode: "scaffold",
+            agent_id: agentId,
+            message: `에이전트 '${displayName}' (${agentType})가 생성되었습니다. (${createdPaths.length}개 파일)`,
+            data: {
+                agent_type: agentType,
+                lang: template?.lang ?? (agentType.includes("agent") ? "rust" : "ts"),
+                created_paths: createdPaths,
+                structure_tree: tree,
+                manifest,
+            },
+        };
+    }
+    catch (e) {
+        return {
+            status: "ERROR",
+            mode: "scaffold",
+            agent_id: agentId,
+            message: "에이전트 생성에 실패했습니다.",
+            error: String(e),
+        };
+    }
+}
+async function handleList(input) {
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const agents = await listAgents(baseDir);
+    return {
+        status: "OK",
+        mode: "list",
+        message: agents.length > 0
+            ? `${agents.length}개의 에이전트가 등록되어 있습니다.`
+            : "등록된 에이전트가 없습니다.",
+        data: {
+            count: agents.length,
+            agents: agents.map(a => ({
+                agent_id: a.agent_id,
+                display_name: a.manifest?.display_name ?? a.agent_id,
+                version: a.manifest?.version ?? "unknown",
+                role: a.manifest?.role ?? "unknown",
+                runtime_type: a.manifest?.runtime?.type ?? "unknown",
+            })),
+        },
+    };
+}
+async function handleStatus(input) {
+    if (!input.agent_id) {
+        return {
+            status: "ERROR",
+            mode: "status",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const manifest = await readAgentState(baseDir, input.agent_id);
+    if (!manifest) {
+        return {
+            status: "ERROR",
+            mode: "status",
+            agent_id: input.agent_id,
+            message: `에이전트 '${input.agent_id}'를 찾을 수 없습니다.`,
+            error: "agent_not_found",
+        };
+    }
+    // Read state file
+    let state = {};
+    try {
+        const statePath = path.join(agentsDir(baseDir), input.agent_id, "state.json");
+        state = JSON.parse(await fs.readFile(statePath, "utf-8"));
+    }
+    catch {
+        // No state file
+    }
+    return {
+        status: "OK",
+        mode: "status",
+        agent_id: input.agent_id,
+        message: `에이전트 '${manifest.display_name}' 상태: ${state.status ?? "unknown"}`,
+        data: { manifest, state },
+    };
+}
+async function handleRegister(input) {
+    if (!input.agent_id) {
+        return {
+            status: "ERROR",
+            mode: "register",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const agentDir = path.join(baseDir, input.agent_id);
+    // Read manifest from agent directory
+    let manifest;
+    try {
+        const content = await fs.readFile(path.join(agentDir, "manifest.json"), "utf-8");
+        manifest = JSON.parse(content);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "register",
+            agent_id: input.agent_id,
+            message: `에이전트 '${input.agent_id}/manifest.json'을 찾을 수 없습니다.`,
+            error: "manifest_not_found",
+        };
+    }
+    // Validate manifest before registration
+    const validation = validateAgentManifest(manifest);
+    if (!validation.valid) {
+        return {
+            status: "ERROR",
+            mode: "register",
+            agent_id: input.agent_id,
+            message: `매니페스트 검증 실패: ${validation.errors.join("; ")}`,
+            error: "manifest_validation_failed",
+            data: { errors: validation.errors, warnings: validation.warnings },
+        };
+    }
+    // Register locally
+    const ok = await writeAgentState(baseDir, manifest);
+    if (!ok) {
+        return {
+            status: "ERROR",
+            mode: "register",
+            agent_id: input.agent_id,
+            message: "에이전트 등록에 실패했습니다.",
+            error: "write_failed",
+        };
+    }
+    return {
+        status: "OK",
+        mode: "register",
+        agent_id: input.agent_id,
+        message: `에이전트 '${manifest.display_name}'가 로컬에 등록되었습니다.`,
+        data: { manifest, warnings: validation.warnings },
+    };
+}
+// ============================================================================
+// Pack Handler
+// ============================================================================
+/** Files that must never be included in a bundle. */
+const BANNED_PATTERNS = [
+    "node_modules",
+    ".env",
+    ".env.local",
+    ".env.production",
+    "credentials.json",
+    ".git",
+    ".DS_Store",
+    "target", // Rust build artifacts
+];
+/** Max bundle size: 100 MB */
+const MAX_BUNDLE_SIZE = 100 * 1024 * 1024;
+async function collectFiles(dir, prefix) {
+    const results = [];
+    async function walk(currentDir, currentPrefix) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip banned patterns
+            if (BANNED_PATTERNS.some(p => entry.name === p || entry.name.startsWith(p + "/"))) {
+                continue;
+            }
+            const absPath = path.join(currentDir, entry.name);
+            const relPath = currentPrefix ? `${currentPrefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                await walk(absPath, relPath);
+            }
+            else {
+                results.push({ rel: relPath, abs: absPath });
+            }
+        }
+    }
+    await walk(dir, prefix);
+    return results;
+}
+async function computeChecksum(filePath) {
+    const content = await fs.readFile(filePath);
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+async function handlePack(input) {
+    const agentId = input.agent_id;
+    if (!agentId) {
+        return {
+            status: "ERROR",
+            mode: "pack",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const agentDir = path.join(baseDir, agentId);
+    const outputDir = input.output_dir ? path.resolve(input.output_dir) : baseDir;
+    // 1. Check agent directory exists
+    try {
+        await fs.access(agentDir);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "pack",
+            agent_id: agentId,
+            message: `에이전트 디렉토리 '${agentId}'를 찾을 수 없습니다.`,
+            error: "agent_not_found",
+        };
+    }
+    // 2. Validate manifest.json exists and is valid
+    let manifest;
+    try {
+        const content = await fs.readFile(path.join(agentDir, "manifest.json"), "utf-8");
+        manifest = JSON.parse(content);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "pack",
+            agent_id: agentId,
+            message: "manifest.json이 없거나 유효하지 않습니다.",
+            error: "invalid_manifest",
+        };
+    }
+    // 3. Validate schema_version
+    if (!manifest.schema_version || !manifest.schema_version.startsWith("agent-manifest")) {
+        return {
+            status: "ERROR",
+            mode: "pack",
+            agent_id: agentId,
+            message: "manifest.json에 유효한 schema_version이 필요합니다.",
+            error: "invalid_schema_version",
+        };
+    }
+    // 3.5. Bump version if requested
+    if (input.bump_version && manifest.version) {
+        const parts = manifest.version.split(".").map(Number);
+        if (parts.length >= 3 && parts.every((p) => !isNaN(p))) {
+            if (input.bump_version === "major") {
+                parts[0]++;
+                parts[1] = 0;
+                parts[2] = 0;
+            }
+            else if (input.bump_version === "minor") {
+                parts[1]++;
+                parts[2] = 0;
+            }
+            else {
+                parts[2]++;
+            }
+            manifest.version = parts.join(".");
+            await fs.writeFile(path.join(agentDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
+        }
+    }
+    // 4. Check entry file exists (if specified)
+    if (manifest.runtime?.entry) {
+        try {
+            await fs.access(path.join(agentDir, manifest.runtime.entry));
+        }
+        catch {
+            return {
+                status: "ERROR",
+                mode: "pack",
+                agent_id: agentId,
+                message: `entry 파일 '${manifest.runtime.entry}'를 찾을 수 없습니다.`,
+                error: "missing_entry",
+            };
+        }
+    }
+    // 5. Collect files and generate checksums
+    try {
+        const files = await collectFiles(agentDir, "");
+        const checksums = {};
+        let totalSize = 0;
+        for (const file of files) {
+            const stat = await fs.stat(file.abs);
+            totalSize += stat.size;
+            checksums[file.rel] = await computeChecksum(file.abs);
+        }
+        // 6. Check size limit
+        if (totalSize > MAX_BUNDLE_SIZE) {
+            const sizeMB = (totalSize / 1024 / 1024).toFixed(1);
+            return {
+                status: "ERROR",
+                mode: "pack",
+                agent_id: agentId,
+                message: `번들 크기(${sizeMB}MB)가 제한(100MB)을 초과합니다.`,
+                error: "bundle_too_large",
+            };
+        }
+        // 7. Write checksums.json into .musu/
+        const musuDir = path.join(agentDir, ".musu");
+        await fs.mkdir(musuDir, { recursive: true });
+        await fs.writeFile(path.join(musuDir, "checksums.json"), JSON.stringify(checksums, null, 2), "utf-8");
+        // 8. Create tar.gz bundle using system tar
+        const bundleName = `${agentId}.musu.tar.gz`;
+        const bundlePath = path.join(outputDir, bundleName);
+        await fs.mkdir(outputDir, { recursive: true });
+        await execFileAsync("tar", [
+            "-czf", bundlePath,
+            "-C", baseDir,
+            agentId,
+        ]);
+        // Verify bundle was created
+        const bundleStat = await fs.stat(bundlePath);
+        return {
+            status: "OK",
+            mode: "pack",
+            agent_id: agentId,
+            message: `번들 '${bundleName}'이 생성되었습니다. (${files.length}개 파일, ${(bundleStat.size / 1024).toFixed(1)}KB)`,
+            data: {
+                bundle_path: bundlePath,
+                bundle_size: bundleStat.size,
+                file_count: files.length,
+                total_source_size: totalSize,
+                checksums,
+                manifest_version: manifest.version,
+            },
+        };
+    }
+    catch (e) {
+        return {
+            status: "ERROR",
+            mode: "pack",
+            agent_id: agentId,
+            message: "번들 생성에 실패했습니다.",
+            error: String(e),
+        };
+    }
+}
+// ============================================================================
+// Deploy Handler
+// ============================================================================
+function generateContainerfile(manifest) {
+    const rt = manifest.runtime?.type ?? "node";
+    const entry = manifest.runtime?.entry ?? "src/index.js";
+    const port = manifest.runtime?.port ?? 3000;
+    const healthCheck = manifest.runtime?.health_check ?? "/health";
+    if (rt === "node") {
+        return `FROM node:20-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --production
+COPY . .
+EXPOSE ${port}
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \\
+  CMD wget -qO- http://localhost:${port}${healthCheck} || exit 1
+CMD ["node", "${entry}"]
+`;
+    }
+    if (rt === "rust") {
+        const binaryName = manifest.agent_id;
+        return `FROM rust:1.77-alpine AS builder
+RUN apk add --no-cache musl-dev
+WORKDIR /build
+COPY Cargo.toml Cargo.lock* ./
+COPY src/ src/
+RUN cargo build --release
+
+FROM alpine:3.19
+RUN adduser -D -u 1001 agent
+COPY --from=builder /build/target/release/${binaryName} /usr/local/bin/${binaryName}
+USER agent
+EXPOSE ${port}
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \\
+  CMD wget -qO- http://localhost:${port}${healthCheck} || exit 1
+CMD ["${binaryName}"]
+`;
+    }
+    if (rt === "python") {
+        return `FROM python:3.12-slim
+WORKDIR /app
+COPY requirements.txt* ./
+RUN pip install --no-cache-dir -r requirements.txt 2>/dev/null || true
+COPY . .
+EXPOSE ${port}
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \\
+  CMD wget -qO- http://localhost:${port}${healthCheck} || exit 1
+CMD ["python3", "${entry}"]
+`;
+    }
+    // Fallback
+    return `FROM alpine:3.19
+WORKDIR /app
+COPY . .
+EXPOSE ${port}
+CMD ["sh", "-c", "echo 'No runtime handler for ${rt}'"]
+`;
+}
+async function handleDeploy(input) {
+    const agentId = input.agent_id;
+    if (!agentId) {
+        return {
+            status: "ERROR",
+            mode: "deploy",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const agentDir = path.join(baseDir, agentId);
+    const target = input.deploy_target ?? "local";
+    // Check agent dir exists
+    try {
+        await fs.access(agentDir);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "deploy",
+            agent_id: agentId,
+            message: `에이전트 디렉토리 '${agentId}'를 찾을 수 없습니다.`,
+            error: "agent_not_found",
+        };
+    }
+    // Read manifest
+    let manifest;
+    try {
+        const content = await fs.readFile(path.join(agentDir, "manifest.json"), "utf-8");
+        manifest = JSON.parse(content);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "deploy",
+            agent_id: agentId,
+            message: "manifest.json이 없거나 유효하지 않습니다.",
+            error: "invalid_manifest",
+        };
+    }
+    // Verify checksums before deployment
+    const checksumPath = path.join(agentDir, ".musu", "checksums.json");
+    try {
+        await fs.access(checksumPath);
+        const verification = await verifyAllChecksums(agentDir, checksumPath);
+        if (!verification.valid) {
+            const failures = verification.results.filter((r) => !r.valid);
+            return {
+                status: "ERROR",
+                mode: "deploy",
+                agent_id: agentId,
+                message: `체크섬 검증 실패: ${failures.length}개 파일이 변조되었습니다.`,
+                error: "checksum_mismatch",
+                data: { failures },
+            };
+        }
+    }
+    catch {
+        // No checksums.json — skip verification (not packed yet)
+    }
+    try {
+        if (target === "container") {
+            // Generate Containerfile
+            const containerfile = generateContainerfile(manifest);
+            const containerfilePath = path.join(agentDir, "Containerfile");
+            await fs.writeFile(containerfilePath, containerfile, "utf-8");
+            // Build with podman
+            const imageName = `musu-agent-${agentId}:${manifest.version ?? "latest"}`;
+            const { stdout: buildOut } = await execFileAsync("podman", [
+                "build",
+                "-t", imageName,
+                "-f", containerfilePath,
+                agentDir,
+            ]);
+            return {
+                status: "OK",
+                mode: "deploy",
+                agent_id: agentId,
+                message: `컨테이너 이미지 '${imageName}'가 빌드되었습니다.`,
+                data: {
+                    target: "container",
+                    image: imageName,
+                    containerfile_path: containerfilePath,
+                    build_output: buildOut.slice(0, 500),
+                },
+            };
+        }
+        if (target === "npm") {
+            // Validate package.json exists
+            const pkgPath = path.join(agentDir, "package.json");
+            try {
+                await fs.access(pkgPath);
+            }
+            catch {
+                return {
+                    status: "ERROR",
+                    mode: "deploy",
+                    agent_id: agentId,
+                    message: "npm 배포에는 package.json이 필요합니다.",
+                    error: "missing_package_json",
+                };
+            }
+            // Run npm publish
+            const { stdout: publishOut } = await execFileAsync("npm", [
+                "publish",
+                "--access", "public",
+            ], { cwd: agentDir });
+            return {
+                status: "OK",
+                mode: "deploy",
+                agent_id: agentId,
+                message: `에이전트 '${agentId}'가 npm에 배포되었습니다.`,
+                data: {
+                    target: "npm",
+                    output: publishOut.slice(0, 500),
+                },
+            };
+        }
+        if (target === "mesh") {
+            // Pack first, then POST manifest to Prime /v1/agents/deploy with auto_start
+            const primeUrl = input.prime_url ?? "http://127.0.0.1:8791";
+            const resp = await fetch(`${primeUrl}/v1/agents/deploy`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    manifest,
+                    auto_start: true,
+                    mesh: true,
+                }),
+            });
+            const result = await resp.json();
+            if (!resp.ok) {
+                return {
+                    status: "ERROR",
+                    mode: "deploy",
+                    agent_id: agentId,
+                    message: `Gateway mesh 배포에 실패했습니다: ${result.error ?? resp.statusText}`,
+                    error: "mesh_deploy_failed",
+                    data: result,
+                };
+            }
+            return {
+                status: "OK",
+                mode: "deploy",
+                agent_id: agentId,
+                message: `에이전트 '${manifest.display_name}'가 Gateway mesh에 배포되었습니다.`,
+                data: {
+                    target: "mesh",
+                    prime_response: result,
+                },
+            };
+        }
+        // target === "local" — register locally
+        const ok = await writeAgentState(baseDir, manifest);
+        return {
+            status: ok ? "OK" : "ERROR",
+            mode: "deploy",
+            agent_id: agentId,
+            message: ok
+                ? `에이전트 '${manifest.display_name}'가 로컬에 배포되었습니다. Prime에서 start로 실행하세요.`
+                : "로컬 배포에 실패했습니다.",
+            data: { target: "local", manifest },
+            error: ok ? undefined : "write_failed",
+        };
+    }
+    catch (e) {
+        return {
+            status: "ERROR",
+            mode: "deploy",
+            agent_id: agentId,
+            message: "배포에 실패했습니다.",
+            error: String(e),
+        };
+    }
+}
+// ============================================================================
+// Verify Handler
+// ============================================================================
+async function handleVerify(input) {
+    const agentId = input.agent_id;
+    if (!agentId) {
+        return {
+            status: "ERROR",
+            mode: "verify",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const baseDir = input.target_dir ? path.resolve(input.target_dir) : process.cwd();
+    const agentDir = path.join(baseDir, agentId);
+    const checksumPath = path.join(agentDir, ".musu", "checksums.json");
+    try {
+        await fs.access(checksumPath);
+    }
+    catch {
+        return {
+            status: "ERROR",
+            mode: "verify",
+            agent_id: agentId,
+            message: "checksums.json이 없습니다. 먼저 pack을 실행하세요.",
+            error: "no_checksums",
+        };
+    }
+    const verification = await verifyAllChecksums(agentDir, checksumPath);
+    const failures = verification.results.filter((r) => !r.valid);
+    return {
+        status: verification.valid ? "OK" : "ERROR",
+        mode: "verify",
+        agent_id: agentId,
+        message: verification.valid
+            ? `체크섬 검증 완료: ${verification.results.length}개 파일 모두 일치.`
+            : `체크섬 불일치: ${failures.length}/${verification.results.length}개 파일.`,
+        data: {
+            total: verification.results.length,
+            passed: verification.results.length - failures.length,
+            failed: failures.length,
+            failures: failures.map((f) => f.file),
+        },
+        error: verification.valid ? undefined : "checksum_mismatch",
+    };
+}
+// ============================================================================
+// Release Handler (orchestrates: pack → verify → deploy)
+// ============================================================================
+async function handleRelease(input) {
+    const agentId = input.agent_id;
+    if (!agentId) {
+        return {
+            status: "ERROR",
+            mode: "release",
+            message: "agent_id가 필요합니다.",
+            error: "missing_agent_id",
+        };
+    }
+    const steps = [];
+    // Step 1: Pack (with optional version bump)
+    const packResult = await handlePack({ ...input, mode: "pack" });
+    steps.push({ step: "pack", status: packResult.status, message: packResult.message });
+    if (packResult.status !== "OK") {
+        return {
+            status: "ERROR",
+            mode: "release",
+            agent_id: agentId,
+            message: `릴리즈 실패 (pack 단계): ${packResult.message}`,
+            error: "release_pack_failed",
+            data: { steps },
+        };
+    }
+    // Step 2: Verify
+    const verifyResult = await handleVerify({ ...input, mode: "verify" });
+    steps.push({ step: "verify", status: verifyResult.status, message: verifyResult.message });
+    if (verifyResult.status !== "OK") {
+        return {
+            status: "ERROR",
+            mode: "release",
+            agent_id: agentId,
+            message: `릴리즈 실패 (verify 단계): ${verifyResult.message}`,
+            error: "release_verify_failed",
+            data: { steps },
+        };
+    }
+    // Step 3: Deploy
+    const deployResult = await handleDeploy({ ...input, mode: "deploy" });
+    steps.push({ step: "deploy", status: deployResult.status, message: deployResult.message });
+    if (deployResult.status !== "OK") {
+        return {
+            status: "ERROR",
+            mode: "release",
+            agent_id: agentId,
+            message: `릴리즈 실패 (deploy 단계): ${deployResult.message}`,
+            error: "release_deploy_failed",
+            data: { steps },
+        };
+    }
+    return {
+        status: "OK",
+        mode: "release",
+        agent_id: agentId,
+        message: `에이전트 '${agentId}' 릴리즈 완료 (pack → verify → deploy).`,
+        data: { steps },
+    };
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+export async function agent(input) {
+    switch (input.mode) {
+        case "scaffold":
+            return handleScaffold(input);
+        case "list":
+            return handleList(input);
+        case "status":
+            return handleStatus(input);
+        case "register":
+            return handleRegister(input);
+        case "pack":
+            return handlePack(input);
+        case "deploy":
+            return handleDeploy(input);
+        case "verify":
+            return handleVerify(input);
+        case "release":
+            return handleRelease(input);
+        default:
+            return {
+                status: "ERROR",
+                mode: String(input.mode),
+                message: `알 수 없는 모드: ${input.mode}`,
+                error: "unknown_mode",
+            };
+    }
+}