@defai.digital/discussion-domain 13.0.3 → 13.1.1

package/dist/consensus/voting.js

@@ -3,8 +3,15 @@
  *
  * Tallies votes from all providers and determines winner based on
  * raw counts or confidence-weighted scores.
+ *
+ * Invariants:
+ * - INV-DISC-642: Agent responses weighted by agentWeightMultiplier (default 1.5x)
  */
 import { VOTING_TALLY, interpolate, formatVotes, getProviderSystemPrompt, } from '../prompts/templates.js';
+/**
+ * Default agent weight multiplier (INV-DISC-642)
+ */
+const DEFAULT_AGENT_WEIGHT = 1.5;
 export class VotingConsensus {
     method = 'voting';
     async execute(context) {
@@ -23,8 +30,8 @@ export class VotingConsensus {
                 error: 'No valid votes found in discussion rounds',
             };
         }
-        // Tally votes
-        const votingResults = this.tallyVotes(votes, config.threshold);
+        // Tally votes with agent weight multiplier (INV-DISC-642)
+        const votingResults = this.tallyVotes(votes, context.agentWeightMultiplier);
         // Generate synthesis summary
         const synthesizerId = config.synthesizer ||
             (participatingProviders.includes('claude') ? 'claude' : participatingProviders[0]) ||
@@ -58,6 +65,7 @@ export class VotingConsensus {
                         choice: response.vote,
                         confidence: response.confidence,
                         reasoning: this.extractReasoning(response.content),
+                        isAgent: response.isAgent ?? false,
                     });
                 }
             }
@@ -68,13 +76,16 @@ export class VotingConsensus {
         const reasoningMatch = /reasoning:\s*(.+?)(?=\n\n|$)/is.exec(content);
         return reasoningMatch?.[1] ? reasoningMatch[1].trim() : '';
     }
