@aura3d/scripting 1.0.6

package/dist/HTN.d.ts

@@ -0,0 +1,58 @@
+import { WorldState, type GOAPStateShape } from "./GOAP";
+export type HTNTaskResult = "success" | "running" | "failure";
+export type HTNTaskType = "primitive" | "compound";
+export interface HTNTaskMethod {
+    readonly name: string;
+    readonly preconditions?: GOAPStateShape;
+    readonly subtasks: readonly HTNTask[];
+    readonly priority?: number;
+    readonly check?: (state: WorldState, context: unknown) => boolean;
+}
+export interface HTNPrimitiveTaskOptions {
+    readonly name: string;
+    readonly preconditions?: GOAPStateShape;
+    readonly effects?: GOAPStateShape;
+    readonly execute?: (state: WorldState, context: unknown) => HTNTaskResult;
+}
+export interface HTNCompoundTaskOptions {
+    readonly name: string;
+    readonly methods?: readonly HTNTaskMethod[];
+}
+export interface HTNPlannerOptions {
+    readonly maxDepth?: number;
+    readonly maxIterations?: number;
+}
+export interface HTNPlan {
+    readonly valid: boolean;
+    readonly rootTask: string;
+    readonly tasks: readonly string[];
+    readonly methodTrace: readonly string[];
+    readonly decompositions: number;
+    readonly maxDepthReached: number;
+    readonly iterations: number;
+    readonly finalState: GOAPStateShape;
+}
+export declare class HTNTask {
+    readonly name: string;
+    readonly type: HTNTaskType;
+    readonly preconditions: GOAPStateShape;
+    readonly effects: GOAPStateShape;
+    private readonly methods;
+    private readonly executeCallback?;
+    private constructor();
+    static primitive(options: HTNPrimitiveTaskOptions): HTNTask;
+    static compound(options: HTNCompoundTaskOptions): HTNTask;
+    getMethods(): readonly HTNTaskMethod[];
+    canRun(state: WorldState): boolean;
+    applyEffects(state: WorldState): WorldState;
+    execute(state: WorldState, context: unknown): HTNTaskResult;
+}
+export declare class HTNPlanner {
+    private readonly maxDepth;
+    private readonly maxIterations;
+    constructor(options?: HTNPlannerOptions);
+    plan(rootTask: HTNTask, initialState: WorldState, context?: unknown): HTNPlan;
+    isPlanValid(plan: HTNPlan, rootTask: HTNTask, initialState: WorldState, context?: unknown): boolean;
+    private decompose;
+}
+//# sourceMappingURL=HTN.d.ts.map

package/dist/HTN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTN.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/HTN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CACnE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC;CAC3E;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACrC;AAeD,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAyD;IAE1F,OAAO;IAiBP,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO;IAI3D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO;IAIzD,UAAU,IAAI,SAAS,aAAa,EAAE;IAItC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAIlC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAI3C,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa;CAI5D;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,iBAAsB;IAO3C,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAE,OAAY,GAAG,OAAO;IAoBjF,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,GAAE,OAAY,GAAG,OAAO;IAMvG,OAAO,CAAC,SAAS;CAmClB"}

package/dist/HTN.js

