unreal-engine-mcp-server 0.6.0-beta-e → 0.6.0

package/dist/tools/catalog/capabilities/records/system-control/widget-audio-viewport.js

@@ -1,115 +0,0 @@
-import { buildCoreRecord } from '../core/builder.js';
-const PT = 'system_control';
-export const WIDGET_AUDIO_VIEWPORT_RECORDS = [
-    buildCoreRecord({
-        parentTool: PT,
-        action: 'create_widget',
-        domain: 'widget',
-        family: 'widget',
-        summary: 'Create a widget asset via the manage_widget_authoring bridge action.',
-        whenToUse: ['A new UMG widget asset must be created.'],
-        whenNotToUse: ['An existing widget should be shown (use show_widget).'],
-        inputProps: {
-            name: { type: 'string', description: 'Widget name (derived from widgetPath if absent).' },
-            widgetPath: { type: 'string', description: 'Full widget asset path such as /Game/UI/WBP_Menu; supplies name and savePath when they are omitted.' },
-            widgetType: { type: 'string', description: 'Parent class: UserWidget (default) or another UserWidget subclass by name or path; anything else is refused.' },
-            savePath: { type: 'string', description: 'Destination /Game folder (default /Game/UI/Widgets).' },
-        },
-        required: [],
-        effect: 'write',
-        costLatency: 'interactive',
-        dispatchAction: 'manage_widget_authoring',
-        exampleInput: { action: 'create_widget', name: 'WBP_Menu', savePath: '/Game/UI' },
-    }),
-    buildCoreRecord({
-        parentTool: PT,
-        action: 'show_widget',
-        domain: 'widget',
-        family: 'widget',
-        summary: 'Show an editor toast notification with a message; it cannot put a widget Blueprint on screen.',
-        whenToUse: ['A short message must be shown to the person at the editor.'],
-        whenNotToUse: ['A widget Blueprint must be displayed in game (add it to the viewport from Blueprint logic).'],
-        inputProps: {
-            widgetId: { type: 'string', description: 'Only "notification" (the default); any other value is refused.' },
-            name: { type: 'string', description: 'Same as widgetId.' },
-            message: { type: 'string', description: 'Notification message text.' },
-            duration: { type: 'number', description: 'Seconds the notification stays up (default 4, 0.5 to 60).' },
-        },
-        required: [],
-        effect: 'write',
-        dispatchAction: 'manage_widget_authoring',
-        exampleInput: { action: 'show_widget', widgetId: 'notification', message: 'Saved' },
-    }),
-    buildCoreRecord({
-        parentTool: PT,
-        action: 'add_widget_child',
-        domain: 'widget',
-        family: 'widget',
-        summary: 'Add a child widget component to a parent widget via the manage_widget_authoring bridge action.',
-        whenToUse: ['A child component must be added to an existing widget.'],
-        whenNotToUse: ['A top-level widget must be created (use create_widget).'],
-        inputProps: {
-            widgetPath: { type: 'string', description: 'Parent widget path (required).' },
-            childClass: { type: 'string', description: 'Child component class (required).' },
-            parentName: { type: 'string', description: 'Panel to add the child under (get_widget_info lists the panels); omitted, the root panel. A name that is not a panel fails with PARENT_NOT_FOUND.' },
-            name: { type: 'string', description: 'Name of the new widget; omitted, a generated one.' },
-            text: { type: 'string', description: 'Optional text for text-bearing components.' },
-        },
-        required: ['widgetPath', 'childClass'],
-        outputProps: {
-            componentName: { type: 'string', description: 'Name the new widget got.' },
-            parentName: { type: 'string', description: 'Panel it was added under.' },
-        },
-        effect: 'write',
-        costLatency: 'interactive',
-        dispatchAction: 'manage_widget_authoring',
-        exampleInput: { action: 'add_widget_child', widgetPath: '/Game/UI/WBP_Menu', childClass: 'TextBlock' },
-    }),
-    buildCoreRecord({
-        parentTool: PT,
-        action: 'play_sound',
-        domain: 'audio',
-        family: 'audio',
-        summary: 'Play a 2D sound by path via the play_sound_2d bridge action, with an engine fallback sound.',
-        whenToUse: ['A 2D (non-spatial) sound must be played at runtime.'],
-        whenNotToUse: ['A spatial sound at a location is needed (use manage_audio).'],
-        inputProps: {
-            soundPath: { type: 'string', description: 'Sound asset path (default the editor CompileSuccess cue).' },
-            volume: { type: 'number', description: 'Volume multiplier (0 silences the request).' },
-            pitch: { type: 'number', description: 'Pitch multiplier.' },
-            startTime: { type: 'number', description: 'Seconds into the sound to start playing from (default 0).' },
-        },
-        required: [],
-        effect: 'write',
-        dispatchAction: 'play_sound_2d',
-        exampleInput: { action: 'play_sound', soundPath: '/Game/Audio/SFX_Click', volume: 1.0 },
-    }),
-    buildCoreRecord({
-        parentTool: PT,
-        action: 'screenshot',
-        domain: 'viewport',
-        family: 'viewport',
-        summary: 'Capture a screenshot of the editor viewport, game viewport, or full editor window.',
-        whenToUse: ['A viewport or window screenshot must be captured, optionally as base64.'],
-        whenNotToUse: ['A PIE session screenshot with camera control is needed (use control_editor).'],
-        inputProps: {
-            filename: { type: 'string', description: 'Screenshot filename base.' },
-            mode: { type: 'string', enum: ['editor_viewport', 'game_viewport', 'full_editor_window'], description: 'Screenshot target mode.' },
-            window: { type: ['integer', 'string'], description: 'With mode full_editor_window, which window to capture: a list index (2, or "2") or a case-insensitive substring of its title ("WBP_HubUI"). Omit for the main editor frame; responses list the open windows under windows[].' },
-            resolution: { type: 'string', description: 'Maximum WxH for the PNG (e.g. "1280x720"), aspect ratio kept, never upscaled. Without it an image returned inline fits 1600x900.' },
-            width: { type: 'number', description: 'Width in pixels.' },
-            height: { type: 'number', description: 'Height in pixels.' },
-            keepFile: { type: 'boolean', description: 'false: hand the image back without leaving a file in Saved/Screenshots (refused with returnBase64 false, which would leave no output at all). Default true. Files already written are listed by list_output_files and removed by delete_output_file.' },
-            path: { type: 'string', description: 'game_viewport mode only: project-relative folder to write the PNG into (default Saved/Screenshots/WindowsEditor).' },
-            returnBase64: { type: 'boolean', description: 'Return the PNG inline as an image (default true); a capture also saves a file unless keepFile is false. With no resolution, an inline image is downscaled to fit 1600x900. false returns only the saved path and metadata, at the full viewport size.' },
-            includeMetadata: { type: 'boolean', description: 'Include capture metadata.' },
-            metadata: { type: 'object', description: 'Optional metadata payload.', additionalProperties: true, 'x-unreal-reflection-boundary': true },
-        },
-        required: [],
-        effect: 'read',
-        costLatency: 'interactive',
-        dispatchAction: 'control_editor',
-        exampleInput: { action: 'screenshot', mode: 'editor_viewport', filename: 'Shot1' },
-    }),
-];
-//# sourceMappingURL=widget-audio-viewport.js.map

