iamai 0.2.2a1.dev2__tar.gz → 0.3.0__tar.gz

iamai-0.3.0/.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,102 @@
+name: Bug report
+description: Report a reproducible defect in the iamai runtime, CLI, adapters, or packaging.
+title: "[Bug] "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please provide a minimal reproduction. Questions and usage help belong in GitHub Discussions.
+
+  - type: input
+    id: version
+    attributes:
+      label: iamai version or commit
+      description: Paste the installed version or full commit SHA.
+      placeholder: 0.3.0 or 87ba55b4a1e05c8d158f1f9b43cbf7b1afdcd2f0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: surface
+    attributes:
+      label: Affected surface
+      options:
+        - Runtime lifecycle
+        - Event or message model
+        - Plugin or adapter lifecycle
+        - State backend
+        - CLI or configuration
+        - Python packaging
+        - Rust core
+        - Documentation or examples
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: Include the smallest code or repository that reproduces the problem.
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Install ...
+        2. Run ...
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior and logs
+      description: Remove tokens, credentials, and private endpoints before posting.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: |
+        OS: macOS 15.5
+        Python: 3.12.4
+        Rust: 1.xx
+        Installer: uv 0.x
+    validations:
+      required: true
+
+  - type: textarea
+    id: regression
+    attributes:
+      label: Regression information
+      description: State the last known working version, or write "unknown".
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Confirmations
+      options:
+        - label: I searched existing issues and Discussions for duplicates.
+          required: true
+        - label: The reproduction and logs contain no secrets or private data.
+          required: true

iamai-0.3.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions and design discussions
+    url: https://github.com/retrofor/iamai/discussions
+    about: Ask usage questions or discuss ideas before proposing a core change.
+  - name: Security vulnerability
+    url: https://github.com/retrofor/iamai/security/advisories/new
+    about: Report vulnerabilities privately instead of opening a public issue.

iamai-0.3.0/.github/ISSUE_TEMPLATE/ecosystem-submission.yml

@@ -0,0 +1,104 @@
+name: Ecosystem submission
+description: Publish an iamai plugin, adapter, ruleset, tool, template, or other ecosystem entry.
+title: "[Ecosystem] "
+labels:
+  - ecosystem-submission
+  - triage
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for publishing an iamai ecosystem entry. Maintainers will validate the package or repository before adding it to the public registry.
+  - type: dropdown
+    id: extension_type
+    attributes:
+      label: Extension type
+      options:
+        - plugin
+        - adapter
+        - ruleset
+        - permission
+        - state_backend
+        - agent_tool
+        - agent_skill
+        - middleware
+        - template
+        - example
+        - provider
+        - theme
+    validations:
+      required: true
+  - type: input
+    id: entry_id
+    attributes:
+      label: Registry entry id
+      description: Use a stable lowercase id such as plugin.echo or adapter.acme.
+      placeholder: plugin.echo
+    validations:
+      required: true
+  - type: input
+    id: display_name
+    attributes:
+      label: Display name
+      placeholder: Echo Plugin
+    validations:
+      required: true
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: One sentence, 180 characters or fewer.
+      placeholder: Echo command plugin for local testing.
+    validations:
+      required: true
+  - type: input
+    id: package_name
+    attributes:
+      label: Python package
+      description: Required unless this entry is repository-only.
+      placeholder: iamai-plugin-echo
+  - type: input
+    id: repository_url
+    attributes:
+      label: Repository URL
+      description: Required unless this entry is package-only.
+      placeholder: https://github.com/you/iamai-plugin-echo
+  - type: textarea
+    id: runtime_capabilities
+    attributes:
+      label: Runtime capabilities
+      description: Comma or newline separated capabilities such as network:http, storage:sqlite, agent:tool, approval:required.
+      placeholder: network:http, storage:sqlite
+  - type: textarea
+    id: security_notes
+    attributes:
+      label: Security statement
+      description: Declare network access, credentials, dangerous actions, optional dependencies, or review notes.
+      placeholder: Requires outbound HTTPS and an API token stored in adapter config.
+  - type: textarea
+    id: permission_notes
+    attributes:
+      label: Permission notes
+      description: For Agent tools, declare permission name, input schema, audit fields, and whether human approval is required.
+      placeholder: permission=web.search; audit_fields=query,provider; approval=false
+  - type: textarea
+    id: registry_json
+    attributes:
+      label: Candidate registry JSON
+      description: Paste or keep the JSON generated by the documentation submission form.
+      render: json
+    validations:
+      required: true
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Confirmations
+      options:
+        - label: The package or repository is public and reachable.
+          required: true
+        - label: This submission contains no secrets, private endpoints, or unsafe install steps.
+          required: true
+        - label: I declared network access, credential needs, dangerous actions, and Agent tool permissions where applicable.
+          required: true
+        - label: I understand verification badges are assigned by iamai maintainers after review.
+          required: true

