a2a-sdk 0.2.0__tar.gz

a2a_sdk-0.2.0/.coveragerc

@@ -0,0 +1,8 @@
+[run]
+branch = True
+
+[report]
+exclude_also =
+    pass
+    import
+    @abstractmethod

a2a_sdk-0.2.0/.git-blame-ignore-revs

@@ -0,0 +1,21 @@
+# Template taken from https://github.com/v8/v8/blob/master/.git-blame-ignore-revs.
+#
+# This file contains a list of git hashes of revisions to be ignored by git blame. These
+# revisions are considered "unimportant" in that they are unlikely to be what you are
+# interested in when blaming. Most of these will probably be commits related to linting
+# and code formatting.
+#
+# Instructions:
+# - Only large (generally automated) reformatting or renaming CLs should be
+#   added to this list. Do not put things here just because you feel they are
+#   trivial or unimportant. If in doubt, do not put it on this list.
+# - Precede each revision with a comment containing the PR title and number.
+#   For bulk work over many commits, place all commits in a block with a single
+#   comment at the top describing the work done in those commits.
+# - Only put full 40-character hashes on this list (not short hashes or any
+#   other revision reference).
+# - Append to the bottom of the file (revisions should be in chronological order
+#   from oldest to newest).
+# - Because you must use a hash, you need to append to this list in a follow-up
+#   PR to the actual reformatting PR that you are trying to ignore.
+193693836e1ed8cd361e139668323d2e267a9eaa

a2a_sdk-0.2.0/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# Code owners file.
+# This file controls who is tagged for review for any given pull request.
+#
+# For syntax help see:
+# https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners#codeowners-syntax
+
+*   @google/a2a-eng