package/dist/tools/catalog/capabilities/records/unfolded.d.ts

@@ -1,4 +0,0 @@
-import type { CapabilityRecord, CapabilityRecordSource } from '../model.js';
-export declare const ALL_UNFOLDED_CAPABILITY_SOURCES: readonly CapabilityRecordSource[];
-export declare const ALL_UNFOLDED_CAPABILITY_RECORDS: readonly CapabilityRecord[];
-//# sourceMappingURL=unfolded.d.ts.map

package/dist/tools/catalog/capabilities/records/unfolded.js

@@ -1,51 +0,0 @@
-import { createCapabilityRecord } from '../parser.js';
-import { ANIMATION_PHYSICS_UNFOLDED_SOURCES } from './gameplay/animation-physics/index.js';
-import { BUILD_ENVIRONMENT_UNFOLDED_SOURCES } from './build-environment/index.js';
-import { CONTROL_ACTOR_UNFOLDED_SOURCES } from './control-actor/index.js';
-import { CONTROL_EDITOR_UNFOLDED_SOURCES } from './control-editor/index.js';
-import { INSPECT_UNFOLDED_SOURCES } from './inspect/index.js';
-import { MANAGE_AI_UNFOLDED_SOURCES } from './gameplay/manage-ai/records.js';
-import { MANAGE_ASSET_UNFOLDED_SOURCES } from './manage-asset/index.js';
-import { MANAGE_AUDIO_UNFOLDED_SOURCES } from './manage-audio/index.js';
-import { MANAGE_BLUEPRINT_UNFOLDED_SOURCES } from './manage-blueprint/index.js';
-import { MANAGE_CHARACTER_UNFOLDED_SOURCES } from './gameplay/manage-character/index.js';
-import { MANAGE_COMBAT_UNFOLDED_SOURCES } from './gameplay/manage-combat/index.js';
-import { MANAGE_EFFECT_UNFOLDED_SOURCES } from './gameplay/manage-effect/index.js';
-import { GAS_RECORDS } from './gameplay/manage-gas/gas.data.js';
-import { MANAGE_GEOMETRY_UNFOLDED_SOURCES } from './world/manage-geometry.index.js';
-import { MANAGE_INTERACTION_UNFOLDED_SOURCES } from './gameplay/manage-interaction/index.js';
-import { MANAGE_INVENTORY_UNFOLDED_SOURCES } from './gameplay/manage-inventory/index.js';
-import { MANAGE_LEVEL_STRUCTURE_UNFOLDED_SOURCES } from './world/manage-level-structure.index.js';
-import { MANAGE_LEVEL_UNFOLDED_SOURCES } from './manage-level/index.js';
-import { MANAGE_NETWORKING_UNFOLDED_SOURCES } from './manage-networking/index.js';
-import { MANAGE_PCG_UNFOLDED_SOURCES } from './world/manage-pcg.index.js';
-import { MANAGE_SEQUENCE_UNFOLDED_SOURCES } from './manage-sequence/index.js';
-import { MANAGE_TOOLS_SOURCES } from './manage-tools/index.js';
-import { SYSTEM_CONTROL_UNFOLDED_SOURCES } from './system-control/index.js';
-export const ALL_UNFOLDED_CAPABILITY_SOURCES = Object.freeze([
-    ...BUILD_ENVIRONMENT_UNFOLDED_SOURCES,
-    ...MANAGE_LEVEL_STRUCTURE_UNFOLDED_SOURCES,
-    ...MANAGE_GEOMETRY_UNFOLDED_SOURCES,
-    ...MANAGE_PCG_UNFOLDED_SOURCES,
-    ...ANIMATION_PHYSICS_UNFOLDED_SOURCES,
-    ...MANAGE_EFFECT_UNFOLDED_SOURCES,
-    ...GAS_RECORDS,
-    ...MANAGE_CHARACTER_UNFOLDED_SOURCES,
-    ...MANAGE_COMBAT_UNFOLDED_SOURCES,
-    ...MANAGE_AI_UNFOLDED_SOURCES,
-    ...MANAGE_INVENTORY_UNFOLDED_SOURCES,
-    ...MANAGE_INTERACTION_UNFOLDED_SOURCES,
-    ...MANAGE_SEQUENCE_UNFOLDED_SOURCES,
-    ...MANAGE_AUDIO_UNFOLDED_SOURCES,
-    ...MANAGE_NETWORKING_UNFOLDED_SOURCES,
-    ...MANAGE_ASSET_UNFOLDED_SOURCES,
-    ...MANAGE_BLUEPRINT_UNFOLDED_SOURCES,
-    ...CONTROL_ACTOR_UNFOLDED_SOURCES,
-    ...CONTROL_EDITOR_UNFOLDED_SOURCES,
-    ...MANAGE_LEVEL_UNFOLDED_SOURCES,
-    ...SYSTEM_CONTROL_UNFOLDED_SOURCES,
-    ...INSPECT_UNFOLDED_SOURCES,
-    ...MANAGE_TOOLS_SOURCES,
-]);
-export const ALL_UNFOLDED_CAPABILITY_RECORDS = Object.freeze(ALL_UNFOLDED_CAPABILITY_SOURCES.map((source) => createCapabilityRecord(source)));
-//# sourceMappingURL=unfolded.js.map

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

