Introduce langchain based interpreter for AFM

.github/workflows/langchain-interpreter.yml

@@ -0,0 +1,89 @@
+name: LangChain Interpreter CI
+
+on:
+  push:
+    branches: [main, dev]
+    paths:
+      - "langchain-interpreter/**"
+      - ".github/workflows/langchain-interpreter.yml"
+  pull_request:
+    branches: [main, dev]
+    paths:
+      - "langchain-interpreter/**"
+      - ".github/workflows/langchain-interpreter.yml"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: langchain-interpreter
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Lint with ruff
+        run: uv run ruff check .
+
+  docker:
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    permissions:
+      packages: write
+    defaults:
+      run:
+        working-directory: langchain-interpreter
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Determine image name
+        id: meta
+        env:
+          OWNER: ${{ github.repository_owner }}
+        run: |
+          # GHCR requires lowercase repository names
+          OWNER_LOWER=$(echo "$OWNER" | tr '[:upper:]' '[:lower:]')
+          echo "image_name=ghcr.io/$OWNER_LOWER/afm-langchain-interpreter" >> $GITHUB_OUTPUT
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: langchain-interpreter
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: |
+            ${{ steps.meta.outputs.image_name }}:latest
+            ${{ steps.meta.outputs.image_name }}:${{ github.sha }}
+          labels: |
+            org.opencontainers.image.source=https://github.com/${{ github.repository }}
+            org.opencontainers.image.revision=${{ github.sha }}
+            org.opencontainers.image.title=AFM LangChain Interpreter
+            org.opencontainers.image.licenses=Apache-2.0
+          annotations: |
+            index:org.opencontainers.image.source=https://github.com/${{ github.repository }}
+            index:org.opencontainers.image.licenses=Apache-2.0

.github/workflows/release-common.yml

@@ -28,7 +28,7 @@ on:
 
 env:
   # Allowed implementations - update this list when adding new implementations
-  ALLOWED_IMPLEMENTATIONS: ballerina-interpreter
+  ALLOWED_IMPLEMENTATIONS: ballerina-interpreter langchain-interpreter
 
 jobs:
   release:
@@ -84,6 +84,21 @@ jobs:
           bal build
           bal test
 
+      - name: Install uv
+        if: inputs.implementation == 'langchain-interpreter'
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build and test (Python)
+        if: inputs.implementation == 'langchain-interpreter'
+        env:
+          IMPLEMENTATION: ${{ inputs.implementation }}
+        working-directory: ${{ inputs.implementation }}
+        run: |
+          uv sync --dev
+          uv run pytest
+
       - name: Create release branch
         env:
           IMPLEMENTATION: ${{ inputs.implementation }}

.github/workflows/release.yml

@@ -9,6 +9,7 @@ on:
         type: choice
         options:
           - ballerina-interpreter
+          - langchain-interpreter
       branch:
         description: 'Branch to release from'
         required: false
@@ -49,12 +50,22 @@ jobs:
         env:
           IMPLEMENTATION: ${{ inputs.implementation }}
         run: |
-          # Read version from Ballerina.toml (first match is package version)
-          RELEASE_VERSION=$(grep '^version = ' "$IMPLEMENTATION/Ballerina.toml" | head -1 | sed 's/version = "\(.*\)"/\1/')
+          # Determine version file
+          if [ -f "$IMPLEMENTATION/Ballerina.toml" ]; then
+            VERSION_FILE="$IMPLEMENTATION/Ballerina.toml"
+          elif [ -f "$IMPLEMENTATION/pyproject.toml" ]; then
+            VERSION_FILE="$IMPLEMENTATION/pyproject.toml"
+          else
+            echo "::error::No version file found for implementation: $IMPLEMENTATION"
+            exit 1
+          fi
+
+          # Read version (first match is package version)
+          RELEASE_VERSION=$(grep '^version = ' "$VERSION_FILE" | head -1 | sed 's/version = "\(.*\)"/\1/')
 
           # Validate version format
           if [[ ! "$RELEASE_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-            echo "::error::Version in Ballerina.toml must be in format X.Y.Z, got: $RELEASE_VERSION"
+            echo "::error::Version in $VERSION_FILE must be in format X.Y.Z, got: $RELEASE_VERSION"
             exit 1
           fi
 
@@ -120,7 +131,14 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git pull origin "$BRANCH" --rebase
-          sed -i "s/^version = \".*\"/version = \"$NEXT_VERSION\"/" "$IMPLEMENTATION/Ballerina.toml"
-          git add "$IMPLEMENTATION/Ballerina.toml"
+          # Determine version file
+          if [ -f "$IMPLEMENTATION/Ballerina.toml" ]; then
+            VERSION_FILE="$IMPLEMENTATION/Ballerina.toml"
+          elif [ -f "$IMPLEMENTATION/pyproject.toml" ]; then
+            VERSION_FILE="$IMPLEMENTATION/pyproject.toml"
+          fi
+
+          sed -i "s/^version = \".*\"/version = \"$NEXT_VERSION\"/" "$VERSION_FILE"
+          git add "$VERSION_FILE"
           git commit -m "Bump $IMPLEMENTATION version to $NEXT_VERSION"
           git push origin "$BRANCH"

README.md

@@ -7,13 +7,14 @@ Reference implementations for [Agent-Flavored Markdown (AFM)](https://wso2.githu
 | Implementation | Language/Framework | Status |
 |----------------|-------------------|--------|
 | [ballerina-interpreter](./ballerina-interpreter) | Ballerina | Active |
-| langchain-interpreter | Python/LangChain | Planned |
+| [langchain-interpreter](./langchain-interpreter) | Python/LangChain | Active |
 
 ## Repository Structure
 
 ```
 reference-implementations-afm/
 ├── ballerina-interpreter/   # Ballerina-based AFM interpreter
+├── langchain-interpreter/   # LangChain-based AFM interpreter
 └── .github/workflows/       # CI/CD (path-filtered per implementation)
 ```
 

langchain-interpreter/.dockerignore

@@ -0,0 +1,12 @@
+.venv
+.git
+.github
+__pycache__
+*.pyc
+.pytest_cache
+.coverage
+htmlcov
+.env
+dist
+build
+*.egg-info