@lov3kaizen/agentsea-crews 1.0.1 → 1.1.0

package/dist/nestjs/index.js

@@ -1513,7 +1513,80 @@ var AgentCapabilities = class {
   }
 };
 
+// src/agents/CoreExecutor.ts
+async function loadProvider(providerName) {
+  const ctorName = resolveProviderCtorName(providerName);
+  let core;
+  try {
+    core = await import("@lov3kaizen/agentsea-core");
+  } catch {
+    throw new Error(
+      'CrewAgent requires "@lov3kaizen/agentsea-core" to execute against a real LLM. Install it, or pass a custom `execute` function (or `mock: true`) to createCrewAgent / createCrew.'
+    );
+  }
+  const Ctor = core[ctorName];
+  return new Ctor();
+}
+function resolveProviderCtorName(providerName) {
+  switch ((providerName ?? "").toLowerCase()) {
+    case "anthropic":
+    case "claude":
+      return "AnthropicProvider";
+    case "openai":
+    case "gpt":
+      return "OpenAIProvider";
+    case "gemini":
+    case "google":
+      return "GeminiProvider";
+    case "ollama":
+      return "OllamaProvider";
+    default:
+      throw new Error(
+        `CrewAgent: unsupported provider "${providerName}". Supported providers are: anthropic, openai, gemini, ollama. Pass a custom \`execute\` function to createCrewAgent for any other provider.`
+      );
+  }
+}
+function createCoreExecutor(config, options = {}) {
+  let providerPromise;
+  const getProvider = () => {
+    if (!providerPromise) {
+      providerPromise = options.provider ? Promise.resolve(options.provider) : loadProvider(config.provider);
+    }
+    return providerPromise;
+  };
+  return async (input, systemPrompt) => {
+    const provider = await getProvider();
+    const start = Date.now();
+    const response = await provider.generateResponse(
+      [{ role: "user", content: input }],
+      {
+        model: config.model,
+        systemPrompt,
+        temperature: config.temperature,
+        maxTokens: config.maxTokens
+      }
+    );
+    return {
+      output: response.content,
+      tokensUsed: response.usage.inputTokens + response.usage.outputTokens,
+      latencyMs: Date.now() - start,
+      iterations: 1
+    };
+  };
+}
+
 // src/agents/CrewAgent.ts
