@drico2008/fincli 0.1.3 → 0.1.9

package/README.md

@@ -2,7 +2,7 @@
 
 FinCLI adalah financial CLI/TUI terminal modern untuk memantau market, mengelola watchlist, portfolio, journal, konfigurasi provider, dan menyiapkan integrasi AI market analysis secara modular.
 
-Status saat ini: Phase 23 MVP sudah aktif di atas fondasi Phase 1 sampai Phase 22.
+Status saat ini: FinCLI MVP aktif dengan TUI, provider chain, AI assistance, web research, portfolio, journal, watchlist, export, dan session history lokal.
 
 - Textual TUI satu kolom dengan command palette inline yang bisa discroll; sidebar lama sudah dihapus agar output market lebih lega.
 - Slash command router dengan command wajib FinCLI v0.1.
@@ -148,12 +148,17 @@ python -m fincli.app.main
 /journal add BTC-USD bullish "Breakout gagal, tunggu konfirmasi"
 /journal stats
 /journal review
-/price AAPL
+/history
+/history sessions
+/history save "Riset market pagi"
+/quote AAPL
 /technical BTC-USD 1d
 /technical XAUUSD 1d
 /technical EURUSD 1d
 /structure BTC-USD 1d
 /news AAPL
+/web penyebab rupiah melemah hari ini
+/web sources penyebab rupiah melemah hari ini
 /funda MSFT
 /yahoo BBRI history 6mo 1d
 /yahoo BBRI statistics
@@ -177,7 +182,7 @@ python -m fincli.app.main
 /exit
 ```
 
-Command `/market`, `/price`, `/quote`, `/technical`, `/structure`, `/news`, dan `/funda` sudah memakai provider chain aktif. Command `/ai` dan `/analyze` sudah memakai AI provider aktif dari `/ai_model` dan `.env`. `/analyze` membawa konteks indikator, struktur pasar, news, dan fundamental ringkas ke prompt AI. `/ai` juga mengambil quote, OHLCV/technical, structure, news, dan fundamental saat user menyebut symbol seperti `AAPL`, `EURUSD`, atau `XAUUSD`.
+Command `/market`, `/quote`, `/technical`, `/structure`, `/news`, dan `/funda` sudah memakai provider chain aktif. Command `/ai` dan `/analyze` sudah memakai AI provider aktif dari `/ai_model` dan `.env`. `/analyze` membawa konteks indikator, struktur pasar, news, dan fundamental ringkas ke prompt AI. `/ai` juga mengambil quote, OHLCV/technical, structure, news, dan fundamental saat user menyebut symbol seperti `AAPL`, `EURUSD`, atau `XAUUSD`.
 
 ## AI Chat UX
 
@@ -207,8 +212,31 @@ AI assistant di dalam FinCLI dipersonalisasi untuk market workflow:
 - Boleh free chat untuk pertanyaan umum, market, portfolio, journal, provider, dan risk workflow.
 - Menolak coding/debugging/refactor/pembuatan software di dalam assistant FinCLI agar fokus app tetap jelas.
 - Jika prompt berisi symbol eksplisit, FinCLI menyisipkan market context dari provider chain aktif sebelum memanggil AI provider.
+- Jika prompt membutuhkan info terkini, FinCLI dapat mengambil konteks web publik dan memasukkannya ke AI prompt.
 - Tidak membocorkan API key dan tidak mengklaim realtime jika provider aktif hanya delayed/fallback.
 
+Contoh web-aware freechat:
+
+```text
+apa yang menyebabkan penurunan rupiah terhadap semua mata uang hari ini
+berita terbaru BI rate dan dampaknya ke IHSG
+```
+
+Untuk web search yang dirangkum oleh AI:
+
+```text
+/web penyebab rupiah melemah hari ini
+/web update harga emas dan dollar index
+```
+
+Untuk melihat sumber mentah tanpa ringkasan AI:
+
+```text
+/web sources penyebab rupiah melemah hari ini
+```
+
+FinCLI memakai lightweight HTTP web research, bukan Chrome automation. Ini lebih stabil untuk npm global install dan tidak membuka browser di background. Output tetap harus diverifikasi karena kualitas sumber web bisa berbeda-beda.
+
 ## Interactive AI Model Selector
 
 ```text
