1"""
2TwelveData skill exports — script-mode skill.
3 
4Usage from a bash block:
5    python3 - <<'EOF'
6    import sys
7    sys.path.insert(0, "/data/workspace/skills/twelvedata")
8    from exports import twelvedata_price, twelvedata_time_series
9    print(twelvedata_price(symbol="AAPL"))
10    EOF
11 
12Imports from sidecar.proxy_client (NOT core.http_client) so this skill
13stays runnable without the agent platform's core/* modules on PYTHONPATH.
14"""
15import os
16 
17# Make sidecar/ importable when the script is invoked directly via
18# `python3 -c` from the agent's bash tool. /app is already on PYTHONPATH
19# inside the container (set by entrypoint.sh), so `from sidecar...` works
20# in production. The fallback covers local-dev runs from outside /app.
21try:
22    from sidecar.proxy_client import proxied_get
23except ImportError:
24    # Local dev / running outside the deployed image: fall back to
25    # core.http_client which is identical. Skill still works either way.
26    from core.http_client import proxied_get
27 
28API_KEY = os.environ.get("TWELVEDATA_API_KEY", "")
29BASE = "https://api.twelvedata.com"
30 
31 
32def _get(endpoint, params=None):
33    """Make a GET request to TwelveData API."""
34    if params is None:
35        params = {}
36    params["apikey"] = API_KEY
37    r = proxied_get(f"{BASE}/{endpoint}", params=params)
38    r.raise_for_status()
39    return r.json()
40 
41 
42def twelvedata_time_series(symbol, interval="1day", outputsize=30, start_date=None, end_date=None, prepost=False):
43    """Get OHLCV time series data."""
44    params = {"symbol": symbol, "interval": interval, "outputsize": outputsize}
45    if start_date:
46        params["start_date"] = start_date
47    if end_date:
48        params["end_date"] = end_date
49    if prepost:
50        params["prepost"] = "true"
51    return _get("time_series", params)
52 
53 
54def twelvedata_price(symbol, prepost=False):
55    """Get current price for a symbol."""
56    params = {"symbol": symbol}
57    if prepost:
58        params["prepost"] = "true"
59    return _get("price", params)
60 
61 
62def twelvedata_eod(symbol, date=None, prepost=False):
63    """Get end-of-day price."""
64    params = {"symbol": symbol}
65    if date:
66        params["date"] = date
67    if prepost:
68        params["prepost"] = "true"
69    return _get("eod", params)
70 
71 
72def twelvedata_quote(symbol, prepost=False):
73    """Get detailed quote (price, volume, 52w high/low, change %)."""
74    params = {"symbol": symbol}
75    if prepost:
76        params["prepost"] = "true"
77    return _get("quote", params)
78 
79 
80def twelvedata_quote_batch(symbols, prepost=False):
81    """Get quotes for multiple symbols. symbols: comma-separated string."""
82    params = {"symbol": symbols}
83    if prepost:
84        params["prepost"] = "true"
85    return _get("quote", params)
86 
87 
88def twelvedata_price_batch(symbols, prepost=False):
89    """Get prices for multiple symbols. symbols: comma-separated string."""
90    params = {"symbol": symbols}
91    if prepost:
92        params["prepost"] = "true"
93    return _get("price", params)
94 
95 
96def twelvedata_search(query):
97    """Search for symbols by name or ticker."""
98    return _get("symbol_search", {"symbol": query})
99 
100 
101def twelvedata_stocks(exchange=None, country=None):
102    """Get list of available stocks, optionally filtered."""
103    params = {}
104    if exchange:
105        params["exchange"] = exchange
106    if country:
107        params["country"] = country
108    return _get("stocks", params)
109 
110 
111def twelvedata_forex_pairs():
112    """Get all available forex pairs."""
113    return _get("forex_pairs")
114 
115 
116def twelvedata_exchanges():
117    """Get list of supported exchanges."""
118    return _get("exchanges")
119