@manycore/aholo-sdk-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,363 @@
+#!/usr/bin/env node
+import { createAssetClient } from '@manycore/aholo-sdk-asset';
+import { createLux3dClient } from '@manycore/aholo-sdk-lux3d';
+import { createWorldClient } from '@manycore/aholo-sdk-world';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { buildClientConfig } from './config.js';
+import { DESTRUCTIVE_ANNOTATIONS, LONG_TASK_BLOCKING_WAIT_DESC, LONG_TASK_SUBMIT_HINT, READONLY_ANNOTATIONS, RECONSTRUCT_OBJECT_DESC, RECONSTRUCT_SPACE_DESC, TASK_QUALITY_HINT, regionSchema, sceneSchema, sceneSourceSchema, SERVER_INSTRUCTIONS, SERVER_VERSION, taskQualitySchema, useMaskSchema, waitSchema, } from './constants.js';
+import { toolError } from './errors.js';
+import { inspectLocalMedia } from './inspect-media.js';
+import { jsonResult } from './response.js';
+import { reconstructFromFiles, reconstructFromUrls, validateSceneSource, } from './world-reconstruct.js';
+const resourceSchema = z
+    .array(z.object({
+    url: z.string().url(),
+    type: z.enum(['image', 'video']).optional(),
+}))
+    .min(1)
+    .describe('输入资源 URL。纯图片重建须 ≥20 条；纯视频每条 type=video。');
+const fromFilesBaseSchema = {
+    localPaths: z.array(z.string()).min(1).describe('本地文件路径列表'),
+    resourceType: z
+        .enum(['image', 'video'])
+        .optional()
+        .describe('资源类型。纯视频请设 video；省略时按图片计（须 ≥20 张）。'),
+    name: z.string().optional().describe('世界展示名称'),
+    taskQuality: taskQualitySchema,
+    useMask: useMaskSchema,
+    wait: waitSchema,
+    timeoutMs: z.number().int().positive().optional().describe('wait=true 时的轮询超时（毫秒）'),
+    region: regionSchema,
+};
+const server = new McpServer({ name: 'aholo-sdk-mcp', version: SERVER_VERSION }, { instructions: SERVER_INSTRUCTIONS });
+server.registerTool('world_inspect_local_media', {
+    description: [
+        '分析本地图片/视频（只读，不提交任务）。',
+        '返回：文件大小、媒体类型、视频时长、可选 previewFramePath（需本机 ffmpeg）。',
+        '用于 scene 不确定时辅助判断；用户已明确「模型/室内」时可跳过。',
+        '不自动决定 scene，须结合用户意图选择 world_reconstruct_object_* 或 world_reconstruct_space_*。',
+    ].join(' '),
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        localPath: z.string().describe('本地文件绝对或相对路径'),
+    },
+}, async ({ localPath }) => {
+    try {
+        const inspection = await inspectLocalMedia(localPath);
+        return jsonResult(inspection);
+    }
+    catch (error) {
+        return toolError('world_inspect_local_media', error);
+    }
+});
+server.registerTool('upload_asset', {
+    description: '上传本地文件到 Aholo CDN。返回公开 URL 与 md5。只读副作用：仅上传，不创建重建任务。',
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+        localPath: z.string().describe('本地文件路径'),
+        region: regionSchema,
+        filename: z.string().optional().describe('覆盖上传文件名'),
+    },
+}, async ({ localPath, region, filename }) => {
+    try {
+        const asset = createAssetClient(buildClientConfig(region));
+        const result = await asset.uploadFile(localPath, filename ? { filename } : undefined);
+        return jsonResult(result);
+    }
+    catch (error) {
+        return toolError('upload_asset', error);
+    }
+});
+server.registerTool('world_reconstruct_object_from_files', {
+    description: RECONSTRUCT_OBJECT_DESC,
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: fromFilesBaseSchema,
+}, async (args) => reconstructFromFiles({ ...args, scene: 'model', toolName: 'world_reconstruct_object_from_files' }));
+server.registerTool('world_reconstruct_space_from_files', {
+    description: RECONSTRUCT_SPACE_DESC,
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: fromFilesBaseSchema,
+}, async (args) => reconstructFromFiles({ ...args, scene: 'space', toolName: 'world_reconstruct_space_from_files' }));
+server.registerTool('world_reconstruct_object', {
+    description: [
+        '用已有 URL 创建 **物体场景（model）** 3DGS 重建任务。',
+        '适用：单个物体/产品/手办。不适用：室内空间（用 world_reconstruct_space）。',
+        LONG_TASK_SUBMIT_HINT,
+        TASK_QUALITY_HINT,
+    ].join(' '),
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        name: z.string().optional(),
+        resources: resourceSchema,
+        taskQuality: taskQualitySchema,
+        useMask: useMaskSchema,
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async (args) => reconstructFromUrls({ ...args, scene: 'model', toolName: 'world_reconstruct_object' }));
+server.registerTool('world_reconstruct_space', {
+    description: [
+        '用已有 URL 创建 **室内空间（space）** 3DGS 重建任务。',
+        '适用：室内/房间环拍。不适用：桌面单品（用 world_reconstruct_object）。',
+        LONG_TASK_SUBMIT_HINT,
+        TASK_QUALITY_HINT,
+    ].join(' '),
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        name: z.string().optional(),
+        resources: resourceSchema,
+        taskQuality: taskQualitySchema,
+        useMask: useMaskSchema,
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async (args) => reconstructFromUrls({ ...args, scene: 'space', toolName: 'world_reconstruct_space' }));
+server.registerTool('world_reconstruct', {
+    description: [
+        '【兼容】创建 3DGS 重建（需自行指定 scene）。',
+        '优先使用 world_reconstruct_object / world_reconstruct_space 或 *_from_files。',
+        '须 sceneSource +（user_explicit 时）userConfirmedScene=true，禁止无依据猜测 scene。',
+        TASK_QUALITY_HINT,
+    ].join(' '),
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        name: z.string().optional(),
+        resources: resourceSchema,
+        scene: sceneSchema,
+        sceneSource: sceneSourceSchema,
+        userConfirmedScene: z
+            .boolean()
+            .optional()
+            .describe('sceneSource=user_explicit 时必须为 true'),
+        taskQuality: taskQualitySchema,
+        useMask: useMaskSchema,
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ sceneSource, userConfirmedScene, scene, ...rest }) => {
+    const gate = validateSceneSource(sceneSource, userConfirmedScene);
+    if (gate)
+        return gate;
+    return reconstructFromUrls({ ...rest, scene, toolName: 'world_reconstruct' });
+});
+server.registerTool('world_reconstruct_from_files', {
+    description: [
+        '【兼容】上传本地文件并创建 3DGS 重建（需指定 scene）。',
+        '优先使用 world_reconstruct_object_from_files / world_reconstruct_space_from_files。',
+        '须 sceneSource +（user_explicit 时）userConfirmedScene=true。',
+        TASK_QUALITY_HINT,
+    ].join(' '),
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        ...fromFilesBaseSchema,
+        scene: sceneSchema,
+        sceneSource: sceneSourceSchema,
+        userConfirmedScene: z.boolean().optional(),
+    },
+}, async ({ sceneSource, userConfirmedScene, scene, ...rest }) => {
+    const gate = validateSceneSource(sceneSource, userConfirmedScene);
+    if (gate)
+        return gate;
+    return reconstructFromFiles({ ...rest, scene, toolName: 'world_reconstruct_from_files' });
+});
+server.registerTool('world_generate', {
+    description: [
+        '从文字描述创建 3DGS 世界生成（Spatial Gen）任务。',
+        '不适用：从视频/图片重建（请用 world_reconstruct_*）。',
+        LONG_TASK_SUBMIT_HINT,
+    ].join(' '),
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        prompt: z.string().describe('3D 空间文字描述'),
+        name: z.string().optional(),
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ prompt, name, wait, timeoutMs, region }) => {
+    try {
+        const config = buildClientConfig(region);
+        const world = createWorldClient(config);
+        const { worldId } = await world.generations.create({ prompt, name });
+        if (!wait)
+            return jsonResult({ worldId });
+        const detail = await world.waitFor(worldId, timeoutMs ? { timeoutMs } : undefined);
+        return jsonResult({ worldId, detail });
+    }
+    catch (error) {
+        return toolError('world_generate', error);
+    }
+});
+server.registerTool('world_get', {
+    description: '只读：查询 world 详情与任务状态、产物 URL。长任务查进度的首选 tool（非阻塞，秒回）。',
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        worldId: z.string(),
+        region: regionSchema,
+    },
+}, async ({ worldId, region }) => {
+    try {
+        const world = createWorldClient(buildClientConfig(region));
+        return jsonResult(await world.retrieve(worldId));
+    }
+    catch (error) {
+        return toolError('world_get', error);
+    }
+});
+server.registerTool('world_wait_for', {
+    description: LONG_TASK_BLOCKING_WAIT_DESC,
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        worldId: z.string(),
+        timeoutMs: z.number().int().positive().optional(),
+        intervalMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ worldId, timeoutMs, intervalMs, region }) => {
+    try {
+        const world = createWorldClient(buildClientConfig(region));
+        return jsonResult(await world.waitFor(worldId, { timeoutMs, intervalMs }));
+    }
+    catch (error) {
+        return toolError('world_wait_for', error);
+    }
+});
+server.registerTool('world_list', {
+    description: '只读：分页列出当前账号下的 world。',
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        pageNum: z.number().int().positive().optional(),
+        pageSize: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ pageNum, pageSize, region }) => {
+    try {
+        const world = createWorldClient(buildClientConfig(region));
+        return jsonResult(await world.list({ pageNum, pageSize }));
+    }
+    catch (error) {
+        return toolError('world_list', error);
+    }
+});
+server.registerTool('lux3d_img_to_3d_from_file', {
+    description: `本地图片 → Lux3D 图生 3D。${LONG_TASK_SUBMIT_HINT}`,
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        localPath: z.string(),
+        version: z.enum(['v1.0-pro', 'v2.0-preview']).optional(),
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ localPath, version, wait, timeoutMs, region }) => {
+    try {
+        const lux3d = createLux3dClient(buildClientConfig(region));
+        const taskId = await lux3d.imgTo3d.createFromFile(localPath, version ? { version } : undefined);
+        if (!wait)
+            return jsonResult({ taskId });
+        const result = await lux3d.tasks.waitFor(taskId, timeoutMs ? { timeoutMs } : undefined);
+        return jsonResult({ taskId, result });
+    }
+    catch (error) {
+        return toolError('lux3d_img_to_3d_from_file', error);
+    }
+});
+server.registerTool('lux3d_img_to_3d', {
+    description: `图片 URL → Lux3D 图生 3D。${LONG_TASK_SUBMIT_HINT}`,
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        img: z.string().url(),
+        version: z.enum(['v1.0-pro', 'v2.0-preview']).optional(),
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ img, version, wait, timeoutMs, region }) => {
+    try {
+        const lux3d = createLux3dClient(buildClientConfig(region));
+        const taskId = await lux3d.imgTo3d.create({ img, ...(version ? { version } : {}) });
+        if (!wait)
+            return jsonResult({ taskId });
+        const result = await lux3d.tasks.waitFor(taskId, timeoutMs ? { timeoutMs } : undefined);
+        return jsonResult({ taskId, result });
+    }
+    catch (error) {
+        return toolError('lux3d_img_to_3d', error);
+    }
+});
+server.registerTool('lux3d_text_to_3d', {
+    description: `文字 → Lux3D 3D。${LONG_TASK_SUBMIT_HINT}`,
+    annotations: DESTRUCTIVE_ANNOTATIONS,
+    inputSchema: {
+        prompt: z.string(),
+        style: z
+            .enum(['photorealistic', 'cartoon', 'anime', 'hand_painted', 'cyberpunk', 'fantasy', 'glass'])
+            .optional(),
+        wait: waitSchema,
+        timeoutMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ prompt, style, wait, timeoutMs, region }) => {
+    try {
+        const lux3d = createLux3dClient(buildClientConfig(region));
+        const taskId = await lux3d.textTo3d.create({ prompt, ...(style ? { style } : {}) });
+        if (!wait)
+            return jsonResult({ taskId });
+        const result = await lux3d.tasks.waitFor(taskId, timeoutMs ? { timeoutMs } : undefined);
+        return jsonResult({ taskId, result });
+    }
+    catch (error) {
+        return toolError('lux3d_text_to_3d', error);
+    }
+});
+server.registerTool('lux3d_get_task', {
+    description: '只读：查询 Lux3D 任务状态一次。长任务查进度的首选 tool（非阻塞，秒回）。',
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        taskId: z.number().int(),
+        region: regionSchema,
+    },
+}, async ({ taskId, region }) => {
+    try {
+        const lux3d = createLux3dClient(buildClientConfig(region));
+        return jsonResult(await lux3d.tasks.retrieve(taskId));
+    }
+    catch (error) {
+        return toolError('lux3d_get_task', error);
+    }
+});
+server.registerTool('lux3d_wait_for_task', {
+    description: LONG_TASK_BLOCKING_WAIT_DESC,
+    annotations: READONLY_ANNOTATIONS,
+    inputSchema: {
+        taskId: z.number().int(),
+        timeoutMs: z.number().int().positive().optional(),
+        intervalMs: z.number().int().positive().optional(),
+        region: regionSchema,
+    },
+}, async ({ taskId, timeoutMs, intervalMs, region }) => {
+    try {
+        const lux3d = createLux3dClient(buildClientConfig(region));
+        return jsonResult(await lux3d.tasks.waitFor(taskId, { timeoutMs, intervalMs }));
+    }
+    catch (error) {
+        return toolError('lux3d_wait_for_task', error);
+    }
+});
+async function main() {
+    if (!process.env.AHOLO_API_KEY) {
+        console.error('AHOLO_API_KEY is required');
+        process.exit(1);
+    }
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inspect-media.d.ts

@@ -0,0 +1,16 @@
+export type MediaKind = 'image' | 'video' | 'unknown';
+export interface MediaInspection {
+    localPath: string;
+    fileName: string;
+    mediaKind: MediaKind;
+    fileSizeBytes: number;
+    durationSec?: number;
+    previewFramePath?: string;
+    suggestedResourceType?: 'image' | 'video';
+    sceneGuide: {
+        model: string;
+        space: string;
+    };
+    notes: string[];
+}
+export declare function inspectLocalMedia(localPath: string): Promise<MediaInspection>;

package/dist/inspect-media.js

@@ -0,0 +1,81 @@
+import { execFile } from 'node:child_process';
+import { constants as fsConstants } from 'node:fs';
+import { access, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, extname, join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const IMAGE_EXT = new Set(['.jpg', '.jpeg', '.png', '.webp', '.gif', '.bmp']);
+const VIDEO_EXT = new Set(['.mp4', '.mov', '.avi', '.mkv', '.webm', '.insv', '.insp', '.m4v']);
+function detectMediaKind(ext) {
+    const lower = ext.toLowerCase();
+    if (IMAGE_EXT.has(lower))
+        return 'image';
+    if (VIDEO_EXT.has(lower))
+        return 'video';
+    return 'unknown';
+}
+async function ffprobeDuration(filePath) {
+    try {
+        const { stdout } = await execFileAsync('ffprobe', [
+            '-v',
+            'error',
+            '-show_entries',
+            'format=duration',
+            '-of',
+            'default=noprint_wrappers=1:nokey=1',
+            filePath,
+        ]);
+        const value = Number.parseFloat(stdout.trim());
+        return Number.isFinite(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function extractPreviewFrame(filePath, mediaKind) {
+    if (mediaKind !== 'video')
+        return undefined;
+    const outPath = join(tmpdir(), `aholo-mcp-preview-${Date.now()}.jpg`);
+    try {
+        await execFileAsync('ffmpeg', ['-y', '-ss', '1', '-i', filePath, '-frames:v', '1', '-q:v', '2', outPath]);
+        await access(outPath, fsConstants.R_OK);
+        return outPath;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function inspectLocalMedia(localPath) {
+    await access(localPath, fsConstants.R_OK);
+    const fileStat = await stat(localPath);
+    const ext = extname(localPath);
+    const mediaKind = detectMediaKind(ext);
+    const durationSec = mediaKind === 'video' ? await ffprobeDuration(localPath) : undefined;
+    const previewFramePath = await extractPreviewFrame(localPath, mediaKind);
+    const notes = [
+        'scene 须由用户意图或预览内容确定：model=物体，space=室内空间。',
+        '纯视频重建请设 resourceType=video；图片重建须 ≥20 张。',
+    ];
+    if (mediaKind === 'unknown') {
+        notes.push(`未识别扩展名 ${ext || '(无)'}，请确认是图片还是视频。`);
+    }
+    if (mediaKind === 'video' && !durationSec) {
+        notes.push('未能读取视频时长（需本机 ffprobe）；仍可提交，但建议 Agent 查看 previewFramePath。');
+    }
+    return {
+        localPath,
+        fileName: basename(localPath),
+        mediaKind,
+        fileSizeBytes: fileStat.size,
+        durationSec,
+        previewFramePath,
+        suggestedResourceType: mediaKind === 'unknown' ? undefined : mediaKind,
+        sceneGuide: {
+            model: '单个物体/产品/手办，相机绕物体拍摄',
+            space: '室内/房间环拍，重建整个空间',
+        },
+        notes,
+    };
+}
+//# sourceMappingURL=inspect-media.js.map

package/dist/inspect-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-media.js","sourceRoot":"","sources":["../src/inspect-media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAmB/F,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE;YAChD,IAAI;YACJ,OAAO;YACP,eAAe;YACf,iBAAiB;YACjB,KAAK;YACL,oCAAoC;YACpC,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,SAAoB;IACvE,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1G,MAAM,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,gBAAgB,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAa;QACtB,0CAA0C;QAC1C,yCAAyC;KAC1C,CAAC;IACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,cAAc,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,SAAS;QACT,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC;QAC7B,SAAS;QACT,aAAa,EAAE,QAAQ,CAAC,IAAI;QAC5B,WAAW;QACX,gBAAgB;QAChB,qBAAqB,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACtE,UAAU,EAAE;YACV,KAAK,EAAE,oBAAoB;YAC3B,KAAK,EAAE,gBAAgB;SACxB;QACD,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/response.d.ts

@@ -0,0 +1,3 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function jsonResult(data: unknown): CallToolResult;
+export declare function errorResult(message: string, detail?: unknown): CallToolResult;

package/dist/response.js

@@ -0,0 +1,26 @@
+export function jsonResult(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+export function errorResult(message, detail) {
+    const payload = detail === undefined
+        ? { error: message }
+        : { error: message, detail: serializeError(detail) };
+    return {
+        isError: true,
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+}
+function serializeError(error) {
+    if (error instanceof Error) {
+        const withCode = error;
+        return {
+            name: withCode.name,
+            message: withCode.message,
+            ...(withCode.code !== undefined ? { code: withCode.code } : {}),
+        };
+    }
+    return error;
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAgB;IAC3D,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE;QACpB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAmC,CAAC;QACrD,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}