unreal-engine-mcp-server 0.5.21 → 0.6.0-a

package/dist/tools/catalog/capabilities/records/utility/example-values.js

@@ -0,0 +1,173 @@
+const FAMILY_DEFAULTS = {
+    authoring: { name: 'Cue_FootstepConcrete', path: '/Game/Audio/Cues', assetPath: '/Game/Audio/Cues/Cue_FootstepConcrete' },
+    metasound: { name: 'MS_EngineTone', path: '/Game/Audio/MetaSounds', assetPath: '/Game/Audio/MetaSounds/MS_EngineTone' },
+    runtime: { name: 'ReverbZone_Cavern', path: '/Game/Audio', assetPath: '/Game/Audio/Cues/Cue_FootstepConcrete' },
+    replication: { name: 'BP_PlayerCharacter', path: '/Game/Blueprints', assetPath: '/Game/Blueprints/BP_PlayerCharacter' },
+    session: { name: 'ArenaSession', path: '/Game/Blueprints/Framework', assetPath: '/Game/Blueprints/Framework/BP_ArenaGameMode' },
+    gameFramework: { name: 'BP_ArenaGameMode', path: '/Game/Blueprints/Framework', assetPath: '/Game/Blueprints/Framework/BP_ArenaGameMode' },
+    input: { name: 'IA_Jump', path: '/Game/Input/Actions', assetPath: '/Game/Input/Actions/IA_Jump' },
+};
+const FIELD_EXAMPLES = {
+    actionPath: '/Game/Input/Actions/IA_Jump',
+    actorName: 'BP_PlayerCharacter_C_0',
+    attenuationRadius: 1200,
+    blueprintPath: '/Game/Blueprints/BP_PlayerCharacter',
+    channelName: 'TeamAlpha',
+    componentName: 'FootstepAudio',
+    condition: 'COND_OwnerOnly',
+    contextPath: '/Game/Input/IMC_Default',
+    controllerId: 0,
+    dataType: 'FVector',
+    dormancy: 'DORM_DormantAll',
+    effectType: 'SourceEffectFilter',
+    enabled: true,
+    entryIndex: 0,
+    existsAfter: true,
+    functionName: 'ServerFireWeapon',
+    gameModeBlueprint: '/Game/Blueprints/Framework/BP_ArenaGameMode',
+    gameStateClass: '/Game/Blueprints/Framework/BP_ArenaGameState',
+    hasAuthority: true,
+    inputName: 'Frequency',
+    inputType: 'Float',
+    interfaceType: 'LAN',
+    isLocalController: true,
+    isLocallyControlled: true,
+    key: 'SpaceBar',
+    mapName: '/Game/Maps/Arena',
+    mixName: 'CombatMix',
+    modifierType: 'DeadZone',
+    nodeClassName: 'UE.Sine.Audio',
+    nodeId: 'Node_0',
+    nodeType: 'WavePlayer',
+    outputName: 'Out',
+    outputType: 'Audio',
+    pawnClass: '/Game/Blueprints/BP_PlayerCharacter',
+    playerControllerClass: '/Game/Blueprints/Framework/BP_ArenaPlayerController',
+    playerIndex: 1,
+    playerName: 'PlayerOne',
+    playerStateClass: '/Game/Blueprints/Framework/BP_ArenaPlayerState',
+    propertyName: 'Health',
+    pushToTalkEnabled: true,
+    reliable: true,
+    repNotifyFunc: 'OnRep_Health',
+    role: 'ROLE_Authority',
+    rpcType: 'Server',
+    serverAddress: '127.0.0.1',
+    sessionName: 'ArenaSession',
+    soundClassName: 'SFX',
+    soundClassPath: '/Game/Audio/Classes/SC_SFX',
+    soundName: 'FootstepConcrete',
+    soundPath: '/Game/Audio/Waves/SW_FootstepConcrete',
+    sourceNodeId: 'Node_0',
+    sourceOutputName: 'Out',
+    splitScreenType: 'TwoPlayer_Horizontal',
+    targetInputName: 'In',
+    targetNodeId: 'Node_1',
+    triggerType: 'Pressed',
+    voiceEnabled: true,
+    voiceSettings: { volume: 0.8, noiseSuppression: true, echoCancellation: true, sampleRate: 48000 },
+};
+const ACTION_EXAMPLES = {
+    'create_submix_effect.effectType': 'SubmixEffectReverb',
+    'add_metasound_output.outputType': 'Audio',
+    'add_metasound_input.inputType': 'Float',
+    'add_legacy_axis_mapping.key': 'W',
+    'remove_legacy_axis_mapping.key': 'W',
+    'create_attenuation_settings.name': 'ATT_Footstep',
+    'set_sound_attenuation.name': 'ATT_Footstep',
+    'create_dialogue_voice.name': 'DV_Narrator',
+    'create_dialogue_wave.name': 'DW_Intro',
+    'create_reverb_effect.name': 'RE_Cavern',
+    'create_source_effect_chain.name': 'SEC_Weapon',
+    'create_submix_effect.name': 'SME_Reverb',
+    'create_sound_class.name': 'SC_SFX',
+    'create_sound_mix.name': 'SM_Combat',
+    'create_game_state.name': 'BP_ArenaGameState',
+    'create_player_controller.name': 'BP_ArenaPlayerController',
+    'create_player_state.name': 'BP_ArenaPlayerState',
+    'create_game_instance.name': 'BP_ArenaGameInstance',
+    'create_hud_class.name': 'BP_ArenaHUD',
+    'create_input_mapping_context.name': 'IMC_Default',
+    'create_input_mapping_context.path': '/Game/Input',
+    'get_audio_info.assetClass': 'SoundCue',
+    'get_audio_info.type': 'SoundCue',
+    'get_input_info.assetClass': 'InputAction',
+    'get_input_info.assetName': 'IA_Jump',
+    'get_input_info.type': 'InputAction',
+};
+const REFLECTED_EXAMPLES = {
+    networkingInfo: {
+        role: 'ROLE_Authority',
+        remoteRole: 'ROLE_SimulatedProxy',
+        hasAuthority: true,
+    },
+    gameFrameworkInfo: {
+        gameModeClass: '/Game/Blueprints/Framework/BP_ArenaGameMode_C',
+        defaultPawnClass: '/Game/Blueprints/BP_PlayerCharacter_C',
+        playerControllerClass: '/Game/Blueprints/Framework/BP_ArenaPlayerController_C',
+        source: 'levelDefault',
+    },
+    sessionsInfo: {
+        localPlayerCount: 1,
+        inPlaySession: false,
+        currentSessionName: 'None',
+        isLANMatch: false,
+        maxPlayers: 0,
+        currentPlayers: 1,
+        splitScreenEnabled: false,
+        splitScreenType: 'None',
+        voiceChatEnabled: false,
+        isHosting: false,
+        connectedServerAddress: '',
+        activeVoiceChannels: [],
+    },
+};
+function valueFor(action, field, family) {
+    const override = ACTION_EXAMPLES[`${action}.${field}`];
+    if (override !== undefined)
+        return override;
+    const defaults = FAMILY_DEFAULTS[family];
+    if (defaults !== undefined) {
+        if (field === 'name')
+            return defaults.name;
+        if (field === 'path')
+            return defaults.path;
+        if (field === 'assetPath')
+            return defaults.assetPath;
+    }
+    const reflected = REFLECTED_EXAMPLES[field];
+    if (reflected !== undefined)
+        return { ...reflected };
+    const known = FIELD_EXAMPLES[field];
+    if (known !== undefined)
+        return known;
+    return `Example${field.charAt(0).toUpperCase()}${field.slice(1)}`;
+}
+export function buildExampleInput(action, family, required, requiredOneOf) {
+    const input = { action };
+    for (const field of required) {
+        if (field === 'action')
+            continue;
+        input[field] = valueFor(action, field, family);
+    }
+    for (const field of requiredOneOf ?? []) {
+        if (field === 'action' || Object.hasOwn(input, field))
+            continue;
+        input[field] = valueFor(action, field, family);
+        break;
+    }
+    return input;
+}
+export function buildExampleOutput(action, family, outputRequired) {
+    const output = {
+        success: true,
+        message: `${action} completed successfully.`,
+    };
+    for (const field of outputRequired) {
+        if (field === 'success' || field === 'message')
+            continue;
+        output[field] = valueFor(action, field, family);
+    }
+    return output;
+}
+//# sourceMappingURL=example-values.js.map

