agent-framework 1.2.0__tar.gz → 1.2.2__tar.gz

agent_framework-1.2.2/.pre-commit-config.yaml

@@ -0,0 +1,69 @@
+fail_fast: true
+exclude: ^scripts/
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-toml
+        name: Check TOML files
+        files: \.toml$
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+      - id: check-yaml
+        name: Check YAML files
+        files: \.yaml$
+      - id: check-json
+        name: Check JSON files
+        files: \.json$
+        exclude: ^.*\.vscode\/.*|^demos/samples/chatkit-integration/frontend/(tsconfig.*\.json|package-lock\.json)$
+      - id: end-of-file-fixer
+        name: Fix End of File
+        files: \.py$
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+      - id: mixed-line-ending
+        name: Check Mixed Line Endings
+        files: \.py$
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+      - id: trailing-whitespace
+        name: Trim Trailing Whitespace
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+      - id: check-merge-conflict
+        name: Check Merge Conflicts
+      - id: detect-private-key
+        name: Detect Private Keys
+      - id: check-added-large-files
+        name: Check Added Large Files
+      - id: no-commit-to-branch
+        name: Protect main branch
+        args: [--branch, main]
+      - id: check-ast
+        name: Check Valid Python Samples
+        types: ["python"]
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.21.2
+    hooks:
+      - id: pyupgrade
+        name: Upgrade Python syntax
+        args: [--py310-plus]
+        exclude: ^packages/lab/cookiecutter-agent-framework-lab/
+  - repo: local
+    hooks:
+      - id: poe-check
+        name: Run checks through Poe
+        entry: uv run python scripts/workspace_poe_tasks.py prek-check
+        language: system
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.9.4
+    hooks:
+      - id: bandit
+        name: Bandit Security Checks
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    # uv version.
+    rev: 0.11.6
+    hooks:
+      # Update the uv lockfile
+      - id: uv-lock
+        name: Update uv lockfile
+        files: pyproject.toml

agent_framework-1.2.2/AGENTS.md

@@ -0,0 +1,95 @@
+# AGENTS.md
+
+Instructions for AI coding agents working in the Python codebase.
+
+**Key Documentation:**
+- [DEV_SETUP.md](DEV_SETUP.md) - Development environment setup and available poe tasks
+- [CODING_STANDARD.md](CODING_STANDARD.md) - Coding standards, docstring format, and performance guidelines
+- [samples/SAMPLE_GUIDELINES.md](samples/SAMPLE_GUIDELINES.md) - Sample structure and guidelines
+
+**Agent Skills** (`.github/skills/`) — detailed, task-specific instructions loaded on demand:
+- `python-development` — coding standards, type annotations, docstrings, logging, performance
+- `python-testing` — test structure, fixtures, async mode, running tests
+- `python-code-quality` — linting, formatting, type checking, prek hooks, CI workflow
+- `python-feature-lifecycle` — package vs feature lifecycle stages, decorators, enums, and promotion guidance
+- `python-package-management` — monorepo structure, lazy loading, versioning, new packages
+- `python-samples` — sample file structure, PEP 723, documentation guidelines
+
+## Maintaining Documentation
+
+When making changes to a package, check if the following need updates:
+- The package's `AGENTS.md` file (adding/removing/renaming public APIs, architecture changes, import path changes)
+- The agent skills in `.github/skills/` if conventions, commands, or workflows change
+
+## Pull Request Description Guidance
+
+When preparing a PR description:
+- Follow the repository PR template at `.github/pull_request_template.md` and keep its structure/headings.
+- Describe the net change relative to `main` (this is implied; do not call it out explicitly as "vs main").
+- Do not add ad-hoc validation sections (for example, "Validation" or "Tests run"); CI/CD and the template checklist cover validation status.
+
+## Quick Reference
+
+Run `uv run poe` from the `python/` directory to see available commands. See [DEV_SETUP.md](DEV_SETUP.md) for detailed usage.
+
+## Project Structure
+
+```
+python/
+├── packages/
+│   ├── core/                 # agent-framework-core (main package)
+│   │   ├── agent_framework/  # Public API exports
+│   │   └── tests/
+│   ├── foundry/              # agent-framework-foundry
+│   ├── anthropic/            # agent-framework-anthropic
+│   ├── ollama/               # agent-framework-ollama
+│   └── ...                   # Other provider packages
+├── samples/                  # Sample code and examples
+├── .github/skills/           # Agent skills for Copilot
+└── tests/                    # Integration tests
+```
+
+### Package Relationships
+
+- `agent-framework-core` contains core abstractions and OpenAI/Azure OpenAI built-in
+- Provider packages (`foundry`, `anthropic`, etc.) extend core with specific integrations
+- Core uses lazy loading via `__getattr__` in provider folders (e.g., `agent_framework/azure/`)
+
+## Package Documentation
+
+### Core
+- [core](packages/core/AGENTS.md) - Core abstractions, types, and built-in OpenAI/Azure OpenAI support
+
+### LLM Providers
+- [anthropic](packages/anthropic/AGENTS.md) - Anthropic Claude API
+- [bedrock](packages/bedrock/AGENTS.md) - AWS Bedrock
+- [claude](packages/claude/AGENTS.md) - Claude Agent SDK
+- [foundry_local](packages/foundry_local/AGENTS.md) - Azure AI Foundry Local
+- [ollama](packages/ollama/AGENTS.md) - Local Ollama inference
+
+### Azure Integrations
+- [foundry](packages/foundry/README.md) - Microsoft Foundry chat, agent, memory, and embedding integrations
+- [azure-contentunderstanding](packages/azure-contentunderstanding/AGENTS.md) - Azure Content Understanding context provider
+- [azure-ai-search](packages/azure-ai-search/AGENTS.md) - Azure AI Search RAG
+- [azure-cosmos](packages/azure-cosmos/AGENTS.md) - Azure Cosmos DB-backed history provider
+- [azurefunctions](packages/azurefunctions/AGENTS.md) - Azure Functions hosting
+
+### Protocols & UI
+- [a2a](packages/a2a/AGENTS.md) - Agent-to-Agent protocol
+- [ag-ui](packages/ag-ui/AGENTS.md) - AG-UI protocol
+- [chatkit](packages/chatkit/AGENTS.md) - OpenAI ChatKit integration
+- [devui](packages/devui/AGENTS.md) - Developer UI for testing
+
+### Storage & Memory
+- [mem0](packages/mem0/AGENTS.md) - Mem0 memory integration
+- [redis](packages/redis/AGENTS.md) - Redis storage
+
+### Infrastructure
+- [copilotstudio](packages/copilotstudio/AGENTS.md) - Microsoft Copilot Studio
+- [declarative](packages/declarative/AGENTS.md) - YAML/JSON agent definitions
+- [durabletask](packages/durabletask/AGENTS.md) - Durable execution
+- [github_copilot](packages/github_copilot/AGENTS.md) - GitHub Copilot extensions
+- [purview](packages/purview/AGENTS.md) - Data governance
+
+### Experimental
+- [lab](packages/lab/AGENTS.md) - Experimental features