sandbox connected and streaming

bin/deploy

@@ -3,9 +3,9 @@
 #REMOTE=northamerica-northeast2-docker.pkg.dev/dexorder-430504/dexorder
 REMOTE=${REMOTE:-git.dxod.org/dexorder/dexorder}
 
-if [ "$1" != "flink" ] && [ "$1" != "relay" ] && [ "$1" != "ingestor" ] && [ "$1" != "web" ] && [ "$1" != "gateway" ] && [ "$1" != "lifecycle-sidecar" ] && [ "$1" != "client-py" ]; then
+if [ "$1" != "flink" ] && [ "$1" != "relay" ] && [ "$1" != "ingestor" ] && [ "$1" != "web" ] && [ "$1" != "gateway" ] && [ "$1" != "lifecycle-sidecar" ] && [ "$1" != "sandbox" ]; then
   echo
-  echo usage: "$0 "'{flink|relay|ingestor|web|gateway|lifecycle-sidecar|client-py} [''dev''] [config] [deployment] [kubernetes] [image_tag]'
+  echo usage: "$0 "'{flink|relay|ingestor|web|gateway|lifecycle-sidecar|sandbox} [''dev''] [config] [deployment] [kubernetes] [image_tag]'
   echo
   echo '      [''dev''] if the literal string ''dev'' is not the second argument, then the build refuses to run if source code is not checked in. Otherwise, the git revision numbers are used in the image tag.'
   echo
@@ -100,6 +100,72 @@ if [ "$PROJECT" != "lifecycle-sidecar" ]; then
   rsync -a --checksum --delete protobuf/ $PROJECT/protobuf/
 fi
 
+# For gateway: copy Python API files for research subagent
+if [ "$PROJECT" == "gateway" ]; then
+  echo "Copying Python API files for research subagent..."
+
+  # Create api-source directory
+  mkdir -p gateway/src/harness/subagents/research/api-source
+
+  # Copy all Python API files (for easy future expansion)
+  cp sandbox/dexorder/api/*.py gateway/src/harness/subagents/research/api-source/
+
+  # Generate api-reference.md with verbatim Python source code
+  API_REF="gateway/src/harness/subagents/research/memory/api-reference.md"
+
+  cat > "$API_REF" << 'HEADER'
+# Dexorder Research API Reference
+
+This file contains the complete Python API source code with full docstrings.
+These files are copied verbatim from `sandbox/dexorder/api/`.
+
+The API provides access to market data and charting capabilities for research scripts.
+
+---
+
+## Overview
+
+Research scripts access the API via:
+```python
+from dexorder.api import get_api
+api = get_api()
+```
+
+The API instance provides:
+- `api.data` - DataAPI for fetching OHLC market data
+- `api.charting` - ChartingAPI for creating financial charts
+
+---
+
+## Complete API Source Code
+
+The following sections contain the verbatim Python source files with complete
+type hints, docstrings, and examples.
+
+HEADER
+
+  # Append each Python file
+  for py_file in api.py data_api.py charting_api.py __init__.py; do
+    if [ -f "sandbox/dexorder/api/$py_file" ]; then
+      echo "" >> "$API_REF"
+      echo "### $py_file" >> "$API_REF"
+      echo '```python' >> "$API_REF"
+      cat "sandbox/dexorder/api/$py_file" >> "$API_REF"
+      echo '```' >> "$API_REF"
+      echo "" >> "$API_REF"
+    fi
+  done
+
+  cat >> "$API_REF" << 'FOOTER'
+
+---
+
+For practical usage patterns and complete working examples, see `usage-examples.md`.
+FOOTER
+
+  echo "Generated api-reference.md with Python API source code"
+fi
+
 docker build $NO_CACHE -f $PROJECT/Dockerfile --build-arg="CONFIG=$CONFIG" --build-arg="DEPLOYMENT=$DEPLOYMENT" -t dexorder/ai-$PROJECT:latest $PROJECT || exit 1
 
 # Cleanup is handled by trap