@@ -474,7 +502,7 @@ FinCLI memakai yfinance untuk akses saham global yang tersedia di Yahoo Finance.
 Command:
 
 ```text
-/price BBRI
+/quote BBRI
 /technical BBRI 1d
 /analyze BBRI 1d
 /yahoo BBRI history 6mo 1d
@@ -643,8 +671,14 @@ FinCLI menyimpan data lokal di:
 ~/.fincli/fincli.log
 ```
 
-API key tidak disimpan di output terminal dan sebaiknya tetap berada di `.env` atau environment variable.
-Untuk install global via npm, API key paling praktis disimpan lewat command FinCLI di `~/.fincli/secrets.env`.
+API key tidak disimpan di output terminal. Untuk install global via npm, jalur utama adalah command FinCLI:
+
+```text
+/ai_model key groq <api_key>
+/news_model key twelvedata <api_key>
+```
+
+Key disimpan lokal di `~/.fincli/secrets.env`, dipakai otomatis untuk semua session FinCLI berikutnya, dan tidak perlu dikonfigurasi ulang. Jika `.env` lokal berisi nilai kosong, FinCLI tetap memakai secret lokal yang sudah tersimpan.
 
 ## Test
 
@@ -663,7 +697,7 @@ Hasil terakhir di environment ini:
 - `fincli` tidak dikenali: jalankan `pip install -e .` dari root project.
 - TUI tidak tampil rapi: perbesar terminal desktop.
 - API key tidak terbaca: gunakan `/ai_model key <provider> <api_key>` atau `/news_model key <provider> <api_key>`, lalu cek `/config` atau `/provider key status`.
-- `/price` gagal karena yfinance belum ada: jalankan `pip install -e ".[dev]"` atau `pip install -r requirements.txt`.
+- `/quote` gagal karena yfinance belum ada: jalankan `pip install -e ".[dev]"` atau `pip install -r requirements.txt`.
 - Config rusak: hapus `~/.fincli/config.json` untuk kembali ke default.
 
 ## Roadmap Lanjutan

package/fincli/__init__.py

@@ -1,3 +1,3 @@
 """FinCLI package."""
 
-__version__ = "0.1.3"
+__version__ = "0.1.9"

package/fincli/app/analysis/assistant_context.py

@@ -15,6 +15,7 @@ Identity and scope:
 
 Financial analysis rules:
 - Analyze from provided market context first. Do not invent prices, news, fundamentals, provider status, or certainty.
+- If Web Research Context is provided, use it as current public context, mention source URLs, and separate sourced facts from interpretation.
 - Use probabilistic language: scenario, bias, confirmation, invalidation, risk, caution.
 - Do not promise profit and do not present aggressive entries as guaranteed signals.
 - For technical analysis, weigh trend, momentum, volatility, support/resistance, market structure, and data quality.
@@ -155,7 +156,32 @@ def build_fincli_assistant_prompt(user_prompt: str, market_context: str = "") ->
         f"{user_prompt.strip()}\n\n"
         "Instruction:\n"
         "- Answer the user's prompt directly.\n"
-        "- If market context is present, cite provider/data-quality limitations.\n"
+        "- If market or web context is present, cite provider/data-quality limitations and source URLs when available.\n"
         "- If market context is missing and the user asks about an instrument, say what data is missing.\n"
         "- Keep the coding boundary enforced.\n"
     )
