wwise-waapi-mcp 1.0.0

package/dist/src/domains/profiler/tools.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProfilerTools = getProfilerTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * Wwise Profiler 数据访问工具（ak.wwise.core.profiler.*）。
+ * 支持读取 CPU 使用率、内存统计和活跃语音信息，均为低风险读取操作。
+ */
+function getProfilerTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getCpuUsage",
+            title: "Get CPU Usage",
+            description: "Read profiler CPU usage information.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:authoring:read"],
+            tags: ["waapi", "profiler", "cpu", "stub"],
+            examples: [{ title: "Read CPU usage" }],
+            inputSchemaJson: {
+                type: "object",
+                properties: {},
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.startCapture",
+            title: "Start Capture",
+            description: "Start profiler capture recording.",
+            domain: "profiler",
+            risk: "medium",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "profiler", "capture", "stub"],
+            examples: [{ title: "Start capture" }],
+            inputSchemaJson: {
+                type: "object",
+                properties: {},
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getVoices",
+            title: "Get Voices",
+            description: "Inspect active voices in the profiler.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:authoring:read"],
+            tags: ["waapi", "profiler", "voices", "stub"],
+            examples: [{ title: "List active voices" }],
+            inputSchema: {
+                time: v4_1.z.number().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    time: { type: "number" }
+                },
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.stopCapture",
+            title: "Stop Capture",
+            description: "Stop the current profiler capture session.",
+            domain: "profiler",
+            risk: "medium",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "capture"],
+            examples: [{ title: "Stop capturing" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.saveCapture",
+            title: "Save Capture",
+            description: "Save the current profiler capture to a file.",
+            domain: "profiler",
+            risk: "medium",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "capture"],
+            examples: [{ title: "Save capture to file", input: { file: "C:/capture.prof" } }],
+            inputSchema: { file: v4_1.z.string().min(1) },
+            inputSchemaJson: { type: "object", properties: { file: { type: "string", minLength: 1 }, options: {} }, required: ["file"], additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getCursorTime",
+            title: "Get Cursor Time",
+            description: "Get the current time of the user or capture cursor.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "cursor"],
+            examples: [{ title: "Get user cursor time", input: { cursor: "user" } }],
+            inputSchema: { cursor: v4_1.z.enum(["user", "capture"]) },
+            inputSchemaJson: { type: "object", properties: { cursor: { type: "string", enum: ["user", "capture"] }, options: {} }, required: ["cursor"], additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getVoiceContributions",
+            title: "Get Voice Contributions",
+            description: "Get the volume/bus contributions for a specific voice pipeline.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "voices"],
+            examples: [{ title: "Get contributions at user cursor", input: { voicePipelineID: 1234, time: "user" } }],
+            inputSchema: {
+                voicePipelineID: v4_1.z.number().int(),
+                time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]),
+                bussesPipelineID: v4_1.z.number().int().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    voicePipelineID: { type: "integer" },
+                    time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] },
+                    bussesPipelineID: { type: "integer" }, options: {}
+                },
+                required: ["voicePipelineID", "time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getGameObjects",
+            title: "Get Game Objects",
+            description: "Get the list of active game objects at a given profiler cursor time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "game-objects"],
+            examples: [{ title: "Get game objects at user cursor", input: { time: "user" } }],
+            inputSchema: { time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] }, options: {} },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getAudioObjects",
+            title: "Get Audio Objects",
+            description: "Get the list of active audio objects at a given profiler cursor time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "audio-objects"],
+            examples: [{ title: "Get audio objects at user cursor", input: { time: "user" } }],
+            inputSchema: {
+                time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]),
+                busPipelineID: v4_1.z.number().int().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] },
+                    busPipelineID: { type: "integer" }, options: {}
+                },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getBusses",
+            title: "Get Busses",
+            description: "Get the list of active mixing busses at a given profiler cursor time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "busses"],
+            examples: [{ title: "Get busses at user cursor", input: { time: "user" } }],
+            inputSchema: {
+                time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]),
+                busPipelineID: v4_1.z.number().int().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] },
+                    busPipelineID: { type: "integer" }, options: {}
+                },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.enableProfilerData",
+            title: "Enable Profiler Data",
+            description: "Enable specific profiler data types to be collected during capture.",
+            domain: "profiler",
+            risk: "medium",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "capture"],
+            examples: [{ title: "Enable RTPC profiling", input: { dataTypes: ["RTPC"] } }],
+            inputSchema: { dataTypes: v4_1.z.array(v4_1.z.string()).min(1) },
+            inputSchemaJson: { type: "object", properties: { dataTypes: { type: "array", minItems: 1, items: { type: "string" } }, options: {} }, required: ["dataTypes"], additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getRTPCs",
+            title: "Get RTPCs",
+            description: "Get the RTPC values active at a given profiler cursor time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "rtpc"],
+            examples: [{ title: "Get RTPCs at user cursor", input: { time: "user" } }],
+            inputSchema: { time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] }, options: {} },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getLoadedMedia",
+            title: "Get Loaded Media",
+            description: "Get the media currently loaded into memory at a given profiler time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "media"],
+            examples: [{ title: "Get loaded media at user cursor", input: { time: "user" } }],
+            inputSchema: { time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] }, options: {} },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getStreamedMedia",
+            title: "Get Streamed Media",
+            description: "Get the media currently being streamed at a given profiler time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "media", "streaming"],
+            examples: [{ title: "Get streamed media at user cursor", input: { time: "user" } }],
+            inputSchema: { time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] }, options: {} },
+                required: ["time"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.profiler.getPerformanceMonitor",
+            title: "Get Performance Monitor",
+            description: "Get performance monitor counters at a given profiler time.",
+            domain: "profiler",
+            risk: "low",
+            permissions: ["waapi:profiler"],
+            tags: ["waapi", "profiler", "performance"],
+            examples: [{ title: "Get performance counters at user cursor", input: { time: "user" } }],
+            inputSchema: { time: v4_1.z.union([v4_1.z.number().int(), v4_1.z.enum(["user", "capture"])]) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { time: { oneOf: [{ type: "integer" }, { type: "string", enum: ["user", "capture"] }] }, options: {} },
+                required: ["time"],
+                additionalProperties: false
+            }
+        })
+    ];
+}

