ase-python 0.1.0__tar.gz

ase_python-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,27 @@
+name: Bug report
+description: Report a reproducible defect in ASE.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What is failing, and what did you expect instead?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Exact commands, scenario files, and environment details.
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Python version, OS, ASE install mode, and any framework versions involved.
+    validations:
+      required: true
+

ase_python-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

ase_python-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature request
+description: Propose a new capability or workflow for ASE.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user or developer problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: Describe the desired behavior and any constraints.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives
+      description: What workarounds or competing approaches have you considered?
+

ase_python-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## Summary
+
+Describe the change and the user-visible outcome.
+
+## Validation
+
+- [ ] tests added or updated
+- [ ] `ruff check` passed
+- [ ] targeted `pytest` passed
+- [ ] targeted `mypy --strict` passed where applicable
+
+## Neutrality Check
+
+- [ ] no framework-specific semantics were added to ASE core
+- [ ] framework-specific logic stays in adapters, harnesses, or conformance assets
+

ase_python-0.1.0/.github/workflows/certify.yml

@@ -0,0 +1,126 @@
+name: certify
+
+on:
+  push:
+  pull_request:
+
+env:
+  PIP_CONSTRAINT: constraints/py311.txt
+
+jobs:
+  certify:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        manifest:
+          - conformance/launch/openai-agents-python/manifest.yaml
+          - conformance/launch/langgraph-python/manifest.yaml
+          - conformance/launch/pydantic-ai-python/manifest.yaml
+          - conformance/launch/openai-agents-typescript/manifest.yaml
+          - conformance/bundles/core/openai-agents-python/manifest.yaml
+          - conformance/bundles/stateful/pydantic-ai-python/manifest.yaml
+          - conformance/bundles/multi_agent/langgraph-python/manifest.yaml
+          - conformance/bundles/realtime/openai-agents-typescript/manifest.yaml
+          - conformance/bundles/mcp/mcp-python/manifest.yaml
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install ASE
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Certify launch bundle
+        run: |
+          ase certify "${{ matrix.manifest }}" --out-file "$(basename "${{ matrix.manifest }}").cert.json"
+      - name: Upload certification artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: certification-bundles-${{ strategy.job-index }}
+          path: "*.cert.json"
+
+  official-adapters-python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        framework:
+          - openai-agents-python
+          - langgraph-python
+          - pydantic-ai-python
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install ASE
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Bootstrap upstream Python framework
+        run: |
+          python scripts/bootstrap_upstream_validations.py --framework "${{ matrix.framework }}"
+      - name: Run and certify upstream Python adapter
+        run: |
+          ase test "validation/upstream/${{ matrix.framework }}/ase-scenario.yaml"
+          ase certify "validation/upstream/${{ matrix.framework }}/ase-manifest.yaml" --out-file "${{ matrix.framework }}.official.cert.json"
+      - name: Upload Python adapter certifications
+        uses: actions/upload-artifact@v4
+        with:
+          name: certification-official-python-${{ matrix.framework }}
+          path: "*.official.cert.json"
+
+  official-adapters-mixed:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+      - name: Install ASE
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Bootstrap upstream TypeScript framework
+        run: |
+          python scripts/bootstrap_upstream_validations.py --framework openai-agents-js
+      - name: Run and certify the upstream TypeScript adapter
+        run: |
+          ase test validation/upstream/openai-agents-js/ase-scenario.yaml
+          ase certify validation/upstream/openai-agents-js/ase-manifest.yaml --out-file openai-agents-js.official.cert.json
+      - name: Upload TypeScript adapter certification
+        uses: actions/upload-artifact@v4
+        with:
+          name: certification-official-typescript
+          path: "*.official.cert.json"
+
+  compatibility-matrix:
+    needs:
+      - certify
+      - official-adapters-python
+      - official-adapters-mixed
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install ASE
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Download certification artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: certification-artifacts
+      - name: Generate compatibility matrix
+        run: |
+          python scripts/generate_compatibility_matrix.py docs/compatibility-matrix.generated.md certification-artifacts
+      - name: Upload compatibility matrix
+        uses: actions/upload-artifact@v4
+        with:
+          name: compatibility-matrix
+          path: docs/compatibility-matrix.generated.md

ase_python-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,48 @@
+name: publish-pypi
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Build distributions
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: pypi-dist
+          path: dist/*
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/project/ase-python/
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: pypi-dist
+          path: dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

ase_python-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+.venv/
+.venv311/
+.venv312/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.idea/
+.ase-recovery/
+.ase-recovery-next/
+.upstream/
+external/
+build/
+dist/
+docs/compatibility-matrix.generated.md
+validation/upstream/**/events.generated.jsonl
+validation/case_studies/**/events.bad.jsonl
+validation/case_studies/**/events.fixed.jsonl
+examples/**/events.generated.jsonl
+validation/upstream/**/__pycache__/
+*.pyc

ase_python-0.1.0/.gitlab-ci.yml