package/dist/tools/catalog/capabilities/records/utility/example-values.js.map

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

package/dist/tools/catalog/capabilities/records/utility/helpers.d.ts

@@ -0,0 +1,2 @@
+export { utilityRecord, withTopics, withAliases, type UtilityRecordSpec } from './utility-record-builders.js';
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC"}

package/dist/tools/catalog/capabilities/records/utility/helpers.js

@@ -0,0 +1,2 @@
+export { utilityRecord, withTopics, withAliases } from './utility-record-builders.js';
+//# sourceMappingURL=helpers.js.map

package/dist/tools/catalog/capabilities/records/utility/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/helpers.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EAEZ,MAAM,8BAA8B,CAAC"}

package/dist/tools/catalog/capabilities/records/utility/index.d.ts

@@ -0,0 +1,8 @@
+import type { CapabilityCatalog, CapabilityRecord } from '../../index.js';
+export declare const UTILITY_NET_NEW_COUNT: 32;
+export declare const UTILITY_REUSED_SEQUENCE_COUNT: 19;
+export declare const UTILITY_AGGREGATE_COUNT: 51;
+export declare const UTILITY_SOURCE_RECORDS: readonly CapabilityRecord[];
+export declare const UTILITY_CAPABILITY_CATALOG: CapabilityCatalog;
+export declare const UTILITY_CAPABILITY_RECORD_COUNT: number;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAO1E,eAAO,MAAM,qBAAqB,EAAG,EAAW,CAAC;AACjD,eAAO,MAAM,6BAA6B,EAAG,EAAW,CAAC;AACzD,eAAO,MAAM,uBAAuB,EAAG,EAAW,CAAC;AAGnD,eAAO,MAAM,sBAAsB,EAAE,SAAS,gBAAgB,EAI5D,CAAC;AAWH,eAAO,MAAM,0BAA0B,EAAE,iBAExC,CAAC;AACF,eAAO,MAAM,+BAA+B,QAAoC,CAAC"}