+function modelCostWeight(model) {
+  const m = (model ?? "").toLowerCase();
+  if (m.includes("opus") || m.includes("gpt-5") || m.includes("o3")) return 5;
+  if (m.includes("sonnet") || m.includes("gpt-4.1") || m.includes("gpt-4") && !m.includes("mini") || m.includes("gemini-1.5-pro") || m.includes("gemini-2.5-pro")) {
+    return 3;
+  }
+  if (m.includes("haiku") || m.includes("mini") || m.includes("flash") || m.includes("llama") || m.includes("mistral")) {
+    return 1;
+  }
+  return 3;
+}
 var CrewAgent = class _CrewAgent {
   id;
   name;
@@ -1552,10 +1625,11 @@ var CrewAgent = class _CrewAgent {
    */
   async execute(input) {
     if (!this.executeFunc) {
+      const tokensUsed = 100 + Math.min(input.length, 400);
       const mockResult = {
         output: `[Mock response from ${this.name}]: ${input.slice(0, 100)}...`,
-        tokensUsed: Math.floor(Math.random() * 500) + 100,
-        latencyMs: Math.floor(Math.random() * 2e3) + 500,
+        tokensUsed,
+        latencyMs: 0,
         iterations: 1
       };
       this.totalTokensUsed += mockResult.tokensUsed;
@@ -1658,16 +1732,27 @@ ${JSON.stringify(task.context, null, 2)}`);
       ) ?? true
     ).map((c) => c.name);
     const estimatedTime = this.estimateTaskTime(task);
+    const estimatedCost = this.estimateTaskCost(estimatedTime);
     const reasoning = this.generateBidReasoning(task, confidence, matchedCaps);
     return Promise.resolve({
       agentName: this.name,
       taskId: task.id ?? "unknown",
       confidence,
       estimatedTime,
+      estimatedCost,
       reasoning,
       capabilities: matchedCaps
     });
   }
+  /**
+   * Estimate a relative cost for handling a task. Combines the agent's model
+   * price tier with the estimated effort so the auction `cheapest` criterion
+   * can distinguish a cheap-but-slower model from an expensive-but-faster one.
+   * The unit is arbitrary and only meaningful relative to other bids.
+   */
+  estimateTaskCost(estimatedTime) {
+    return modelCostWeight(this.model) * Math.max(estimatedTime, 1);
+  }
   /**
    * Check if agent has all required capabilities
    */
@@ -1853,7 +1938,13 @@ Please provide helpful guidance based on your expertise.
   }
 };
 function createCrewAgent(options) {
-  return new CrewAgent(options);
+  if (options.execute || options.mock) {
+    return new CrewAgent(options);
+  }
+  return new CrewAgent({
+    ...options,
+    execute: createCoreExecutor(options.config, { provider: options.provider })
+  });
 }
 
 // src/agents/AgentRegistry.ts
@@ -2553,9 +2644,9 @@ var AuctionStrategy = class extends BaseDelegationStrategy {
         }, bids[0]);
       case "cheapest":
         return bids.reduce((best, bid) => {
-          const bestTime = best.estimatedTime ?? Infinity;
-          const bidTime = bid.estimatedTime ?? Infinity;
-          return bidTime < bestTime ? bid : best;
+          const bestCost = best.estimatedCost ?? best.estimatedTime ?? Infinity;
+          const bidCost = bid.estimatedCost ?? bid.estimatedTime ?? Infinity;
+          return bidCost < bestCost ? bid : best;
         }, bids[0]);
       case "confidence":
       default:
@@ -3038,9 +3129,8 @@ var ConsensusStrategy = class extends BaseDelegationStrategy {
    */
   async collectVotes(task, voters, candidates) {
     const votes = [];
-    const candidateNames = candidates.map((c) => c.name);
     for (const voter of voters) {
-      const vote = await this.getVote(voter, task, candidateNames);
+      const vote = await this.getVote(voter, task, candidates);
       if (vote) {
         votes.push(vote);
       }
@@ -3048,33 +3138,35 @@ var ConsensusStrategy = class extends BaseDelegationStrategy {
     return votes;
   }
   /**
-   * Get a vote from an agent
+   * Get a vote from an agent.
+   *
+   * Each voter ranks the candidates by how well their capabilities fit the
+   * task (the same `calculateTaskScore` signal the BestMatch/Auction strategies
+   * use), plus a small self-preference bias so an agent leans toward itself when
+   * candidates are otherwise comparable. This is fully deterministic — given the
+   * same agents and task it always produces the same votes — and explainable,
+   * which is what consensus needs. (A future enhancement could replace this with
+   * an actual LLM deliberation per voter; the tally/agreement logic is unchanged.)
    */
   getVote(voter, task, candidates) {
-    const scores = [];
-    for (const candidateName of candidates) {
-      if (candidateName === voter.name) {
-        scores.push({ name: candidateName, score: 0.7 });
-      } else {
-        const randomFactor = 0.8 + Math.random() * 0.4;
-        scores.push({
-          name: candidateName,
-          score: Math.random() * randomFactor
-        });
+    if (candidates.length === 0) return Promise.resolve(null);
+    const SELF_PREFERENCE_BONUS = 0.15;
+    const scores = candidates.map((candidate) => {
+      let score = candidate.calculateTaskScore(task);
+      if (candidate.name === voter.name) {
+        score += SELF_PREFERENCE_BONUS;
       }
-    }
-    scores.sort((a, b) => b.score - a.score);
+      return { name: candidate.name, score };
+    });
+    scores.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
     const selected = scores[0];
     if (!selected) return Promise.resolve(null);
-    let weight = 1;
-    if (this.weightedVoting) {
-      weight = voter.calculateTaskScore(task) || 0.5;
-    }
+    const weight = this.weightedVoting ? voter.calculateTaskScore(task) || 0.5 : 1;
     return Promise.resolve({
       voter: voter.name,
       candidate: selected.name,
       weight,
-      reasoning: `Selected based on perceived suitability (score: ${selected.score.toFixed(2)})`
+      reasoning: `Ranked "${selected.name}" highest by capability fit for the task (score: ${selected.score.toFixed(2)})`
     });
   }
   /**
@@ -3938,13 +4030,24 @@ var ConflictResolver = class {
       resolved: /* @__PURE__ */ new Date()
     };
   }
+  /**
+   * Normalize response content for equality comparison: trim, collapse runs of
+   * whitespace, and lowercase. This groups textually-equivalent answers (ignoring
+   * incidental formatting) over their FULL content rather than a fragile first-N
+   * characters prefix. Note: this is exact-match-after-normalization, not semantic
+   * similarity — agents that express the same idea with different wording will not
+   * group. Semantic grouping would require embeddings (future enhancement).
+   */
+  normalizeContent(content) {
+    return content.trim().replace(/\s+/g, " ").toLowerCase();
+  }
   /**
    * Resolve by voting
    */
   resolveByVoting(conflict, _context) {
     const votes = /* @__PURE__ */ new Map();
     for (const response of conflict.responses) {
-      const key = response.content.substring(0, 100);
+      const key = this.normalizeContent(response.content);
       const current = votes.get(key) ?? 0;
       votes.set(key, current + response.confidence);
     }
@@ -3957,7 +4060,7 @@ var ConflictResolver = class {
       }
     }
     const winner = conflict.responses.find(
-      (r) => r.content.substring(0, 100) === winningKey
+      (r) => this.normalizeContent(r.content) === winningKey
     );
     return Promise.resolve({
       conflictId: conflict.id,
@@ -3973,7 +4076,31 @@ var ConflictResolver = class {
    * Resolve by authority
    */
   resolveByAuthority(conflict, _context) {
-    return Promise.resolve(this.resolveByConfidence(conflict));
+    const ranked = conflict.responses.map((r) => ({
+      response: r,
+      authority: typeof r.metadata?.authority === "number" ? r.metadata.authority : void 0
+    })).filter(
+      (x) => x.authority !== void 0
+    );
+    if (ranked.length === 0) {
+      return Promise.resolve({
+        ...this.resolveByConfidence(conflict),
+        strategy: "authority",
+        explanation: "No authority metadata provided; fell back to highest confidence"
+      });
+    }
+    const winnerEntry = ranked.reduce(
+      (best, cur) => cur.authority > best.authority ? cur : best
+    );
+    return Promise.resolve({
+      conflictId: conflict.id,
+      strategy: "authority",
+      winner: winnerEntry.response,
+      explanation: `Selected response from highest-authority agent "${winnerEntry.response.agentName}" (authority: ${winnerEntry.authority})`,
+      successful: true,
+      escalated: false,
+      resolved: /* @__PURE__ */ new Date()
+    });
   }
   /**
    * Resolve by consensus
@@ -3981,7 +4108,7 @@ var ConflictResolver = class {
   resolveByConsensus(conflict, _context) {
     const contentGroups = /* @__PURE__ */ new Map();
     for (const response of conflict.responses) {
-      const key = response.content.substring(0, 100);
+      const key = this.normalizeContent(response.content);
       const group = contentGroups.get(key) ?? [];
       group.push(response);
       contentGroups.set(key, group);
@@ -4141,7 +4268,12 @@ var Crew = class {
    */
   initializeAgents() {
     for (const agentConfig of this.config.agents) {
-      const agent = createCrewAgent({ config: agentConfig });
+      const agent = createCrewAgent({
+        config: agentConfig,
+        execute: this.config.execute,
+        mock: this.config.mock,
+        provider: this.config.provider
+      });
       this.addAgent(agent);
     }
   }

package/dist/nestjs/index.mjs

@@ -4,7 +4,7 @@ import {
 } from "../chunk-4PF73ECN.mjs";
 import {
   createCrew
-} from "../chunk-QMK3HWFX.mjs";
+} from "../chunk-V6VK6BOL.mjs";
 
 // src/nestjs/crews.module.ts
 var CREWS_MODULE_OPTIONS = "CREWS_MODULE_OPTIONS";

package/dist/templates/index.js

@@ -1428,7 +1428,80 @@ var AgentCapabilities = class {
   }
 };
 
+// src/agents/CoreExecutor.ts
+async function loadProvider(providerName) {
+  const ctorName = resolveProviderCtorName(providerName);
+  let core;
+  try {
+    core = await import("@lov3kaizen/agentsea-core");
+  } catch {
+    throw new Error(
+      'CrewAgent requires "@lov3kaizen/agentsea-core" to execute against a real LLM. Install it, or pass a custom `execute` function (or `mock: true`) to createCrewAgent / createCrew.'
+    );
+  }
+  const Ctor = core[ctorName];
+  return new Ctor();
+}
+function resolveProviderCtorName(providerName) {
+  switch ((providerName ?? "").toLowerCase()) {
+    case "anthropic":
+    case "claude":
+      return "AnthropicProvider";
+    case "openai":
+    case "gpt":
+      return "OpenAIProvider";
+    case "gemini":
+    case "google":
+      return "GeminiProvider";
+    case "ollama":
+      return "OllamaProvider";
+    default:
+      throw new Error(
+        `CrewAgent: unsupported provider "${providerName}". Supported providers are: anthropic, openai, gemini, ollama. Pass a custom \`execute\` function to createCrewAgent for any other provider.`
+      );
+  }
+}
+function createCoreExecutor(config, options = {}) {
+  let providerPromise;
+  const getProvider = () => {
+    if (!providerPromise) {
+      providerPromise = options.provider ? Promise.resolve(options.provider) : loadProvider(config.provider);
+    }
+    return providerPromise;
+  };
+  return async (input, systemPrompt) => {
+    const provider = await getProvider();
+    const start = Date.now();
+    const response = await provider.generateResponse(
+      [{ role: "user", content: input }],
+      {
+        model: config.model,
+        systemPrompt,
+        temperature: config.temperature,
+        maxTokens: config.maxTokens
+      }
+    );
+    return {
+      output: response.content,
+      tokensUsed: response.usage.inputTokens + response.usage.outputTokens,
+      latencyMs: Date.now() - start,
+      iterations: 1
+    };
+  };
+}
+
 // src/agents/CrewAgent.ts
+function modelCostWeight(model) {
+  const m = (model ?? "").toLowerCase();
+  if (m.includes("opus") || m.includes("gpt-5") || m.includes("o3")) return 5;
+  if (m.includes("sonnet") || m.includes("gpt-4.1") || m.includes("gpt-4") && !m.includes("mini") || m.includes("gemini-1.5-pro") || m.includes("gemini-2.5-pro")) {
+    return 3;
+  }
+  if (m.includes("haiku") || m.includes("mini") || m.includes("flash") || m.includes("llama") || m.includes("mistral")) {
+    return 1;
+  }
+  return 3;
+}
 var CrewAgent = class _CrewAgent {
   id;
   name;
@@ -1467,10 +1540,11 @@ var CrewAgent = class _CrewAgent {
    */
   async execute(input) {
     if (!this.executeFunc) {
+      const tokensUsed = 100 + Math.min(input.length, 400);
       const mockResult = {
         output: `[Mock response from ${this.name}]: ${input.slice(0, 100)}...`,
-        tokensUsed: Math.floor(Math.random() * 500) + 100,
-        latencyMs: Math.floor(Math.random() * 2e3) + 500,
+        tokensUsed,
+        latencyMs: 0,
         iterations: 1
       };
       this.totalTokensUsed += mockResult.tokensUsed;
@@ -1573,16 +1647,27 @@ ${JSON.stringify(task.context, null, 2)}`);
       ) ?? true
     ).map((c) => c.name);
     const estimatedTime = this.estimateTaskTime(task);
+    const estimatedCost = this.estimateTaskCost(estimatedTime);
     const reasoning = this.generateBidReasoning(task, confidence, matchedCaps);
     return Promise.resolve({
       agentName: this.name,
       taskId: task.id ?? "unknown",
       confidence,
       estimatedTime,
+      estimatedCost,
       reasoning,
       capabilities: matchedCaps
     });
   }
+  /**
+   * Estimate a relative cost for handling a task. Combines the agent's model
+   * price tier with the estimated effort so the auction `cheapest` criterion
+   * can distinguish a cheap-but-slower model from an expensive-but-faster one.
+   * The unit is arbitrary and only meaningful relative to other bids.
+   */
+  estimateTaskCost(estimatedTime) {
+    return modelCostWeight(this.model) * Math.max(estimatedTime, 1);
+  }
   /**
    * Check if agent has all required capabilities
    */
@@ -1768,7 +1853,13 @@ Please provide helpful guidance based on your expertise.
   }
 };
 function createCrewAgent(options) {
-  return new CrewAgent(options);
+  if (options.execute || options.mock) {
+    return new CrewAgent(options);
+  }
+  return new CrewAgent({
+    ...options,
+    execute: createCoreExecutor(options.config, { provider: options.provider })
+  });
 }
 
 // src/agents/AgentRegistry.ts
@@ -2468,9 +2559,9 @@ var AuctionStrategy = class extends BaseDelegationStrategy {
         }, bids[0]);
       case "cheapest":
         return bids.reduce((best, bid) => {
-          const bestTime = best.estimatedTime ?? Infinity;
-          const bidTime = bid.estimatedTime ?? Infinity;
-          return bidTime < bestTime ? bid : best;
+          const bestCost = best.estimatedCost ?? best.estimatedTime ?? Infinity;
+          const bidCost = bid.estimatedCost ?? bid.estimatedTime ?? Infinity;
+          return bidCost < bestCost ? bid : best;
         }, bids[0]);
       case "confidence":
       default:
@@ -2953,9 +3044,8 @@ var ConsensusStrategy = class extends BaseDelegationStrategy {
    */
   async collectVotes(task, voters, candidates) {
     const votes = [];
-    const candidateNames = candidates.map((c) => c.name);
     for (const voter of voters) {
-      const vote = await this.getVote(voter, task, candidateNames);
+      const vote = await this.getVote(voter, task, candidates);
       if (vote) {
         votes.push(vote);
       }
@@ -2963,33 +3053,35 @@ var ConsensusStrategy = class extends BaseDelegationStrategy {
     return votes;
   }
   /**
-   * Get a vote from an agent
+   * Get a vote from an agent.
+   *
+   * Each voter ranks the candidates by how well their capabilities fit the
+   * task (the same `calculateTaskScore` signal the BestMatch/Auction strategies
+   * use), plus a small self-preference bias so an agent leans toward itself when
+   * candidates are otherwise comparable. This is fully deterministic — given the
+   * same agents and task it always produces the same votes — and explainable,
+   * which is what consensus needs. (A future enhancement could replace this with
+   * an actual LLM deliberation per voter; the tally/agreement logic is unchanged.)
    */
   getVote(voter, task, candidates) {
-    const scores = [];
-    for (const candidateName of candidates) {
-      if (candidateName === voter.name) {
-        scores.push({ name: candidateName, score: 0.7 });
-      } else {
-        const randomFactor = 0.8 + Math.random() * 0.4;
-        scores.push({
-          name: candidateName,
-          score: Math.random() * randomFactor
-        });
+    if (candidates.length === 0) return Promise.resolve(null);
+    const SELF_PREFERENCE_BONUS = 0.15;
+    const scores = candidates.map((candidate) => {
+      let score = candidate.calculateTaskScore(task);
+      if (candidate.name === voter.name) {
+        score += SELF_PREFERENCE_BONUS;
       }
-    }
-    scores.sort((a, b) => b.score - a.score);
+      return { name: candidate.name, score };
+    });
+    scores.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
     const selected = scores[0];
     if (!selected) return Promise.resolve(null);
-    let weight = 1;
-    if (this.weightedVoting) {
-      weight = voter.calculateTaskScore(task) || 0.5;
-    }
+    const weight = this.weightedVoting ? voter.calculateTaskScore(task) || 0.5 : 1;
     return Promise.resolve({
       voter: voter.name,
       candidate: selected.name,
       weight,
-      reasoning: `Selected based on perceived suitability (score: ${selected.score.toFixed(2)})`
+      reasoning: `Ranked "${selected.name}" highest by capability fit for the task (score: ${selected.score.toFixed(2)})`
     });
   }
   /**
@@ -3853,13 +3945,24 @@ var ConflictResolver = class {
       resolved: /* @__PURE__ */ new Date()
     };
   }
+  /**
+   * Normalize response content for equality comparison: trim, collapse runs of
+   * whitespace, and lowercase. This groups textually-equivalent answers (ignoring
+   * incidental formatting) over their FULL content rather than a fragile first-N
+   * characters prefix. Note: this is exact-match-after-normalization, not semantic
+   * similarity — agents that express the same idea with different wording will not
+   * group. Semantic grouping would require embeddings (future enhancement).
+   */
+  normalizeContent(content) {
+    return content.trim().replace(/\s+/g, " ").toLowerCase();
+  }
   /**
    * Resolve by voting
    */
   resolveByVoting(conflict, _context) {
     const votes = /* @__PURE__ */ new Map();
     for (const response of conflict.responses) {
-      const key = response.content.substring(0, 100);
+      const key = this.normalizeContent(response.content);
       const current = votes.get(key) ?? 0;
       votes.set(key, current + response.confidence);
     }
@@ -3872,7 +3975,7 @@ var ConflictResolver = class {
       }
     }
     const winner = conflict.responses.find(
-      (r) => r.content.substring(0, 100) === winningKey
+      (r) => this.normalizeContent(r.content) === winningKey
     );
     return Promise.resolve({
       conflictId: conflict.id,
@@ -3888,7 +3991,31 @@ var ConflictResolver = class {
    * Resolve by authority
    */
   resolveByAuthority(conflict, _context) {
-    return Promise.resolve(this.resolveByConfidence(conflict));
+    const ranked = conflict.responses.map((r) => ({
+      response: r,
+      authority: typeof r.metadata?.authority === "number" ? r.metadata.authority : void 0
+    })).filter(
+      (x) => x.authority !== void 0
+    );
+    if (ranked.length === 0) {
+      return Promise.resolve({
+        ...this.resolveByConfidence(conflict),
+        strategy: "authority",
+        explanation: "No authority metadata provided; fell back to highest confidence"
+      });
+    }
+    const winnerEntry = ranked.reduce(
+      (best, cur) => cur.authority > best.authority ? cur : best
+    );
+    return Promise.resolve({
+      conflictId: conflict.id,
+      strategy: "authority",
+      winner: winnerEntry.response,
+      explanation: `Selected response from highest-authority agent "${winnerEntry.response.agentName}" (authority: ${winnerEntry.authority})`,
+      successful: true,
+      escalated: false,
+      resolved: /* @__PURE__ */ new Date()
+    });
   }
   /**
    * Resolve by consensus
@@ -3896,7 +4023,7 @@ var ConflictResolver = class {
   resolveByConsensus(conflict, _context) {
     const contentGroups = /* @__PURE__ */ new Map();
     for (const response of conflict.responses) {
-      const key = response.content.substring(0, 100);
+      const key = this.normalizeContent(response.content);
       const group = contentGroups.get(key) ?? [];
       group.push(response);
       contentGroups.set(key, group);
@@ -4056,7 +4183,12 @@ var Crew = class {
    */
   initializeAgents() {
     for (const agentConfig of this.config.agents) {
-      const agent = createCrewAgent({ config: agentConfig });
+      const agent = createCrewAgent({
+        config: agentConfig,
+        execute: this.config.execute,
+        mock: this.config.mock,
+        provider: this.config.provider
+      });
       this.addAgent(agent);
     }
   }

package/dist/templates/index.mjs

@@ -11,8 +11,8 @@ import {
   createResearchCrewConfig,
   createWritingCrew,
   createWritingCrewConfig
-} from "../chunk-TFB7N65B.mjs";
-import "../chunk-QMK3HWFX.mjs";
+} from "../chunk-6JLVFEU6.mjs";
+import "../chunk-V6VK6BOL.mjs";
 export {
   CodeReviewTasks,
   CustomerSupportTasks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lov3kaizen/agentsea-crews",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Multi-agent orchestration framework for AgentSea. Build, compose, and orchestrate agent crews with role-based coordination, task delegation, and workflow automation.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -40,7 +40,7 @@
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
-    "@lov3kaizen/agentsea-core": "1.0.1"
+    "@lov3kaizen/agentsea-core": "1.1.0"
   },
   "peerDependenciesMeta": {
     "@nestjs/common": {