package/dist/src/domains/project/tools.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectTools = getProjectTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * Wwise 项目管理工具（ak.wwise.console.project.*）。
+ * 支持打开、关闭和保存项目，均为高风险操作且需要 WAAPI 连接。
+ */
+function getProjectTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.console.project.open",
+            title: "Open Project",
+            description: "Open a Wwise project via console integration.",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:project"],
+            tags: ["waapi", "project", "open", "stub"],
+            examples: [{ title: "Open a project", input: { projectPath: "C:/Projects/GameAudio/GameAudio.wproj" } }],
+            inputSchema: {
+                projectPath: v4_1.z.string().min(1)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    projectPath: { type: "string", minLength: 1 }
+                },
+                required: ["projectPath"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.project.save",
+            title: "Save Project",
+            description: "Save the current Wwise project.",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:project"],
+            tags: ["waapi", "project", "save", "stub"],
+            examples: [{ title: "Save current project" }],
+            inputSchemaJson: {
+                type: "object",
+                properties: {},
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.ui.project.close",
+            title: "Close Project",
+            description: "Close the current project from the UI surface.",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:project"],
+            tags: ["waapi", "project", "close", "stub"],
+            examples: [{ title: "Close without prompt", input: { force: true } }],
+            inputSchema: {
+                force: v4_1.z.boolean().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    force: { type: "boolean" }
+                },
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.console.project.close",
+            title: "Console: Close Project",
+            description: "Close the currently loaded project in the Wwise console (CLI).",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "project", "console"],
+            examples: [{ title: "Close project from console" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.console.project.create",
+            title: "Console: Create Project",
+            description: "Create a new Wwise project via the console (CLI).",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "project", "console"],
+            examples: [{ title: "Create a project", input: { path: "C:/Projects/MyGame/MyGame.wproj" } }],
+            inputSchema: {
+                path: v4_1.z.string().min(1),
+                platforms: v4_1.z.array(v4_1.z.string()).optional(),
+                languages: v4_1.z.array(v4_1.z.string()).optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    path: { type: "string", minLength: 1 },
+                    platforms: { type: "array", items: { type: "string" } },
+                    languages: { type: "array", items: { type: "string" } }, options: {}
+                },
+                required: ["path"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.ui.project.create",
+            title: "UI: Create Project",
+            description: "Create a new Wwise project via the Authoring UI.",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "project", "ui"],
+            examples: [{ title: "Create project via UI", input: { path: "C:/Projects/MyGame/MyGame.wproj" } }],
+            inputSchema: {
+                path: v4_1.z.string().min(1),
+                platforms: v4_1.z.array(v4_1.z.string()).optional(),
+                languages: v4_1.z.array(v4_1.z.string()).optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    path: { type: "string", minLength: 1 },
+                    platforms: { type: "array", items: { type: "string" } },
+                    languages: { type: "array", items: { type: "string" } }, options: {}
+                },
+                required: ["path"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.ui.project.open",
+            title: "UI: Open Project",
+            description: "Open a Wwise project via the Authoring UI.",
+            domain: "project",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "project", "ui"],
+            examples: [{ title: "Open a project", input: { path: "C:/Projects/MyGame/MyGame.wproj" } }],
+            inputSchema: {
+                path: v4_1.z.string().min(1),
+                onMigrationRequired: v4_1.z.enum(["migrate", "fail"]).optional(),
+                bypassSave: v4_1.z.boolean().optional(),
+                autoCheckOutToSourceControl: v4_1.z.boolean().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    path: { type: "string", minLength: 1 },
+                    onMigrationRequired: { type: "string", enum: ["migrate", "fail"] },
+                    bypassSave: { type: "boolean" },
+                    autoCheckOutToSourceControl: { type: "boolean" }, options: {}
+                },
+                required: ["path"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.getInfo",
+            title: "Get Info",
+            description: "Get general information about the running Wwise Authoring instance.",
+            domain: "project",
+            risk: "low",
+            permissions: ["waapi:authoring:read"],
+            tags: ["waapi", "project", "info"],
+            examples: [{ title: "Get Wwise version and platform info" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.getProjectInfo",
+            title: "Get Project Info",
+            description: "Get information about the currently loaded Wwise project.",
+            domain: "project",
+            risk: "low",
+            permissions: ["waapi:authoring:read"],
+            tags: ["waapi", "project", "info"],
+            examples: [{ title: "Get project name and path" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        })
+    ];
+}

package/dist/src/domains/remote/tools.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRemoteTools = getRemoteTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * 远程控制台连接工具（ak.wwise.core.remote.*）。
+ * 支持连接、断开和列出远程目标，均需要 WAAPI 连接。
+ */
+function getRemoteTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.remote.connect",
+            title: "Connect Remote",
+            description: "Connect the authoring app to a remote console or target.",
+            domain: "remote",
+            risk: "medium",
+            permissions: ["waapi:remote"],
+            tags: ["waapi", "remote", "connect", "stub"],
+            examples: [{ title: "Connect to a console", input: { host: "127.0.0.1", commandPort: 24024 } }],
+            inputSchema: {
+                host: v4_1.z.string().min(1),
+                commandPort: v4_1.z.number().int().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    host: { type: "string", minLength: 1 },
+                    commandPort: { type: "integer" }
+                },
+                required: ["host"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.remote.getAvailableConsoles",
+            title: "Get Available Consoles",
+            description: "Discover available remote consoles.",
+            domain: "remote",
+            risk: "low",
+            permissions: ["waapi:remote"],
+            tags: ["waapi", "remote", "discover", "stub"],
+            examples: [{ title: "Scan for consoles" }],
+            inputSchemaJson: {
+                type: "object",
+                properties: {},
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.remote.disconnect",
+            title: "Disconnect",
+            description: "Disconnect from the currently connected Wwise Sound Engine instance.",
+            domain: "remote",
+            risk: "medium",
+            permissions: ["waapi:remote"],
+            tags: ["waapi", "remote", "disconnect"],
+            examples: [{ title: "Disconnect from engine" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.remote.getConnectionStatus",
+            title: "Get Connection Status",
+            description: "Get the current connection status to the Wwise Sound Engine.",
+            domain: "remote",
+            risk: "low",
+            permissions: ["waapi:remote"],
+            tags: ["waapi", "remote", "status"],
+            examples: [{ title: "Check connection status" }],
+            inputSchemaJson: { type: "object", properties: {}, additionalProperties: false }
+        })
+    ];
+}

package/dist/src/domains/sound/tools.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSoundTools = getSoundTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * Sound 对象工具（ak.wwise.core.sound.*）。
+ * 支持设置音效对象的活动音频源，需要 WAAPI 连接。
+ */
+function getSoundTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.sound.setActiveSource",
+            title: "Set Active Source",
+            description: "Set the active audio source for a Sound object, optionally per-platform.",
+            domain: "sound",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "sound", "source"],
+            examples: [{ title: "Set the active source of a sound", input: { sound: "{SOUND_GUID}", source: "{SOURCE_GUID}" } }],
+            inputSchema: {
+                sound: v4_1.z.string().min(1),
+                source: v4_1.z.string().min(1),
+                platform: v4_1.z.string().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    sound: { type: "string", minLength: 1 },
+                    source: { type: "string", minLength: 1 },
+                    platform: { type: "string" }, options: {}
+                },
+                required: ["sound", "source"],
+                additionalProperties: false
+            }
+        })
+    ];
+}