iamai-0.3.0/.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,84 @@
+name: Feature request
+description: Propose a scoped, testable change to the iamai core or ecosystem contract.
+title: "[Feature] "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        iamai keeps the core focused on a safe, testable runtime. Platform integrations and model-specific capabilities normally belong in external packages.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem and user scenario
+      description: Describe the concrete workflow that is blocked today.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: ownership
+    attributes:
+      label: Proposed ownership boundary
+      options:
+        - Core runtime or public API
+        - Official adapter or plugin
+        - External ecosystem package
+        - Documentation or example
+        - Unsure
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed change
+      description: Define the smallest behavior or contract that solves the scenario.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Include existing plugins, adapters, or composition options you evaluated.
+    validations:
+      required: true
+
+  - type: textarea
+    id: compatibility
+    attributes:
+      label: Compatibility impact
+      description: Note public API, serialization, lifecycle, schema, packaging, or migration effects.
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      placeholder: |
+        - [ ] Observable behavior is defined.
+        - [ ] Backward compatibility is preserved or migration is documented.
+        - [ ] Tests cover the new contract.
+    validations:
+      required: true
+
+  - type: textarea
+    id: test_plan
+    attributes:
+      label: Test plan
+      description: Identify the unit, integration, conformance, or packaging checks that prove completion.
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: confirmations
+    attributes:
+      label: Confirmations
+      options:
+        - label: I searched existing issues, the roadmap, and Discussions for duplicates.
+          required: true
+        - label: I have identified whether this belongs in core or the external ecosystem.
+          required: true

iamai-0.3.0/.github/dependabot.yml

@@ -0,0 +1,62 @@
+version: 2
+
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+      timezone: "Asia/Shanghai"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python:uv"
+    commit-message:
+      prefix: "deps(python)"
+    groups:
+      python-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:10"
+      timezone: "Asia/Shanghai"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "rust"
+    commit-message:
+      prefix: "deps(rust)"
+    groups:
+      rust-minor-and-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:20"
+      timezone: "Asia/Shanghai"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "github_actions"
+    commit-message:
+      prefix: "deps(actions)"
+    groups:
+      github-actions:
+        patterns:
+          - "*"

iamai-0.3.0/.github/workflows/check.yml

@@ -0,0 +1,110 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - dev
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint-and-rust:
+    name: Lint / Rust / Config
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-local-path: .uv-cache
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Sync development dependencies
+        run: uv sync --locked --all-packages --group dev
+
+      - name: Run Ruff
+        run: uv run ruff check .
+
+      - name: Run Mypy
+        run: uv run python -m mypy
+
+      - name: Run Rust tests
+        run: cargo test --no-default-features
+
+      - name: Validate example configs
+        run: bash scripts/check_example_configs.sh
+
+  test:
+    name: Pytest (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-local-path: .uv-cache
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Sync test dependencies
+        run: uv sync --locked --all-packages --group dev --group docs
+
+      - name: Run pytest
+        run: uv run pytest
+
+  docs:
+    name: Docs
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-local-path: .uv-cache
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Sync documentation dependencies
+        run: uv sync --locked --group dev --group docs
+
+      - name: Build Sphinx docs
+        run: uv run sphinx-build -W --keep-going -b html docs docs/_build/html

iamai-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,229 @@
+---
+# This file is autogenerated by maturin v1.13.1
+# To update, run
+#
+#    maturin generate-ci github -o CI.yml
+#
+name: release
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  validate:
+    name: Validate release source
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.12
+      - uses: astral-sh/setup-uv@v8.3.2
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Sync workspace dependencies
+        run: uv sync --locked --all-packages --group dev --group docs
+      - name: Verify tag matches package version
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        run: |
+          package_version="$(uv run python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')"
+          test "$GITHUB_REF_NAME" = "v$package_version"
+      - name: Run Python checks
+        run: |
+          uv run ruff check .
+          uv run mypy
+          uv run pytest
+      - name: Run Rust tests
+        run: cargo test --no-default-features
+      - name: Validate example configurations
+        run: bash scripts/check_example_configs.sh
+  linux:
+    needs: validate
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+          - runner: ubuntu-22.04
+            target: s390x
+          - runner: ubuntu-22.04
+            target: ppc64le
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.11
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: auto
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+  musllinux:
+    needs: validate
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.11
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: musllinux_1_2
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-musllinux-${{ matrix.platform.target }}
+          path: dist
+  windows:
+    needs: validate
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+          - runner: windows-11-arm
+            target: aarch64
+            python_arch: arm64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.13
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+  macos:
+    needs: validate
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.11
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+  sdist:
+    needs: validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-sdist
+          path: dist
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: ${{ startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch' }}
+    needs: [linux, musllinux, windows, macos, sdist]
+    permissions:
+      # Use to sign the release artifacts
+      id-token: write
+      # Used to upload release artifacts
+      contents: write
+      # Used to generate artifact attestation
+      attestations: write
+    steps:
+      - uses: actions/download-artifact@v7
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v3
+        with:
+          subject-path: wheels-*/*
+      - name: Install uv
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        uses: astral-sh/setup-uv@v8.3.2
+      - name: Publish to PyPI
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        run: uv publish --check-url https://pypi.org/simple 'wheels-*/*'
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN || secrets.PYPI_TOKEN }}
+      - name: Create draft GitHub release
+        id: github_release
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1; then
+            if [[ "$(gh release view "$GITHUB_REF_NAME" --json isDraft --jq .isDraft)" == "false" ]]; then
+              echo "already_published=true" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+            gh release upload "$GITHUB_REF_NAME" wheels-*/* --clobber
+          else
+            gh release create "$GITHUB_REF_NAME" wheels-*/* \
+              --draft \
+              --generate-notes \
+              --title "$GITHUB_REF_NAME" \
+              --verify-tag
+          fi
+      - name: Publish GitHub release
+        if: ${{ startsWith(github.ref, 'refs/tags/') && steps.github_release.outputs.already_published != 'true' }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release edit "$GITHUB_REF_NAME" --draft=false