package/dist/tools/catalog/capabilities/records/utility/index.js

@@ -0,0 +1,22 @@
+import { parseCapabilityCatalog } from '../../index.js';
+import { MANAGE_AUDIO_RECORDS } from '../manage-audio/index.js';
+import { MANAGE_NETWORKING_RECORDS } from '../manage-networking/index.js';
+import { MANAGE_SEQUENCE_RECORDS } from '../manage-sequence/index.js';
+import { compareById } from '../../../../../utils/serialization/ordering.js';
+export const UTILITY_NET_NEW_COUNT = 32;
+export const UTILITY_REUSED_SEQUENCE_COUNT = 19;
+export const UTILITY_AGGREGATE_COUNT = 51;
+export const UTILITY_SOURCE_RECORDS = Object.freeze([
+    ...MANAGE_SEQUENCE_RECORDS,
+    ...MANAGE_AUDIO_RECORDS,
+    ...MANAGE_NETWORKING_RECORDS,
+]);
+const parsed = parseCapabilityCatalog([...UTILITY_SOURCE_RECORDS]);
+const uniqueIds = new Set(parsed.map((record) => record.id)).size;
+if (parsed.length !== UTILITY_AGGREGATE_COUNT || uniqueIds !== UTILITY_AGGREGATE_COUNT) {
+    throw new TypeError(`Utility capability aggregate must contain exactly ${UTILITY_AGGREGATE_COUNT} unique records; `
+        + `received ${parsed.length} records and ${uniqueIds} unique IDs`);
+}
+export const UTILITY_CAPABILITY_CATALOG = Object.freeze([...parsed].sort(compareById));
+export const UTILITY_CAPABILITY_RECORD_COUNT = UTILITY_CAPABILITY_CATALOG.length;
+//# sourceMappingURL=index.js.map

