Merge final-refactor: full framework refactor with MemoryAgent v2, research agents, 53 agents verified

.env.example

@@ -1,183 +1,32 @@
-# Auto-generated .env.example from backup
-# Values intentionally blank.
+# =============================================================================
+# Haive Framework - Environment Configuration
+# =============================================================================
+# Copy this file to .env and fill in your values.
 
-AI21_API_KEY=
-ALCHEMY_API_KEY=
-ALPHAVANTAGE_API_KEY=
-AMADEUS_CLIENT_ID=
-AMADEUS_CLIENT_SECRET=
-ANTHROPIC_API_KEY=
-APIFY_API_TOKEN=
-APP_ENV=
-ASKNEWS_CLIENT_ID=
-ASKNEWS_CLIENT_SECRET=
-AWS_ACCESS_KEY_ID=
-AWS_DEFAULT_REGION=
-AWS_ENDPOINT_URL=
-AWS_SECRET_ACCESS_KEY=
-AZURE_AI_SERVICES_ENDPOINT=
-AZURE_AI_SERVICES_KEY=
-AZURE_AI_SERVICES_REGION=
-AZURE_CLIENT_ID=
-AZURE_DEPLOYMENT_NAME=
-AZURE_OBJECT_ID=
-AZURE_OPENAI_API_BASE=
-AZURE_OPENAI_API_KEY=
-AZURE_OPENAI_API_VERSION=
-AZURE_OPENAI_ENDPOINT=
-AZURE_SECRET_ID=
-AZURE_TENANT_ID=
-BING_SEARCH_URL=
-BING_SUPERVISION_KEY=
-BRAVE_SEARCH_API_KEY=
-CLICKUP_API_KEY=
-CLICKUP_CLIENT_ID=
-CLICKUP_CLIENT_SECRET=
-CLICKUP_REDIRECT_URI=
-CLOUDFLARE_ACCOUNT_ID=
-CLOUDFLARE_API_TOKEN=
-CLOUDFLARE_R2_BUCKET=
-CLOUDFLARE_R2_ENDPOINT=
-DATAFORSEO_LOGIN=
-DATAFORSEO_PASSWORD=
-DEBUG=
-DEEPL_API_KEY=
-DEEPSEEK_API_KEY=
-DISCORD_APPLICATION_ID=
-DISCORD_BOT_TOKEN=
-DISCORD_CLIENT_ID=
-DISCORD_PUBLIC_KEY=
-DOCS_PACKAGES_BASE_URL=
-DOCS_PUBLIC_BASE_URL=
-DOCS_ROOT_URL=
-DROPBOX_ACCESS_TOKEN=
-DROPBOX_APP_KEY=
-DROPBOX_APP_SECRET=
-DROPBOX_FOLDER_PATH=
-ELEVENLABS_API_KEY=
-EMBEDDINGS_API_ENDPOINT=
-EMBEDDINGS_API_KEY=
-EMBEDDINGS_API_REGION=
-EMBEDDINGS_API_VERSION=
-ETHERSCAN_API_KEY=
-FIGMA_ACCESS_TOKEN=
-FINANCIAL_DATASETS_API_KEY=
-FIREWORKS_AI_API_KEY=
-GITHUB_ACCESS_TOKEN=
-GITHUB_APP_ID=
-GITHUB_APP_PRIVATE_KEY=
-GITHUB_BASE_BRANCH=
-GITHUB_BASE_URL=
-GITHUB_BRANCH=
-GITHUB_ORG=
-GITHUB_REPOSITORY=
-GMAIL_API_KEY=
-GMAIL_CLIENT_ID=
-GMAIL_CLIENT_SECRET=
-GOOGLE_API_KEY=
-GOOGLE_BOOKS_API_KEY=
-GOOGLE_CSE_ID=
-GPLACES_API_KEY=
-GROQ_API_KEY=
-HAIVE_AGENTS_DOCS_URL=
-HAIVE_AGENTS_REPO_URL=
-HAIVE_CORE_DOCS_URL=
-HAIVE_CORE_REPO_URL=
-HAIVE_DATAFLOW_DOCS_URL=
-HAIVE_DATAFLOW_REPO_URL=
-HAIVE_GAMES_DOCS_URL=
-HAIVE_GAMES_REPO_URL=
-HAIVE_HAP_DOCS_URL=
-HAIVE_HAP_REPO_URL=
-HAIVE_MCP_DOCS_URL=
-HAIVE_MCP_REPO_URL=
-HAIVE_PREBUILT_DOCS_URL=
-HAIVE_PREBUILT_REPO_URL=
-HAIVE_TOOLS_DOCS_URL=
-HAIVE_TOOLS_REPO_URL=
-HF_TOKEN=
-JIRA_API_KEY=
-JIRA_BASE_URL=
-JIRA_ISSUE_TYPE=
-JIRA_PROJECT_KEY=
-MERRIAM_WEBSTER_API_KEY=
-MISTRAL_API_KEY=
-MONGO_URI=
-NEO4J_DATABASE=
-NEO4J_PASSWORD=
-NEO4J_URI=
-NEO4J_USER=
-NEWSAPI_KEY=
-NOTION_API_KEY=
-OCR_AGENT=
-OPENAI_API_KEY=
-OPENAI_API_TYPE=
-OPENAI_API_VERSION=
-OPENWEATHERMAP_API_KEY=
-OUTLINE_API_KEY=
-OUTLINE_INSTANCE_URL=
-PEFT_AVAILABLE=
-PERPLEXITY_API_KEY=
-PINECONE=
-POLYGON_API_KEY=
-POSTGRES_CONNECTION_STRING=
-REDDIT_CLIENT_ID=
-REDDIT_CLIENT_SECRET=
-REDDIT_USER_AGENT=
-SALESFORCE_DOMAIN=
-SALESFORCE_PASSWORD=
-SALESFORCE_SECURITY_TOKEN=
-SALESFORCE_USERNAME=
-SCENEX_API_KEY=
-SECRET_KEY=
-SERPAPI_API_KEY=
-SERP_API_KEY=
-SLACK_USER_TOKEN=
-SPOONACULAR_API_KEY=
-STEAM_ID=
-STEAM_KEY=
-STRIPE_SECRET_KEY=
-SUPABASE_ANON_KEY=
-SUPABASE_DATABASE_URI=
-SUPABASE_DATABASE_URI_SSL=
-SUPABASE_DATABASE_URL=
-SUPABASE_DBNAME=
-SUPABASE_HOST=
-SUPABASE_KEY=
-SUPABASE_PASSWORD=
-SUPABASE_PORT=
-SUPABASE_PROJECT_URL=
-SUPABASE_SERVICE_KEY=
-SUPABASE_URL=
-SUPABASE_USER=
-TAVILY_API_KEY=
-TWILIO_ACCOUNT_SID=
-TWILIO_AUTH_TOKEN=
-TWILIO_FROM_NUMBER=
-TWILIO_TO_NUMBER=
-TWITTER_ACCESS_TOKEN=
-TWITTER_ACCESS_TOKEN_SECRET=
-TWITTER_API_KEY=
-TWITTER_API_SECRET=
-TWITTER_BEARER_TOKEN=
-WOLFRAM_ALPHA_APPID=
-_T=
-__all__=
-__slots__=
-doc=
-error_msg=
-file_path=
-file_paths=
-found_secrets_file=
-msg=
-path=
-secrets=
-secrets_dirs=
-secrets_file_str=
-secrets_paths=
-stacklevel=
-sub_folder_path=
-sub_secrets=
-value=
-value_type=
-watcher_type=
+# -- LangSmith (Observability & Tracing) --------------------------------------
+LANGSMITH_TRACING=true
+LANGSMITH_API_KEY=your-langsmith-api-key
+LANGSMITH_PROJECT=haive
+LANGSMITH_ENDPOINT=https://api.smith.langchain.com
+
+# -- LLM Provider Keys --------------------------------------------------------
+OPENAI_API_KEY=your-openai-api-key
+ANTHROPIC_API_KEY=your-anthropic-api-key
+
+# Azure OpenAI (optional)
+AZURE_OPENAI_API_KEY=your-azure-api-key
+AZURE_OPENAI_ENDPOINT=your-azure-endpoint
+AZURE_OPENAI_API_VERSION=2024-02-01
+
+# Google (optional)
+GOOGLE_API_KEY=your-google-api-key
+
+# -- LangGraph Platform (for remote deployment) --------------------------------
+LANGGRAPH_API_URL=http://localhost:8123
+
+# -- PostgreSQL Persistence (optional) ----------------------------------------
+# DB_HOST=localhost
+# DB_PORT=5432
+# DB_NAME=haive
+# DB_USER=postgres
+# DB_PASS=postgres