@@ -1,4 +0,0 @@
-import type { JsonObject } from '../../model.js';
-export declare function buildExampleInput(action: string, family: string, required: readonly string[], requiredOneOf?: readonly string[]): JsonObject;
-export declare function buildExampleOutput(action: string, family: string, outputRequired: readonly string[]): JsonObject;
-//# sourceMappingURL=example-values.d.ts.map

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

@@ -1,195 +0,0 @@
-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,
-    bDelayedStart: true,
-    blueprintPath: '/Game/Blueprints/BP_PlayerCharacter',
-    channelName: 'TeamAlpha',
-    componentName: 'FootstepAudio',
-    condition: 'COND_OwnerOnly',
-    contextPath: '/Game/Input/IMC_Default',
-    controllerId: 0,
-    dataType: 'Vector',
-    dormancy: 'DORM_DormantAll',
-    effectType: 'SourceEffectFilter',
-    enablePrediction: true,
-    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: 'Null',
-    configFile: 'C:/Projects/Arena/Config/DefaultEngine.ini',
-    connectionURL: '127.0.0.1:7777',
-    liveApplied: ['voice.MicNoiseGateThreshold'],
-    persisted: true,
-    pieWorld: 'Arena (PIE instance 1)',
-    playerStart: 'PlayerStart_Team1',
-    playerStartTag: 'Team1',
-    previousPort: 7777,
-    previousTag: 'None',
-    requiresRestart: false,
-    serverPort: 7777,
-    settingsSaved: true,
-    travelStarted: true,
-    written: ['[SystemSettings] voice.MicNoiseGateThreshold=0.05'],
-    created: true,
-    updated: false,
-    actorReplicates: true,
-    compiled: true,
-    saved: true,
-    variableName: 'PredictionData_Vector',
-    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',
-    respawnDelay: 5,
-    role: 'ROLE_Authority',
-    rpcType: 'Server',
-    serverAddress: '127.0.0.1',
-    sessionName: 'ArenaSession',
-    smoothingRate: 0.1,
-    soundClassName: 'SFX',
-    soundClassPath: '/Game/Audio/Classes/SC_SFX',
-    soundName: 'FootstepConcrete',
-    soundPath: '/Game/Audio/Waves/SW_FootstepConcrete',
-    spectatorClass: '/Script/Engine.SpectatorPawn',
-    sourceNodeId: 'Node_0',
-    sourceOutputName: 'Out',
-    splitScreenType: 'TwoPlayer_Horizontal',
-    targetInputName: 'In',
-    targetNodeId: 'Node_1',
-    triggerType: 'Pressed',
-    voiceEnabled: true,
-    micInputGain: 1.5,
-    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',
-    'set_net_role.role': 'ROLE_SimulatedProxy',
-    '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,
-        currentPlayers: 1,
-        splitScreenEnabled: false,
-        splitScreenActive: false,
-        splitScreenLayout: 'Horizontal',
-        pieInstances: [],
-    },
-};
-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/output-glossary.d.ts