package/dist/tools/catalog/capabilities/records/utility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAW,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAW,CAAC;AAGnD,MAAM,CAAC,MAAM,sBAAsB,GAAgC,MAAM,CAAC,MAAM,CAAC;IAC/E,GAAG,uBAAuB;IAC1B,GAAG,oBAAoB;IACvB,GAAG,yBAAyB;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,sBAAsB,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;AACnE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,IAAI,MAAM,CAAC,MAAM,KAAK,uBAAuB,IAAI,SAAS,KAAK,uBAAuB,EAAE,CAAC;IACvF,MAAM,IAAI,SAAS,CACjB,qDAAqD,uBAAuB,mBAAmB;UAC7F,YAAY,MAAM,CAAC,MAAM,gBAAgB,SAAS,aAAa,CAClE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAsB,MAAM,CAAC,MAAM,CACxE,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAAC,MAAM,CAAC"}

package/dist/tools/catalog/capabilities/records/utility/output-glossary.d.ts

@@ -0,0 +1,5 @@
+import type { JsonObject } from '../../index.js';
+export declare const OUTPUT_HEADER: Readonly<Record<string, JsonObject>>;
+export declare const UTILITY_OUTPUT_FIELDS: Readonly<Record<string, JsonObject>>;
+export declare function outputProperty(name: string): JsonObject;
+//# sourceMappingURL=output-glossary.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/output-glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-glossary.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/output-glossary.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiBjD,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM7D,CAAC;AAqBH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAkCrE,CAAC;AAQH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAMvD"}

package/dist/tools/catalog/capabilities/records/utility/output-glossary.js

