wwise-waapi-mcp 1.0.0

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

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSoundbankTools = getSoundbankTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * SoundBank 管理工具（ak.wwise.core.soundbank.*）。
+ * 支持生成、设置包含项和获取 SoundBank 信息，
+ * 均需要 WAAPI 连接，生成操作为高风险。
+ */
+function getSoundbankTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.soundbank.generate",
+            title: "Generate SoundBank",
+            description: "Generate one or more SoundBanks from authoring data.",
+            domain: "soundbank",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "soundbank", "generate", "stub"],
+            examples: [{ title: "Generate banks for Windows", input: { soundbanks: ["Init"], platforms: ["Windows"] } }],
+            inputSchema: {
+                soundbanks: v4_1.z.array(v4_1.z.union([v4_1.z.string(), v4_1.z.object({ name: v4_1.z.string().min(1) })])).optional(),
+                platforms: v4_1.z.array(v4_1.z.string()).optional(),
+                languages: v4_1.z.array(v4_1.z.string()).optional(),
+                skipLanguages: v4_1.z.boolean().optional(),
+                rebuildSoundBanks: v4_1.z.boolean().optional(),
+                clearAudioFileCache: v4_1.z.boolean().optional(),
+                writeToDisk: v4_1.z.boolean().optional(),
+                rebuildInitBank: v4_1.z.boolean().optional(),
+                options: v4_1.z.unknown().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    soundbanks: { type: "array", items: { oneOf: [{ type: "string" }, { type: "object", properties: { name: { type: "string", minLength: 1 } }, required: ["name"], additionalProperties: true }] } },
+                    platforms: { type: "array", items: { type: "string" } },
+                    languages: { type: "array", items: { type: "string" } },
+                    skipLanguages: { type: "boolean" },
+                    rebuildSoundBanks: { type: "boolean" },
+                    clearAudioFileCache: { type: "boolean" },
+                    writeToDisk: { type: "boolean" },
+                    rebuildInitBank: { type: "boolean" },
+                    options: {}
+                },
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.soundbank.getInclusions",
+            title: "Get SoundBank Inclusions",
+            description: "Return inclusion settings for a SoundBank definition.",
+            domain: "soundbank",
+            risk: "medium",
+            permissions: ["waapi:authoring:read"],
+            tags: ["waapi", "soundbank", "query", "stub"],
+            examples: [{ title: "Read bank inclusions", input: { soundbank: "Init" } }],
+            inputSchema: {
+                soundbank: v4_1.z.string().min(1),
+                options: v4_1.z.unknown().optional()
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    soundbank: { type: "string", minLength: 1 },
+                    options: {}
+                },
+                required: ["soundbank"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.soundbank.setInclusions",
+            title: "Set SoundBank Inclusions",
+            description: "Set the inclusions of a SoundBank (add, remove, or replace).",
+            domain: "soundbank",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "soundbank", "inclusions"],
+            examples: [{ title: "Add objects to a SoundBank", input: { soundbank: "{GUID}", inclusions: [{ object: "{EVENT_GUID}", filter: ["events"] }], operation: "add" } }],
+            inputSchema: {
+                soundbank: v4_1.z.string().min(1),
+                inclusions: v4_1.z.array(v4_1.z.object({ object: v4_1.z.string().min(1), filter: v4_1.z.array(v4_1.z.string()) })).min(1),
+                operation: v4_1.z.enum(["add", "remove", "replace"])
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    soundbank: { type: "string", minLength: 1 },
+                    inclusions: { type: "array", minItems: 1, items: { type: "object", properties: { object: { type: "string" }, filter: { type: "array", items: { type: "string" } } }, required: ["object", "filter"] } },
+                    operation: { type: "string", enum: ["add", "remove", "replace"] }, options: {}
+                },
+                required: ["soundbank", "inclusions", "operation"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.soundbank.convertExternalSources",
+            title: "Convert External Sources",
+            description: "Convert external sources to be included in a SoundBank.",
+            domain: "soundbank",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "soundbank", "external"],
+            examples: [{ title: "Convert an external source for Windows", input: { sources: [{ input: "C:/audio/vo.wav", platform: "Windows" }] } }],
+            inputSchema: {
+                sources: v4_1.z.array(v4_1.z.object({ input: v4_1.z.string().min(1), platform: v4_1.z.string().min(1), output: v4_1.z.string().optional() })).min(1)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    sources: { type: "array", minItems: 1, items: { type: "object", properties: { input: { type: "string" }, platform: { type: "string" }, output: { type: "string" } }, required: ["input", "platform"] } },
+                    options: {}
+                },
+                required: ["sources"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.wwise.core.soundbank.processDefinitionFiles",
+            title: "Process Definition Files",
+            description: "Process SoundBank definition files.",
+            domain: "soundbank",
+            risk: "high",
+            permissions: ["waapi:authoring:write"],
+            tags: ["waapi", "soundbank", "definition"],
+            examples: [{ title: "Process a definition file", input: { files: ["C:/project/def.txt"] } }],
+            inputSchema: { files: v4_1.z.array(v4_1.z.string().min(1)).min(1) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { files: { type: "array", minItems: 1, items: { type: "string", minLength: 1 } }, options: {} },
+                required: ["files"],
+                additionalProperties: false
+            }
+        })
+    ];
+}

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