-    tallyVotes(votes, _threshold) {
+    tallyVotes(votes, agentWeightMultiplier = DEFAULT_AGENT_WEIGHT) {
         // Count raw votes
         const rawVotes = {};
         const weightedVotes = {};
         for (const vote of votes) {
+            // Apply agent weight multiplier (INV-DISC-642)
+            const weight = vote.isAgent ? agentWeightMultiplier : 1.0;
+            const weightedConfidence = vote.confidence * weight;
             rawVotes[vote.choice] = (rawVotes[vote.choice] || 0) + 1;
-            weightedVotes[vote.choice] = (weightedVotes[vote.choice] || 0) + vote.confidence;
+            weightedVotes[vote.choice] = (weightedVotes[vote.choice] || 0) + weightedConfidence;
         }
         // Determine winner (by weighted votes)
         let winner = '';

package/dist/consensus/voting.js.map

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

package/dist/context-tracker.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Discussion Context Tracker
+ *
+ * Tracks recursive discussion state including depth, budget, and call counts.
+ * Prevents infinite recursion and enforces resource limits.
+ *
+ * Invariants:
+ * - INV-DISC-600: Depth never exceeds maxDepth
+ * - INV-DISC-601: No circular discussions
+ * - INV-DISC-610: Child timeout ≤ parent remaining budget
+ * - INV-DISC-620: Total calls ≤ maxTotalCalls
+ */
+import { type DiscussionContext, type TimeoutConfig, type RecursiveConfig, type CostControlConfig } from '@defai.digital/contracts';
+/**
+ * Result of checking if sub-discussion can be spawned
+ */
+export interface SubDiscussionCheck {
+    allowed: boolean;
+    reason?: string;
+    errorCode?: string;
+    availableBudgetMs?: number;
+    remainingCalls?: number;
+}
+/**
+ * Configuration for the context tracker
+ */
+export interface ContextTrackerConfig {
+    recursive: RecursiveConfig;
+    timeout: TimeoutConfig;
+    cost: CostControlConfig;
+}
+/**
+ * Discussion context tracker for managing recursive discussion state
+ */
+export interface DiscussionContextTracker {
+    /** Get current context */
+    getContext(): DiscussionContext;
+    /** Check if sub-discussion can be spawned */
+    canSpawnSubDiscussion(estimatedDurationMs?: number): SubDiscussionCheck;
+    /** Create child context for sub-discussion */
+    createChildContext(childDiscussionId: string): DiscussionContext;
+    /** Record provider calls made */
+    recordCalls(count: number): void;
+    /** Record time elapsed */
+    recordElapsed(elapsedMs: number): void;
+    /** Get timeout for current depth level */
+    getTimeoutForCurrentLevel(): number;
+    /** Get timeout for a specific depth level */
+    getTimeoutForLevel(depth: number): number;
+    /** Check if at root level */
+    isRoot(): boolean;
+    /** Get remaining depth capacity */
+    getRemainingDepth(): number;
+    /** Get remaining call capacity */
+    getRemainingCalls(): number;
+    /** Get remaining budget in milliseconds */
+    getRemainingBudgetMs(): number;
+    /** Get elapsed time since start */
+    getElapsedMs(): number;
+}
+/**
+ * Creates a discussion context tracker
+ */
+export declare function createContextTracker(discussionId: string, config?: Partial<ContextTrackerConfig>, parentContext?: DiscussionContext): DiscussionContextTracker;
+/**
+ * Discussion context error
+ */
+export declare class DiscussionContextError extends Error {
+    readonly code: string;
+    readonly context?: DiscussionContext | undefined;
+    constructor(code: string, message: string, context?: DiscussionContext | undefined);
+    static maxDepthExceeded(context: DiscussionContext): DiscussionContextError;
+    static circularDiscussion(discussionId: string, context: DiscussionContext): DiscussionContextError;
+    static budgetExhausted(context: DiscussionContext): DiscussionContextError;
+    static maxCallsExceeded(context: DiscussionContext): DiscussionContextError;
+}
+//# sourceMappingURL=context-tracker.d.ts.map

package/dist/context-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tracker.d.ts","sourceRoot":"","sources":["../src/context-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAUvB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,UAAU,IAAI,iBAAiB,CAAC;IAEhC,6CAA6C;IAC7C,qBAAqB,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAExE,8CAA8C;IAC9C,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAEjE,iCAAiC;IACjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,0BAA0B;IAC1B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,0CAA0C;IAC1C,yBAAyB,IAAI,MAAM,CAAC;IAEpC,6CAA6C;IAC7C,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,6BAA6B;IAC7B,MAAM,IAAI,OAAO,CAAC;IAElB,mCAAmC;IACnC,iBAAiB,IAAI,MAAM,CAAC;IAE5B,kCAAkC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAE5B,2CAA2C;IAC3C,oBAAoB,IAAI,MAAM,CAAC;IAE/B,mCAAmC;IACnC,YAAY,IAAI,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM,EAC1C,aAAa,CAAC,EAAE,iBAAiB,GAChC,wBAAwB,CAgK1B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,iBAAiB;gBAF3B,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,iBAAiB,YAAA;IAM7C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB;IAQ3E,MAAM,CAAC,kBAAkB,CACvB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,sBAAsB;IAQzB,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB;IAQ1E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB;CAO5E"}

package/dist/context-tracker.js

@@ -0,0 +1,177 @@
+/**
+ * Discussion Context Tracker
+ *
+ * Tracks recursive discussion state including depth, budget, and call counts.
+ * Prevents infinite recursion and enforces resource limits.
+ *
+ * Invariants:
+ * - INV-DISC-600: Depth never exceeds maxDepth
+ * - INV-DISC-601: No circular discussions
+ * - INV-DISC-610: Child timeout ≤ parent remaining budget
+ * - INV-DISC-620: Total calls ≤ maxTotalCalls
+ */
+import { DiscussionErrorCodes, createRootDiscussionContext, createChildDiscussionContext, canSpawnSubDiscussion, getTimeoutForLevel, DEFAULT_DISCUSSION_DEPTH, DEFAULT_TOTAL_BUDGET_MS, DEFAULT_MAX_TOTAL_CALLS, MIN_SYNTHESIS_TIME_MS, } from '@defai.digital/contracts';
+/**
+ * Creates a discussion context tracker
+ */
+export function createContextTracker(discussionId, config = {}, parentContext) {
+    // Merge config with defaults
+    const recursiveConfig = {
+        enabled: config.recursive?.enabled ?? false,
+        maxDepth: config.recursive?.maxDepth ?? DEFAULT_DISCUSSION_DEPTH,
+        allowedProviders: config.recursive?.allowedProviders,
+        allowSubDiscussions: config.recursive?.allowSubDiscussions ?? true,
+    };
+    const timeoutConfig = {
+        strategy: config.timeout?.strategy ?? 'cascade',
+        totalBudgetMs: config.timeout?.totalBudgetMs ?? DEFAULT_TOTAL_BUDGET_MS,
+        minSynthesisMs: config.timeout?.minSynthesisMs ?? MIN_SYNTHESIS_TIME_MS,
+        levelTimeouts: config.timeout?.levelTimeouts,
+    };
+    const costConfig = {
+        maxTotalCalls: config.cost?.maxTotalCalls ?? DEFAULT_MAX_TOTAL_CALLS,
+        budgetUsd: config.cost?.budgetUsd,
+        cascadingConfidence: {
+            enabled: config.cost?.cascadingConfidence?.enabled ?? true,
+            threshold: config.cost?.cascadingConfidence?.threshold ?? 0.9,
+            minProviders: config.cost?.cascadingConfidence?.minProviders ?? 2,
+        },
+    };
+    // Initialize context
+    let context;
+    if (parentContext) {
+        // Create child context
+        const elapsed = Date.now() - new Date(parentContext.startedAt).getTime();
+        context = createChildDiscussionContext(parentContext, discussionId, elapsed, 0);
+    }
+    else {
+        // Create root context
+        context = createRootDiscussionContext(discussionId, {
+            maxDepth: recursiveConfig.maxDepth,
+            totalBudgetMs: timeoutConfig.totalBudgetMs,
+            maxTotalCalls: costConfig.maxTotalCalls,
+        });
+    }
+    // Track mutable state
+    let totalCalls = context.totalCalls;
+    let elapsedSinceContextCreation = 0;
+    return {
+        getContext() {
+            return {
+                ...context,
+                totalCalls,
+                remainingBudgetMs: Math.max(0, context.remainingBudgetMs - elapsedSinceContextCreation),
+            };
+        },
+        canSpawnSubDiscussion(estimatedDurationMs) {
+            // Check if recursion is enabled
+            if (!recursiveConfig.enabled) {
+                return {
+                    allowed: false,
+                    reason: 'Recursive discussions not enabled',
+                    errorCode: DiscussionErrorCodes.INVALID_CONFIG,
+                };
+            }
+            // Check if sub-discussions allowed
+            if (!recursiveConfig.allowSubDiscussions) {
+                return {
+                    allowed: false,
+                    reason: 'Sub-discussions not allowed in configuration',
+                    errorCode: DiscussionErrorCodes.INVALID_CONFIG,
+                };
+            }
+            // Use contract function for basic checks
+            const remainingBudget = context.remainingBudgetMs - elapsedSinceContextCreation;
+            const minBudget = estimatedDurationMs ?? timeoutConfig.minSynthesisMs * 2;
+            const checkContext = {
+                ...context,
+                totalCalls,
+                remainingBudgetMs: remainingBudget,
+            };
+            const check = canSpawnSubDiscussion(checkContext, minBudget);
+            if (!check.allowed) {
+                // Determine error code based on reason
+                const reason = check.reason ?? 'Sub-discussion not allowed';
+                let errorCode = DiscussionErrorCodes.INVALID_CONFIG;
+                if (reason.includes('depth')) {
+                    errorCode = DiscussionErrorCodes.MAX_DEPTH_EXCEEDED;
+                }
+                else if (reason.includes('budget')) {
+                    errorCode = DiscussionErrorCodes.BUDGET_EXHAUSTED;
+                }
+                else if (reason.includes('calls')) {
+                    errorCode = DiscussionErrorCodes.MAX_CALLS_EXCEEDED;
+                }
+                return {
+                    allowed: false,
+                    reason,
+                    errorCode,
+                    availableBudgetMs: remainingBudget,
+                    remainingCalls: context.maxTotalCalls - totalCalls,
+                };
+            }
+            return {
+                allowed: true,
+                availableBudgetMs: remainingBudget,
+                remainingCalls: context.maxTotalCalls - totalCalls,
+            };
+        },
+        createChildContext(childDiscussionId) {
+            const elapsed = Date.now() - new Date(context.startedAt).getTime();
+            return createChildDiscussionContext({ ...context, totalCalls }, childDiscussionId, elapsed, 0);
+        },
+        recordCalls(count) {
+            totalCalls += count;
+        },
+        recordElapsed(elapsedMs) {
+            elapsedSinceContextCreation += elapsedMs;
+        },
+        getTimeoutForCurrentLevel() {
+            return getTimeoutForLevel(timeoutConfig, context.depth, context.maxDepth);
+        },
+        getTimeoutForLevel(depth) {
+            return getTimeoutForLevel(timeoutConfig, depth, context.maxDepth);
+        },
+        isRoot() {
+            return context.depth === 0;
+        },
+        getRemainingDepth() {
+            return context.maxDepth - context.depth;
+        },
+        getRemainingCalls() {
+            return Math.max(0, context.maxTotalCalls - totalCalls);
+        },
+        getRemainingBudgetMs() {
+            return Math.max(0, context.remainingBudgetMs - elapsedSinceContextCreation);
+        },
+        getElapsedMs() {
+            return Date.now() - new Date(context.startedAt).getTime();
+        },
+    };
+}
+/**
+ * Discussion context error
+ */
+export class DiscussionContextError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'DiscussionContextError';
+    }
+    static maxDepthExceeded(context) {
+        return new DiscussionContextError(DiscussionErrorCodes.MAX_DEPTH_EXCEEDED, `Maximum discussion depth ${context.maxDepth} exceeded at depth ${context.depth}`, context);
+    }
+    static circularDiscussion(discussionId, context) {
+        return new DiscussionContextError(DiscussionErrorCodes.CIRCULAR_DISCUSSION, `Circular discussion detected: ${discussionId} already in chain`, context);
+    }
+    static budgetExhausted(context) {
+        return new DiscussionContextError(DiscussionErrorCodes.BUDGET_EXHAUSTED, `Timeout budget exhausted: ${context.remainingBudgetMs}ms remaining`, context);
+    }
+    static maxCallsExceeded(context) {
+        return new DiscussionContextError(DiscussionErrorCodes.MAX_CALLS_EXCEEDED, `Maximum calls ${context.maxTotalCalls} exceeded`, context);
+    }
+}
+//# sourceMappingURL=context-tracker.js.map