@@ -0,0 +1,60 @@
+import { str, num, bool } from '../shared/schema-props.js';
+const REFLECTION_BOUNDARY = 'x-unreal-reflection-boundary';
+function reflected(description) {
+    return {
+        type: 'object',
+        description,
+        additionalProperties: true,
+        [REFLECTION_BOUNDARY]: true,
+    };
+}
+export const OUTPUT_HEADER = Object.freeze({
+    success: { type: 'boolean', description: 'Whether the action succeeded.' },
+    message: { type: 'string', description: 'Human-readable result message.' },
+    details: { type: 'object', 'x-unreal-reflection-boundary': true, description: 'Additional handler result fields not named by the contract.' },
+});
+export const UTILITY_OUTPUT_FIELDS = Object.freeze({
+    actorName: str('Name of the actor that was spawned or acted upon.'),
+    assetClass: str('Unreal class name of the asset that was inspected, such as SoundCue or InputAction.'),
+    assetName: str('Object name of the asset that was inspected, without its package path.'),
+    assetPath: str('Full /Game path of the asset that was created, modified or inspected.'),
+    attenuationPath: str('Path of the Sound Attenuation asset referenced by the inspected Sound Cue.'),
+    componentName: str('Name of the audio component that was created or spawned.'),
+    consumeInput: bool('Whether the Input Action consumes the input it handles.'),
+    duration: num('Length of the inspected sound in seconds.'),
+    existsAfter: bool('Whether the asset still resolved after the action completed.'),
+    falloffDistance: num('Distance in centimetres over which the attenuation falls off.'),
+    functionName: str('Name of the Blueprint RPC function that was created.'),
+    gameFrameworkInfo: reflected('Game Framework class assignments and rule state read from the GameMode.'),
+    hasAuthority: bool('Whether the actor currently holds network authority.'),
+    isLocalController: bool('Whether the controller possessing this actor is the local controller.'),
+    isLocallyControlled: bool('Whether the actor is controlled by the local player.'),
+    mappingCount: num('Number of key mappings declared by the inspected Input Mapping Context.'),
+    modifierCount: num('Number of Sound Class effects declared by the inspected Sound Mix.'),
+    networkingInfo: reflected('Replication, relevancy and network role state read from the Blueprint or actor.'),
+    nodeCount: num('Number of nodes in the inspected Sound Cue graph.'),
+    nodeId: str('Identifier of the graph node that was added.'),
+    numChannels: num('Number of audio channels in the inspected Sound Wave.'),
+    parentClass: str('Path of the parent Sound Class the inspected Sound Class inherits from.'),
+    pitch: num('Pitch multiplier declared by the inspected Sound Class.'),
+    playerIndex: num('Index assigned to the local player that was added.'),
+    role: str('Network role of the actor, such as ROLE_Authority.'),
+    sampleRate: num('Sample rate of the inspected Sound Wave for the current platform.'),
+    serverAddress: str('Address of the LAN server that was hosted or joined.'),
+    sessionName: str('Name of the online session that was created or joined.'),
+    sessionsInfo: reflected('Local and online session state, including player counts, split-screen, voice and hosting flags.'),
+    spatialize: bool('Whether the inspected Sound Attenuation spatializes its source.'),
+    type: str('Kind of asset the bridge resolved, such as SoundCue, SoundWave or InputAction.'),
+    valueType: str('Enhanced Input value type of the Input Action, reported as its numeric enum index.'),
+    volume: num('Volume multiplier declared by the inspected Sound Class.'),
+});
+export function outputProperty(name) {
+    const header = OUTPUT_HEADER[name];
+    if (header !== undefined)
+        return { ...header };
+    const known = UTILITY_OUTPUT_FIELDS[name];
+    if (known !== undefined)
+        return { ...known };
+    return { type: 'string', description: `Value reported by the bridge for ${name}.` };
+}
+//# sourceMappingURL=output-glossary.js.map

package/dist/tools/catalog/capabilities/records/utility/output-glossary.js.map

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

package/dist/tools/catalog/capabilities/records/utility/utility-output-schema.d.ts

@@ -0,0 +1,4 @@
+import type { Draft202012ObjectSchema } from '../../index.js';
+export declare function inputSchema(fields: readonly string[], required: readonly string[], requiredOneOf?: readonly string[]): Draft202012ObjectSchema;
+export declare function outputSchema(fields: readonly string[], required: readonly string[]): Draft202012ObjectSchema;
+//# sourceMappingURL=utility-output-schema.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/utility-output-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-output-schema.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/utility-output-schema.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,gBAAgB,CAAC;AAqB1E,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAChC,uBAAuB,CAIzB;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,uBAAuB,CAI5G"}

package/dist/tools/catalog/capabilities/records/utility/utility-output-schema.js

@@ -0,0 +1,26 @@
+import { SCHEMA_URI } from '../shared/record-presets.js';
+import { property } from './utility-schema-pins.js';
+import { outputProperty } from './output-glossary.js';
+function schema(properties, required, requiredOneOf) {
+    return {
+        $schema: SCHEMA_URI,
+        type: 'object',
+        properties,
+        required: [...required],
+        ...(requiredOneOf === undefined ? {} : { requiredOneOf: [...requiredOneOf] }),
+        additionalProperties: false,
+    };
+}
+export function inputSchema(fields, required, requiredOneOf) {
+    const properties = {};
+    for (const field of fields)
+        properties[field] = property(field);
+    return schema(properties, required, requiredOneOf);
+}
+export function outputSchema(fields, required) {
+    const properties = {};
+    for (const field of fields)
+        properties[field] = outputProperty(field);
+    return schema(properties, required);
+}
+//# sourceMappingURL=utility-output-schema.js.map