@@ -0,0 +1,72 @@
+stages:
+  - certify
+  - matrix
+  - examples
+
+variables:
+  PIP_CONSTRAINT: constraints/py311.txt
+
+certify_launch_bundles:
+  image: python:3.11
+  stage: certify
+  script:
+    - pip install -e ".[dev]"
+    - ase certify conformance/launch/openai-agents-python/manifest.yaml --out-file openai-agents-python.cert.json
+    - ase certify conformance/launch/langgraph-python/manifest.yaml --out-file langgraph-python.cert.json
+    - ase certify conformance/launch/pydantic-ai-python/manifest.yaml --out-file pydantic-ai-python.cert.json
+    - ase certify conformance/launch/openai-agents-typescript/manifest.yaml --out-file openai-agents-typescript.cert.json
+    - ase certify conformance/bundles/core/openai-agents-python/manifest.yaml --out-file core-openai-agents-python.cert.json
+    - ase certify conformance/bundles/stateful/pydantic-ai-python/manifest.yaml --out-file stateful-pydantic-ai-python.cert.json
+    - ase certify conformance/bundles/multi_agent/langgraph-python/manifest.yaml --out-file multi-agent-langgraph-python.cert.json
+    - ase certify conformance/bundles/realtime/openai-agents-typescript/manifest.yaml --out-file realtime-openai-agents-typescript.cert.json
+    - ase certify conformance/bundles/mcp/mcp-python/manifest.yaml --out-file mcp-python.cert.json
+  artifacts:
+    when: always
+    paths:
+      - "*.cert.json"
+
+official_adapters_python:
+  image: python:3.12
+  stage: examples
+  parallel:
+    matrix:
+      - FRAMEWORK: ["openai-agents-python", "langgraph-python", "pydantic-ai-python"]
+  script:
+    - pip install -e ".[dev]"
+    - python scripts/bootstrap_upstream_validations.py --framework "$FRAMEWORK"
+    - ase test "validation/upstream/$FRAMEWORK/ase-scenario.yaml"
+    - ase certify "validation/upstream/$FRAMEWORK/ase-manifest.yaml" --out-file "$FRAMEWORK.official.cert.json"
+  artifacts:
+    when: always
+    paths:
+      - "*.official.cert.json"
+
+official_adapters_typescript:
+  image: node:22-bookworm
+  stage: examples
+  before_script:
+    - apt-get update && apt-get install -y python3.11 python3-pip
+  script:
+    - python3.11 -m pip install -e ".[dev]"
+    - python3.11 scripts/bootstrap_upstream_validations.py --framework openai-agents-js
+    - ase test validation/upstream/openai-agents-js/ase-scenario.yaml
+    - ase certify validation/upstream/openai-agents-js/ase-manifest.yaml --out-file openai-agents-js.official.cert.json
+  artifacts:
+    when: always
+    paths:
+      - "*.official.cert.json"
+
+compatibility_matrix:
+  image: python:3.11
+  stage: matrix
+  needs:
+    - certify_launch_bundles
+    - official_adapters_python
+    - official_adapters_typescript
+  script:
+    - pip install -e ".[dev]"
+    - python scripts/generate_compatibility_matrix.py docs/compatibility-matrix.generated.md *.cert.json
+  artifacts:
+    when: always
+    paths:
+      - docs/compatibility-matrix.generated.md

ase_python-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,44 @@
+# Code of Conduct
+
+## Our Pledge
+
+We want ASE to be an open, respectful, developer-first project. Contributors,
+maintainers, and users are expected to engage with empathy, clarity, and
+professionalism.
+
+## Our Standards
+
+Examples of behavior that contribute to a positive environment:
+
+- giving actionable, respectful technical feedback
+- assuming good intent while being direct about problems
+- keeping reviews focused on the code and product behavior
+- welcoming questions from new contributors
+
+Examples of unacceptable behavior:
+
+- harassment, discrimination, or personal attacks
+- hostile or mocking communication
+- publishing others' private information without permission
+- disruptive behavior that makes collaboration unsafe or unproductive
+
+## Enforcement
+
+Maintainers are responsible for clarifying and enforcing this policy. They may
+remove, edit, or reject contributions or comments that violate it.
+
+## Reporting
+
+Report conduct issues privately to the project maintainers through the
+repository's private maintainer contact path. Do not open public issues for
+personal safety concerns.
+
+## Scope
+
+This Code of Conduct applies in project spaces and in public spaces when an
+individual is representing ASE or the ASE community.
+
+## Attribution
+
+This policy is adapted from the Contributor Covenant, version 2.1.
+

ase_python-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,18 @@
+# Contributing
+
+ASE's core must remain framework-neutral.
+
+Before adding code:
+
+1. Ask whether the change generalizes across at least two frameworks or execution modes.
+2. If not, put it in an adapter, example harness, or conformance bundle instead of `src/ase` core.
+3. Keep the adapter event protocol and append-only trace schema as the compatibility boundary.
+
+Contribution rules:
+
+- no framework-specific runtime imports in ASE core
+- no framework-specific fields in the core trace schema unless they generalize
+- keep upstream runtime harnesses in `validation/upstream/`, not core
+- no docs examples that have not been exercised in CI
+- no compatibility-matrix edits by hand; generate it from certification artifacts only
+- fetch third-party upstream repos into `.upstream/` instead of vendoring them

ase_python-0.1.0/LICENSE

@@ -0,0 +1,105 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright
+owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities
+that control, are controlled by, or are under common control with that entity.
+For the purposes of this definition, "control" means (i) the power, direct or
+indirect, to cause the direction or management of such entity, whether by
+contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including
+but not limited to software source code, documentation source, and configuration
+files.
+
+"Object" form shall mean any form resulting from mechanical transformation or
+translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made
+available under the License, as indicated by a copyright notice that is included
+in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that
+is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version
+of the Work and any modifications or additions to that Work or Derivative Works
+thereof, that is intentionally submitted to Licensor for inclusion in the Work
+by the copyright owner or by an individual or Legal Entity authorized to submit
+on behalf of the copyright owner.
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf
+of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License,
+each Contributor hereby grants to You a perpetual, worldwide, non-exclusive,
+no-charge, royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of
+this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that You
+changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then
+any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND.
+
+8. Limitation of Liability. In no event and under no legal theory shall any
+Contributor be liable to You for damages arising in any way out of the use or
+inability to use the Work.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or
+Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations.
+
+END OF TERMS AND CONDITIONS
+