agentic-systems 1.1.3__tar.gz → 2.0.0__tar.gz

{agentic_systems-1.1.3 → agentic_systems-2.0.0}/CHANGELOG.md

@@ -1,6 +1,84 @@
 # Changelog
 
 All notable changes to Agentic Systems are documented here.
+## 2.0.0 - 2026-08-19
+
+Stable release of the unified computation model. The stable API contains 78
+top-level exports, 370 traced export/member IDs, and 10 shared contract scenarios.
+
+### Added
+
+- `Executable`, `ExecutionPlan`, `SequentialPlan`, and `ParallelPlan` as the
+  common contract for tools, agents, pipelines, and systems.
+- Hierarchical `RunResult` values with execution and parent identity, child
+  results, and tree traversal.
+- `ToolSet` as the public name for a namespaced collection of tools.
+- Pure `toolkit.skill(path=...)` loading without a hidden `AgenticSystem`.
+- `ModelProviderConfig` and `toolkit.provider(...)`, separating provider
+  configuration from runtime execution.
+- `Agent.pipeline(...)`, `AgenticSystem.add(...)`, `compile(...)`, and direct
+  system `run`/`arun` execution.
+- Generic `Evaluator.evaluate(...)` support for any executable agent or system.
+- A public 5 Provider x 4 Framework compatibility report and matrix notebook
+  covering all 20 combinations.
+- Portable `vllm`/`vllm-client` extras and a separate `vllm-server` extra.
+- Real Native, LangGraph, OpenAI Agents, and Strands adapter dispatch.
+- FrameworkConfig, exact native kwargs forwarding, Agent.prepare,
+  Agent.native_agent, and RunResult.native_result.
+- Offline 5 Provider x 4 Framework certification with fake transports and real
+  Framework SDK loops.
+- Layered 21-notebook Python curriculum mirrored by 21 preserved-output CLI notebooks.
+- Deterministic Framework and matrix tutorials executed from clean kernels.
+- OpenAI Agents offline certification for mixed Tools, typed output, sessions, guardrails and handoffs.
+- Strands offline certification for mixed Tools, hooks, structured output and sync/async execution.
+- Native Strands MCP certification over local stdio and Streamable HTTP
+  transports, executed through the deterministic Python Provider.
+- Non-secret Provider environment snapshots now load the nearest `.env`
+  consistently with runtime factories and the CLI; OpenAI gains the symmetric
+  `openai_environment_snapshot()` public helper.
+- OpenAI Agents tracing is disabled per run by default for non-OpenAI Providers,
+  preventing cross-provider trace export when several credentials coexist.
+- Native Bedrock API-key recognition across auto resolution, diagnostics, and
+  notebook readiness. `AWS_BEARER_TOKEN_BEDROCK` and the standard AWS credential
+  chain are two authentication modes of the same boto3 `bedrock-runtime`
+  Provider; boto3/botocore >=1.39 is required for the Bearer mode.
+- Agentic Systems Studio as a portable product bundle with ten independently
+  reusable system bundles, a system creator, SQLite catalog, Mermaid topology,
+  notebooks, CLI, tests and sandbox validation.
+- A standalone, reproducible `agentic-systems-skill-2.0.0.zip` skill artifact.
+
+### Removed
+
+- providers.python_direct, engines.python_direct, PYTHON_DIRECT_ENGINE,
+  and the tools.compat quarantine.
+- Runtime engine coercion, include_aliases, and output_contains aliases.
+- style-only and declarative-only Framework states.
+- The Bedrock-specific OpenAI Agents bridge, its nine public helper methods and
+  its `disable_openai_runtime_tracing` constructor option. OpenAI Agents over
+  Bedrock now uses the general Framework adapter exclusively.
+- All disable_framework_tracing parameters. 2.0 has no parallel public switch
+  or shim; native SDK configuration remains available, with a safe no-egress
+  default for OpenAI Agents runs backed by non-OpenAI Providers.
+- The domain-specific `tutorials/skills/accountability_otc` legacy tutorial and
+  its private-data-shaped tests. The neutral `tutorial_api_inspection` filesystem
+  Skill now teaches the 2.0 runtime Skill contract; OTC assets are absent from
+  release bundles.
+
+The tutorial gate executes 17 deterministic notebooks, validates 4 Provider notebooks
+offline, and verifies 21 preserved-output CLI notebooks mapped 1:1 to the Python curriculum.
+
+Live OpenAI and local Ollama `qwen3:4b` evidence passed all four Frameworks
+through the strict matrix gate with real tool calls and normalized `RunResult`
+values; Ollama executed 100% on an NVIDIA GPU. Bedrock bearer authentication and
+inference-profile discovery passed, but live agent execution is not certified
+because the account returned its daily-token `ThrottlingException`. Bedrock IAM
+and vLLM server evidence remain external until their environments execute the
+same `--live --require-pass` route.
+The Bedrock ratchet rises to 100% over all 620 remaining statements.
+Branch ratchets are fixed at Core 98.1%, Providers 97.7%, and Frameworks 98.8%;
+each threshold is the measured alpha result truncated to one decimal and may
+only increase.
+
 
 ## 1.1.3 - 2026-08-11
 

