Formalise the docs and code

Author: Shashikant86

examples/demo_semantic_search.py

@@ -85,14 +85,9 @@ Hard queries that neither method handles well. Many are abbreviations, cross-dom
 Requires the action_search Lambda running locally:
 
 ```bash
-# Terminal 1: Start the Lambda
-cd ai-generation/apps/action_search
-cp .env.example .env
-# Edit .env: set USE_LOCAL_STORE=false and TURBOPUFFER_API_KEY=tpuf_xxx
-make run-local
+# Terminal 1: Start the local action_search Lambda
 
 # Terminal 2: Run benchmark
-cd stackone-ai-python
 uv run python tests/benchmark_search.py --local
 ```
 

tests/BENCHMARK_RESULTS.md

@@ -9,9 +9,8 @@
 Run with production API:
     STACKONE_API_KEY=xxx python tests/benchmark_search.py
 
-Run with local Lambda (ai-generation/apps/action_search):
-    # First, start the local Lambda:
-    #   cd ai-generation/apps/action_search && make run-local
+Run with local Lambda:
+    # First, start the local action_search Lambda
     # Then run benchmark:
     python tests/benchmark_search.py --local
 
@@ -33,7 +32,7 @@
 from stackone_ai.semantic_search import SemanticSearchClient, SemanticSearchResponse, SemanticSearchResult
 from stackone_ai.utility_tools import ToolIndex
 
-# Default local Lambda URL (from ai-generation/apps/action_search docker-compose)
+# Default local Lambda URL
 DEFAULT_LOCAL_LAMBDA_URL = "http://localhost:4513/2015-03-31/functions/function/invocations"
 
 
@@ -51,13 +50,8 @@ def search(
 class LocalLambdaSearchClient:
     """Client for local action_search Lambda.
 
-    This client connects to the local Lambda running via docker-compose
-    from ai-generation/apps/action_search.
-
     Usage:
-        # Start local Lambda first:
-        #   cd ai-generation/apps/action_search && make run-local
-
+        # Start the local action_search Lambda first
         client = LocalLambdaSearchClient()
         response = client.search("create employee", connector="bamboohr", top_k=5)
     """
@@ -214,7 +208,6 @@ class EvaluationTask:
 
 
 # 103 semantically-challenging evaluation queries
-# Ported from ai-generation/apps/action_search/tests/benchmark.integration.spec.ts
 EVALUATION_TASKS: list[EvaluationTask] = [
     # ============ ALL CONNECTORS - SEMANTIC CHALLENGES ============
     # HR/HRIS - Natural language
@@ -1212,7 +1205,7 @@ def main() -> None:
   # Run with production API
   STACKONE_API_KEY=xxx python tests/benchmark_search.py
 
-  # Run with local Lambda (start it first: cd ai-generation/apps/action_search && make run-local)
+  # Run with local Lambda (start the local action_search Lambda first)
   python tests/benchmark_search.py --local
 
   # Run with custom local Lambda URL