@ecommaps/ai-sales-agent

Composable sales agent kit for buyer-facing storefront assistants.

Install

npm install @ecommaps/ai-sales-agent

Runtime and Peer Requirements

Node.js 20+
AI SDK v6-compatible runtime
React 18/19 for UI entrypoints
Depends on @ecommaps/client and @ecommaps/storefront-kit

Entry Points

@ecommaps/ai-sales-agent/server
@ecommaps/ai-sales-agent/react
@ecommaps/ai-sales-agent/next

Server Exports

buildSalesSkillProfile
buildSalesAgentTools
createSalesAgentRuntime

React Exports

AIAssistantShell
ReasoningBlock
MarkdownMessageRenderer
ProductCard
CollectionCard
PromotionCard

Minimal Runtime Example

import { openai } from "@ai-sdk/openai";
import { buildSalesAgentTools, buildSalesSkillProfile, createSalesAgentRuntime } from "@ecommaps/ai-sales-agent/server";
 
const tools = buildSalesAgentTools({ client: ecommapsClient, getOrCreateCartId });
const { systemPromptBlock } = buildSalesSkillProfile({ store, isFirstAssistantTurn: true });
 
const result = await createSalesAgentRuntime({
  model: openai("gpt-4o-mini"),
  systemPrompt: systemPromptBlock,
  messages,
  tools,
});

Additional References

@ecommaps/storefront-kit @ecommaps/mcp