a2a_sdk-0.2.0/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,33 @@
+name: 🐞 Bug Report
+description: File a bug report
+title: "[Bug]: "
+type: "Bug"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for stopping by to let us know something could be better!
+        Private Feedback? Please use this [Google form](https://goo.gle/a2a-feedback)
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Also tell us what you expected to happen and how to reproduce the issue.
+      placeholder: Tell us what you see!
+      value: "A bug happened!"
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.
+      render: shell
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/google/A2A?tab=coc-ov-file#readme)
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

a2a_sdk-0.2.0/.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,41 @@
+name: 💡 Feature Request
+description: Suggest an idea for this repository
+title: "[Feat]: "
+type: "Feature"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for stopping by to let us know something could be better!
+        Private Feedback? Please use this [Google form](https://goo.gle/a2a-feedback)
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: A clear and concise description of what the problem is.
+      placeholder: Ex. I'm always frustrated when [...]
+  - type: textarea
+    id: describe
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/google/a2a-python?tab=coc-ov-file#readme)
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

a2a_sdk-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+# Description
+
+Thank you for opening a Pull Request!
+Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
+
+- [ ] Follow the [`CONTRIBUTING` Guide](https://github.com/google/a2a-python/blob/main/CONTRIBUTING.md).
+- [ ] Make your Pull Request title in the <https://www.conventionalcommits.org/> specification.
+- [ ] Ensure the tests and linter pass (Run `nox -s format` from the repository root to format)
+- [ ] Appropriate docs were updated (if necessary)
+
+Fixes #<issue_number_goes_here> 🦕

a2a_sdk-0.2.0/.github/actions/spelling/advice.md

@@ -0,0 +1,28 @@
+<!-- See https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-advice --> <!-- markdownlint-disable MD033 MD041 -->
+<details><summary>If the flagged items are :exploding_head: false positives</summary>
+
+If items relate to a ...
+
+- binary file (or some other file you wouldn't want to check at all).
+
+  Please add a file path to the `excludes.txt` file matching the containing file.
+
+  File paths are Perl 5 Regular Expressions - you can [test](https://www.regexplanet.com/advanced/perl/) yours before committing to verify it will match your files.
+
+  `^` refers to the file's path from the root of the repository, so `^README\.md$` would exclude `README.md` (on whichever branch you're using).
+
+- well-formed pattern.
+
+  If you can write a [pattern](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples:-patterns) that would match it,
+  try adding it to the `patterns.txt` file.
+
+  Patterns are Perl 5 Regular Expressions - you can [test](https://www.regexplanet.com/advanced/perl/) yours before committing to verify it will match your lines.
+
+  Note that patterns can't match multiline strings.
+
+</details>
+
+<!-- adoption information-->
+
+:steam_locomotive: If you're seeing this message and your PR is from a branch that doesn't have check-spelling,
+please merge to your PR's base branch to get the version configured for your repository.

a2a_sdk-0.2.0/.github/actions/spelling/allow.txt

@@ -0,0 +1,35 @@
+ACard
+AClient
+AError
+ARequest
+ARun
+AServer
+AStarlette
+EUR
+GBP
+INR
+JPY
+JSONRPCt
+Llm
+aconnect
+adk
+autouse
+cla
+cls
+coc
+codegen
+coro
+datamodel
+dunders
+genai
+gle
+inmemory
+langgraph
+lifecycles
+linting
+oauthoidc
+opensource
+socio
+sse
+tagwords
+vulnz

a2a_sdk-0.2.0/.github/actions/spelling/excludes.txt

@@ -0,0 +1,89 @@
+# See https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples:-excludes
+(?:^|/)(?i)COPYRIGHT
+(?:^|/)(?i)LICEN[CS]E
+(?:^|/)(?i)CODE_OF_CONDUCT.md\E$
+(?:^|/)(?i).gitignore\E$
+(?:^|/)3rdparty/
+(?:^|/)go\.sum$
+(?:^|/)package(?:-lock|)\.json$
+(?:^|/)Pipfile$
+(?:^|/)pyproject.toml
+(?:^|/)requirements(?:-dev|-doc|-test|)\.txt$
+(?:^|/)vendor/
+/CODEOWNERS$
+\.a$
+\.ai$
+\.all-contributorsrc$
+\.avi$
+\.bmp$
+\.bz2$
+\.cer$
+\.class$
+\.coveragerc$
+\.crl$
+\.crt$
+\.csr$
+\.dll$
+\.docx?$
+\.drawio$
+\.DS_Store$
+\.eot$
+\.eps$
+\.exe$
+\.gif$
+\.git-blame-ignore-revs$
+\.gitattributes$
+\.gitkeep$
+\.graffle$
+\.gz$
+\.icns$
+\.ico$
+\.jar$
+\.jks$
+\.jpe?g$
+\.key$
+\.lib$
+\.lock$
+\.map$
+\.min\..
+\.mo$
+\.mod$
+\.mp[34]$
+\.o$
+\.ocf$
+\.otf$
+\.p12$
+\.parquet$
+\.pdf$
+\.pem$
+\.pfx$
+\.png$
+\.psd$
+\.pyc$
+\.pylintrc$
+\.qm$
+\.s$
+\.sig$
+\.so$
+\.svgz?$
+\.sys$
+\.tar$
+\.tgz$
+\.tiff?$
+\.ttf$
+\.wav$
+\.webm$
+\.webp$
+\.woff2?$
+\.xcf$
+\.xlsx?$
+\.xpm$
+\.xz$
+\.zip$
+^\.github/actions/spelling/
+^\Q.github/workflows/spelling.yaml\E$
+^\Q.github/workflows/linter.yaml\E$
+\.gitignore\E$
+\.vscode/
+noxfile.py
+\.ruff.toml$

a2a_sdk-0.2.0/.github/actions/spelling/line_forbidden.patterns

@@ -0,0 +1,307 @@
+# Should be `HH:MM:SS`
+\bHH:SS:MM\b
+
+# Should probably be `YYYYMMDD`
+\b[Yy]{4}[Dd]{2}[Mm]{2}(?!.*[Yy]{4}[Dd]{2}[Mm]{2}).*$
+
+# Should be `anymore`
+\bany more[,.]
+
+# Should be `cannot` (or `can't`)
+# See https://www.grammarly.com/blog/cannot-or-can-not/
+# > Don't use `can not` when you mean `cannot`. The only time you're likely to see `can not` written as separate words is when the word `can` happens to precede some other phrase that happens to start with `not`.
+# > `Can't` is a contraction of `cannot`, and it's best suited for informal writing.
+# > In formal writing and where contractions are frowned upon, use `cannot`.
+# > It is possible to write `can not`, but you generally find it only as part of some other construction, such as `not only . . . but also.`
+# - if you encounter such a case, add a pattern for that case to patterns.txt.
+\b[Cc]an not\b
+
+# Should be `GitHub`
+(?<![&*.]|// |\btype |\bimport )\bGithub\b(?![{()])
+\b[Gg]it\s[Hh]ub\b
+
+# Should be `GitLab`
+(?<![&*.]|// |\btype )\bGitlab\b(?![{)])
+
+# Should be `JavaScript`
+\bJavascript\b
+
+# Should be `macOS` or `Mac OS X` or ...
+\bMacOS\b
+
+# Should be `Microsoft`
+\bMicroSoft\b
+
+# Should be `OAuth`
+(?:^|[^-/*$])[ '"]oAuth(?: [a-z]|\d+ |[^ a-zA-Z0-9:;_.()])
+
+# Should be `TypeScript`
+\bTypescript\b
+
+# Should be `another`
+\ban[- ]other\b
+
+# Should be `case-(in)sensitive`
+\bcase (?:in|)sensitive\b
+
+# Should be `coinciding`
+\bco-inciding\b
+
+# Should be `deprecation warning(s)`
+\b[Dd]epreciation [Ww]arnings?\b
+
+# Should be `greater than`
+\bgreater then\b
+
+# Should be `ID`
+#\bId\b
+
+# Should be `in front of`
+\bin from of\b
+
+# Should be `into`
+# when not phrasal and when `in order to` would be wrong:
+# https://thewritepractice.com/into-vs-in-to/
+\sin to\s(?!if\b)
+
+# Should be `use`
+\sin used by\b
+
+# Should be `is obsolete`
+\bis obsolescent\b
+
+# Should be `it's` or `its`
+\bits[']
+
+# Should be `its`
+\bit's(?= own\b)
+
+# Should be `perform its`
+\bperform it's\b
+
+# Should be `opt-in`
+(?<!\sfor)\sopt in\s
+
+# Should be `less than`
+\bless then\b
+
+# Should be `load balancer`
+\b[Ll]oud balancer
+
+# Should be `one of`
+\bon of\b
+
+# Should be `otherwise`
+\bother[- ]wise\b
+
+# Should be `or (more|less)`
+\bore (?:more|less)\b
+
+# Should be `rather than`
+\brather then\b
+
+# Should be `regardless, ...` or `regardless of (whether)`
+\b[Rr]egardless if you\b
+
+# Should be `no longer needed`
+\bno more needed\b(?! than\b)
+
+# Should be `did not exist`
+\bwere not existent\b
+
+# Should be `nonexistent`
+\bnon existing\b
+
+# Should be `nonexistent`
+\b[Nn]o[nt][- ]existent\b
+
+# Should be `@brief` / `@details` / `@param` / `@return` / `@retval`
+(?:^\s*|(?:\*|//|/*)\s+`)[\\@](?:breif|(?:detail|detials)|(?:params(?!\.)|prama?)|ret(?:uns?)|retvl)\b
+
+# Should be `preexisting`
+[Pp]re[- ]existing
+
+# Should be `preempt`
+[Pp]re[- ]empt\b
+
+# Should be `preemptively`
+[Pp]re[- ]emptively
+
+# Should be `recently changed` or `recent changes`
+[Rr]ecent changed
+
+# Should be `reentrancy`
+[Rr]e[- ]entrancy
+
+# Should be `reentrant`
+[Rr]e[- ]entrant
+
+# Should be `understand`
+\bunder stand\b
+
+# Should be `workarounds`
+\bwork[- ]arounds\b
+
+# Should be `workaround`
+(?:(?:[Aa]|[Tt]he|ugly)\swork[- ]around\b|\swork[- ]around\s+for)
+
+# Should be `(coarse|fine)-grained`
+\b(?:coarse|fine) grained\b
+
+# Should be `neither/nor` -- or reword
+\bnot\b[^.?!"/(]+\bnor\b
+
+# Should be `neither/nor` (plus rewording the beginning)
+# This is probably a double negative...
+\bnot\b[^.?!"/]*\bneither\b[^.?!"/(]*\bnor\b
+
+# In English, duplicated words are generally mistakes
+# There are a few exceptions (e.g. "that that").
+# If the highlighted doubled word pair is in:
+# * code, write a pattern to mask it.
+# * prose, have someone read the English before you dismiss this error.
+\s([A-Z]{3,}|[A-Z][a-z]{2,}|[a-z]{3,})\s\g{-1}\s
+
+# Should be `Gen AI`
+\b[gG]enAI\b
+
+# Should be LangChain
+\b(?!LangChain\b)(?!langchain\b)[Ll]ang\s?[Cc]hain?\b
+
+# Should be LangGraph
+\b(?!LangGraph\b)(?!langgraph\b)[Ll]ang\s?[Gg]raph?\b
+
+# Should be LangServe
+\b(?!LangServe\b)(?!langserve\b)[Ll]ang\s?[Ss]erve?\b
+
+# Should be LlamaIndex
+\b(?!LlamaIndex\b)[Ll][Ll]ama\s?[Ii]ndex?\s
+
+# Should be Hugging Face
+\s(?!Hugging Face\b)[Hh]ugging\s?[Ff]ace?\b
+
+# Should be DeepSeek
+\b(?!DeepSeek\b)(?!deepseek\b)[Dd]eep\s?[Ss]eek?\b
+
+# Should be Vertex AI
+\b(?!Vertex AI\b)(?!.*[\(\)\{\},])(?<!import\s)(?<!\.)(?<!,\s)Vertex\s?[Aa]?[Ii]?\b
+
+# Should be Vertex AI
+\b[Vv]ertext\b
+
+# Should be Gemini
+\sgemini\s\w
+
+# Should be `Gemini Version Size` (e.g. `Gemini 2.0 Flash`)
+\bGemini\s(Pro|Flash|Ultra)\s?\d\.\d\b
+
+# Gemini Size should be capitalized (e.g. `Gemini 2.0 Flash`)
+\bGemini\s?\d\.\d\s(pro|flash|ultra)\b
+
+# Don't say "Google Gemini" or "Google Gemini"
+\b[Gg]oogle(?: [Cc]loud| [Dd]eep[Mm]ind)?'s [Gg]emini\b
+
+# Don't say "Powered by Gemini", instead say "with Gemini"
+\b[Pp]owered\s[Bb]y\s[Gg]emini\b
+
+# Should be Gemini API in Vertex AI
+\b[Vv]ertex\s[Aa][Ii]\s[Gg]emini\s[Aa][Pp][Ii]\b
+
+# Should be Agentspace
+\b(?!Agentspace\b)[Aa]gent\s?[Ss]pace?\b
+
+# Should be Imagen
+\simagen\s\w
+
+# Should be Imagen 2 or Imagen 3
+\bImagen\d\b
+
+# Should be BigQuery
+\b(?!BigQuery\b)(?!bigquery\b)[Bb]ig\s?[Qq]uery\b
+
+# Should be DataFrame or DataFrames
+\b(?!DataFrames?\b)(?!.*[\(\)\{\}\.,=])(?<!")\b[Dd]ata\s?[Ff]rames?\b(?!")
+
+# Should be Google Cloud
+\s[Gg][Cc][Pp]\s
+
+# Should be Google Cloud
+\b(?!Google\sCloud\b)[Gg]oogle\s?[Cc]loud\b
+
+# Should be DeepMind
+\b(?!DeepMind\b)[Dd]eep\s?[Mm]ind\b
+
+# Should be TensorFlow
+\b(?!TensorFlow\b)(?!tensorflow\b)[Tt]ensor\s?[Ff]low\b
+
+# Should be AlloyDB
+\b(?!AlloyDB\b)(?!alloydb\b)[Aa]lloy\s?[Dd]\s?[Bb]\b
+
+# Should be Translation API
+\bTranslate\s?API\b
+
+# Should be Dialogflow
+\bDialogFlow\b
+
+# Should be Firebase
+\b(?!Firebase\b)Fire\s?[Bb]ase\b
+
+# Should be Firestore
+\b(?!Firestore\b)Fire\s?[Ss]tore\b
+
+# Should be Memorystore
+\b(?!Memorystore\b)Memory\s?[Ss]tore\b
+
+# Should be Document AI
+\bDoc\s?AI\b
+
+# Should be Vertex AI Search
+\bVertex\s?Search\b
+
+# Should be Vertex AI Vector Search
+\bVertex\sVector\sSearch\b
+
+# Should be Colab
+\s(?!Colab)[Cc]o[Ll][Ll]?abs?\b
+
+# Should be Kaggle
+\skaggle\b
+
+# Should be TPU or TPUs
+\btpus?\b
+
+# Should be GKE
+\sgke\s
+
+# Should be GCS
+\sgcs\s
+
+# Should be Dataflow ML
+\b[Dd]ataflowML\b
+
+# Should be API
+\s(?!API)(?!.*[\(\)\{\},=#]+)[Aa][Pp][Ii]\s
+
+# Should be arXiv
+\bAr[Xx]iv\b
+
+# Should be DeepEval
+\b(?!DeepEval\b)(?!deepeval\b)[Dd]eep\s?[Ee]val\b
+
+# Invalid Space Character
+\w \w
+
+# Don't use "smart quotes"
+(?!'")[‘’“”]
+
+# "an" should only be before vowels.
+\ban\s+(?![FHLMNRSX][A-Z0-9]+\b)(?!hour\b)(?!honest\b)([b-df-hj-np-tv-zB-DF-HJ-NP-TV-Z]{1}\w*)
+
+# Don't use Google internal links
+((corp|prod|sandbox).google.com|googleplex.com|https?://(?!localhost/)[0-9a-z][0-9a-z-]+/|(?:^|[^/.-])\b(?:go|b|cl|cr)/[a-z0-9_.-]+\b)
+
+# Use `%pip` instead of `!pip` or `!pip3`
+!\s?pip3?
+
+# Don't use embedded images, upload to Google Cloud Storage
+\(data:image/(?:jpeg|png);base64,[^{]

a2a_sdk-0.2.0/.github/conventional-commit-lint.yaml

@@ -0,0 +1,2 @@
+enabled: true
+always_check_pr_title: true

a2a_sdk-0.2.0/.github/linters/.jscpd.json

@@ -0,0 +1,5 @@
+{
+  "ignore": ["**/.github/**", "**/.git/**", "**/tests/**", "**/examples/**"],
+  "threshold": 3,
+  "reporters": ["html", "markdown"]
+}

a2a_sdk-0.2.0/.github/linters/.markdownlint.json

@@ -0,0 +1,4 @@
+{
+  "MD034": false,
+  "MD013": false
+}

a2a_sdk-0.2.0/.github/workflows/linter.yaml

@@ -0,0 +1,65 @@
+#################################
+#################################
+## Super Linter GitHub Actions ##
+#################################
+#################################
+name: Lint Code Base
+
+#
+# Documentation:
+# https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions
+#
+
+#############################
+# Start the job on all push #
+#############################
+on:
+  pull_request:
+    branches: [main]
+
+###############
+# Set the Job #
+###############
+jobs:
+  build:
+    # Name the Job
+    name: Lint Code Base
+    # Set the agent to run on
+    runs-on: ubuntu-latest
+    # if on repo to avoid failing runs on forks
+    if: |
+      github.repository == 'google/a2a-python'
+
+    ##################
+    # Load all steps #
+    ##################
+    steps:
+      ##########################
+      # Checkout the code base #
+      ##########################
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          # Full git history is needed to get a proper list of changed files within `super-linter`
+          fetch-depth: 0
+
+      ################################
+      # Run Linter against code base #
+      ################################
+      - name: Lint Code Base
+        uses: super-linter/super-linter/slim@v7
+        env:
+          DEFAULT_BRANCH: main
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          LOG_LEVEL: WARN
+          SHELLCHECK_OPTS: -e SC1091 -e 2086
+          VALIDATE_PYTHON_BLACK: false
+          VALIDATE_PYTHON_FLAKE8: false
+          VALIDATE_PYTHON_ISORT: false
+          VALIDATE_PYTHON_PYLINT: false
+          VALIDATE_PYTHON_PYINK: false
+          VALIDATE_CHECKOV: false
+          VALIDATE_JAVASCRIPT_STANDARD: false
+          VALIDATE_TYPESCRIPT_STANDARD: false
+          VALIDATE_GIT_COMMITLINT: false
+          MARKDOWN_CONFIG_FILE: .markdownlint.json