@@ -0,0 +1,115 @@
+import { WorldState } from "./GOAP.js";
+export class HTNTask {
+    name;
+    type;
+    preconditions;
+    effects;
+    methods;
+    executeCallback;
+    constructor(options) {
+        if (options.name.trim().length === 0)
+            throw new Error("HTN task name cannot be empty.");
+        this.name = options.name;
+        this.type = options.type;
+        this.preconditions = options.preconditions ?? {};
+        this.effects = options.effects ?? {};
+        this.methods = [...(options.methods ?? [])].sort((left, right) => (right.priority ?? 0) - (left.priority ?? 0) || left.name.localeCompare(right.name));
+        this.executeCallback = options.execute;
+    }
+    static primitive(options) {
+        return new HTNTask({ ...options, type: "primitive" });
+    }
+    static compound(options) {
+        return new HTNTask({ ...options, type: "compound" });
+    }
+    getMethods() {
+        return this.methods;
+    }
+    canRun(state) {
+        return state.matches(this.preconditions);
+    }
+    applyEffects(state) {
+        return state.apply(this.effects);
+    }
+    execute(state, context) {
+        if (this.type !== "primitive")
+            return "failure";
+        return this.executeCallback?.(state, context) ?? "success";
+    }
+}
+export class HTNPlanner {
+    maxDepth;
+    maxIterations;
+    constructor(options = {}) {
+        this.maxDepth = options.maxDepth ?? 12;
+        this.maxIterations = options.maxIterations ?? 128;
+        if (!Number.isInteger(this.maxDepth) || this.maxDepth < 1)
+            throw new RangeError("HTN maxDepth must be a positive integer.");
+        if (!Number.isInteger(this.maxIterations) || this.maxIterations < 1)
+            throw new RangeError("HTN maxIterations must be a positive integer.");
+    }
+    plan(rootTask, initialState, context = {}) {
+        const stats = {
+            decompositions: 0,
+            iterations: 0,
+            maxDepthReached: 0,
+            methodTrace: []
+        };
+        const result = this.decompose([rootTask], initialState.clone(), context, 0, stats);
+        return {
+            valid: result.valid,
+            rootTask: rootTask.name,
+            tasks: result.tasks.map((task) => task.name),
+            methodTrace: stats.methodTrace,
+            decompositions: stats.decompositions,
+            maxDepthReached: stats.maxDepthReached,
+            iterations: stats.iterations,
+            finalState: result.state.toObject()
+        };
+    }
+    isPlanValid(plan, rootTask, initialState, context = {}) {
+        if (!plan.valid)
+            return false;
+        const nextPlan = this.plan(rootTask, initialState, context);
+        return nextPlan.valid && nextPlan.tasks.join(">") === plan.tasks.join(">");
+    }
+    decompose(tasks, state, context, depth, stats) {
+        stats.maxDepthReached = Math.max(stats.maxDepthReached, depth);
+        if (depth > this.maxDepth || stats.iterations >= this.maxIterations) {
+            return { valid: false, tasks: [], state };
+        }
+        if (tasks.length === 0) {
+            return { valid: true, tasks: [], state };
+        }
+        stats.iterations += 1;
+        const [currentTask, ...remainingTasks] = tasks;
+        if (!currentTask)
+            return { valid: true, tasks: [], state };
+        if (currentTask.type === "primitive") {
+            if (!currentTask.canRun(state))
+                return { valid: false, tasks: [], state };
+            const executed = currentTask.execute(state, context);
+            if (executed === "failure")
+                return { valid: false, tasks: [], state };
+            const nextState = currentTask.applyEffects(state);
+            const remainder = this.decompose(remainingTasks, nextState, context, depth, stats);
+            return remainder.valid
+                ? { valid: true, tasks: [currentTask, ...remainder.tasks], state: remainder.state }
+                : { valid: false, tasks: [], state };
+        }
+        stats.decompositions += 1;
+        for (const method of currentTask.getMethods()) {
+            const preconditionsMet = method.check ? method.check(state, context) : state.matches(method.preconditions ?? {});
+            if (!preconditionsMet)
+                continue;
+            const traceLength = stats.methodTrace.length;
+            stats.methodTrace.push(`${currentTask.name}:${method.name}`);
+            const result = this.decompose([...method.subtasks, ...remainingTasks], state, context, depth + 1, stats);
+            if (result.valid)
+                return result;
+            stats.methodTrace.length = traceLength;
+        }
+        return { valid: false, tasks: [], state };
+    }
+}
+//# sourceMappingURL=HTN.js.map

package/dist/HTN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTN.js","sourceRoot":"","sources":["../../../../packages/scripting/src/HTN.ts"],"names":[],"mappings":"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"}