+
+
+def build_web_research_answer_prompt(user_prompt: str, web_context: str) -> str:
+    """Build a prompt that turns gathered web context into an answer, not a source dump."""
+    context = web_context.strip() or "Web Research: no public web context returned."
+    return (
+        f"{FINCLI_ASSISTANT_SYSTEM_PROMPT}\n\n"
+        "Web Search Skill Result:\n"
+        f"{context}\n\n"
+        "User Prompt:\n"
+        f"{user_prompt.strip()}\n\n"
+        "Instruction:\n"
+        "- You already have web search context above. Do not answer by only listing articles or links.\n"
+        "- Synthesize the sources into a useful explanation/summary for the user.\n"
+        "- Prioritize facts found in the web context, then clearly label interpretation.\n"
+        "- If sources disagree or are thin, say that the evidence is limited.\n"
+        "- Use this output structure when relevant:\n"
+        "  1. Ringkasan singkat\n"
+        "  2. Poin utama/penyebab\n"
+        "  3. Dampak atau implikasi\n"
+        "  4. Risiko dan hal yang perlu diverifikasi\n"
+        "  5. Sumber singkat\n"
+        "- Keep source citations compact: source title or URL only where useful.\n"
+        "- Do not provide financial advice or certainty about market direction.\n"
+    )

package/fincli/app/analysis/indicators.py

@@ -26,7 +26,7 @@ class TechnicalSummary:
 
 
 def phase_one_indicator_status() -> str:
-    return "Indicator engine scaffold ready. pandas/numpy/yfinance integration planned for Phase 2."
+    return "Indicator engine active: SMA, EMA, RSI, MACD, Bollinger Bands, ATR, volume, support, and resistance."
 
 
 def summarize_technical_indicators(candles: list[Candle]) -> TechnicalSummary:

package/fincli/app/analysis/market_structure.py

@@ -20,7 +20,7 @@ class MarketStructureSummary:
 
 
 def phase_one_structure_status() -> str:
-    return "Market structure scaffold ready. HH/HL/LH/LL detection planned for Phase 2."
+    return "Market structure engine active: HH/HL/LH/LL, BOS, CHoCH, liquidity area, and risk zone."
 
 
 def analyze_market_structure(candles: list[Candle], lookback: int = 20) -> MarketStructureSummary:

package/fincli/app/cli/commands.py

