Bridge (Validation) | ForbocAI SDK

Bridge behavior in the UE plugin mirrors the core SDK bridge slice: validation requests go to the API, and the plugin caches validation state, active presets, and available rulesets in BridgeSlice.

Core Types

1 USTRUCT(BlueprintType)
2 struct FBridgeValidationContext {
3   UPROPERTY(BlueprintReadOnly) FString NpcStateJson;
4   UPROPERTY(BlueprintReadOnly) FString WorldStateJson;
5   UPROPERTY(BlueprintReadOnly) FString ConstraintsJson;
6 };
7 
8 USTRUCT(BlueprintType)
9 struct FValidationResult {
10   UPROPERTY(BlueprintReadOnly) bool bValid;
11   UPROPERTY(BlueprintReadOnly) FString Reason;
12   UPROPERTY(BlueprintReadOnly) FAgentAction CorrectedAction;
13 };

FBridgeRule and FDirectiveRuleSet mirror the API-facing rule metadata returned by the current backend.

Validate An Action

1 #include "RuntimeStore.h"
2 #include "RuntimeConfig.h"
3 #include "CLI/CliOperations.h"
4 
5 auto Store = createSDKStore();
6 SDKConfig::SetApiConfig(TEXT("https://api.forboc.ai"), ApiKey);
7 
8 FAgentAction Action = TypeFactory::Action(TEXT("OPEN_GATE"), TEXT("north_gate"));
9 Action.PayloadJson = TEXT("{\"gateId\":\"north_gate\"}");
10 
11 FBridgeValidationContext Context;
12 Context.NpcStateJson = TEXT("{\"alertLevel\":0}");
13 Context.WorldStateJson = TEXT("{\"curfew\":false}");
14 
15 FValidationResult Result = SDKOps::ValidateBridge(Store, Action, Context);

Rules And Presets

Use the bridge thunks or the synchronous wrappers to inspect server-side rules:

1 TArray<FBridgeRule> Rules = SDKOps::BridgeRules(Store);
2 TArray<FDirectiveRuleSet> Rulesets = SDKOps::RulesList(Store);
3 TArray<FString> PresetIds = SDKOps::RulesPresets(Store);
4 FDirectiveRuleSet Preset = SDKOps::BridgePreset(Store, TEXT("rpg"));

To register or delete a ruleset:

1 FDirectiveRuleSet Ruleset;
2 Ruleset.Id = TEXT("market-curfew");
3 Ruleset.RulesetId = TEXT("market-curfew");
4 
5 SDKOps::RulesRegister(Store, Ruleset);
6 SDKOps::RulesDelete(Store, TEXT("market-curfew"));

Slice Behavior

The current slice tracks:

LastValidation
Status
Error
ActivePresets
AvailableRulesets
AvailablePresetIds

ClearBridgeValidation only clears the last validation/status/error fields. It does not wipe cached presets or rulesets.

Direct Thunks

If you want parity with packages/core, dispatch:

rtk::validateBridgeThunk(Action, Context, NpcId)
rtk::getBridgeRulesThunk()
rtk::loadBridgePresetThunk(PresetName)
rtk::listRulesetsThunk()
rtk::listRulePresetsThunk()
rtk::registerRulesetThunk(Ruleset)
rtk::deleteRulesetThunk(RulesetId)