Merge branch 'main' into new-consensus

Author: dineshpinto

.dockerignore

@@ -0,0 +1,22 @@
+# Envs
+.venv
+.venv*/
+.env
+.env.*
+.ruff_cache
+.pytest_cache
+.vscode
+.DS_Store
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Other folders
+docs/
+examples/
+tests/

.env.example

@@ -57,7 +57,7 @@ AGENT__GEMINI_API_KEY="your_api_key"
 # --- Network Connection ---
 
 # Flare RPC endpoint URL.
-# ECOSYSTEM__WEB3_PROVIDER_URL=https://stylish-light-theorem.flare-mainnet.quiknode.pro/ext/bc/C/rpc
+ECOSYSTEM__WEB3_PROVIDER_URL=https://stylish-light-theorem.flare-mainnet.quiknode.pro/ext/bc/C/rpc
 # Example for Coston2 testnet:
 # ECOSYSTEM__WEB3_PROVIDER_URL=https://coston2-api.flare.network/ext/C/rpc
 
@@ -116,7 +116,7 @@ AGENT__GEMINI_API_KEY="your_api_key"
 # VECTOR_DB__QDRANT_URL=
 
 # Dimension of vectors to use.
-# VECTOR_DB__QDRANT_VECTOR_SIZE=768
+VECTOR_DB__QDRANT_VECTOR_SIZE=768
 
 # Batch size for upserting points to Qdrant.
 # VECTOR_DB__QDRANT_BATCH_SIZE=100
@@ -135,7 +135,7 @@ AGENT__GEMINI_API_KEY="your_api_key"
 # --- Graph Database ---
 
 # Connection URI for the Neo4j database.
-# GRAPH_DB__NEO4J_URI=neo4j://localhost:7687
+GRAPH_DB__NEO4J_URI=neo4j://localhost:7687
 
 # The name of the specific Neo4j database.
 # GRAPH_DB__NEO4J_DATABASE=neo4j
@@ -147,7 +147,7 @@ AGENT__GEMINI_API_KEY="your_api_key"
 # --- X ---
 
 # API key for X.
-# SOCIAL__X_API_KEY=
+SOCIAL__X_API_KEY="your_x_api_key"
 
 # API key secret for X.
 # SOCIAL__X_API_KEY_SECRET=
@@ -162,13 +162,34 @@ AGENT__GEMINI_API_KEY="your_api_key"
 
 # API key for Telegram.
 # SOCIAL__TELEGRAM_API_TOKEN=
+# SOCIAL__TELEGRAM_BOT_TOKEN=
+# SOCIAL__TELEGRAM_CHAT_ID=
+
+# --- discord ---
+
+#SOCIAL__DISCORD_BOT_TOKEN=
+#SOCIAL__DISCORD_GUILD_ID=
+#SOCIAL__DISCORD_CHANNEL_ID=
+
+# --- slack ---
+#SOCIAL__SLACK_BOT_TOKEN=
+#SOCIAL__SLACK_CHANNEL_ID=
+
+# --- farcaster ---
+# SOCIAL__FARCASTER_API_KEY=
+# SOCIAL__FARCASTER_API_URL=
+# SOCIAL__FARCASTER_SIGNER_UUID=
+
+# --- GITHUB ---
+# SOCIAL__GITHUB_TOKEN =
+# SOCIAL__GITHUB_REPO =
 
 # ==============================================================================
 #                      TRUSTED EXECUTION ENVIRONMENT (TEE)
 # ==============================================================================
 
 # Use a pregenerated attestation token for testing.
-# TEE__SIMULATE_ATTESTATION_TOKEN=true
+TEE__SIMULATE_ATTESTATION_TOKEN=true
 
 # ==============================================================================
 #                               DATA INGESTION
@@ -177,7 +198,7 @@ AGENT__GEMINI_API_KEY="your_api_key"
 # --- Ingestion Embedding ---
 
 # Target size for text chunks before embedding (in characters).
-# INGESTION__CHUNK_SIZE=5000
+INGESTION__CHUNK_SIZE=5000
 
 # Overlap between consecutive text chunks (in characters).
 # INGESTION__CHUNK_OVERLAP=500

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @dineshpinto

.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  # Enable version updates for uv
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      uv-all:
+        patterns:
+          - "*"
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      actions-all:
+        patterns:
+          - "*"