package/dist/tools/catalog/capabilities/records/utility/utility-output-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-output-schema.js","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/utility-output-schema.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,SAAS,MAAM,CACb,UAAsC,EACtC,QAA2B,EAC3B,aAAiC;IAEjC,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;QAC7E,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,WAAW,CACzB,MAAyB,EACzB,QAA2B,EAC3B,aAAiC;IAEjC,MAAM,UAAU,GAA+B,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,MAAyB,EAAE,QAA2B;IACjF,MAAM,UAAU,GAA+B,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,UAAU,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/tools/catalog/capabilities/records/utility/utility-record-builders.d.ts

@@ -0,0 +1,26 @@
+import type { CapabilityRecordSource } from '../../index.js';
+type Effect = 'read' | 'write' | 'destructive';
+export type UtilityRecordSpec = {
+    readonly tool: 'manage_audio' | 'manage_networking';
+    readonly action: string;
+    readonly family: string;
+    readonly summary: string;
+    readonly topics?: readonly string[];
+    readonly params?: readonly string[];
+    readonly required?: readonly string[];
+    readonly requiredOneOf?: readonly string[];
+    readonly outputs?: readonly string[];
+    readonly outputRequired?: readonly string[];
+    readonly plugins?: readonly string[];
+    readonly states?: readonly ('edit' | 'pie' | 'simulate')[];
+    readonly effect?: Effect;
+    readonly safeToRetry?: boolean;
+    readonly supportsUndo?: boolean;
+    readonly dispatchAction?: string;
+    readonly resources?: 'low' | 'medium' | 'high';
+};
+export declare function utilityRecord(spec: UtilityRecordSpec): CapabilityRecordSource;
+export declare function withTopics(record: CapabilityRecordSource, topics: readonly string[]): CapabilityRecordSource;
+export declare function withAliases(record: CapabilityRecordSource, aliases: readonly string[]): CapabilityRecordSource;
+export {};
+//# sourceMappingURL=utility-record-builders.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/utility-record-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-record-builders.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/utility-record-builders.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAA4B,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAWvF,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAG/C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAChD,CAAC;AAgBF,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,sBAAsB,CAuD7E;AAQD,wBAAgB,UAAU,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,CAE5G;AAGD,wBAAgB,WAAW,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,CAE9G"}

package/dist/tools/catalog/capabilities/records/utility/utility-record-builders.js