{agentic_systems-1.1.3/src/agentic_systems.egg-info → agentic_systems-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentic-systems
-Version: 1.1.3
+Version: 2.0.0
 Summary: Agentic Systems: a computational grammar for building, executing, observing, and evaluating intelligent systems.
 Author-email: Jacobo Gerardo Gonzalez Leon <jacobogerardo.gonzalez@bbva.com>
 License-Expression: MIT
@@ -21,16 +21,25 @@ Requires-Dist: pandas>=2.0.0
 Requires-Dist: typing-extensions>=4.10.0
 Requires-Dist: rich>=13.0.0
 Provides-Extra: bedrock
-Requires-Dist: boto3>=1.34.0; extra == "bedrock"
-Requires-Dist: botocore>=1.34.0; extra == "bedrock"
+Requires-Dist: boto3>=1.39.0; extra == "bedrock"
+Requires-Dist: botocore>=1.39.0; extra == "bedrock"
 Provides-Extra: langgraph
 Requires-Dist: langgraph>=0.2.0; extra == "langgraph"
 Requires-Dist: typing-extensions>=4.10.0; extra == "langgraph"
 Provides-Extra: openai
-Requires-Dist: openai>=1.0.0; extra == "openai"
+Requires-Dist: openai<3,>=2.45.0; extra == "openai"
+Provides-Extra: openai-agents
+Requires-Dist: openai-agents<0.19,>=0.18.3; extra == "openai-agents"
+Provides-Extra: strands
+Requires-Dist: strands-agents<2,>=1.29.0; extra == "strands"
+Requires-Dist: mcp<2,>=1; extra == "strands"
 Provides-Extra: vllm
-Requires-Dist: vllm>=0.9.0; extra == "vllm"
-Requires-Dist: openai>=1.0.0; extra == "vllm"
+Requires-Dist: openai<3,>=2.45.0; extra == "vllm"
+Provides-Extra: vllm-client
+Requires-Dist: openai<3,>=2.45.0; extra == "vllm-client"
+Provides-Extra: vllm-server
+Requires-Dist: vllm>=0.9.0; extra == "vllm-server"
+Requires-Dist: openai<3,>=2.45.0; extra == "vllm-server"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
@@ -41,11 +50,13 @@ Requires-Dist: jupyterlab>=4.0.0; extra == "dev"
 Requires-Dist: nbclient>=0.10.0; extra == "dev"
 Requires-Dist: nbformat>=5.10.0; extra == "dev"
 Provides-Extra: all
-Requires-Dist: boto3>=1.34.0; extra == "all"
-Requires-Dist: botocore>=1.34.0; extra == "all"
+Requires-Dist: boto3>=1.39.0; extra == "all"
+Requires-Dist: botocore>=1.39.0; extra == "all"
 Requires-Dist: langgraph>=0.2.0; extra == "all"
-Requires-Dist: openai>=1.0.0; extra == "all"
-Requires-Dist: vllm>=0.9.0; extra == "all"
+Requires-Dist: openai<3,>=2.45.0; extra == "all"
+Requires-Dist: openai-agents<0.19,>=0.18.3; extra == "all"
+Requires-Dist: strands-agents<2,>=1.29.0; extra == "all"
+Requires-Dist: mcp<2,>=1; extra == "all"
 Requires-Dist: ipykernel>=6.0.0; extra == "all"
 Requires-Dist: jupyterlab>=4.0.0; extra == "all"
 Requires-Dist: nbclient>=0.10.0; extra == "all"
@@ -79,7 +90,7 @@ Its Python API turns that grammar into explicit, composable abstractions: tools,
 
 Use it when agentic workloads need to be observable, testable, portable and ready for repeated execution, not just notebook demos.
 
-Agentic Systems 1.1 keeps explicit traceability between its API,
+Agentic Systems 2.0 keeps explicit traceability between its API,
 documentation, tutorials, and tests.
 
 ```text
@@ -88,7 +99,7 @@ API -> Docs -> Tutorials -> explicit automated or manual evidence
 
 Public concepts are defined in the API, explained in the documentation, taught through the canonical tutorials, and checked by explicit release gates.
 
-Release status: `1.1.3` consolidates the current documentation and owner-based test architecture while preserving the 111-symbol public API and 1.1 runtime behavior.
+Release status: `2.0.0` is the Provider x Framework architecture: 78 stable top-level exports, 370 traced export/member IDs, 10 shared contract scenarios, four real Framework adapters, and no silent fallback.
 
 ## Installation
 
@@ -100,6 +111,31 @@ pip install agentic-systems
 import agentic_systems as toolkit
 ```
 
+### Install the Agentic Systems skill
+
+The `v2.0.0` GitHub release includes a credential-free skill ZIP whose archive
+root is `agentic-systems/`.
+
+```powershell
+Expand-Archive .\agentic-systems-skill-2.0.0.zip `
+  -DestinationPath "$env:USERPROFILE\.codex\skills" -Force
+```
+
+```bash
+unzip agentic-systems-skill-2.0.0.zip -d ~/.codex/skills
+```
+
+Restart or reload Codex, then invoke `$agentic-systems`. OpenAI Skills upload
+surfaces that accept a ZIP can consume the same artifact. Download the
+standalone skill and the complete ten-system Studio from the
+[v2.0.0 release](https://github.com/JacoboGGLeon/agentic_systems/releases/tag/v2.0.0).
+
+Release assets:
+
+- `agentic-systems-skill-2.0.0.zip`: Codex/OpenAI skill package.
+- `agentic-systems-studio-2.0.0.zip`: portable Studio with ten nested systems.
+- `SHA256SUMS-2.0.0.txt`: hashes for the Python and product artifacts.
+
 For an installed-package smoke test and provider notebook setup, follow
 [First Run Onboarding](docs/ONBOARDING_FIRST_RUN.md).
 
@@ -128,7 +164,7 @@ Agentic Systems represents those concerns as a computational grammar: runtime, t
 | Environments | Episodic execution over records, transitions, rewards and history. |
 | Evals | Repeatable validation cases with pass/fail reporting. |
 | Lineage Memory | Human-readable explanation of what happened and why. |
-| Integrations | A portable Graph backend, an optional LangGraph adapter, and explicit framework identities. |
+| Integrations | Native, LangGraph, OpenAI Agents, and Strands execution over explicit Providers. |
 
 ## Core Model
 
@@ -161,17 +197,17 @@ Canonical providers:
 | `python-runtime` | Local deterministic execution for tools, policies and smoke tests. |
 | `auto` | Selects a concrete provider from environment signals before execution. |
 
-Default `provider="auto"` priority is `bedrock-runtime`, then `openai-runtime`, then `vllm-runtime`. Override it with `provider_priority=[...]` or `AGENTIC_SYSTEMS_PROVIDER_PRIORITY=...`. Bedrock is considered configured only when both a region and an AWS authentication signal are present; a region alone does not outrank a usable OpenAI or vLLM configuration.
+Default `provider="auto"` priority is `bedrock-runtime`, then `openai-runtime`, `vllm-runtime`, and `ollama-runtime`. Override it with `provider_priority=[...]` or `AGENTIC_SYSTEMS_PROVIDER_PRIORITY=...`. Bedrock is considered configured only when both a region and an AWS authentication signal are present. That signal may be the standard AWS credential chain (signed with SigV4) or the native `AWS_BEARER_TOKEN_BEDROCK` API key; both use the same boto3 `bedrock-runtime` Provider and a region alone does not outrank another usable Provider.
 
 Canonical framework facades:
 
 | Framework | Use |
 |---|---|
 | `langgraph` | LangGraph graph orchestration. |
-| `openai-agents` | Style-only identity over the selected runtime; no OpenAI Agents SDK adapter. |
-| `strands` | Declarative compatibility identity; no Strands SDK adapter. |
+| `openai-agents` | OpenAI Agents `Runner`, native Tools, handoffs, guardrails, sessions and MCP. |
+| `strands` | `strands.Agent`, native Tools/MCP, hooks and lifecycle. |
 
-Providers decide where execution runs. A real Framework adapter may own the outer orchestration loop; an accepted framework label alone does not prove adapter execution. Configuration details live in `docs/ONBOARDING_FIRST_RUN.md`, `docs/CLI.md` and the `tutorials/00_runtime_*` notebooks.
+Providers decide where inference runs. The selected Framework always owns its orchestration loop, and `RunResult.meta["framework_adapter"]` records the adapter that executed. Configuration details live in docs/ONBOARDING_FIRST_RUN.md, docs/CLI.md and the layered tutorials/core, tutorials/providers and tutorials/frameworks paths.
 
 ## From Zero-to-Hero
 
@@ -402,42 +438,32 @@ The CLI is for inspection, diagnostics and packaging smoke tests. It should not
 
 ## Tutorials
 
-The official learning path is `tutorials/`. It explains and exercises the public API directly from `import agentic_systems as toolkit`.
+The canonical learning path is layered by responsibility:
+
+| Layer | Purpose | Default execution |
+|---|---|---|
+| tutorials/core | Agentic Systems grammar and composition | Python Runtime, Native Framework, portable Graph |
+| tutorials/providers | Inference boundary | Explicit preflight; external execution when configured |
+| tutorials/frameworks | Native orchestration SDK | Real SDK offline; Provider auto is optional |
+| tutorials/api | Exact public contract | Generated manifest, documentation and CLI/Pytest traceability |
 
-Provider notebooks require no activation cell. Configure the external boundary,
-open the corresponding notebook, and choose **Run All**:
+Provider notebooks use one public route and choose Run All:
 
 | Provider | Readiness inputs | Notebook |
 |---|---|---|
-| OpenAI | `OPENAI_API_KEY`; optional `OPENAI_MODEL` | `00_runtime_openai_provider_api.ipynb` |
-| vLLM | `VLLM_BASE_URL` and `VLLM_MODEL` | `00_runtime_vllm_provider_api.ipynb` |
-| Bedrock | Standard AWS credential chain; optional model/region overrides | `00_runtime_bedrock_provider_api.ipynb` |
+| OpenAI | OPENAI_API_KEY; OPENAI_MODEL optional | tutorials/providers/01_openai.ipynb |
+| vLLM | VLLM_BASE_URL and VLLM_MODEL | tutorials/providers/03_vllm.ipynb |
+| Bedrock | Region plus SigV4 credentials or AWS_BEARER_TOKEN_BEDROCK | tutorials/providers/02_bedrock.ipynb |
+| Ollama | OLLAMA_MODEL; OLLAMA_BASE_URL optional | tutorials/providers/04_ollama.ipynb |
 
-Live execution is the default when readiness passes. A provider-specific
-`RUN_*_LIVE=0` is an explicit opt-out, not a prerequisite.
-
-```text
-tutorials/00_runtime_api.ipynb
-tutorials/00_runtime_bedrock_provider_api.ipynb
-tutorials/00_runtime_openai_provider_api.ipynb
-tutorials/00_runtime_scheduler_api.ipynb
-tutorials/00_runtime_vllm_provider_api.ipynb
-tutorials/01_tool_api.ipynb
-tutorials/02_skill_api.ipynb
-tutorials/03_agent_api.ipynb
-tutorials/04_human_result_api.ipynb
-tutorials/05_lineage_memory_api.ipynb
-tutorials/06_integrations_strands_api.ipynb
-tutorials/07_integrations_openai_runtime_api.ipynb
-tutorials/08_system_api.ipynb
-tutorials/09_graph_api.ipynb
-tutorials/10_environment_eval_api.ipynb
-tutorials/11_single_agentic_system_api.ipynb
-tutorials/12_multi_agentic_system_api.ipynb
-tutorials/13_multi_agentic_graph_api.ipynb
-```
+The Framework notebooks execute LangGraph, OpenAI Agents and Strands SDKs for
+real with python-runtime; the matrix notebook covers all 20 declared pairs.
+Optional RUN_*_LIVE=1 changes only the Provider.
+RUN_*_LIVE=0 forces a fully offline validation.
 
-There is no active `examples/` root. Tutorials are the executable documentation.
+The full ordered inventory of 21 Python notebooks and their 21 CLI mirrors lives in
+tutorials/README.md. There is no active examples/ root or duplicate notebook
+route.
 
 ## Documentation
 
@@ -451,12 +477,12 @@ evidence belongs to GitHub Releases.
 Current verified status:
 
 ```text
-Version: 1.1.3
+Version: 2.0.0
 PyPI package: agentic-systems
 Tests: run `python -m pytest` for the current count
 Core coverage: 100.00%
-Coverage scope: Bedrock facade and internal package excluded from core; separately gated at 53.1%
-Canonical notebooks: 13 deterministic executed; 5 Provider notebooks checked statically
+Coverage scope: Bedrock facade and internal package excluded from core; separately gated at 100%
+Canonical notebooks: 17 deterministic executed; 3 live Provider notebooks checked statically
 
 ```
 

{agentic_systems-1.1.3 → agentic_systems-2.0.0}/README.md

@@ -22,7 +22,7 @@ Its Python API turns that grammar into explicit, composable abstractions: tools,
 
 Use it when agentic workloads need to be observable, testable, portable and ready for repeated execution, not just notebook demos.
 
-Agentic Systems 1.1 keeps explicit traceability between its API,
+Agentic Systems 2.0 keeps explicit traceability between its API,
 documentation, tutorials, and tests.
 
 ```text
@@ -31,7 +31,7 @@ API -> Docs -> Tutorials -> explicit automated or manual evidence
 
 Public concepts are defined in the API, explained in the documentation, taught through the canonical tutorials, and checked by explicit release gates.
 
-Release status: `1.1.3` consolidates the current documentation and owner-based test architecture while preserving the 111-symbol public API and 1.1 runtime behavior.
+Release status: `2.0.0` is the Provider x Framework architecture: 78 stable top-level exports, 370 traced export/member IDs, 10 shared contract scenarios, four real Framework adapters, and no silent fallback.
 
 ## Installation
 
@@ -43,6 +43,31 @@ pip install agentic-systems
 import agentic_systems as toolkit
 ```
 
+### Install the Agentic Systems skill
+
+The `v2.0.0` GitHub release includes a credential-free skill ZIP whose archive
+root is `agentic-systems/`.
+
+```powershell
+Expand-Archive .\agentic-systems-skill-2.0.0.zip `
+  -DestinationPath "$env:USERPROFILE\.codex\skills" -Force
+```
+
+```bash
+unzip agentic-systems-skill-2.0.0.zip -d ~/.codex/skills
+```
+
+Restart or reload Codex, then invoke `$agentic-systems`. OpenAI Skills upload
+surfaces that accept a ZIP can consume the same artifact. Download the
+standalone skill and the complete ten-system Studio from the
+[v2.0.0 release](https://github.com/JacoboGGLeon/agentic_systems/releases/tag/v2.0.0).
+
+Release assets:
+
+- `agentic-systems-skill-2.0.0.zip`: Codex/OpenAI skill package.
+- `agentic-systems-studio-2.0.0.zip`: portable Studio with ten nested systems.
+- `SHA256SUMS-2.0.0.txt`: hashes for the Python and product artifacts.
+
 For an installed-package smoke test and provider notebook setup, follow
 [First Run Onboarding](docs/ONBOARDING_FIRST_RUN.md).
 
@@ -71,7 +96,7 @@ Agentic Systems represents those concerns as a computational grammar: runtime, t
 | Environments | Episodic execution over records, transitions, rewards and history. |
 | Evals | Repeatable validation cases with pass/fail reporting. |
 | Lineage Memory | Human-readable explanation of what happened and why. |
-| Integrations | A portable Graph backend, an optional LangGraph adapter, and explicit framework identities. |
+| Integrations | Native, LangGraph, OpenAI Agents, and Strands execution over explicit Providers. |
 
 ## Core Model
 
@@ -104,17 +129,17 @@ Canonical providers:
 | `python-runtime` | Local deterministic execution for tools, policies and smoke tests. |
 | `auto` | Selects a concrete provider from environment signals before execution. |
 
-Default `provider="auto"` priority is `bedrock-runtime`, then `openai-runtime`, then `vllm-runtime`. Override it with `provider_priority=[...]` or `AGENTIC_SYSTEMS_PROVIDER_PRIORITY=...`. Bedrock is considered configured only when both a region and an AWS authentication signal are present; a region alone does not outrank a usable OpenAI or vLLM configuration.
+Default `provider="auto"` priority is `bedrock-runtime`, then `openai-runtime`, `vllm-runtime`, and `ollama-runtime`. Override it with `provider_priority=[...]` or `AGENTIC_SYSTEMS_PROVIDER_PRIORITY=...`. Bedrock is considered configured only when both a region and an AWS authentication signal are present. That signal may be the standard AWS credential chain (signed with SigV4) or the native `AWS_BEARER_TOKEN_BEDROCK` API key; both use the same boto3 `bedrock-runtime` Provider and a region alone does not outrank another usable Provider.
 
 Canonical framework facades:
 
 | Framework | Use |
 |---|---|
 | `langgraph` | LangGraph graph orchestration. |
-| `openai-agents` | Style-only identity over the selected runtime; no OpenAI Agents SDK adapter. |
-| `strands` | Declarative compatibility identity; no Strands SDK adapter. |
+| `openai-agents` | OpenAI Agents `Runner`, native Tools, handoffs, guardrails, sessions and MCP. |
+| `strands` | `strands.Agent`, native Tools/MCP, hooks and lifecycle. |
 
-Providers decide where execution runs. A real Framework adapter may own the outer orchestration loop; an accepted framework label alone does not prove adapter execution. Configuration details live in `docs/ONBOARDING_FIRST_RUN.md`, `docs/CLI.md` and the `tutorials/00_runtime_*` notebooks.
+Providers decide where inference runs. The selected Framework always owns its orchestration loop, and `RunResult.meta["framework_adapter"]` records the adapter that executed. Configuration details live in docs/ONBOARDING_FIRST_RUN.md, docs/CLI.md and the layered tutorials/core, tutorials/providers and tutorials/frameworks paths.
 
 ## From Zero-to-Hero
 
@@ -345,42 +370,32 @@ The CLI is for inspection, diagnostics and packaging smoke tests. It should not
 
 ## Tutorials
 
-The official learning path is `tutorials/`. It explains and exercises the public API directly from `import agentic_systems as toolkit`.
+The canonical learning path is layered by responsibility:
+
+| Layer | Purpose | Default execution |
+|---|---|---|
+| tutorials/core | Agentic Systems grammar and composition | Python Runtime, Native Framework, portable Graph |
+| tutorials/providers | Inference boundary | Explicit preflight; external execution when configured |
+| tutorials/frameworks | Native orchestration SDK | Real SDK offline; Provider auto is optional |
+| tutorials/api | Exact public contract | Generated manifest, documentation and CLI/Pytest traceability |
 
-Provider notebooks require no activation cell. Configure the external boundary,
-open the corresponding notebook, and choose **Run All**:
+Provider notebooks use one public route and choose Run All:
 
 | Provider | Readiness inputs | Notebook |
 |---|---|---|
-| OpenAI | `OPENAI_API_KEY`; optional `OPENAI_MODEL` | `00_runtime_openai_provider_api.ipynb` |
-| vLLM | `VLLM_BASE_URL` and `VLLM_MODEL` | `00_runtime_vllm_provider_api.ipynb` |
-| Bedrock | Standard AWS credential chain; optional model/region overrides | `00_runtime_bedrock_provider_api.ipynb` |
+| OpenAI | OPENAI_API_KEY; OPENAI_MODEL optional | tutorials/providers/01_openai.ipynb |
+| vLLM | VLLM_BASE_URL and VLLM_MODEL | tutorials/providers/03_vllm.ipynb |
+| Bedrock | Region plus SigV4 credentials or AWS_BEARER_TOKEN_BEDROCK | tutorials/providers/02_bedrock.ipynb |
+| Ollama | OLLAMA_MODEL; OLLAMA_BASE_URL optional | tutorials/providers/04_ollama.ipynb |
 
-Live execution is the default when readiness passes. A provider-specific
-`RUN_*_LIVE=0` is an explicit opt-out, not a prerequisite.
-
-```text
-tutorials/00_runtime_api.ipynb
-tutorials/00_runtime_bedrock_provider_api.ipynb
-tutorials/00_runtime_openai_provider_api.ipynb
-tutorials/00_runtime_scheduler_api.ipynb
-tutorials/00_runtime_vllm_provider_api.ipynb
-tutorials/01_tool_api.ipynb
-tutorials/02_skill_api.ipynb
-tutorials/03_agent_api.ipynb
-tutorials/04_human_result_api.ipynb
-tutorials/05_lineage_memory_api.ipynb
-tutorials/06_integrations_strands_api.ipynb
-tutorials/07_integrations_openai_runtime_api.ipynb
-tutorials/08_system_api.ipynb
-tutorials/09_graph_api.ipynb
-tutorials/10_environment_eval_api.ipynb
-tutorials/11_single_agentic_system_api.ipynb
-tutorials/12_multi_agentic_system_api.ipynb
-tutorials/13_multi_agentic_graph_api.ipynb
-```
+The Framework notebooks execute LangGraph, OpenAI Agents and Strands SDKs for
+real with python-runtime; the matrix notebook covers all 20 declared pairs.
+Optional RUN_*_LIVE=1 changes only the Provider.
+RUN_*_LIVE=0 forces a fully offline validation.
 
-There is no active `examples/` root. Tutorials are the executable documentation.
+The full ordered inventory of 21 Python notebooks and their 21 CLI mirrors lives in
+tutorials/README.md. There is no active examples/ root or duplicate notebook
+route.
 
 ## Documentation
 
@@ -394,12 +409,12 @@ evidence belongs to GitHub Releases.
 Current verified status:
 
 ```text
-Version: 1.1.3
+Version: 2.0.0
 PyPI package: agentic-systems
 Tests: run `python -m pytest` for the current count
 Core coverage: 100.00%
-Coverage scope: Bedrock facade and internal package excluded from core; separately gated at 53.1%
-Canonical notebooks: 13 deterministic executed; 5 Provider notebooks checked statically
+Coverage scope: Bedrock facade and internal package excluded from core; separately gated at 100%
+Canonical notebooks: 17 deterministic executed; 3 live Provider notebooks checked statically
 
 ```
 

{agentic_systems-1.1.3 → agentic_systems-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentic-systems"
-version = "1.1.3"
+version = "2.0.0"
 description = "Agentic Systems: a computational grammar for building, executing, observing, and evaluating intelligent systems."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -33,10 +33,14 @@ Repository = "https://www.github.com/JacoboGGLeon/agentic_systems"
 LinkedIn = "https://www.linkedin.com/in/jacoboggleon/"
 
 [project.optional-dependencies]
-bedrock = ["boto3>=1.34.0", "botocore>=1.34.0"]
+bedrock = ["boto3>=1.39.0", "botocore>=1.39.0"]
 langgraph = ["langgraph>=0.2.0", "typing-extensions>=4.10.0"]
-openai = ["openai>=1.0.0"]
-vllm = ["vllm>=0.9.0", "openai>=1.0.0"]
+openai = ["openai>=2.45.0,<3"]
+openai-agents = ["openai-agents>=0.18.3,<0.19"]
+strands = ["strands-agents>=1.29.0,<2", "mcp>=1,<2"]
+vllm = ["openai>=2.45.0,<3"]
+vllm-client = ["openai>=2.45.0,<3"]
+vllm-server = ["vllm>=0.9.0", "openai>=2.45.0,<3"]
 dev = [
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
@@ -48,11 +52,13 @@ dev = [
     "nbformat>=5.10.0",
 ]
 all = [
-    "boto3>=1.34.0",
-    "botocore>=1.34.0",
+    "boto3>=1.39.0",
+    "botocore>=1.39.0",
     "langgraph>=0.2.0",
-    "openai>=1.0.0",
-    "vllm>=0.9.0",
+    "openai>=2.45.0,<3",
+    "openai-agents>=0.18.3,<0.19",
+    "strands-agents>=1.29.0,<2",
+    "mcp>=1,<2",
     "ipykernel>=6.0.0",
     "jupyterlab>=4.0.0",
     "nbclient>=0.10.0",
@@ -71,6 +77,9 @@ where = ["src"]
 include = ["agentic_systems*"]
 
 [tool.pytest.ini_options]
+filterwarnings = [
+    "ignore:'asyncio.get_event_loop_policy' is deprecated and slated for removal in Python 3.16:DeprecationWarning:agents\\.run",
+]
 pythonpath = ["src"]
 testpaths = ["tests"]
 cache_dir = ".tmp/pytest_cache"

{agentic_systems-1.1.3 → agentic_systems-2.0.0}/src/agentic_systems/__init__.py

@@ -1,6 +1,13 @@
 """Agentic Systems public API."""
 
 from . import core, providers, integrations
+from .compatibility import (
+    CompatibilityCase,
+    FRAMEWORK_NAMES,
+    PROVIDER_NAMES,
+    compatibility_matrix,
+    compatibility_report,
+)
 from .agents import Agent
 from .api import PUBLIC_API as _PUBLIC_API
 from .factories import (
@@ -8,19 +15,34 @@ from .factories import (
     default_model_id,
     default_region,
     environment,
+    framework,
     eval,
     load_skill,
     runtime,
+    provider,
     scheduler,
     skill,
     system,
+    toolset,
     output_schema,
 )
+from .api_contract import api_contract, exercise_api
 from .bedrock_runtime_client import BedrockRuntimeClient, DEFAULT_EMBEDDING_MODEL_ID
 from .chain import Chain, ChainStep
-from .contracts import AgentContract, ContractPolicySpec, RunPolicy, ToolExpectationValue, ValidationIssue, ValidationResult, normalize_tool_expectation, validate_contract_policy, validate_tool_expectation
+from .contracts import (
+    AgentContract,
+    ContractPolicySpec,
+    RunPolicy,
+    ToolExpectationValue,
+    ValidationIssue,
+    ValidationResult,
+    normalize_tool_expectation,
+    validate_contract_policy,
+    validate_tool_expectation,
+)
 from .engines.names import (
     BEDROCK_RUNTIME_ENGINE,
+    OLLAMA_RUNTIME_ENGINE,
     OPENAI_RUNTIME_ENGINE,
     PYTHON_RUNTIME_ENGINE,
     VLLM_RUNTIME_ENGINE,
@@ -52,6 +74,7 @@ from .integrations.langgraph import (
     lineage_from_langgraph_result,
     lineage_from_langgraph_state,
 )
+from .integrations.config import FrameworkConfig
 from .output_contracts import (
     AGENTIC_OUTPUT_SCHEMA_VERSION,
     AgenticOutput,
@@ -64,13 +87,37 @@ from .output_contracts import (
     UsageInfo,
 )
 from .results import TRACE_SCHEMA_VERSION, RunResult
+from .execution import (
+    AsyncExecutable,
+    CallableExecutable,
+    Executable,
+    ExecutionPlan,
+    CompiledSystem,
+    SequentialPlan,
+    ParallelPlan,
+    coerce_run_result,
+    is_executable,
+)
 from .lineage import LINEAGE_SCHEMA_VERSION, LineageMemory, LineageStep, lineage_memory
-from .final_answer import FINAL_ANSWER_SCHEMA_VERSION, OutputSchema, final_answer, normalize_output
-from .core.runtime import AUTO_PROVIDER_ENV_VAR, DEFAULT_AUTO_PROVIDER_PRIORITY, RuntimeConfig, normalize_provider_priority, resolve_auto_provider
+from .final_answer import (
+    FINAL_ANSWER_SCHEMA_VERSION,
+    OutputSchema,
+    final_answer,
+    normalize_output,
+)
+from .core.provider import ModelProviderConfig
+from .core.runtime import (
+    AUTO_PROVIDER_ENV_VAR,
+    DEFAULT_AUTO_PROVIDER_PRIORITY,
+    RuntimeConfig,
+    normalize_provider_priority,
+    resolve_auto_provider,
+)
 from .core.scheduler import SchedulerConfig
 from .skills import LoadedSkill, Skill, SkillManifest
 from .system import AgenticSystem, InspectReport, PublicToolRegistry
 from .tools import Tool, tool
+from .tools import ToolSet, ToolSetRef
 from .human_output import human_result
 from .utils import (
     AGENT_OUTPUT_SCHEMA_VERSION,
@@ -97,9 +144,15 @@ from .utils import (
     compose_result,
     tool_result_summary,
 )
+from .providers.openai_runtime import openai_environment_snapshot
+from .providers.ollama_runtime import ollama_environment_snapshot
 from .providers.vllm_runtime import vllm_environment_snapshot
 
-__version__ = "1.1.3"
+__version__ = "2.0.0"
 
 __all__ = list(_PUBLIC_API)
 del _PUBLIC_API
+for _name in tuple(globals()):
+    if not _name.startswith("_") and _name not in __all__:
+        del globals()[_name]
+del _name