package/dist/LearningAgentFixtures.d.ts

@@ -0,0 +1,60 @@
+export interface LearningAgentFixtureOptions {
+    readonly seed?: number;
+    readonly targetDistance?: number;
+    readonly health?: number;
+    readonly energy?: number;
+    readonly nearbyCount?: number;
+}
+export interface LearningAgentFixture {
+    readonly source: "origin-master-ml-agent-adapted";
+    readonly observation: {
+        readonly featureSize: number;
+        readonly normalizedPosition: readonly [number, number, number];
+        readonly normalizedVelocity: readonly [number, number, number];
+        readonly targetDistance: number;
+        readonly health: number;
+        readonly energy: number;
+        readonly nearbyEntitySlots: number;
+        readonly featureHash: string;
+    };
+    readonly behaviorCloning: {
+        readonly demonstrations: number;
+        readonly trainLoss: number;
+        readonly validationLoss: number;
+        readonly trainAccuracy: number;
+        readonly validationAccuracy: number;
+        readonly earlyStoppingEpoch: number;
+        readonly selectedAction: "move-to-target" | "hold-position" | "recover";
+    };
+    readonly reinforcementLearning: {
+        readonly gamma: number;
+        readonly lambda: number;
+        readonly clipRange: number;
+        readonly policyLoss: number;
+        readonly valueLoss: number;
+        readonly totalLoss: number;
+        readonly avgAdvantage: number;
+        readonly avgReturn: number;
+        readonly entropy: number;
+        readonly klDivergence: number;
+        readonly explainedVariance: number;
+    };
+    readonly reward: {
+        readonly progress: number;
+        readonly survival: number;
+        readonly energyPenalty: number;
+        readonly proximityBonus: number;
+        readonly total: number;
+    };
+    readonly productionReadiness: {
+        readonly featureExtractionTelemetry: true;
+        readonly behaviorCloningTelemetry: true;
+        readonly ppoStatsTelemetry: true;
+        readonly rewardBreakdownTelemetry: true;
+    };
+    readonly blockedClaims: readonly string[];
+    readonly claimBoundary: string;
+    readonly hash: string;
+}
+export declare function sampleLearningAgentFixture(options?: LearningAgentFixtureOptions): LearningAgentFixture;
+//# sourceMappingURL=LearningAgentFixtures.d.ts.map

package/dist/LearningAgentFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningAgentFixtures.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/LearningAgentFixtures.ts"],"names":[],"mappings":"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"}

package/dist/LearningAgentFixtures.js