package/dist/context-tracker.js.map

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

package/dist/cost-tracker.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Discussion Cost Tracker
+ *
+ * Tracks costs and resource usage across discussion execution.
+ * Enforces budget limits and provides visibility into spending.
+ *
+ * Invariants:
+ * - INV-DISC-620: Total calls ≤ maxTotalCalls
+ * - INV-DISC-621: Abort if cost budget exceeded
+ */
+import type { CostControlConfig } from '@defai.digital/contracts';
+/**
+ * Cost per provider (approximate, in USD per 1K tokens)
+ * These are rough estimates for planning purposes
+ */
+export declare const PROVIDER_COSTS: Record<string, {
+    input: number;
+    output: number;
+}>;
+/**
+ * Provider call record
+ */
+export interface ProviderCallRecord {
+    /** Provider ID */
+    providerId: string;
+    /** Input tokens */
+    inputTokens: number;
+    /** Output tokens */
+    outputTokens: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Estimated cost in USD */
+    estimatedCostUsd: number;
+    /** Discussion depth where call occurred */
+    depth: number;
+    /** Timestamp */
+    timestamp: string;
+    /** Whether call succeeded */
+    success: boolean;
+}
+/**
+ * Cost tracking summary
+ */
+export interface CostSummary {
+    /** Total provider calls made */
+    totalCalls: number;
+    /** Total input tokens */
+    totalInputTokens: number;
+    /** Total output tokens */
+    totalOutputTokens: number;
+    /** Total estimated cost in USD */
+    totalCostUsd: number;
+    /** Cost breakdown by provider */
+    byProvider: Record<string, {
+        calls: number;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+    }>;
+    /** Cost breakdown by depth level */
+    byDepth: Record<number, {
+        calls: number;
+        costUsd: number;
+    }>;
+    /** Whether budget limit was exceeded */
+    budgetExceeded: boolean;
+    /** Whether call limit was exceeded */
+    callLimitExceeded: boolean;
+    /** Remaining budget (if configured) */
+    remainingBudgetUsd: number | undefined;
+    /** Remaining calls */
+    remainingCalls: number;
+}
+/**
+ * Budget check result
+ */
+export interface BudgetCheckResult {
+    /** Whether operation is allowed */
+    allowed: boolean;
+    /** Reason if not allowed */
+    reason?: string;
+    /** Current usage metrics */
+    currentCalls: number;
+    currentCostUsd: number;
+    /** Estimated cost of proposed operation */
+    estimatedCostUsd?: number;
+}
+/**
+ * Discussion cost tracker interface
+ */
+export interface DiscussionCostTracker {
+    /** Record a provider call */
+    recordCall(record: Omit<ProviderCallRecord, 'estimatedCostUsd' | 'timestamp'>): void;
+    /** Check if a call is within budget */
+    checkBudget(providerId: string, estimatedTokens?: number): BudgetCheckResult;
+    /** Get current cost summary */
+    getSummary(): CostSummary;
+    /** Get total calls made */
+    getTotalCalls(): number;
+    /** Get remaining calls */
+    getRemainingCalls(): number;
+    /** Check if budget exceeded */
+    isBudgetExceeded(): boolean;
+    /** Check if call limit exceeded */
+    isCallLimitExceeded(): boolean;
+    /** Estimate cost for a provider call */
+    estimateCost(providerId: string, inputTokens: number, outputTokens: number): number;
+    /** Create child tracker for sub-discussion */
+    createChildTracker(depth: number): DiscussionCostTracker;
+}
+/**
+ * Create a cost tracker for a discussion
+ */
+export declare function createCostTracker(config: CostControlConfig, parentTracker?: DiscussionCostTracker): DiscussionCostTracker;
+/**
+ * Format cost for display
+ */
+export declare function formatCost(costUsd: number): string;
+/**
+ * Format cost summary for CLI/logs
+ */
+export declare function formatCostSummary(summary: CostSummary): string;
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/cost-tracker.d.ts.map

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