rzyfront/vendix-ai-chat
skills/vendix-ai-chat/SKILL.md
AI Chat system: conversation CRUD, sync and SSE message endpoints, agent/RAG routing, NgRx chat state, and chat widget. Trigger: When working with AI conversations, the chat widget, chat API endpoints, or NgRx chat state.
$ install --global
skillsauthnpx skillsauth add rzyfront/vendix vendix-ai-chatInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 5:04 AM264.4s1 file scanned
SKILL.md
- name:
- vendix-ai-chat
- description:
- >
- AI Chat system:
- conversation CRUD, sync and SSE message endpoints, agent/RAG routing,
- NgRx chat state, and chat widget. Trigger:
- When working with AI conversations, the chat
- license:
- Apache-2.0
- author:
- rzyfront
- version:
- 2.1
- scope:
- [root]
Source of Truth
- Backend:
apps/backend/src/domains/store/ai-chat/ - Frontend state:
apps/frontend/src/app/core/store/ai-chat/ - Frontend API:
apps/frontend/src/app/core/services/ai-chat-api.service.ts - Widget:
apps/frontend/src/app/shared/components/ai-chat-widget/
Backend Endpoints
Base route: /store/ai-chat.
POST /conversationswithAiAccessGuardand@RequireAIFeature('conversations').GET /conversations.GET /conversations/:id.POST /conversations/:id/messageswith@RequireAIFeature('streaming_chat').SSE /conversations/:id/streamwith@RequireAIFeature('streaming_chat').PATCH /conversations/:id/archive.PATCH /conversations/:id/title.
Backend Service Behavior
- Conversation queries filter by
user_id; store/org scope is handled byStorePrismaService. - Default app key is
chat_assistant. - Context window uses last 20
system|user|assistantmessages plus the new user message. - Sync send rejects archived conversations with
AI_CHAT_002. - Streaming archived conversations yield an error chunk.
- Listing excludes
deleted, so archived conversations may still be returned unless frontend removes/filters them.
Sync message routing:
metadata.agent_enabled === true->AIAgentService.runAgent().metadata.rag_enabled === true->RAGService.queryWithContext().- Otherwise ->
AIEngineService.run(appKey, undefined, contextMessages).
Streaming message routing currently always calls AIEngineService.runStream() and does not use agent/RAG routing.
Frontend State
AIChatFacade exposes observables and signal parallels with initialValue for conversations, active id, messages, streaming content, sending/loading flags, and errors.
app.config.ts registers provideState('aiChat', aiChatReducer) and AIChatEffects.
Reducer supports optimistic user messages and streaming chunk accumulation. Current effects use sync HTTP sendMessage; no effect currently wires AIStreamService or dispatches receiveStreamChunk/streamComplete.
Widget
app-ai-chat-widget is a standalone FAB/panel component with no inputs/outputs. It mirrors facade observables into local signals and provides conversation list/message UI.
Current caveats:
- Search found no layout mounting of
<app-ai-chat-widget>inapps/frontend/src/app. - UI has streaming placeholders, but real current send path is sync HTTP.
getStreamUrl()does not append the requiredcontentquery param for backend SSE chat stream.
Rules
- Keep user scoping on all conversation reads/writes.
- Do not claim chat frontend streaming is active unless effects/EventSource wiring is added.
- Use metadata flags for sync chat routing, but remember the current frontend app modal does not expose metadata JSON.
- Keep
toSignal(..., { initialValue })in facades.
Related Skills
vendix-ai-platform-corevendix-ai-streamingvendix-ai-agent-toolsvendix-ai-embeddings-ragvendix-subscription-gate
Related Skills
rzyfront/mobile-dev
development
VerifiedTrustedCommunity
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
5SKILL.mdUpdated May 29, 2026
rzyfront/vendix-subscription-gate
development
VerifiedTrustedCommunity
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-saas-billing
testing
VerifiedTrustedCommunity
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-redis-quota
development
VerifiedTrustedCommunity
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.
5SKILL.mdUpdated May 16, 2026