@@ -22,6 +22,8 @@ COMMANDS: tuple[CommandSpec, ...] = (
     CommandSpec("/news_model key", "Simpan API key market/news lokal.", "/news_model key finnhub <api_key>", "Provider"),
     CommandSpec("/market", "Ringkasan market profesional untuk instrumen.", "/market AAPL 1d", "Market"),
     CommandSpec("/news", "Tampilkan news/fundamental terbaru untuk instrumen.", "/news AAPL", "Market"),
+    CommandSpec("/web", "Web search lalu AI merangkum jawaban.", "/web penyebab rupiah melemah hari ini", "Research"),
+    CommandSpec("/web sources", "Tampilkan sumber mentah hasil web search.", "/web sources penyebab rupiah melemah hari ini", "Research"),
     CommandSpec("/technical", "Analisis teknikal instrumen.", "/technical BTC-USD 1d", "Analysis"),
     CommandSpec("/structure", "Analisis struktur pasar instrumen.", "/structure BTC-USD 1d", "Analysis"),
     CommandSpec("/funda", "Fundamental ringkas instrumen.", "/funda MSFT", "Market"),
@@ -41,9 +43,13 @@ COMMANDS: tuple[CommandSpec, ...] = (
     CommandSpec("/journal add", "Tambahkan catatan journal singkat.", '/journal add BTC-USD bullish "Breakout gagal, tunggu konfirmasi"', "Journal"),
     CommandSpec("/journal stats", "Tampilkan statistik journal.", "/journal stats", "Journal"),
     CommandSpec("/journal review", "AI review kebiasaan journal.", "/journal review", "Journal"),
+    CommandSpec("/history", "Tampilkan command history current session.", "/history", "History"),
+    CommandSpec("/history sessions", "Tampilkan daftar session tersimpan.", "/history sessions", "History"),
+    CommandSpec("/history show", "Tampilkan detail session tertentu.", "/history show <session_id>", "History"),
+    CommandSpec("/history save", "Beri nama current session.", '/history save "Riset IHSG pagi"', "History"),
+    CommandSpec("/history delete", "Hapus session tertentu.", "/history delete <session_id>", "History"),
     CommandSpec("/config", "Tampilkan konfigurasi aktif tanpa membocorkan API key.", "/config"),
-    CommandSpec("/price", "Tampilkan harga instrumen.", "/price NVDA", "Market"),
-    CommandSpec("/quote", "Alias harga/quote instrumen.", "/quote NVDA", "Market"),
+    CommandSpec("/quote", "Tampilkan harga/quote instrumen.", "/quote NVDA", "Market"),
     CommandSpec("/scan", "Scanner watchlist dengan filter indikator.", "/scan watchlist rsi<30", "Market"),
     CommandSpec("/calendar", "Economic calendar provider/fallback.", "/calendar week US high", "Market"),
     CommandSpec("/provider status", "Tampilkan status provider aktif.", "/provider status", "Provider"),
@@ -52,8 +58,8 @@ COMMANDS: tuple[CommandSpec, ...] = (
     CommandSpec("/provider key status", "Tampilkan status API key market provider.", "/provider key status", "Provider"),
     CommandSpec("/cache stats", "Tampilkan statistik cache market persistent.", "/cache stats", "System"),
     CommandSpec("/cache clear", "Bersihkan runtime dan persistent market cache.", "/cache clear", "System"),
-    CommandSpec("/export journal", "Export journal. Phase 1 menyiapkan command.", "/export journal", "Export"),
-    CommandSpec("/export portfolio", "Export portfolio. Phase 1 menyiapkan command.", "/export portfolio", "Export"),
+    CommandSpec("/export journal", "Export journal ke CSV/JSON.", "/export journal csv journal.csv", "Export"),
+    CommandSpec("/export portfolio", "Export portfolio ke CSV/JSON.", "/export portfolio json portfolio.json", "Export"),
     CommandSpec("/clear", "Bersihkan output terminal.", "/clear"),
     CommandSpec("/exit", "Keluar dari aplikasi.", "/exit"),
 )

package/fincli/app/cli/router.py

@@ -6,16 +6,19 @@ import asyncio
 from concurrent.futures import ThreadPoolExecutor
 from dataclasses import dataclass
 from datetime import date
+import io
 import os
 import shlex
 from typing import Any
 
+from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 
 from fincli.app.cli.commands import CommandRegistry
 from fincli.app.analysis.analyzer import build_market_analysis_prompt, build_technical_ai_summary
 from fincli.app.analysis.assistant_context import (
+    build_web_research_answer_prompt,
     build_fincli_assistant_prompt,
     coding_refusal,
     extract_market_symbols,
@@ -37,6 +40,7 @@ from fincli.app.modules.journal_analytics import JournalStats, build_journal_rev
 from fincli.app.modules.journal import JournalService
 from fincli.app.modules.portfolio import PortfolioService
 from fincli.app.modules.scanner import ScanResult, scan_symbols
+from fincli.app.modules.session_history import SessionHistoryService
 from fincli.app.modules.transactions import TransactionService
 from fincli.app.modules.watchlist import WatchlistService
 from fincli.app.providers.ai.base import AIRequest, AIResponse, BaseAIProvider
@@ -46,12 +50,19 @@ from fincli.app.providers.market.manager import MarketProviderManager
 from fincli.app.providers.market.yfinance_provider import YahooTable, YFinanceProvider
 from fincli.app.services.market_data import MarketDataService
 from fincli.app.services.market_overview import MarketOverview, build_market_overview
+from fincli.app.services.web_research import (
+    WebResearchService,
+    WebSearchResult,
+    build_web_research_context,
+    should_use_web_research,
+)
 from fincli.app.storage.cache import TTLCache
 from fincli.app.storage.config import ConfigManager
 from fincli.app.storage.database import FinCLIDatabase
 from fincli.app.storage.market_cache import MarketCache
 from fincli.app.storage.secrets import save_secret
 from fincli.app.utils.errors import CommandError, FinCLIError
+from fincli.app.utils.formatting import AIResponseView, MarkdownBlock
 
 
 @dataclass(slots=True)
@@ -86,8 +97,16 @@ class CommandRouter:
         self.portfolio = PortfolioService(self.db)
         self.transactions = TransactionService(self.db, self.portfolio)
         self.journal = JournalService(self.db)
+        self.history = SessionHistoryService(self.db)
+        self.session_id = self.history.start_session()
+        self.web_research = WebResearchService()
 
     def route(self, raw: str) -> CommandResult:
+        result = self._route(raw)
+        self._record_history(raw, result)
+        return result
+
+    def _route(self, raw: str) -> CommandResult:
         raw = raw.strip()
         if not raw:
             return CommandResult(Panel("Ketik /help untuk melihat command.", title="FinCLI"))
@@ -117,6 +136,8 @@ class CommandRouter:
                 return CommandResult("Keluar dari FinCLI.", should_exit=True)
             if root == "/config":
                 return CommandResult(self._config_panel())
+            if root == "/history":
+                return self._history(args)
             if root == "/ai_model":
                 return self._ai_model(args)
             if root == "/news_model":
@@ -133,8 +154,8 @@ class CommandRouter:
                 return self._tx(args)
             if root == "/journal":
                 return self._journal(args)
-            if root in {"/price", "/quote"}:
-                return self._price(args)
+            if root == "/quote":
+                return self._quote(args)
             if root == "/market":
                 return self._market(args)
             if root == "/technical":
@@ -143,6 +164,8 @@ class CommandRouter:
                 return self._structure(args)
             if root == "/news":
                 return self._news(args)
+            if root == "/web":
+                return self._web(args)
             if root == "/funda":
                 return self._fundamentals(args)
             if root == "/yahoo":
@@ -180,6 +203,57 @@ class CommandRouter:
             table.add_row(command.name, command.group, command.description, command.example)
         return table
 
+    def _record_history(self, raw: str, result: CommandResult) -> None:
+        normalized = raw.strip().lower()
+        if not normalized or normalized.startswith("/history"):
+            return
+        try:
+            preview = _render_history_preview(result.renderable)
+            self.history.record_event(self.session_id, raw, result.status, preview)
+        except FinCLIError:
+            return
+
+    def _history(self, args: list[str]) -> CommandResult:
+        action = args[0].lower() if args else "current"
+        if action in {"current", "show"}:
+            session_id = self.session_id if action == "current" or len(args) == 1 else args[1]
+            if action == "show" and len(args) < 2:
+                raise CommandError("Format: /history show <session_id>")
+            session = self.history.get_session(session_id)
+            if not session:
+                raise CommandError(f"Session tidak ditemukan: {session_id}")
+            events = self.history.get_events(session_id)
+            return CommandResult(_format_session_events(session, events, current=session_id == self.session_id))
+        if action in {"sessions", "list"}:
+            sessions = self.history.list_sessions()
+            return CommandResult(_format_sessions(sessions, self.session_id))
+        if action == "save":
+            title = " ".join(args[1:]).strip()
+            if not title:
+                raise CommandError("Format: /history save <session_title>")
+            self.history.save_session(self.session_id, title)
+            return CommandResult(Panel(f"Current session disimpan sebagai: {title}", title="History", border_style="green"))
+        if action == "delete":
+            if len(args) < 2:
+                raise CommandError("Format: /history delete <session_id>")
+            if args[1] == self.session_id:
+                self.history.clear_events(self.session_id)
+                self.history.save_session(self.session_id, "FinCLI session")
+                return CommandResult(Panel("Current session dikosongkan.", title="History", border_style="yellow"))
+            self.history.delete_session(args[1])
+            return CommandResult(Panel(f"Session dihapus: {args[1]}", title="History", border_style="green"))
+        if action == "clear":
+            target = args[1].lower() if len(args) >= 2 else "current"
+            if target == "all":
+                self.history.clear_all()
+                self.session_id = self.history.start_session()
+                return CommandResult(Panel("Semua history session dihapus. Session baru dibuat.", title="History"))
+            self.history.clear_events(self.session_id)
+            return CommandResult(Panel("Current session history dikosongkan.", title="History"))
+        raise CommandError(
+            "Format: /history [current|sessions|show <id>|save <title>|delete <id>|clear current|clear all]"
+        )
+
     def _dashboard(self) -> Table:
         return _format_dashboard(
             provider_chain=[provider.name for provider in self.market_service.providers],
@@ -220,11 +294,16 @@ class CommandRouter:
             if info is None:
                 raise CommandError(f"AI provider tidak dikenal: {provider}")
             save_secret(info.env_key, args[2])
-            if self.config.settings.ai_provider == provider:
-                self.ai_provider = AIProviderManager().create(provider)
+            model = self.config.settings.ai_model if self.config.settings.ai_provider == provider else info.default_model
+            self.config.set_ai_model(provider, model)
+            self.ai_provider = AIProviderManager().create(provider)
             return CommandResult(
                 Panel(
-                    f"API key AI untuk {provider} disimpan di ~/.fincli/secrets.env.\nKey tidak ditampilkan di terminal.",
+                    (
+                        f"API key AI untuk {provider} disimpan global di ~/.fincli/secrets.env.\n"
+                        f"Provider aktif disimpan: {provider} / {model}.\n"
+                        "Key tidak ditampilkan di terminal dan dipakai lintas session."
+                    ),
                     title="AI API Key Saved",
                     border_style="green",
                 )
@@ -260,13 +339,17 @@ class CommandRouter:
             save_secret(env_keys[0], args[2])
             if provider == "custom" and len(args) >= 4:
                 save_secret("MARKET_DATA_BASE_URL", args[3])
+            self.config.set_market_provider_priority([provider, *self._priority_tail(provider)])
             self._refresh_market_service()
             self.cache.clear()
             extra = "\nBase URL custom juga disimpan." if provider == "custom" and len(args) >= 4 else ""
             return CommandResult(
                 Panel(
-                    f"API key market/news untuk {provider} disimpan di ~/.fincli/secrets.env.{extra}\n"
-                    "Key tidak ditampilkan di terminal.",
+                    (
+                        f"API key market/news untuk {provider} disimpan global di ~/.fincli/secrets.env.{extra}\n"
+                        f"Provider market/news aktif disimpan: {provider}.\n"
+                        "Key tidak ditampilkan di terminal dan dipakai lintas session."
+                    ),
                     title="Market API Key Saved",
                     border_style="green",
                 )
@@ -481,7 +564,9 @@ class CommandRouter:
             response = self._run_async(self.ai_provider.complete(AIRequest(prompt=prompt, model=self.config.settings.ai_model)))
             if not isinstance(response, AIResponse):
                 raise CommandError("AI provider mengembalikan data tidak valid.")
-            return CommandResult(f"Journal Review\n{_format_ai_response(response)}\n\nDisclaimer: bukan nasihat keuangan.")
+            return CommandResult(
+                MarkdownBlock("Journal Review", _format_ai_response(response), "Disclaimer: bukan nasihat keuangan.")
+            )
 
         if args[0].lower() == "add":
             if len(args) < 3:
@@ -511,9 +596,9 @@ class CommandRouter:
             table.add_row("-", "-", "-", 'Belum ada journal. Gunakan /journal add BTC-USD bullish "Alasan entry"', "-")
         return table
 
-    def _price(self, args: list[str]) -> CommandResult:
+    def _quote(self, args: list[str]) -> CommandResult:
         if not args:
-            raise CommandError("Format: /price <symbol>")
+            raise CommandError("Format: /quote <symbol>")
         symbol = args[0].upper()
         cache_key = f"quote:{symbol}"
         cached = self.cache.get(cache_key)
@@ -595,6 +680,9 @@ class CommandRouter:
             return CommandResult(_format_ai_response(response))
 
         market_context = self._freechat_market_context(prompt)
+        web_context = self._freechat_web_context(prompt)
+        if web_context:
+            market_context = f"{market_context}\n\n{web_context}".strip()
         assistant_prompt = build_fincli_assistant_prompt(prompt, market_context)
         request = AIRequest(prompt=assistant_prompt, model=self.config.settings.ai_model)
         response = self._run_async(self.ai_provider.complete(request))
@@ -602,6 +690,26 @@ class CommandRouter:
             raise CommandError("AI provider mengembalikan data tidak valid.")
         return CommandResult(_format_ai_response(response))
 
+    def _web(self, args: list[str]) -> CommandResult:
+        if not args:
+            raise CommandError("Format: /web <query>")
+        if args[0].lower() in {"sources", "source", "raw"}:
+            source_query = " ".join(args[1:]).strip()
+            if not source_query:
+                raise CommandError("Format: /web sources <query>")
+            results = self._run_async(self.web_research.research(source_query, limit=5))
+            return CommandResult(_format_web_results(source_query, results))
+
+        query = " ".join(args)
+        results = self._run_async(self.web_research.research(query, limit=5))
+        context = build_web_research_context(results)
+        assistant_prompt = build_web_research_answer_prompt(query, context)
+        request = AIRequest(prompt=assistant_prompt, model=self.config.settings.ai_model)
+        response = self._run_async(self.ai_provider.complete(request))
+        if not isinstance(response, AIResponse):
+            raise CommandError("AI provider mengembalikan data tidak valid.")
+        return CommandResult(_format_ai_response(response))
+
     def _analyze(self, args: list[str]) -> CommandResult:
         if not args:
             raise CommandError("Format: /analyze <symbol> [timeframe]")
@@ -618,7 +726,9 @@ class CommandRouter:
         response = self._run_async(self.ai_provider.complete(request))
         if not isinstance(response, AIResponse):
             raise CommandError("AI provider mengembalikan data tidak valid.")
-        return CommandResult(f"AI Market Analysis: {symbol}\n{_format_ai_response(response)}\n\nDisclaimer: bukan nasihat keuangan.")
+        return CommandResult(
+            MarkdownBlock(f"AI Market Analysis: {symbol}", _format_ai_response(response), "Disclaimer: bukan nasihat keuangan.")
+        )
 
     def _scan(self, args: list[str]) -> CommandResult:
         if not args or args[0].lower() != "watchlist":
@@ -757,6 +867,21 @@ class CommandRouter:
             sections.append(self._symbol_freechat_context(symbol))
         return "\n\n".join(sections)
 
+    def _freechat_web_context(self, prompt: str) -> str:
+        if not should_use_web_research(prompt):
+            return ""
+        cache_key = f"web:{prompt.lower()[:180]}"
+        cached = self.cache.get(cache_key)
+        if isinstance(cached, str):
+            return cached
+        try:
+            results = self._run_async(self.web_research.research(prompt, limit=3))
+        except FinCLIError as exc:
+            return f"Web Research: unavailable ({exc})"
+        context = build_web_research_context(results)
+        self.cache.set(cache_key, context)
+        return context
+
     def _symbol_freechat_context(self, symbol: str) -> str:
         lines = [f"Symbol: {symbol}"]
         try:
@@ -879,6 +1004,63 @@ def _format_quote(quote: Quote) -> str:
     )
 
 
+def _format_sessions(sessions: list[dict[str, object]], current_session_id: str) -> Table:
+    table = Table(title="FinCLI Sessions", expand=True)
+    table.add_column("Current", justify="center", width=7)
+    table.add_column("Session ID", style="cyan", no_wrap=True)
+    table.add_column("Title", style="white")
+    table.add_column("Events", justify="right")
+    table.add_column("Updated", style="dim")
+    for session in sessions:
+        session_id = str(session["id"])
+        table.add_row(
+            "*" if session_id == current_session_id else "",
+            session_id,
+            str(session["title"]),
+            str(session["event_count"]),
+            str(session["updated_at"]),
+        )
+    if not sessions:
+        table.add_row("-", "-", "Belum ada session.", "0", "-")
+    table.caption = "/history current | /history show <session_id> | /history delete <session_id>"
+    return table
+
+
+def _format_session_events(session: dict[str, object], events: list[dict[str, object]], current: bool = False) -> Table:
+    marker = "current" if current else "saved"
+    table = Table(title=f"Session {session['id']} ({marker}) - {session['title']}", expand=True)
+    table.add_column("#", justify="right", width=4)
+    table.add_column("Time", style="dim", no_wrap=True)
+    table.add_column("Status", style="cyan", no_wrap=True)
+    table.add_column("Command", style="white")
+    table.add_column("Output Preview", style="dim")
+    for event in events:
+        table.add_row(
+            str(event["id"]),
+            str(event["created_at"]),
+            str(event["status"]),
+            str(event["command"]),
+            str(event["output_preview"] or "")[:180],
+        )
+    if not events:
+        table.add_row("-", "-", "-", "Belum ada command di session ini.", "")
+    table.caption = "/history sessions | /history save <title> | /history clear current"
+    return table
+
+
+def _render_history_preview(renderable: Any) -> str:
+    if renderable is None:
+        return ""
+    if isinstance(renderable, str):
+        return renderable[:1200]
+    console = Console(width=100, record=True, force_terminal=False, file=io.StringIO())
+    try:
+        console.print(renderable)
+        return console.export_text(clear=False).strip()[:1200]
+    except Exception:
+        return str(renderable)[:1200]
+
+
 def _format_dashboard(
     provider_chain: list[str],
     watchlist_rows: list[dict[str, object]],
@@ -1218,6 +1400,21 @@ def _format_news(symbol: str, items: list[NewsItem]) -> str:
     return "\n".join(lines)
 
 
+def _format_web_results(query: str, results: list[WebSearchResult]) -> Table:
+    table = Table(title=f"Web Research: {query}", expand=True)
+    table.add_column("#", justify="right", width=3)
+    table.add_column("Title", style="cyan", overflow="fold")
+    table.add_column("Snippet / Extract", overflow="fold")
+    table.add_column("URL", style="dim", overflow="fold")
+    for index, result in enumerate(results, start=1):
+        extract = result.content[:500] if result.content else result.snippet
+        table.add_row(str(index), result.title, extract or "-", result.url)
+    if not results:
+        table.add_row("-", "No results", "Search providers returned no public context.", "-")
+    table.caption = "Web context is public web data; verify source quality before using it for financial decisions."
+    return table
+
+
 def _format_fundamentals(snapshot: FundamentalSnapshot) -> str:
     return (
         f"Fundamental Snapshot: {snapshot.symbol}\n"
@@ -1277,12 +1474,8 @@ def _format_fundamental_context(snapshot: FundamentalSnapshot) -> str:
     )
 
 
-def _format_ai_response(response: AIResponse) -> str:
-    return (
-        f"Provider: {response.provider}\n"
-        f"Model: {response.model}\n"
-        f"Response:\n{response.content}"
-    )
+def _format_ai_response(response: AIResponse) -> AIResponseView:
+    return AIResponseView(response)
 
 
 def _fmt(value: float | None) -> str:
@@ -1300,5 +1493,5 @@ class UnavailableAIProvider:
     async def complete(self, request: AIRequest) -> AIResponse:
         raise CommandError(
             f"AI provider {self.name} belum siap dipakai.",
-            "Set API key di .env dan gunakan provider client Phase 2 lanjutan, atau injeksi provider untuk testing.",
+            "Gunakan /ai_model untuk memilih provider dan /ai_model key <provider> <api_key> untuk menyimpan API key.",
         )