20 |
21 | {content}
22 |
23 |
24 | );
25 | };
26 |
27 | export default memo(MarkdownRenderer);
28 |
--------------------------------------------------------------------------------
/frontend/src/assets/svg/index.ts:
--------------------------------------------------------------------------------
1 | export { default as AutoTrade } from "./agent-suggest/auto-trade.svg";
2 | export { default as NewsPush } from "./agent-suggest/news-push.svg";
3 | export { default as ResearchReport } from "./agent-suggest/research-report.svg";
4 | export { default as Conversation } from "./conversation.svg";
5 | export { default as DeleteStrategy } from "./delete-strategy.svg";
6 | export { default as Logo } from "./logo.svg";
7 | export { default as Send } from "./send.svg";
8 | export { default as Share } from "./share.svg";
9 | export { default as Market } from "./sidebar/market.svg";
10 | export { default as Ranking } from "./sidebar/ranking.svg";
11 | export { default as Setting } from "./sidebar/setting.svg";
12 | export { default as StrategyAgent } from "./sidebar/strategy-agent.svg";
13 | export { default as StrategyStatus } from "./strategy-status.svg";
14 |
--------------------------------------------------------------------------------
/frontend/src/components/ui/progress.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 | import * as ProgressPrimitive from "@radix-ui/react-progress"
3 |
4 | import { cn } from "@/lib/utils"
5 |
6 | function Progress({
7 | className,
8 | value,
9 | ...props
10 | }: React.ComponentProps
19 | setSelectedProvider(provider)}
23 | />
24 |
25 | {selectedProvider &&
27 | );
28 | }
29 |
--------------------------------------------------------------------------------
/frontend/src/routes.ts:
--------------------------------------------------------------------------------
1 | import {
2 | index,
3 | layout,
4 | prefix,
5 | type RouteConfig,
6 | route,
7 | } from "@react-router/dev/routes";
8 |
9 | export default [
10 | index("app/redirect-to-home.tsx"),
11 |
12 | ...prefix("/home", [
13 | layout("app/home/_layout.tsx", [
14 | index("app/home/home.tsx"),
15 | route("/stock/:stockId", "app/home/stock.tsx"),
16 | ]),
17 | ]),
18 |
19 | route("/market", "app/market/agents.tsx"),
20 |
21 | route("/ranking", "app/rank/board.tsx"),
22 |
23 | ...prefix("/agent", [
24 | route("/:agentName", "app/agent/chat.tsx"),
25 | route("/:agentName/config", "app/agent/config.tsx"),
26 | ]),
27 |
28 | ...prefix("/setting", [
29 | layout("app/setting/_layout.tsx", [
30 | index("app/setting/models.tsx"),
31 | route("/general", "app/setting/general.tsx"),
32 | route("/memory", "app/setting/memory.tsx"),
33 | ]),
34 | ]),
35 |
36 | // router for test components
37 | route("/test", "app/test.tsx"),
38 | ] satisfies RouteConfig;
39 |
--------------------------------------------------------------------------------
/frontend/src/components/valuecell/renderer/unknown-renderer.tsx:
--------------------------------------------------------------------------------
1 | import { FileText } from "lucide-react";
2 | import type { FC } from "react";
3 | import type { ChatItem } from "@/types/agent";
4 |
5 | interface UnknownRendererProps {
6 | item: ChatItem;
7 | content: string;
8 | }
9 |
10 | const UnknownRenderer: FC
13 |
25 | );
26 | };
27 |
28 | export default UnknownRenderer;
29 |
--------------------------------------------------------------------------------
/python/valuecell/core/task/tests/test_locator.py:
--------------------------------------------------------------------------------
1 | """
2 | Tests for process-local TaskService singleton locator.
3 | """
4 |
5 | from unittest.mock import AsyncMock
6 |
7 | from valuecell.core.task.locator import (
8 | get_task_service,
9 | reset_task_service,
10 | set_task_service,
11 | )
12 | from valuecell.core.task.service import TaskService
13 |
14 |
15 | def test_singleton_returns_same_instance():
16 | reset_task_service()
17 | s1 = get_task_service()
18 | s2 = get_task_service()
19 | assert isinstance(s1, TaskService)
20 | assert s1 is s2
21 |
22 |
23 | def test_set_and_reset_task_service():
24 | reset_task_service()
25 | custom_manager = AsyncMock()
26 | custom_service = TaskService(manager=custom_manager)
27 |
28 | set_task_service(custom_service)
29 | got = get_task_service()
30 | assert got is custom_service
31 |
32 | reset_task_service()
33 | new_service = get_task_service()
34 | assert isinstance(new_service, TaskService)
35 | assert new_service is not custom_service
36 |
--------------------------------------------------------------------------------
/frontend/src/i18n/index.ts:
--------------------------------------------------------------------------------
1 | import i18n from "i18next";
2 | import { initReactI18next } from "react-i18next";
3 |
4 | import en from "@/i18n/locales/en.json";
5 | import ja from "@/i18n/locales/ja.json";
6 | import zhCN from "@/i18n/locales/zh_CN.json";
7 | import zhTW from "@/i18n/locales/zh_TW.json";
8 | import { DEFAULT_LANGUAGE, useSettingsStore } from "@/store/settings-store";
9 |
10 | const resources = Object.fromEntries(
11 | [
12 | ["en", en],
13 | ["ja", ja],
14 | ["zh_CN", zhCN],
15 | ["zh_TW", zhTW],
16 | ].map(([locale, translation]) => [locale, { translation }]),
17 | );
18 |
19 | i18n.use(initReactI18next).init({
20 | resources,
21 | lng: useSettingsStore.getState().language,
22 | fallbackLng: DEFAULT_LANGUAGE,
23 | debug: import.meta.env.DEV,
24 | interpolation: {
25 | escapeValue: false,
26 | },
27 | saveMissing: true,
28 | missingKeyHandler: (_lngs, _ns, key) => {
29 | if (import.meta.env.DEV) {
30 | console.log("🚀 ~ missing key:", key);
31 | }
32 | },
33 | });
34 |
35 | export default i18n;
36 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
1 | ---
2 | name: Bug report
3 | about: Create a report to help us improve
4 | title: ''
5 | labels: ''
6 | assignees: ''
7 |
8 | ---
9 |
10 | **Describe the bug**
11 | A clear and concise description of what the bug is.
12 |
13 | **To Reproduce**
14 | Note: set `AGENT_DEBUG_MODE=true` to trace model behavior locally.
15 |
16 | Steps to reproduce the behavior:
17 |
18 | 1. Go to '...'
19 | 2. Click on '....'
20 | 3. Scroll down to '....'
21 | 4. See error
22 |
23 | **Expected behavior**
24 | A clear and concise description of what you expected to happen.
25 |
26 | **Actual behavior**
27 | A clear and concise description of what actually happens.
28 |
29 | **Screenshots**
30 | If applicable, add screenshots to help explain your problem.
31 |
32 | **Environment**
33 | Provide essential details about your environment
34 |
35 | - OS: [e.g. macOS]
36 | - Browser [e.g. Chrome, Safari, Firefox]
37 | - ValueCell version or hashtag [e.g. 0.1.0, #abcd4242]
38 |
39 | **Additional context**
40 | Add any other context about the problem here.
41 |
--------------------------------------------------------------------------------
/frontend/src/components/ui/input.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 |
3 | import { cn } from "@/lib/utils"
4 |
5 | function Input({ className, type, ...props }: React.ComponentProps<"input">) {
6 | return (
7 |
18 | )
19 | }
20 |
21 | export { Input }
22 |
--------------------------------------------------------------------------------
/frontend/src/components/valuecell/form/field/select-field.tsx:
--------------------------------------------------------------------------------
1 | import type { FC, ReactNode } from "react";
2 | import { Field, FieldError, FieldLabel } from "@/components/ui/field";
3 | import {
4 | Select,
5 | SelectContent,
6 | SelectTrigger,
7 | SelectValue,
8 | } from "@/components/ui/select";
9 | import { useFieldContext } from "@/hooks/use-form";
10 |
11 | interface SelectFieldProps {
12 | label: string;
13 | children: ReactNode;
14 | }
15 |
16 | export const SelectField: FC
14 |
24 |
15 |
20 |
21 |
23 | {content}
22 | onOpen?.(result)}
19 | >
20 |
26 | );
27 | };
28 |
29 | export default memo(ScheduledTaskRenderer);
30 |
--------------------------------------------------------------------------------
/frontend/src/app/test.tsx:
--------------------------------------------------------------------------------
1 | import { MarkdownRenderer } from "@/components/valuecell/renderer";
2 |
3 | export default function Test() {
4 | return (
5 | 21 | {TimeUtils.formatUTC(create_time, TIME_FORMATS.DATETIME_SHORT)} 22 |
23 | {/* content */} 24 |{result}
25 |
6 |
19 | );
20 | }
21 |
--------------------------------------------------------------------------------
/python/valuecell/agents/common/trading/history/interfaces.py:
--------------------------------------------------------------------------------
1 | from __future__ import annotations
2 |
3 | from abc import ABC, abstractmethod
4 | from typing import List
5 |
6 | from valuecell.agents.common.trading.models import HistoryRecord, TradeDigest
7 |
8 | # Contracts for history recording and digest building (module-local abstract interfaces).
9 |
10 |
11 | class BaseHistoryRecorder(ABC):
12 | """Persists important checkpoints for later analysis and digest building."""
13 |
14 | @abstractmethod
15 | def record(self, record: HistoryRecord) -> None:
16 | """Persist a single history record."""
17 | raise NotImplementedError
18 |
19 | @abstractmethod
20 | def get_records(self) -> List[HistoryRecord]:
21 | """Get all current records."""
22 | raise NotImplementedError
23 |
24 |
25 | class BaseDigestBuilder(ABC):
26 | """Builds TradeDigest from historical records (incremental or batch)."""
27 |
28 | @abstractmethod
29 | def build(self, records: List[HistoryRecord]) -> TradeDigest:
30 | """Construct a digest object from given history records."""
31 | raise NotImplementedError
32 |
--------------------------------------------------------------------------------
/frontend/src/components/valuecell/app/auto-update-check.tsx:
--------------------------------------------------------------------------------
1 | import { isTauri } from "@tauri-apps/api/core";
2 | import { useEffect, useRef } from "react";
3 | import { useUpdateToast } from "@/hooks/use-update-toast";
4 |
5 | const CHECK_INTERVAL_MS = 60 * 60 * 1000; // Check every hour
6 | const INITIAL_DELAY_MS = 5 * 1000; // Wait 5 seconds after app start
7 |
8 | export function AutoUpdateCheck() {
9 | const { checkForUpdatesSilent } = useUpdateToast();
10 | const checkIntervalRef = useRef
11 |
30 | );
31 | }
32 |
--------------------------------------------------------------------------------
/frontend/src/provider/tracker-provider.tsx:
--------------------------------------------------------------------------------
1 | import { parse } from "best-effort-json-parser";
2 | import { useEffect } from "react";
3 | import { type TrackingEvents, tracker } from "@/lib/tracker";
4 |
5 | export const TrackerProvider = ({
6 | children,
7 | }: {
8 | children: React.ReactNode;
9 | }) => {
10 | useEffect(() => {
11 | const handleGlobalClick = (event: MouseEvent) => {
12 | const target = event.target as HTMLElement;
13 |
14 | // find the closest tracked element
15 | const trackedElements = target.closest("[data-track]");
16 |
17 | if (trackedElements) {
18 | const event = trackedElements.getAttribute(
19 | "data-track",
20 | ) as keyof TrackingEvents;
21 |
22 | if (!event) return;
23 |
24 | const params =
25 | trackedElements.getAttribute("data-track-params") ?? "{}";
26 | tracker.send(event, parse(params));
27 | }
28 | };
29 |
30 | document.addEventListener("click", handleGlobalClick, true);
31 |
32 | return () => {
33 | document.removeEventListener("click", handleGlobalClick, true);
34 | };
35 | }, []);
36 |
37 | return <>{children};
38 | };
39 |
--------------------------------------------------------------------------------
/frontend/src/assets/svg/send.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/frontend/tsconfig.json:
--------------------------------------------------------------------------------
1 | {
2 | "compilerOptions": {
3 | "target": "ES2020",
4 | "useDefineForClassFields": true,
5 | "lib": [
6 | "ES2020",
7 | "DOM",
8 | "DOM.Iterable"
9 | ],
10 | "module": "ESNext",
11 | "skipLibCheck": true,
12 | /* Bundler mode */
13 | "moduleResolution": "bundler",
14 | "allowImportingTsExtensions": true,
15 | "resolveJsonModule": true,
16 | "isolatedModules": true,
17 | "noEmit": true,
18 | "jsx": "react-jsx",
19 | /* Linting */
20 | "strict": true,
21 | "noUnusedLocals": false,
22 | "noUnusedParameters": false,
23 | "noFallthroughCasesInSwitch": true,
24 | /* Paths */
25 | "baseUrl": ".",
26 | "paths": {
27 | "@/*": [
28 | "./src/*"
29 | ],
30 | "@valuecell/*": [
31 | "./src/components/valuecell/*"
32 | ]
33 | },
34 | "types": [
35 | "vite-plugin-svg-sprite/typings/vanilla"
36 | ],
37 | "rootDirs": [
38 | ".",
39 | "./.react-router/types"
40 | ]
41 | },
42 | "include": [
43 | "src",
44 | ".react-router/types/**/*"
45 | ],
46 | "references": [
47 | {
48 | "path": "./tsconfig.node.json"
49 | }
50 | ]
51 | }
--------------------------------------------------------------------------------
/python/valuecell/server/db/models/__init__.py:
--------------------------------------------------------------------------------
1 | """
2 | ValueCell Server - Database Models
3 |
4 | This package contains all database models for the ValueCell server.
5 | All models are automatically imported to ensure they are registered with SQLAlchemy.
6 | """
7 |
8 | # Import all models to ensure they are registered with SQLAlchemy
9 | from .agent import Agent
10 | from .asset import Asset
11 |
12 | # Import base model
13 | from .base import Base
14 | from .strategy import Strategy
15 | from .strategy_compose_cycle import StrategyComposeCycle
16 | from .strategy_detail import StrategyDetail
17 | from .strategy_holding import StrategyHolding
18 | from .strategy_instruction import StrategyInstruction
19 | from .strategy_portfolio import StrategyPortfolioView
20 | from .user_profile import ProfileCategory, UserProfile
21 | from .watchlist import Watchlist, WatchlistItem
22 |
23 | # Export all models
24 | __all__ = [
25 | "Base",
26 | "Agent",
27 | "Asset",
28 | "Strategy",
29 | "Watchlist",
30 | "WatchlistItem",
31 | "UserProfile",
32 | "ProfileCategory",
33 | "StrategyHolding",
34 | "StrategyDetail",
35 | "StrategyPortfolioView",
36 | "StrategyComposeCycle",
37 | "StrategyInstruction",
38 | ]
39 |
--------------------------------------------------------------------------------
/frontend/src/constants/stock.ts:
--------------------------------------------------------------------------------
1 | // Stock color definitions
2 | export const GREEN_COLOR = "#15803d";
3 | export const RED_COLOR = "#E25C5C";
4 | export const NEUTRAL_COLOR = "#707070";
5 |
6 | export const GREEN_GRADIENT: [string, string] = [
7 | "rgba(21, 128, 61, 0.6)",
8 | "rgba(21, 128, 61, 0)",
9 | ];
10 | export const RED_GRADIENT: [string, string] = [
11 | "rgba(226, 92, 92, 0.5)",
12 | "rgba(226, 92, 92, 0)",
13 | ];
14 | export const NEUTRAL_GRADIENT: [string, string] = [
15 | "rgba(112, 112, 112, 0.5)",
16 | "rgba(112, 112, 112, 0)",
17 | ];
18 |
19 | export const GREEN_BADGE = { bg: "#f0fdf4", text: "#15803d" };
20 | export const RED_BADGE = { bg: "#FFEAEA", text: "#E25C5C" };
21 | export const NEUTRAL_BADGE = { bg: "#F5F5F5", text: "#707070" };
22 |
23 | /**
24 | * Stock configurations for home page display.
25 | * Used as fallback when /api/v1/system/default-tickers API fails.
26 | * The API returns region-appropriate stocks based on user's IP location.
27 | */
28 | export const HOME_STOCK_SHOW = [
29 | {
30 | ticker: "NASDAQ:IXIC",
31 | symbol: "NASDAQ",
32 | },
33 | {
34 | ticker: "HKEX:HSI",
35 | symbol: "HSI",
36 | },
37 | {
38 | ticker: "SSE:000001",
39 | symbol: "SSE",
40 | },
41 | ] as const;
42 |
--------------------------------------------------------------------------------
/frontend/src/app/market/agents.tsx:
--------------------------------------------------------------------------------
1 | import { useTranslation } from "react-i18next";
2 | import { Link } from "react-router";
3 | import { useGetAgentList } from "@/api/agent";
4 | import { AgentMarketSkeleton } from "@/components/valuecell/skeleton";
5 | import { AgentCard } from "./components/agent-card";
6 |
7 | export default function AgentMarket() {
8 | const { t } = useTranslation();
9 | const { data: agents = [], isLoading } = useGetAgentList();
10 |
11 | if (isLoading) {
12 | return {t("home.welcome")}
12 | 13 |
14 |
15 |
17 |
18 |
28 |
29 |
17 | {/* Page Title */}
18 |
33 | );
34 | }
35 |
--------------------------------------------------------------------------------
/frontend/src/components/ui/switch.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 | import * as SwitchPrimitive from "@radix-ui/react-switch"
3 |
4 | import { cn } from "@/lib/utils"
5 |
6 | function Switch({
7 | className,
8 | ...props
9 | }: React.ComponentProps19 | {t("market.title")} 20 |
21 | 22 | {/* Agent Cards Grid */} 23 |
24 | {agents.map((agent) => (
25 |
32 |
26 |
27 |
30 | ))}
31 |
26 | {/* Avatar and Name Section */}
27 |
44 | );
45 | };
46 |
47 | export default AgentCard;
48 |
--------------------------------------------------------------------------------
/frontend/src/app/agent/components/chat-conversation/chat-multi-section-component.tsx:
--------------------------------------------------------------------------------
1 | import { parse } from "best-effort-json-parser";
2 | import { type FC, memo } from "react";
3 | import BackButton from "@/components/valuecell/button/back-button";
4 | import { MarkdownRenderer } from "@/components/valuecell/renderer";
5 | import { useMultiSection } from "@/provider/multi-section-provider";
6 | import type { MultiSectionComponentType } from "@/types/agent";
7 |
8 | // define different component types and their specific rendering components
9 | const ReportComponent: FC<{ content: string }> = ({ content }) => {
10 | const { closeSection } = useMultiSection();
11 | const { title, data } = parse(content);
12 |
13 | return (
14 | <>
15 |
28 | {/* Avatar */}
29 |
38 |
39 | {/* Description */}
40 |
30 |
32 |
33 | {/* Name */}
34 | 35 | {agent.display_name} 36 |
37 |41 | {agent.description} 42 |
43 |{title}
18 |
26 |
27 | {Object.entries(threads).map(([threadId, thread]) => {
28 | return (
29 |
30 | {/* Render all tasks within this thread */}
31 | {Object.entries(thread.tasks).map(([taskId, task]) => {
32 | if (task.items && task.items.length > 0) {
33 | return
38 | );
39 | })}
40 |
41 | {/* Streaming indicator */}
42 | {isStreaming &&
44 |
45 | );
46 | };
47 |
48 | export default memo(ChatThreadArea);
49 |
--------------------------------------------------------------------------------
/frontend/src/assets/svg/delete-strategy.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/frontend/src/components/ui/hover-card.tsx:
--------------------------------------------------------------------------------
1 | import * as React from "react"
2 | import * as HoverCardPrimitive from "@radix-ui/react-hover-card"
3 |
4 | import { cn } from "@/lib/utils"
5 |
6 | function HoverCard({
7 | ...props
8 | }: React.ComponentProps onOpen?.(data)}
23 | >
24 | {/* Left side: Icon and text */}
25 |
45 | );
46 | };
47 |
48 | export default memo(ReportRenderer);
49 |
--------------------------------------------------------------------------------
/frontend/src/store/system-store.ts:
--------------------------------------------------------------------------------
1 | import { create } from "zustand";
2 | import { createJSONStorage, devtools, persist } from "zustand/middleware";
3 | import { useShallow } from "zustand/shallow";
4 | import type { SystemInfo } from "@/types/system";
5 | import { TauriStoreState } from "./plugin/tauri-store-state";
6 |
7 | const STORAGE_KEY = "valuecell-system-store";
8 |
9 | interface SystemStoreState extends SystemInfo {
10 | setSystemInfo: (info: Partial
26 | {/* Document icon with background */}
27 |
41 |
42 | {/* Right side: Arrow icon */}
43 |
28 |
30 |
31 | {/* Text content */}
32 |
33 |
40 | 34 | {title} 35 |
36 |37 | {`Created at: ${TimeUtils.formatUTC(create_time, TIME_FORMATS.DATE)}`} 38 |
39 |
53 | {stockData?.map((stock) => (
54 |
57 |