@higher.archi/boe 1.0.27 → 1.0.29

package/dist/engines/negotiation/compiler.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Negotiation Engine Compiler
+ *
+ * Validates negotiation rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileNegotiationRuleSet = compileNegotiationRuleSet;
+const errors_1 = require("../../core/errors");
+const types_1 = require("../utility/types");
+/**
+ * Compile and validate a negotiation ruleset.
+ */
+function compileNegotiationRuleSet(ruleSet) {
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Negotiation ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'negotiation') {
+        throw new errors_1.CompilationError(`Expected mode 'negotiation', got '${ruleSet.mode}'`);
+    }
+    // Validate dimensions
+    if (!ruleSet.dimensions || ruleSet.dimensions.length === 0) {
+        throw new errors_1.CompilationError('At least one dimension is required');
+    }
+    const dimensionIds = new Set();
+    for (const dim of ruleSet.dimensions) {
+        if (!dim.id) {
+            throw new errors_1.CompilationError('Each dimension requires an id');
+        }
+        if (dimensionIds.has(dim.id)) {
+            throw new errors_1.CompilationError(`Duplicate dimension id: '${dim.id}'`);
+        }
+        dimensionIds.add(dim.id);
+    }
+    // Validate exactly 2 parties
+    if (!ruleSet.parties || ruleSet.parties.length !== 2) {
+        throw new errors_1.CompilationError('Exactly 2 parties are required');
+    }
+    // Validate party positions reference existing dimensions and ordering
+    for (const party of ruleSet.parties) {
+        if (!party.id) {
+            throw new errors_1.CompilationError('Each party requires an id');
+        }
+        for (const pos of party.positions) {
+            if (!dimensionIds.has(pos.dimensionId)) {
+                throw new errors_1.CompilationError(`Party '${party.id}' references unknown dimension '${pos.dimensionId}'`);
+            }
+            // Validate acceptable is between ideal and walkaway
+            // Each party can have any direction preference -- the dimension direction
+            // represents party A's preference, party B naturally has the opposite.
+            const minVal = Math.min(pos.ideal, pos.walkaway);
+            const maxVal = Math.max(pos.ideal, pos.walkaway);
+            if (pos.acceptable < minVal || pos.acceptable > maxVal) {
+                throw new errors_1.CompilationError(`Party '${party.id}', dimension '${pos.dimensionId}': ` +
+                    `acceptable must be between ideal and walkaway`);
+            }
+            if (pos.ideal === pos.walkaway) {
+                throw new errors_1.CompilationError(`Party '${party.id}', dimension '${pos.dimensionId}': ` +
+                    `ideal and walkaway must differ`);
+            }
+        }
+    }
+    // Resolve and normalize value weights per party
+    const compiledWeights = {};
+    for (const partyId of Object.keys(ruleSet.valueWeights)) {
+        const weights = ruleSet.valueWeights[partyId];
+        const resolved = resolveWeights(weights, partyId);
+        compiledWeights[partyId] = resolved;
+    }
+    // Build compiled parties
+    const compiledParties = [
+        {
+            id: ruleSet.parties[0].id,
+            name: ruleSet.parties[0].name,
+            positions: ruleSet.parties[0].positions,
+            batna: ruleSet.parties[0].batna
+        },
+        {
+            id: ruleSet.parties[1].id,
+            name: ruleSet.parties[1].name,
+            positions: ruleSet.parties[1].positions,
+            batna: ruleSet.parties[1].batna
+        }
+    ];
+    switch (ruleSet.strategy) {
+        case 'zopa-analysis':
+            return compileZopaAnalysis(ruleSet, compiledParties, compiledWeights);
+        case 'concession-planning':
+            return compileConcessionPlanning(ruleSet, compiledParties, compiledWeights);
+        case 'package-optimization':
+            return compilePackageOptimization(ruleSet, compiledParties, compiledWeights);
+        default:
+            throw new errors_1.CompilationError(`Unknown negotiation strategy: '${ruleSet.strategy}'`);
+    }
+}
+// ========================================
+// Strategy-Specific Compilers
+// ========================================
+function compileZopaAnalysis(ruleSet, parties, valueWeights) {
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'negotiation',
+        strategy: 'zopa-analysis',
+        dimensions: ruleSet.dimensions,
+        parties,
+        valueWeights,
+        config: {
+            resolution: ruleSet.config?.resolution ?? 100
+        }
+    };
+}
+function compileConcessionPlanning(ruleSet, parties, valueWeights) {
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'negotiation',
+        strategy: 'concession-planning',
+        dimensions: ruleSet.dimensions,
+        parties,
+        valueWeights,
+        config: {
+            style: ruleSet.config?.style ?? 'moderate',
+            rounds: ruleSet.config?.rounds ?? 5,
+            startingPosition: ruleSet.config?.startingPosition ?? 'ideal'
+        }
+    };
+}
+function compilePackageOptimization(ruleSet, parties, valueWeights) {
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'negotiation',
+        strategy: 'package-optimization',
+        dimensions: ruleSet.dimensions,
+        parties,
+        valueWeights,
+        config: {
+            sampleSize: ruleSet.config?.sampleSize ?? 1000,
+            objectiveWeights: ruleSet.config?.objectiveWeights ?? {
+                closeProb: 0.6,
+                margin: 0.4
+            }
+        }
+    };
+}
+// ========================================
+// Weight Resolution
+// ========================================
+function resolveWeights(weights, partyId) {
+    const resolved = weights.map(w => {
+        let weight;
+        if ((0, types_1.isSemanticPriority)(w.weight)) {
+            weight = types_1.SEMANTIC_PRIORITY_VALUES[w.weight];
+        }
+        else if (typeof w.weight === 'number') {
+            weight = w.weight;
+        }
+        else {
+            throw new errors_1.CompilationError(`Invalid weight for party '${partyId}', dimension '${w.dimensionId}': '${w.weight}'`);
+        }
+        return {
+            dimensionId: w.dimensionId,
+            weight
+        };
+    });
+    // Normalize to sum to 1.0
+    const totalWeight = resolved.reduce((sum, w) => sum + w.weight, 0);
+    if (totalWeight === 0) {
+        throw new errors_1.CompilationError(`Value weights for party '${partyId}' must not all be zero`);
+    }
+    for (const w of resolved) {
+        w.weight = w.weight / totalWeight;
+    }
+    return resolved;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engines/negotiation/compiler.js.map

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

package/dist/engines/negotiation/engine.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Negotiation Engine
+ *
+ * Two-party negotiation engine that analyzes zones of possible agreement,
+ * plans concession strategies, and optimizes deal packages across
+ * multiple dimensions.
+ *
+ * @example
+ * ```typescript
+ * const engine = new NegotiationEngine();
+ *
+ * const result = engine.execute(compiledNegotiation);
+ * console.log(result.outcome); // 'agreed' | 'no-zopa' | 'batna-preferred'
+ * ```
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { CompiledNegotiationRuleSet, NegotiationOptions, NegotiationResult } from './types';
+export declare class NegotiationEngine {
+    private wm;
+    private strategy;
+    constructor(workingMemory?: WorkingMemory);
+    add<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    remove(factId: string): Fact | undefined;
+    update<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    get(factId: string): Fact | undefined;
+    getByType(type: string): Fact[];
+    getAll(): Fact[];
+    has(factId: string): boolean;
+    size(): number;
+    clear(): void;
+    getChanges(): FactChange[];
+    clearChanges(): void;
+    /**
+     * Execute a negotiation ruleset.
+     *
+     * Analyzes party positions across all dimensions and produces
+     * a negotiation result with ZOPA, concession plans, or optimized packages.
+     *
+     * @param ruleSet - Compiled negotiation ruleset
+     * @param options - Runtime options (onStep callback, onPackage callback)
+     * @returns Negotiation result with outcome and analysis
+     */
+    execute(ruleSet: CompiledNegotiationRuleSet, options?: NegotiationOptions): NegotiationResult;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engines/negotiation/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/negotiation/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAIjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,aAAa,CAAC,EAAE,aAAa;IASzC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE;IAI/B,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,UAAU,EAAE;IAI1B,YAAY,IAAI,IAAI;IAQpB;;;;;;;;;OASG;IACH,OAAO,CACL,OAAO,EAAE,0BAA0B,EACnC,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB;IAQpB,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/negotiation/engine.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Negotiation Engine
+ *
+ * Two-party negotiation engine that analyzes zones of possible agreement,
+ * plans concession strategies, and optimizes deal packages across
+ * multiple dimensions.
+ *
+ * @example
+ * ```typescript
+ * const engine = new NegotiationEngine();
+ *
+ * const result = engine.execute(compiledNegotiation);
+ * console.log(result.outcome); // 'agreed' | 'no-zopa' | 'batna-preferred'
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NegotiationEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+class NegotiationEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.NegotiationExecutor();
+    }
+    // ========================================
+    // IWorkingMemory Implementation
+    // ========================================
+    add(input) {
+        return this.wm.add(input);
+    }
+    remove(factId) {
+        return this.wm.remove(factId);
+    }
+    update(input) {
+        return this.wm.update(input);
+    }
+    get(factId) {
+        return this.wm.get(factId);
+    }
+    getByType(type) {
+        return this.wm.getByType(type);
+    }
+    getAll() {
+        return this.wm.getAll();
+    }
+    has(factId) {
+        return this.wm.has(factId);
+    }
+    size() {
+        return this.wm.size();
+    }
+    clear() {
+        this.wm.clear();
+    }
+    getChanges() {
+        return this.wm.getChanges();
+    }
+    clearChanges() {
+        this.wm.clearChanges();
+    }
+    // ========================================
+    // Engine Execution
+    // ========================================
+    /**
+     * Execute a negotiation ruleset.
+     *
+     * Analyzes party positions across all dimensions and produces
+     * a negotiation result with ZOPA, concession plans, or optimized packages.
+     *
+     * @param ruleSet - Compiled negotiation ruleset
+     * @param options - Runtime options (onStep callback, onPackage callback)
+     * @returns Negotiation result with outcome and analysis
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.NegotiationEngine = NegotiationEngine;
+//# sourceMappingURL=engine.js.map

package/dist/engines/negotiation/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/negotiation/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,qCAKoB;AAQpB,yCAAiD;AAEjD,MAAa,iBAAiB;IACpB,EAAE,CAAgB;IAClB,QAAQ,CAAsB;IAEtC,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,8BAAmB,EAAE,CAAC;IAC5C,CAAC;IAED,2CAA2C;IAC3C,gCAAgC;IAChC,2CAA2C;IAE3C,GAAG,CAA0B,KAAmB;QAC9C,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAA0B,KAAmB;QACjD,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC;IAED,2CAA2C;IAC3C,mBAAmB;IACnB,2CAA2C;IAE3C;;;;;;;;;OASG;IACH,OAAO,CACL,OAAmC,EACnC,UAA8B,EAAE;QAEhC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,2CAA2C;IAC3C,kBAAkB;IAClB,2CAA2C;IAE3C,gBAAgB;QACd,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AArFD,8CAqFC"}

package/dist/engines/negotiation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Negotiation Engine -- Two-Party Deal Analysis
+ */
+export type { NegotiationStrategy, ConcessionStyle, DealOutcome, DimensionDirection, NegotiationDimension, PartyPosition, PartyProfile, ValueFunction, CompiledValueFunction, CompiledPartyProfile, ZopaAnalysisConfig, ConcessionPlanningConfig, PackageOptimizationConfig, ZopaAnalysisRuleSet, ConcessionPlanningRuleSet, PackageOptimizationRuleSet, NegotiationRuleSet, CompiledZopaAnalysisRuleSet, CompiledConcessionPlanningRuleSet, CompiledPackageOptimizationRuleSet, CompiledNegotiationRuleSet, ZopaRange, ConcessionStep, PackageCandidate, NegotiationResult, NegotiationOptions } from './types';
+export { compileNegotiationRuleSet } from './compiler';
+export { NegotiationExecutor, negotiationStrategy } from './strategy';
+export { NegotiationEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/negotiation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/negotiation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,iCAAiC,EACjC,kCAAkC,EAClC,0BAA0B,EAC1B,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/negotiation/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Negotiation Engine -- Two-Party Deal Analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NegotiationEngine = exports.negotiationStrategy = exports.NegotiationExecutor = exports.compileNegotiationRuleSet = void 0;
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileNegotiationRuleSet", { enumerable: true, get: function () { return compiler_1.compileNegotiationRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "NegotiationExecutor", { enumerable: true, get: function () { return strategy_1.NegotiationExecutor; } });
+Object.defineProperty(exports, "negotiationStrategy", { enumerable: true, get: function () { return strategy_1.negotiationStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "NegotiationEngine", { enumerable: true, get: function () { return engine_1.NegotiationEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/engines/negotiation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/negotiation/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgCH,WAAW;AACX,uCAAuD;AAA9C,qHAAA,yBAAyB,OAAA;AAElC,WAAW;AACX,uCAAsE;AAA7D,+GAAA,mBAAmB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAEjD,SAAS;AACT,mCAA6C;AAApC,2GAAA,iBAAiB,OAAA"}

package/dist/engines/negotiation/strategy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Negotiation Engine Strategy
+ *
+ * Core execution logic for all negotiation strategies:
+ * - zopa-analysis: Compute zones of possible agreement per dimension
+ * - concession-planning: Simulate round-by-round concession trajectories
+ * - package-optimization: Find optimal deal packages within the ZOPA
+ */
+import type { CompiledNegotiationRuleSet, NegotiationOptions, NegotiationResult } from './types';
+export declare class NegotiationExecutor {
+    run(ruleSet: CompiledNegotiationRuleSet, options?: NegotiationOptions): NegotiationResult;
+    private runZopaAnalysis;
+    private runConcessionPlanning;
+    private runPackageOptimization;
+}
+/** Singleton instance */
+export declare const negotiationStrategy: NegotiationExecutor;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/engines/negotiation/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/negotiation/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAO1B,kBAAkB,EAClB,iBAAiB,EAMlB,MAAM,SAAS,CAAC;AAMjB,qBAAa,mBAAmB;IAC9B,GAAG,CACD,OAAO,EAAE,0BAA0B,EACnC,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB;IAiBpB,OAAO,CAAC,eAAe;IA0EvB,OAAO,CAAC,qBAAqB;IA+J7B,OAAO,CAAC,sBAAsB;CA0J/B;AAmJD,yBAAyB;AACzB,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}