@@ -0,0 +1,80 @@
+import { V5_0, V5_8_P1 } from '../shared/record-presets.js';
+import { CapabilityAliasSchema, CapabilityIdSchema, LegacyActionNameSchema, LegacyToolNameSchema, } from '../../index.js';
+import { getParentToolMetadata } from '../parent-metadata.js';
+import { inputSchema, outputSchema } from './utility-output-schema.js';
+import { buildExampleInput, buildExampleOutput } from './example-values.js';
+function behavior(spec) {
+    const effect = spec.effect ?? 'write';
+    const idempotency = effect === 'read' ? 'idempotent' : 'non-idempotent';
+    return {
+        effect,
+        idempotency,
+        longRunning: false,
+        safeToRetry: spec.safeToRetry ?? (idempotency === 'idempotent' && effect !== 'destructive'),
+        supportsPreview: false,
+        supportsUndo: spec.supportsUndo ?? (effect === 'write' && (spec.states ?? ['edit']).includes('edit')),
+    };
+}
+export function utilityRecord(spec) {
+    const effect = spec.effect ?? 'write';
+    const inputFields = ['action', ...(spec.params ?? [])];
+    const required = ['action', ...(spec.required ?? [])];
+    const outputFields = ['success', 'message', 'details', ...(spec.outputs ?? [])];
+    const outputRequired = ['success', ...(spec.outputRequired ?? [])];
+    return {
+        id: CapabilityIdSchema.parse(`${spec.tool}.${spec.action}`),
+        aliases: [],
+        legacyIds: [{
+                tool: LegacyToolNameSchema.parse(spec.tool),
+                action: LegacyActionNameSchema.parse(spec.action),
+            }],
+        discovery: {
+            domain: spec.tool === 'manage_audio' ? 'audio' : 'networking',
+            family: spec.family,
+            topics: [spec.action, ...(spec.topics ?? [])],
+            summary: spec.summary,
+            whenToUse: [`Use when ${spec.summary.toLowerCase()}`],
+            whenNotToUse: ['Do not use when the required Unreal capability or target is unavailable.'],
+        },
+        schemas: {
+            input: inputSchema(inputFields, required, spec.requiredOneOf),
+            output: outputSchema(outputFields, outputRequired),
+        },
+        examples: [{
+                title: spec.summary,
+                input: buildExampleInput(spec.action, spec.family, required, spec.requiredOneOf),
+                output: buildExampleOutput(spec.action, spec.family, outputRequired),
+            }],
+        availability: {
+            unreal: { min: V5_0, max: V5_8_P1 },
+            requiredPlugins: [...(spec.plugins ?? [])],
+            editorStates: [...(spec.states ?? ['edit'])],
+        },
+        behavior: behavior(spec),
+        policy: {
+            requiredScope: effect,
+            consent: effect === 'destructive' ? 'explicit' : 'none',
+            dataAccess: effect === 'read' ? 'project-read' : 'project-write',
+        },
+        cost: { latency: 'interactive', resources: spec.resources ?? 'low' },
+        routing: {
+            parentTool: LegacyToolNameSchema.parse(spec.tool),
+            dispatchAction: LegacyActionNameSchema.parse(spec.dispatchAction ?? spec.tool),
+            dispatchMode: 'tool',
+        },
+        normalization: {
+            class: 'C_SAME_VERB_DIFFERENT_TARGET',
+            disposition: 'retain',
+            rationale: `Distinct ${spec.family} capability routed through ${spec.dispatchAction ?? spec.tool}.`,
+        },
+        deprecation: { status: 'active' },
+        parent: getParentToolMetadata(spec.tool),
+    };
+}
+export function withTopics(record, topics) {
+    return { ...record, discovery: { ...record.discovery, topics: [...record.discovery.topics, ...topics] } };
+}
+export function withAliases(record, aliases) {
+    return { ...record, aliases: [...record.aliases, ...aliases.map((alias) => CapabilityAliasSchema.parse(alias))] };
+}
+//# sourceMappingURL=utility-record-builders.js.map

package/dist/tools/catalog/capabilities/records/utility/utility-record-builders.js.map

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

package/dist/tools/catalog/capabilities/records/utility/utility-schema-pins.d.ts

@@ -0,0 +1,8 @@
+import type { JsonObject } from '../../index.js';
+export declare const BOOLEAN_FIELDS: Set<string>;
+export declare const NUMBER_FIELDS: Set<string>;
+export declare const OBJECT_FIELDS: Set<string>;
+export declare const ARRAY_FIELDS: Set<string>;
+export declare const FIELD_DESCRIPTIONS: Readonly<Record<string, string>>;
+export declare function property(name: string): JsonObject;
+//# sourceMappingURL=utility-schema-pins.d.ts.map

package/dist/tools/catalog/capabilities/records/utility/utility-schema-pins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-schema-pins.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/utility/utility-schema-pins.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,eAAO,MAAM,cAAc,aAWzB,CAAC;AAGH,eAAO,MAAM,aAAa,aAWxB,CAAC;AAGH,eAAO,MAAM,aAAa,aAAuF,CAAC;AAGlH,eAAO,MAAM,YAAY,aAAyD,CAAC;AAQnF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqM/D,CAAC;AAQF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAejD"}