.github/workflows/publish.yml

@@ -1,5 +1,5 @@
 ---
-name: 🚀 Publish Release
+name: Publish Release
 on:
   release:
     types: [published]
@@ -9,57 +9,124 @@ permissions:
 concurrency:
   group: release-${{ github.ref }}
   cancel-in-progress: true
+
 jobs:
-  publish:
-    name: 📦 Publish ${{ matrix.package }}
+  # Phase 1: Publish haive-core first (no dependencies)
+  publish-core:
+    name: Publish haive-core
+    runs-on: ubuntu-latest
+    env:
+      ACTIONS_STEP_DEBUG: ${{ secrets.ACTIONS_DEBUG || 'false' }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+          token: ${{ secrets.GH_TOKEN }}
+      - name: Get Package Poetry Info
+        id: poetry
+        uses: ./.github/actions/get-package-poetry-info
+        with:
+          package: haive-core
+      - name: Set up Python ${{ steps.poetry.outputs.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ steps.poetry.outputs.python }}
+          cache: poetry
+      - name: Install Poetry
+        run: pipx install poetry==2.1.0
+      - name: Configure PyPI Credentials
+        run: poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }}
+      - name: Build and Publish haive-core
+        run: |
+          cd packages/haive-core
+          poetry build --format wheel
+          poetry publish --skip-existing
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: haive-core-dist
+          path: packages/haive-core/dist/
+
+  # Phase 2: Publish haive-agents (depends on haive-core)
+  publish-agents:
+    name: Publish haive-agents
+    needs: publish-core
+    runs-on: ubuntu-latest
+    env:
+      ACTIONS_STEP_DEBUG: ${{ secrets.ACTIONS_DEBUG || 'false' }}
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+          token: ${{ secrets.GH_TOKEN }}
+      - name: Get Package Poetry Info
+        id: poetry
+        uses: ./.github/actions/get-package-poetry-info
+        with:
+          package: haive-agents
+      - name: Set up Python ${{ steps.poetry.outputs.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ steps.poetry.outputs.python }}
+          cache: poetry
+      - name: Install Poetry
+        run: pipx install poetry==2.1.0
+      - name: Configure PyPI Credentials
+        run: poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }}
+      - name: Build and Publish haive-agents
+        run: |
+          cd packages/haive-agents
+          poetry build --format wheel
+          poetry publish --skip-existing
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: haive-agents-dist
+          path: packages/haive-agents/dist/
+
+  # Phase 3: Publish remaining packages in parallel (depend on haive-agents)
+  publish-remaining:
+    name: Publish ${{ matrix.package }}
+    needs: publish-agents
     runs-on: ubuntu-latest
     env:
       ACTIONS_STEP_DEBUG: ${{ secrets.ACTIONS_DEBUG || 'false' }}
     strategy:
+      fail-fast: false
       matrix:
         package:
-          - haive-core
-          - haive-agents
           - haive-games
           - haive-tools
           - haive-prebuilt
           - haive-dataflow
     steps:
-      - name: 📥 Checkout Code
+      - name: Checkout Code
         uses: actions/checkout@v4
         with:
           submodules: true
           token: ${{ secrets.GH_TOKEN }}
-      - name: 📦 Get Package Poetry Info
+      - name: Get Package Poetry Info
         id: poetry
         uses: ./.github/actions/get-package-poetry-info
         with:
           package: ${{ matrix.package }}
-      - name: 🧾 Echo Package Metadata
-        run: |
-          echo "📦 Name:        ${{ steps.poetry.outputs.name }}"
-          echo "🔖 Version:     ${{ steps.poetry.outputs.version }}"
-          echo "🧑 Authors:     ${{ steps.poetry.outputs.authors || 'N/A' }}"
-          echo "📄 License:     ${{ steps.poetry.outputs.license || 'N/A' }}"
-          echo "📝 Description: ${{ steps.poetry.outputs.description || 'N/A' }}"
-          echo "🌐 Homepage:    ${{ steps.poetry.outputs.homepage || 'N/A' }}"
-          echo "🔗 Repository:  ${{ steps.poetry.outputs.repository || 'N/A' }}"
-          echo "📚 Docs:        ${{ steps.poetry.outputs.documentation || 'N/A' }}"
-          echo "🏷 Classifiers: ${{ steps.poetry.outputs.classifiers || 'N/A' }}"
-      - name: 🐍 Set up Python ${{ steps.poetry.outputs.python }}
+      - name: Set up Python ${{ steps.poetry.outputs.python }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ steps.poetry.outputs.python }}
           cache: poetry
-      - name: 🛠 Install Poetry
+      - name: Install Poetry
         run: pipx install poetry==2.1.0
-      - name: 🔐 Configure PyPI Credentials
+      - name: Configure PyPI Credentials
         run: poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }}
-      - name: 📦 Build Package (No Publish)
+      - name: Build and Publish ${{ matrix.package }}
         run: |
           cd packages/${{ matrix.package }}
           poetry build --format wheel
-      - name: 📤 Upload Package as Artifact
+          poetry publish --skip-existing
+      - name: Upload Artifact
         uses: actions/upload-artifact@v4
         with:
           name: ${{ matrix.package }}-dist