@@ -0,0 +1,529 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSoundengineTools = getSoundengineTools;
+const v4_1 = require("zod/v4");
+const toolFactory_js_1 = require("../../lib/toolFactory.js");
+/**
+ * 运行时音频引擎工具（ak.soundengine.*）。
+ * 这些工具直接操作游戏引擎中的音频对象、事件和 RTPC 值，
+ * 均为高风险操作且需要 WAAPI 连接。
+ */
+/** GUID 字符串、唯一名称字符串或 Short ID 整数（soundEngineObjectArg）。 */
+const seObj = v4_1.z.union([v4_1.z.string(), v4_1.z.number().int()]);
+const seObjJson = { oneOf: [{ type: "string" }, { type: "integer" }] };
+/** 游戏对象 ID（uint64 number）。 */
+const gameObj = v4_1.z.number();
+/** 三维向量 { x, y, z }。 */
+const vec3 = v4_1.z.object({ x: v4_1.z.number(), y: v4_1.z.number(), z: v4_1.z.number() });
+const vec3Json = { type: "object", properties: { x: { type: "number" }, y: { type: "number" }, z: { type: "number" } }, required: ["x", "y", "z"] };
+/** 3D 空间变换（orientationFront, orientationTop, position 各为 vec3）。 */
+const transform3D = v4_1.z.object({ orientationFront: vec3, orientationTop: vec3, position: vec3 });
+const transform3DJson = {
+    type: "object",
+    properties: { orientationFront: vec3Json, orientationTop: vec3Json, position: vec3Json },
+    required: ["orientationFront", "orientationTop", "position"]
+};
+function getSoundengineTools() {
+    return [
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.postEvent",
+            title: "Post Event",
+            description: "Post a sound event to the runtime sound engine.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "events"],
+            examples: [{ title: "Post an event", input: { event: "Play_Footstep", gameObject: 1001 } }],
+            inputSchema: { event: seObj, gameObject: seObj, playingId: v4_1.z.number().int().optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { event: seObjJson, gameObject: seObjJson, playingId: { type: "integer" }, options: {} },
+                required: ["event", "gameObject"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.executeActionOnEvent",
+            title: "Execute Action on Event",
+            description: "Execute an action on all nodes referenced in a Play-type event. actionType: 0=Stop,1=Pause,2=Resume,3=Break,4=ReleaseEnvelope. fadeCurve: 0-9.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "events"],
+            examples: [{ title: "Stop from event with fade", input: { event: "Play_Music", actionType: 0, gameObject: 64, transitionDuration: 500, fadeCurve: 4 } }],
+            inputSchema: {
+                event: seObj,
+                actionType: v4_1.z.number().int().min(0).max(4),
+                gameObject: gameObj,
+                transitionDuration: v4_1.z.number().int(),
+                fadeCurve: v4_1.z.number().int().min(0).max(9)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    event: seObjJson, actionType: { type: "integer", minimum: 0, maximum: 4 },
+                    gameObject: { type: "number" }, transitionDuration: { type: "integer" },
+                    fadeCurve: { type: "integer", minimum: 0, maximum: 9 }, options: {}
+                },
+                required: ["event", "actionType", "gameObject", "transitionDuration", "fadeCurve"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.getState",
+            title: "Get State",
+            description: "Get the current state of a State Group.",
+            domain: "soundengine",
+            risk: "low",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "states"],
+            examples: [{ title: "Query music state group", input: { stateGroup: "Music_State" } }],
+            inputSchema: { stateGroup: v4_1.z.string() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { stateGroup: { type: "string" }, options: {} },
+                required: ["stateGroup"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.getSwitch",
+            title: "Get Switch",
+            description: "Get the current state of a Switch Group on a game object.",
+            domain: "soundengine",
+            risk: "low",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "switches"],
+            examples: [{ title: "Query surface switch", input: { switchGroup: "Surface_Type", gameObject: 1001 } }],
+            inputSchema: { switchGroup: v4_1.z.string(), gameObject: gameObj.optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { switchGroup: { type: "string" }, gameObject: { type: "number" }, options: {} },
+                required: ["switchGroup"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.loadBank",
+            title: "Load SoundBank",
+            description: "Load a SoundBank into the runtime sound engine.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "banks"],
+            examples: [{ title: "Load Init bank", input: { soundBank: "Init" } }],
+            inputSchema: { soundBank: seObj },
+            inputSchemaJson: {
+                type: "object",
+                properties: { soundBank: seObjJson, options: {} },
+                required: ["soundBank"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.postMsgMonitor",
+            title: "Post Monitor Message",
+            description: "Post a message to the Profiler Capture Log for debugging.",
+            domain: "soundengine",
+            risk: "low",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "profiler"],
+            examples: [{ title: "Log a checkpoint", input: { message: "Level loaded" } }],
+            inputSchema: { message: v4_1.z.string() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { message: { type: "string" }, options: {} },
+                required: ["message"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.postTrigger",
+            title: "Post Trigger",
+            description: "Post a trigger to the sound engine to fire stinger events.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "triggers"],
+            examples: [{ title: "Post a stinger", input: { trigger: "Music_Stinger", gameObject: 1001 } }],
+            inputSchema: { trigger: seObj, gameObject: gameObj.optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { trigger: seObjJson, gameObject: { type: "number" }, options: {} },
+                required: ["trigger"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.registerGameObj",
+            title: "Register Game Object",
+            description: "Register a game object in the runtime sound engine.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "game-object"],
+            examples: [{ title: "Register player object", input: { gameObject: "Player", gameObjectId: 1001 } }],
+            inputSchema: { gameObject: v4_1.z.string().min(1), gameObjectId: v4_1.z.number().int() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { gameObject: { type: "string", minLength: 1 }, gameObjectId: { type: "integer" }, options: {} },
+                required: ["gameObject", "gameObjectId"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.resetRTPCValue",
+            title: "Reset RTPC Value",
+            description: "Reset an RTPC to its default value for a game object or globally.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "rtpc"],
+            examples: [{ title: "Reset RTPC for player", input: { rtpc: "Player_Speed", gameObject: 1001 } }],
+            inputSchema: { rtpc: seObj, gameObject: gameObj.optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { rtpc: seObjJson, gameObject: { type: "number" }, options: {} },
+                required: ["rtpc"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.seekOnEvent",
+            title: "Seek on Event",
+            description: "Seek to position (ms) or percent (0-1) on all sounds started by an active event. playingId 0 targets all.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "events"],
+            examples: [{ title: "Seek to 5 seconds", input: { event: "Play_Music", gameObject: 64, position: 5000, seekToNearestMarker: false, playingId: 0 } }],
+            inputSchema: {
+                event: seObj,
+                gameObject: gameObj,
+                position: v4_1.z.number().int().optional(),
+                percent: v4_1.z.number().min(0).max(1).optional(),
+                seekToNearestMarker: v4_1.z.boolean(),
+                playingId: v4_1.z.number().int().min(0)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    event: seObjJson, gameObject: { type: "number" },
+                    position: { type: "integer" }, percent: { type: "number", minimum: 0, maximum: 1 },
+                    seekToNearestMarker: { type: "boolean" }, playingId: { type: "integer", minimum: 0 }, options: {}
+                },
+                required: ["event", "gameObject", "seekToNearestMarker", "playingId"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setDefaultListeners",
+            title: "Set Default Listeners",
+            description: "Set the default listeners for game objects without an explicit listener assignment.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "listeners"],
+            examples: [{ title: "Set one default listener", input: { listeners: [0] } }],
+            inputSchema: { listeners: v4_1.z.array(gameObj) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { listeners: { type: "array", items: { type: "number" } }, options: {} },
+                required: ["listeners"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setGameObjectAuxSendValues",
+            title: "Set Aux Send Values",
+            description: "Set auxiliary send values for a game object (max 4 entries).",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "aux"],
+            examples: [{ title: "Set reverb send", input: { gameObject: 1001, auxSendValues: [{ listener: 0, auxBus: "ReverbBus", controlValue: 0.5 }] } }],
+            inputSchema: {
+                gameObject: gameObj,
+                auxSendValues: v4_1.z.array(v4_1.z.object({ listener: gameObj, auxBus: seObj, controlValue: v4_1.z.number().min(0).max(1) })).max(4)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    gameObject: { type: "number" },
+                    auxSendValues: { type: "array", maxItems: 4, items: { type: "object", properties: { listener: { type: "number" }, auxBus: seObjJson, controlValue: { type: "number", minimum: 0, maximum: 1 } }, required: ["listener", "auxBus", "controlValue"] } },
+                    options: {}
+                },
+                required: ["gameObject", "auxSendValues"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setGameObjectOutputBusVolume",
+            title: "Set Output Bus Volume",
+            description: "Set the output bus volume between an emitter and a listener game object.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "volume"],
+            examples: [{ title: "Reduce emitter volume", input: { emitter: 1001, listener: 0, controlValue: 0.8 } }],
+            inputSchema: { emitter: gameObj, listener: gameObj, controlValue: v4_1.z.number() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { emitter: { type: "number" }, listener: { type: "number" }, controlValue: { type: "number" }, options: {} },
+                required: ["emitter", "listener", "controlValue"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setListeners",
+            title: "Set Listeners",
+            description: "Assign listeners to a specific emitter game object.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "listeners"],
+            examples: [{ title: "Assign listener to emitter", input: { emitter: 1001, listeners: [0] } }],
+            inputSchema: { emitter: gameObj, listeners: v4_1.z.array(gameObj) },
+            inputSchemaJson: {
+                type: "object",
+                properties: { emitter: { type: "number" }, listeners: { type: "array", items: { type: "number" } }, options: {} },
+                required: ["emitter", "listeners"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setListenerSpatialization",
+            title: "Set Listener Spatialization",
+            description: "Enable/disable spatialization for a listener and optionally set per-speaker volume offsets (dB).",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "listeners", "spatialization"],
+            examples: [{ title: "Enable spatialization", input: { listener: 0, spatialized: true, channelConfig: 3, volumeOffsets: [0, 0] } }],
+            inputSchema: {
+                listener: gameObj,
+                spatialized: v4_1.z.boolean(),
+                channelConfig: v4_1.z.number().int().min(0),
+                volumeOffsets: v4_1.z.array(v4_1.z.number())
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    listener: { type: "number" }, spatialized: { type: "boolean" },
+                    channelConfig: { type: "integer", minimum: 0 }, volumeOffsets: { type: "array", items: { type: "number" } }, options: {}
+                },
+                required: ["listener", "spatialized", "channelConfig", "volumeOffsets"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setMultiplePositions",
+            title: "Set Multiple Positions",
+            description: "Assign multiple 3D positions to a game object. multiPositionType: 0=MultiDirections,1=MultiSources,2=SingleSource.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "position", "spatialization"],
+            examples: [{ title: "Set two source positions", input: { gameObject: 1001, positions: [{ position: { orientationFront: { x: 0, y: 0, z: -1 }, orientationTop: { x: 0, y: 1, z: 0 }, position: { x: 1, y: 0, z: 0 } } }], multiPositionType: 1 } }],
+            inputSchema: {
+                gameObject: gameObj,
+                positions: v4_1.z.array(v4_1.z.object({ position: transform3D })),
+                multiPositionType: v4_1.z.number().int().min(0).max(2)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    gameObject: { type: "number" },
+                    positions: { type: "array", items: { type: "object", properties: { position: transform3DJson }, required: ["position"] } },
+                    multiPositionType: { type: "integer", minimum: 0, maximum: 2 }, options: {}
+                },
+                required: ["gameObject", "positions", "multiPositionType"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setObjectObstructionAndOcclusion",
+            title: "Set Obstruction and Occlusion",
+            description: "Set obstruction (0-1) and occlusion (0-1) levels between an emitter and a listener.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "occlusion"],
+            examples: [{ title: "Half-occluded object", input: { emitter: 1001, listener: 0, obstructionLevel: 0.3, occlusionLevel: 0.5 } }],
+            inputSchema: {
+                emitter: gameObj, listener: gameObj,
+                obstructionLevel: v4_1.z.number().min(0).max(1), occlusionLevel: v4_1.z.number().min(0).max(1)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    emitter: { type: "number" }, listener: { type: "number" },
+                    obstructionLevel: { type: "number", minimum: 0, maximum: 1 },
+                    occlusionLevel: { type: "number", minimum: 0, maximum: 1 }, options: {}
+                },
+                required: ["emitter", "listener", "obstructionLevel", "occlusionLevel"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setPosition",
+            title: "Set Position",
+            description: "Set the 3D world-space position of a game object.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "position"],
+            examples: [{ title: "Place at origin", input: { gameObject: 1001, position: { orientationFront: { x: 0, y: 0, z: -1 }, orientationTop: { x: 0, y: 1, z: 0 }, position: { x: 0, y: 0, z: 0 } } } }],
+            inputSchema: { gameObject: gameObj, position: transform3D },
+            inputSchemaJson: {
+                type: "object",
+                properties: { gameObject: { type: "number" }, position: transform3DJson, options: {} },
+                required: ["gameObject", "position"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setRTPCValue",
+            title: "Set RTPC Value",
+            description: "Set a runtime RTPC value for a game object or globally.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "rtpc"],
+            examples: [{ title: "Set speed RTPC", input: { rtpc: "Player_Speed", value: 12.5, gameObject: 1001 } }],
+            inputSchema: { rtpc: seObj, value: v4_1.z.number(), gameObject: gameObj.optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { rtpc: seObjJson, value: { type: "number" }, gameObject: { type: "number" }, options: {} },
+                required: ["rtpc", "value"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setScalingFactor",
+            title: "Set Scaling Factor",
+            description: "Scale the attenuation radius of a game object (1.0=100%, 2.0=200%).",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "attenuation"],
+            examples: [{ title: "Double attenuation radius", input: { gameObject: 1001, attenuationScalingFactor: 2.0 } }],
+            inputSchema: { gameObject: gameObj, attenuationScalingFactor: v4_1.z.number().positive() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { gameObject: { type: "number" }, attenuationScalingFactor: { type: "number", exclusiveMinimum: 0 }, options: {} },
+                required: ["gameObject", "attenuationScalingFactor"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setState",
+            title: "Set State",
+            description: "Set the active state in a State Group.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "states"],
+            examples: [{ title: "Switch music to combat", input: { stateGroup: "Music_State", state: "Combat" } }],
+            inputSchema: { stateGroup: seObj, state: seObj },
+            inputSchemaJson: {
+                type: "object",
+                properties: { stateGroup: seObjJson, state: seObjJson, options: {} },
+                required: ["stateGroup", "state"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.setSwitch",
+            title: "Set Switch",
+            description: "Set a Switch state on a game object.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "switches"],
+            examples: [{ title: "Set surface to grass", input: { switchGroup: "Surface_Type", switchState: "Grass", gameObject: 1001 } }],
+            inputSchema: { switchGroup: seObj, switchState: seObj, gameObject: gameObj.optional() },
+            inputSchemaJson: {
+                type: "object",
+                properties: { switchGroup: seObjJson, switchState: seObjJson, gameObject: { type: "number" }, options: {} },
+                required: ["switchGroup", "switchState"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.stopAll",
+            title: "Stop All",
+            description: "Stop all sounds on a game object.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "events"],
+            examples: [{ title: "Stop all on player", input: { gameObject: 1001 } }],
+            inputSchema: { gameObject: gameObj },
+            inputSchemaJson: {
+                type: "object",
+                properties: { gameObject: { type: "number" }, options: {} },
+                required: ["gameObject"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.stopPlayingID",
+            title: "Stop Playing ID",
+            description: "Stop a specific playing ID with an optional fade. fadeCurve: 0-9 AkCurveInterpolation.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "events"],
+            examples: [{ title: "Fade out a playing event", input: { playingId: 12345, transitionDuration: 1000, fadeCurve: 4 } }],
+            inputSchema: {
+                playingId: v4_1.z.number().int().min(0),
+                transitionDuration: v4_1.z.number().int(),
+                fadeCurve: v4_1.z.number().int().min(0).max(9)
+            },
+            inputSchemaJson: {
+                type: "object",
+                properties: {
+                    playingId: { type: "integer", minimum: 0 }, transitionDuration: { type: "integer" },
+                    fadeCurve: { type: "integer", minimum: 0, maximum: 9 }, options: {}
+                },
+                required: ["playingId", "transitionDuration", "fadeCurve"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.unloadBank",
+            title: "Unload SoundBank",
+            description: "Unload a SoundBank from the runtime sound engine.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "banks"],
+            examples: [{ title: "Unload level bank", input: { soundBank: "Level01" } }],
+            inputSchema: { soundBank: seObj },
+            inputSchemaJson: {
+                type: "object",
+                properties: { soundBank: seObjJson, options: {} },
+                required: ["soundBank"],
+                additionalProperties: false
+            }
+        }),
+        (0, toolFactory_js_1.createWaapiStubTool)({
+            name: "ak.soundengine.unregisterGameObj",
+            title: "Unregister Game Object",
+            description: "Unregister a game object from the runtime sound engine.",
+            domain: "soundengine",
+            risk: "high",
+            permissions: ["waapi:runtime"],
+            tags: ["waapi", "runtime", "game-object"],
+            examples: [{ title: "Unregister on death", input: { gameObject: 1001 } }],
+            inputSchema: { gameObject: gameObj },
+            inputSchemaJson: {
+                type: "object",
+                properties: { gameObject: { type: "number" }, options: {} },
+                required: ["gameObject"],
+                additionalProperties: false
+            }
+        })
+    ];
+}