herczyn
diff --git a/‎.devcontainer/README.md‎
Lines changed: 83 additions & 0 deletions b/‎.devcontainer/README.md‎
Lines changed: 83 additions & 0 deletions
diff --git a/‎.devcontainer/devcontainer.json‎
Lines changed: 33 additions & 0 deletions b/‎.devcontainer/devcontainer.json‎
Lines changed: 33 additions & 0 deletions
diff --git a/‎.devcontainer/setup.sh‎
Lines changed: 72 additions & 0 deletions b/‎.devcontainer/setup.sh‎
Lines changed: 72 additions & 0 deletions
diff --git a/‎.gitattributes‎
Lines changed: 1 addition & 1 deletion b/‎.gitattributes‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/actions/spelling/allow.txt‎
Lines changed: 28 additions & 0 deletions b/‎.github/actions/spelling/allow.txt‎
Lines changed: 28 additions & 0 deletions
diff --git a/‎.github/linters/.protolint.yaml‎
Lines changed: 4 additions & 0 deletions b/‎.github/linters/.protolint.yaml‎
Lines changed: 4 additions & 0 deletions
@@ -0,0 +1,83 @@
+# A2A Development Container
+
+This devcontainer provides a fully configured development environment for the A2A project with all required dependencies pre-installed.
+
+## What's Included
+
+### Build Tools
+
+- **protoc** (v28.3) - Protocol Buffers compiler
+- **protoc-gen-jsonschema** (bufbuild) - JSON Schema generator for protobuf
+- **jq** (latest) - JSON processor
+- **googleapis** - Google API proto definitions
+
+### Development Tools
+
+- **Python 3.12** with all documentation dependencies
+- **Go** (latest) - for protoc plugin compilation
+
+### VS Code Extensions
+
+- Python language support with Pylance
+- Buf for Protocol Buffers
+- Code Spell Checker
+
+## Usage
+
+### Opening in VS Code
+
+1. Install the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+2. Open this repository in VS Code
+3. When prompted, click "Reopen in Container" (or use Command Palette: "Dev Containers: Reopen in Container")
+4. Wait for the container to build and dependencies to install
+
+### Building Documentation
+
+Once inside the container:
+
+```bash
+# Build all documentation
+./scripts/build_docs.sh
+
+# Convert proto to JSON Schema only
+./scripts/proto_to_json_schema.sh specification/json/a2a.json
+```
+
+### GitHub Codespaces
+
+This devcontainer configuration also works with GitHub Codespaces:
+
+1. Go to the repository on GitHub
+2. Click "Code" → "Codespaces" → "Create codespace on [branch]"
+3. Wait for the environment to be provisioned
+
+## Benefits
+
+- **Reproducible builds**: Everyone uses the same tool versions
+- **No local setup**: No need to install protoc, jq, etc. on your host machine
+- **Quick onboarding**: New contributors can start developing immediately
+- **CI/CD alignment**: Same environment as CI can use similar container
+
+## Customization
+
+To modify the environment:
+
+- **Add tools**: Edit `.devcontainer/setup.sh`
+- **Change Python/Go versions**: Edit `features` in `devcontainer.json`
+- **Add VS Code extensions**: Edit `customizations.vscode.extensions` in `devcontainer.json`
+
+## Troubleshooting
+
+### Container build fails
+
+```bash
+# Rebuild without cache
+Dev Containers: Rebuild Container (without cache)
+```
+
+### Tools not found after setup
+
+```bash
+# Re-run setup script manually
+bash .devcontainer/setup.sh
+```
@@ -0,0 +1,33 @@
+{
+    "name": "A2A Development",
+    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
+    "features": {
+        "ghcr.io/devcontainers/features/python:1": {
+            "version": "3.12"
+        },
+        "ghcr.io/devcontainers/features/go:1": {
+            "version": "latest"
+        },
+        "ghcr.io/devcontainers/features/node:1": {
+            "version": "lts"
+        }
+    },
+    "postCreateCommand": "bash .devcontainer/setup.sh",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-python.python",
+                "ms-python.vscode-pylance",
+                "bufbuild.vscode-buf",
+                "streetsidesoftware.code-spell-checker"
+            ],
+            "settings": {
+                "python.defaultInterpreterPath": "/usr/local/bin/python"
+            }
+        }
+    },
+    "forwardPorts": [
+        8000
+    ],
+    "remoteUser": "vscode"
+}
@@ -0,0 +1,72 @@
+#!/bin/bash
+set -euo pipefail
+
+echo "==> Setting up A2A development environment..."
+
+# Install system dependencies
+echo "→ Installing system packages..."
+sudo apt-get update
+sudo apt-get install -y \
+  curl \
+  git \
+  jq \
+  unzip
+
+# Install Protocol Buffers compiler
+echo "→ Installing protoc..."
+PROTOC_VERSION="28.3"
+PROTOC_ZIP="protoc-${PROTOC_VERSION}-linux-x86_64.zip"
+curl -fsSL -o /tmp/protoc.zip "https://github.com/protocolbuffers/protobuf/releases/download/v${PROTOC_VERSION}/${PROTOC_ZIP}"
+sudo unzip -q /tmp/protoc.zip -d /usr/local
+rm /tmp/protoc.zip
+
+# Install protoc-gen-jsonschema (bufbuild)
+echo "→ Installing protoc-gen-jsonschema..."
+go install github.com/bufbuild/protoschema-plugins/cmd/protoc-gen-jsonschema@latest
+go_bin_path="$(go env GOPATH)/bin/protoc-gen-jsonschema"
+if [ -f "$go_bin_path" ]; then
+  sudo cp "$go_bin_path" /usr/local/bin/
+fi
+
+# Install buf CLI
+echo "→ Installing buf..."
+go install github.com/bufbuild/buf/cmd/buf@latest
+go_bin_path="$(go env GOPATH)/bin/buf"
+if [ -f "$go_bin_path" ]; then
+  sudo cp "$go_bin_path" /usr/local/bin/
+fi
+
+# Install googleapis proto files to third_party
+echo "→ Installing googleapis..."
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE_DIR="$(dirname "$SCRIPT_DIR")"
+GOOGLEAPIS_DIR="$WORKSPACE_DIR/third_party/googleapis"
+if [ ! -d "$GOOGLEAPIS_DIR" ]; then
+  mkdir -p "$WORKSPACE_DIR/third_party"
+  cd "$WORKSPACE_DIR/third_party"
+  git clone --depth 1 https://github.com/googleapis/googleapis.git
+  cd "$WORKSPACE_DIR"
+fi
+
+# Install Python dependencies for documentation
+echo "→ Installing Python packages..."
+pip install --no-cache-dir -r requirements-docs.txt
+
+# Verify installations
+echo ""
+echo "==> Verifying installations..."
+echo "protoc: $(protoc --version)"
+echo "protoc-gen-jsonschema: $(which protoc-gen-jsonschema)"
+echo "buf: $(buf --version 2>/dev/null || echo 'not found')"
+echo "jq: $(jq --version)"
+echo "python: $(python --version)"
+echo "go: $(go version)"
+
+echo ""
+echo "✓ Development environment ready!"
+echo ""
+echo "To build documentation:"
+echo "  ./scripts/build_docs.sh"
+echo ""
+echo "To convert proto to JSON Schema:"
+echo "  ./scripts/proto_to_json_schema.sh specification/json/a2a.json"
@@ -1,7 +1,7 @@
 # Documentation overrides
 /docs/** linguist-documentation=true
 /.mkdocs/** linguist-documentation=true
-/specification/json/a2a.json linguist-generated=true
+# Removed committed a2a.json; generated at build time.
 noxfile.py linguist-vendored=true
 
 # Merge and diff setting
 
@@ -29,6 +29,7 @@ Cpzuhi
 DDo
 DGT
 DHDe
+Debian
 Djq
 Dotnet
 EBFF
@@ -49,6 +50,7 @@ GitVote
 HBz
 HKRMw
 HRA
+HSTS
 HXo
 Hackathon
 IFdvcmxk
@@ -59,6 +61,7 @@ Imh
 Imprd
 JFUz
 JHv
+JIUz
 JPY
 JWKS
 JWS
@@ -89,6 +92,7 @@ RPCs
 RUF
 SLAs
 SLF
+SSLv
 Solax
 TJS
 TMDB
@@ -103,6 +107,7 @@ WQi
 WVw
 Witteveen
 XBs
+XVCJ
 Xca
 YQGt
 YTAKFW
@@ -129,13 +134,15 @@ agentskill
 agntcy
 agp
 ainvoke
+aip
 airbnb
 aldridge
 alloydb
 amannn
 aparse
 aproject
 aprotocol
+argjson
 arxiv
 askmarvin
 asyncclick
@@ -149,6 +156,7 @@ beeai
 bufbuild
 bzr
 cae
+canceltask
 ccc
 cdn
 ceee
@@ -157,6 +165,7 @@ cls
 coc
 codegen
 codeowner
+codespace
 crewai
 datamodel
 datapart
@@ -181,9 +190,11 @@ euo
 evt
 excinfo
 faa
+faf
 fafd
 fdebd
 ffbb
+fff
 firewalls
 flightbook
 forbes
@@ -196,11 +207,13 @@ geneknit
 genkit
 genproto
 georoute
+gettask
 gettickets
 gitvote
 gle
 googleai
 googleapi
+googleapis
 googleblog
 gpt
 gstatic
@@ -216,6 +229,8 @@ inmemory
 ipynb
 iss
 jherr
+jku
+jqlang
 jti
 jwks
 konami
@@ -224,12 +239,16 @@ langgraph
 linenums
 linkedin
 linting
+listtasks
 llm
 llms
 lng
+logtostderr
 marvin
 mcp
+mcr
 mesop
+mikefarah
 mindsdb
 motherlode
 mozilla
@@ -248,6 +267,8 @@ oidc
 ollama
 oneof
 openapis
+openapiv
+openapiv2
 oreilly
 postgres
 postgresql
@@ -256,31 +277,36 @@ prefecthq
 protoc
 protolint
 pyguide
+pylance
 pymdownx
 pypa
 pypackages
 pytype
 pyupgrade
 qwq
 rcm
+regen
 repomapr
 reportgen
 reposted
 rst
 rvelicheti
 scm
 sllm
+sourced
 sourcing
 squidfunk
 srcs
 sse
+sss
 stateclass
 stephenh
 styleguide
 svn
 systemctl
 tagwords
 tasksget
+taskslist
 taskssend
 taskstate
 taskstatus
@@ -293,6 +319,7 @@ tracestate
 ugc
 undoc
 utm
+venv-docs
 versioned
 vnd
 voa
@@ -302,6 +329,7 @@ webform
 webpage
 whatwg
 wikipedia
+winget
 wsgi
 wwwwwwww
 xxxxx
 
@@ -0,0 +1,4 @@
+lint:
+  rules:
+    remove:
+      - MAX_LINE_LENGTH
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +lint:
 +  rules:
 +    remove:
 +      - MAX_LINE_LENGTH