@@ -0,0 +1,122 @@
+export function sampleLearningAgentFixture(options = {}) {
+    const seed = normalizeSeed(options.seed ?? 0x1ea5);
+    const targetDistance = positive(options.targetDistance ?? 6.2, "targetDistance");
+    const health = clamp01(options.health ?? 0.72);
+    const energy = clamp01(options.energy ?? 0.58);
+    const nearbyEntitySlots = Math.max(0, Math.min(5, Math.trunc(options.nearbyCount ?? 3)));
+    const normalizedPosition = [
+        Number((seededUnit(seed) * 0.12).toFixed(4)),
+        0,
+        Number((seededUnit(seed ^ 0x5167) * 0.08).toFixed(4))
+    ];
+    const normalizedVelocity = [
+        Number((0.06 + seededUnit(seed ^ 0x78ab) * 0.04).toFixed(4)),
+        0,
+        Number((seededUnit(seed ^ 0x4312) * 0.02).toFixed(4))
+    ];
+    const featureCore = [
+        ...normalizedPosition,
+        ...normalizedVelocity,
+        1,
+        0,
+        0,
+        Number((targetDistance / 100).toFixed(4)),
+        health,
+        energy,
+        nearbyEntitySlots
+    ];
+    const progress = Number(Math.max(0, 1 - targetDistance / 12).toFixed(4));
+    const survival = Number((health * 0.35).toFixed(4));
+    const energyPenalty = Number(((1 - energy) * -0.18).toFixed(4));
+    const proximityBonus = Number((nearbyEntitySlots > 0 ? 0.08 : 0).toFixed(4));
+    const totalReward = Number((progress + survival + energyPenalty + proximityBonus).toFixed(4));
+    const selectedAction = health < 0.35 ? "recover" : targetDistance > 1.5 ? "move-to-target" : "hold-position";
+    const behaviorCloning = {
+        demonstrations: 24 + nearbyEntitySlots * 4,
+        trainLoss: Number((0.18 - progress * 0.06).toFixed(4)),
+        validationLoss: Number((0.22 - progress * 0.05).toFixed(4)),
+        trainAccuracy: Number((0.74 + progress * 0.12).toFixed(4)),
+        validationAccuracy: Number((0.7 + progress * 0.1).toFixed(4)),
+        earlyStoppingEpoch: 7 + nearbyEntitySlots,
+        selectedAction
+    };
+    const reinforcementLearning = {
+        gamma: 0.99,
+        lambda: 0.95,
+        clipRange: 0.2,
+        policyLoss: Number((-0.04 - progress * 0.03).toFixed(4)),
+        valueLoss: Number((0.21 - totalReward * 0.08).toFixed(4)),
+        totalLoss: Number((0.15 - totalReward * 0.05).toFixed(4)),
+        avgAdvantage: Number((totalReward * 0.42).toFixed(4)),
+        avgReturn: totalReward,
+        entropy: Number((0.52 - progress * 0.08).toFixed(4)),
+        klDivergence: Number((0.009 + seededUnit(seed ^ 0xacab) * 0.004).toFixed(4)),
+        explainedVariance: Number((0.66 + progress * 0.18).toFixed(4))
+    };
+    const core = {
+        featureCore,
+        behaviorCloning,
+        reinforcementLearning,
+        reward: { progress, survival, energyPenalty, proximityBonus, total: totalReward }
+    };
+    return {
+        source: "origin-master-ml-agent-adapted",
+        observation: {
+            featureSize: 27,
+            normalizedPosition,
+            normalizedVelocity,
+            targetDistance,
+            health,
+            energy,
+            nearbyEntitySlots,
+            featureHash: stableHash(JSON.stringify(featureCore))
+        },
+        behaviorCloning,
+        reinforcementLearning,
+        reward: core.reward,
+        productionReadiness: {
+            featureExtractionTelemetry: true,
+            behaviorCloningTelemetry: true,
+            ppoStatsTelemetry: true,
+            rewardBreakdownTelemetry: true
+        },
+        blockedClaims: [
+            "real neural-network training",
+            "ONNX runtime inference parity",
+            "Unity ML-Agents parity",
+            "Unreal Learning Agents parity",
+            "production reinforcement-learning deployment"
+        ],
+        claimBoundary: "This fixture ports old ML-agent concepts into deterministic feature-extraction, behavior-cloning, PPO-stat, and reward telemetry. It does not train neural networks, run ONNX inference, or claim Unity ML-Agents or Unreal Learning Agents parity.",
+        hash: stableHash(JSON.stringify(core))
+    };
+}
+function positive(value, name) {
+    if (!Number.isFinite(value) || value < 0)
+        throw new Error(`${name} must be a non-negative finite number.`);
+    return Number(value.toFixed(4));
+}
+function normalizeSeed(seed) {
+    if (!Number.isInteger(seed) || seed < 0)
+        throw new Error("seed must be a non-negative integer.");
+    return seed >>> 0;
+}
+function clamp01(value) {
+    return Math.max(0, Math.min(1, Number.isFinite(value) ? value : 0));
+}
+function seededUnit(seed) {
+    let value = seed >>> 0;
+    value ^= value << 13;
+    value ^= value >>> 17;
+    value ^= value << 5;
+    return (value >>> 0) / 0xffffffff;
+}
+function stableHash(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=LearningAgentFixtures.js.map

package/dist/LearningAgentFixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LearningAgentFixtures.js","sourceRoot":"","sources":["../../../../packages/scripting/src/LearningAgentFixtures.ts"],"names":[],"mappings":"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"}

package/dist/NetworkReplicationFixtures.d.ts

@@ -0,0 +1,82 @@
+export type NetworkReplicationMode = "all-clients" | "owner-only" | "all-except-owner" | "none";
+export interface NetworkReplicationFixtureOptions {
+    readonly seed?: number;
+    readonly tickRate?: number;
+    readonly latencyMs?: number;
+    readonly jitterMs?: number;
+    readonly interestRadius?: number;
+    readonly clientPosition?: readonly [number, number, number];
+}
+export interface NetworkInputFrame {
+    readonly sequence: number;
+    readonly timestampMs: number;
+    readonly forward: boolean;
+    readonly right: boolean;
+    readonly fire: boolean;
+}
+export interface NetworkEntityState {
+    readonly id: string;
+    readonly ownerId: string;
+    readonly replicationMode: NetworkReplicationMode;
+    readonly position: readonly [number, number, number];
+    readonly velocity: readonly [number, number, number];
+    readonly health: number;
+    readonly ammo: number;
+    readonly animation: string;
+    readonly timestampMs: number;
+    readonly lastProcessedInput: number;
+}
+export interface NetworkPredictionSummary {
+    readonly inputCount: number;
+    readonly predictedSequence: number;
+    readonly acknowledgedSequence: number;
+    readonly pendingInputs: number;
+    readonly predictionError: number;
+    readonly smoothCorrection: readonly [number, number, number];
+    readonly replayedPosition: readonly [number, number, number];
+    readonly reconciliationAccepted: boolean;
+}
+export interface NetworkDeltaSummary {
+    readonly changedFields: readonly string[];
+    readonly removedFields: readonly string[];
+    readonly fullSnapshotBytes: number;
+    readonly deltaBytes: number;
+    readonly compressionRatio: number;
+    readonly reconstructedMatches: boolean;
+    readonly bytesSaved: number;
+}
+export interface NetworkInterestSummary {
+    readonly playerId: string;
+    readonly radius: number;
+    readonly added: readonly string[];
+    readonly removed: readonly string[];
+    readonly unchanged: readonly string[];
+    readonly relevant: readonly string[];
+    readonly culled: readonly string[];
+    readonly gridCellCount: number;
+}
+export interface NetworkInterpolationSummary {
+    readonly sampleTimestampMs: number;
+    readonly beforeTimestampMs: number;
+    readonly afterTimestampMs: number;
+    readonly interpolatedPosition: readonly [number, number, number];
+    readonly extrapolatedPosition: readonly [number, number, number];
+}
+export interface NetworkReplicationFixture {
+    readonly source: "origin-master-net-prediction-replication-adapted";
+    readonly claimBoundary: string;
+    readonly blockedClaims: readonly string[];
+    readonly tickRate: number;
+    readonly latencyMs: number;
+    readonly jitterMs: number;
+    readonly inputFrames: readonly NetworkInputFrame[];
+    readonly clientPredicted: NetworkEntityState;
+    readonly serverAuthoritative: NetworkEntityState;
+    readonly prediction: NetworkPredictionSummary;
+    readonly delta: NetworkDeltaSummary;
+    readonly interest: NetworkInterestSummary;
+    readonly interpolation: NetworkInterpolationSummary;
+    readonly hash: string;
+}
+export declare function sampleNetworkReplicationFixture(options?: NetworkReplicationFixtureOptions): NetworkReplicationFixture;
+//# sourceMappingURL=NetworkReplicationFixtures.d.ts.map

package/dist/NetworkReplicationFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkReplicationFixtures.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/NetworkReplicationFixtures.ts"],"names":[],"mappings":"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"}