.github/workflows/lint.yml

@@ -6,6 +6,9 @@ on:
   pull_request:
     branches: ["main"]
 
+permissions:
+  contents: read
+
 jobs:
   lint:
     runs-on: "ubuntu-latest"
@@ -15,7 +18,7 @@ jobs:
 
       # Set up Python environment
       - name: Set up uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
         with:
           version: "latest"
 

.github/workflows/test.yml

@@ -6,6 +6,9 @@ on:
   pull_request:
     branches: ["main"]
 
+permissions:
+  contents: read
+
 jobs:
   test:
     runs-on: "ubuntu-latest"
@@ -27,14 +30,15 @@ jobs:
       SOCIAL__X_ACCESS_TOKEN_SECRET: "your_secret_twitter_key"
       SOCIAL__TELEGRAM_API_TOKEN: "your_secret_telegram_token"
       TEE__SIMULATE_ATTESTATION_TOKEN: true
+      INGESTION__CHUNK_SIZE: 5000
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       # Set up Python environment
       - name: Set up uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
         with:
           version: "latest"
 

.gitignore

@@ -8,8 +8,13 @@ wheels/
 
 # Virtual environments
 .venv
+.venv*/
 .env
 .ruff_cache
 .pytest_cache
 .vscode
-.DS_Store
+.DS_Store
+
+
+# sqlite
+*.db

Dockerfile

@@ -0,0 +1,27 @@
+# Add <builder-digest> in prod
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS builder
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=0
+WORKDIR /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --locked --no-install-project --all-extras --no-dev --no-editable
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --all-extras --no-dev --no-editable
+RUN rm -rf /root/.cache/uv /root/.cache/pip
+
+# Add <runtime-digest> in prod
+FROM python:3.12-slim-bookworm AS runtime
+
+ENV PIP_NO_CACHE_DIR=1 \
+    UV_PYTHON_DOWNLOADS=0
+RUN groupadd -r app && \
+    useradd -r -g app -d /nonexistent -s /usr/sbin/nologin app
+USER app
+WORKDIR /app
+COPY --from=builder --chown=app:app /app /app
+ENV PATH="/app/.venv/bin:$PATH"
+CMD ["/app/.venv/bin/flare-ai-kit"]

README.md

@@ -11,11 +11,11 @@ SDK for building **verifiable AI Agents** on Flare using Confidential Space.
 
 ## ✨ Features
 
-- **Verifiable Execution:** Run agent logic in a hardware-isolated Trusted Execution Environment (Confidential Space TDX TEEs).
-- **Consensus Engine:** Framework for multi-agent collaboration based on the [Consensus Learning](https://arxiv.org/abs/2402.16157) whitepaper.
-- **Agent Framework:** Build type-safe agents (PydanticAI) that interact with 200+ LLMs (Gemini, GPT etc.).
-- **Flare Integration:** Connect to core protocols ([FTSO](https://dev.flare.network/ftso/overview), [FDC](https://dev.flare.network/fdc/overview), [FAssets](https://dev.flare.network/fassets/overview)) and dApps ([Sceptre](http://sceptre.fi), [SparkDEX](https://sparkdex.ai), [Kinetic](https://kinetic.market) etc.).
-- **Social Intelligence:** Connectors & analytics for X, Telegram, and Farcaster.
+- **Verifiable Execution**: Run logic in hardware‑isolated TEEs - [GCP Confidential Space TDX](https://cloud.google.com/confidential-computing/confidential-space/docs/confidential-space-overview).
+- **Consensus Engine**: Multi‑agent [Consensus Learning](https://arxiv.org/abs/2402.16157) via [Google Agent2Agent](https://github.com/a2aproject/A2A) protocol.
+- **Strictly‑Typed Agents**: Build with [PydanticAI](https://ai.pydantic.dev) to enforce structured outputs across 200+ LLMs.
+- **Flare Protocol Integration**: [FTSO](https://dev.flare.network/ftso/overview), [FDC](https://dev.flare.network/fdc/overview), [FAssets](https://dev.flare.network/fassets/overview), plus ecosystem dApps like [Sceptre](http://sceptre.fi) and [SparkDEX](https://sparkdex.ai).
+- **Social Intelligence**: Analytics and connectors for X, Telegram, Farcaster.
 
 ## 🏗️ Architecture