@@ -1,4 +0,0 @@
-import type { JsonObject } from '../../model.js';
-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.js

@@ -1,120 +0,0 @@
-import { str, num, bool } from '../shared/schema-props.js';
-import { OUTPUT_HEADER } from '../shared/record-presets.js';
-const REFLECTION_BOUNDARY = 'x-unreal-reflection-boundary';
-function reflected(description) {
-    return {
-        type: 'object',
-        description,
-        additionalProperties: true,
-        [REFLECTION_BOUNDARY]: true,
-    };
-}
-export const UTILITY_OUTPUT_FIELDS = Object.freeze({
-    actorName: str('Name of the actor that was spawned or acted upon.'),
-    stopped: num('Sounds play_sound had started that this call stopped.'),
-    paused: num('Playing sounds this call paused (0 when none was playing).'),
-    resumed: num('Paused sounds this call resumed (0 when none was paused).'),
-    allStopped: bool('Whether every sound on the editor and game audio devices was stopped (all: true).'),
-    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.'),
-    effectiveInOpenLevel: bool('Whether the open level runs this game mode in play: its World Settings override names it, or it has none and this is the project default.'),
-    duration: num('Length of the inspected sound in seconds.'),
-    peakDb: num('Loudest level the sound reached, in dB of full scale (0 is full scale, -120 means no signal). The mixer meters each sound after its own volume and before distance attenuation; the editor being in the background does not lower it.'),
-    averageDb: num('Mean level over every reading in dB, the release tail included.'),
-    silent: bool('True when the peak stayed below -60 dB: the sound played but produced no audio; the warning says the likely cause.'),
-    envelopeUpdates: num('Meter readings that arrived, about one per editor frame; 0 means the engine never rendered the sound.'),
-    endedBecause: str('finished (the sound ended on its own), maxSeconds (cut there, as looping sounds and music always are) or stopped (stopped by another call, or its Play-In-Editor world ended).'),
-    timeline: { type: 'array', items: { type: ['number', 'null'] }, description: 'Loudest reading in dB in each timelineStepSeconds step from the start, null for a step no reading landed in (a slow editor frame).' },
-    timelineStepSeconds: num('Seconds each timeline entry covers: 0.05 for sounds up to 5 s, longer so there are at most 100 entries.'),
-    wavePeakDb: num('A Sound Wave only: the loudest sample of the recording itself, in dB of full scale, read from its imported audio rather than the meter, so it holds however few frames the editor drew. Before volume. Compare sounds by this when matching levels.'),
-    waveRmsDb: num('A Sound Wave only: the average (RMS) level of the whole recording in dB, before volume.'),
-    waveSeconds: num('A Sound Wave only: the length of the recording 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('The game mode in use (gameModeClass) and its default pawn, player controller, game state, player state and HUD class paths; a level or live read also gives source, worldName and isPlayInEditor. Carries no game rules.'),
-    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.'),
-    madeDefault: bool('Whether this game mode was made the project default game mode (makeDefault).'),
-    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.'),
-    mapPath: str('Resolved package path of the map the LAN server travels to.'),
-    edgeCount: num('Number of links in the inspected MetaSound graph.'),
-    edges: { type: 'array', items: { type: 'object', additionalProperties: true, [REFLECTION_BOUNDARY]: true }, description: 'Every link: fromNodeId, fromNode, fromPin, toNodeId, toNode, toPin.' },
-    edgesRemoved: num('How many MetaSound links were removed.'),
-    graphInputs: { type: 'array', items: { type: 'object', additionalProperties: true, [REFLECTION_BOUNDARY]: true }, description: 'Inputs of the MetaSound itself: name, type and the nodeId that carries each.' },
-    graphOutputs: { type: 'array', items: { type: 'object', additionalProperties: true, [REFLECTION_BOUNDARY]: true }, description: 'Outputs of the MetaSound itself: name, type and the nodeId that carries each.' },
-    nodeCount: num('Number of nodes in the inspected Sound Cue or MetaSound graph.'),
-    nodeId: str('Identifier of the graph node that was added.'),
-    nodeName: str('Name of the graph node that was added or updated.'),
-    inserted: bool('True when the node was newly inserted; false when an existing one was updated.'),
-    dopplerIntensity: num('Doppler pitch-shift strength now set on the node.'),
-    smoothing: bool('Whether the Doppler pitch change is smoothed.'),
-    rootNodeClass: str('Class of the node now at the root of the Sound Cue.'),
-    drivesNode: str('Name of the node the inserted node now plays.'),
-    saved: bool('Whether the asset was saved to disk.'),
-    oneShot: bool('Whether the new MetaSound is a one-shot source; false when it was made continuous (no On Finished output).'),
-    nodes: { type: 'array', items: { type: 'object', additionalProperties: true, [REFLECTION_BOUNDARY]: true }, description: 'Every node: nodeId, name, className, kind (Node, GraphInput, GraphOutput, Literal, Variable...), inputs [{name, type, literal}] and outputs [{name, type}].' },
-    nodeIds: reflected('Batch step id -> node id for every node the batch created.'),
-    numChannels: num('Number of audio channels in the inspected Sound Wave.'),
-    openLevelGameMode: str('Class path of the game mode the open level runs in play: its World Settings override, else the project default.'),
-    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.'),
-    results: {
-        type: 'array',
-        items: { type: 'object', additionalProperties: true, [REFLECTION_BOUNDARY]: true },
-        description: 'Per-step outcome of a batch: index, edit, id, success, nodeId, appliedValue.',
-    },
-    removed: { type: 'array', items: { type: 'string' }, description: 'Ids of the nodes that were removed.' },
-    removedCount: num('How many nodes were removed.'),
-    role: str('Network role of the actor, such as ROLE_Authority.'),
-    sampleRate: num('Sample rate of the inspected Sound Wave for the current platform.'),
-    serverName: str('Display name of the hosted LAN server.'),
-    sessionsInfo: reflected('Current play session: localPlayerCount, inPlaySession, currentPlayers, splitScreenEnabled, splitScreenActive, splitScreenLayout and pieInstances [{instance, netMode, url}]. Carries no online-subsystem, voice or hosting flags.'),
-    spatialize: bool('Whether the inspected Sound Attenuation spatializes its source.'),
-    travelURL: str('Listen-server travel URL built for the map and options.'),
-    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.'),
-    actorReplicates: bool('Whether the Blueprint itself replicates; a COND_AutonomousOnly variable reaches no client until it does.'),
-    compiled: bool('Whether the Blueprint compiled cleanly after the change.'),
-    configFile: str('Absolute path of the project config file that was written and read back.'),
-    connectionURL: str('The address:port URL, with options, the PIE instance travels to.'),
-    created: bool('Whether a new variable was added (false when an existing one was converted).'),
-    dataType: str('Resolved variable type in the add_variable grammar.'),
-    enabled: bool('Whether split screen is on after the change.'),
-    interfaceType: str('Online subsystem name written as DefaultPlatformService.'),
-    layoutsWritten: str('The GameMapsSettings layout field that changed (TwoPlayerSplitscreenLayout, ThreePlayerSplitscreenLayout or FourPlayerSplitscreenLayout); empty when only enabled changed.'),
-    liveApplied: { type: 'array', items: { type: 'string' }, description: 'Voice console variables applied to the running editor now.' },
-    persisted: bool('Whether the value was read back from the config file on disk.'),
-    pieWorld: str('The PIE world and instance that started travelling.'),
-    playerStart: str('Label of the PlayerStart that was tagged.'),
-    playerStartTag: str('PlayerStartTag after the change.'),
-    previous: str('DefaultPlatformService this editor session started with (empty for the engine default).'),
-    previousPort: num('Default game port before the change.'),
-    previousTag: str('PlayerStartTag before the change (None when it had none).'),
-    requiresRestart: bool('Whether a written setting is only read at startup, so the running editor keeps the old value until it restarts.'),
-    serverPort: num('Default game port after the change.'),
-    settingsSaved: bool('Whether GameMapsSettings was written to DefaultEngine.ini.'),
-    splitScreenType: str('Layout name that was applied, None when split screen was turned off, empty when only enabled changed.'),
-    travelStarted: bool('Whether ClientTravel was issued; the connection itself completes asynchronously.'),
-    updated: bool('Whether an existing variable was converted to owner-only replication.'),
-    variableName: str('Name of the prediction data variable.'),
-    written: { type: 'array', items: { type: 'string' }, description: 'Every [Section] Key=Value entry written to the config file, in order.' },
-});
-export function outputProperty(name) {
-    if (name === 'success' || name === 'message' || name === 'details')
-        return { ...OUTPUT_HEADER[name] };
-    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/utility-output-schema.d.ts

@@ -1,4 +0,0 @@
-import type { Draft202012ObjectSchema } from '../../model.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.js

@@ -1,16 +0,0 @@
-import { property } from './utility-schema-pins.js';
-import { outputProperty } from './output-glossary.js';
-import { schema } from '../shared/record-presets.js';
-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-record-builders.d.ts

@@ -1,29 +0,0 @@
-import type { CapabilityRecordSource, JsonObject } from '../../model.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 whenNotToUse?: 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 withWhenNotToUse(record: CapabilityRecordSource, lines: readonly string[]): CapabilityRecordSource;
-export declare function withInputProps(record: CapabilityRecordSource, props: Readonly<Record<string, JsonObject>>): 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.js

@@ -1,61 +0,0 @@
-import { CapabilityAliasSchema, CapabilityIdSchema, LegacyActionNameSchema, LegacyToolNameSchema } from '../../identifiers.js';
-import { behavior, policy } from '../shared/record-presets.js';
-import { inputSchema, outputSchema } from './utility-output-schema.js';
-import { buildExampleInput, buildExampleOutput } from './example-values.js';
-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 it to ${spec.summary.charAt(0).toLowerCase()}${spec.summary.slice(1)}`],
-            whenNotToUse: [...(spec.whenNotToUse ?? [])],
-        },
-        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: {
-            requiredPlugins: [...(spec.plugins ?? [])],
-            editorStates: [...(spec.states ?? ['edit'])],
-        },
-        behavior: behavior(effect, { safeToRetry: spec.safeToRetry }),
-        policy: policy(effect),
-        cost: { latency: 'interactive', resources: spec.resources ?? 'low' },
-        routing: {
-            parentTool: LegacyToolNameSchema.parse(spec.tool),
-            dispatchAction: LegacyActionNameSchema.parse(spec.dispatchAction ?? spec.tool),
-        },
-    };
-}
-export function withTopics(record, topics) {
-    return { ...record, discovery: { ...record.discovery, topics: [...record.discovery.topics, ...topics] } };
-}
-export function withWhenNotToUse(record, lines) {
-    return { ...record, discovery: { ...record.discovery, whenNotToUse: [...record.discovery.whenNotToUse, ...lines] } };
-}
-export function withInputProps(record, props) {
-    const input = record.schemas.input;
-    return { ...record, schemas: { ...record.schemas, input: { ...input, properties: { ...input.properties, ...props } } } };
-}
-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-schema-pins.d.ts

@@ -1,9 +0,0 @@
-import type { JsonObject } from '../../model.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 VECTOR_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