agentic-systems 1.0.0__tar.gz

agentic_systems-1.0.0/MANIFEST.in

@@ -0,0 +1,10 @@
+graft src
+include README.md
+include pyproject.toml
+prune tests
+prune tutorials
+prune docs
+prune dist
+prune build
+prune .pytest_cache
+global-exclude __pycache__ *.py[cod]

agentic_systems-1.0.0/PKG-INFO

@@ -0,0 +1,335 @@
+Metadata-Version: 2.4
+Name: agentic-systems
+Version: 1.0.0
+Summary: Agentic Systems: auditable agentic systems with tools, skills, agents, systems, graphs, environments and evals across Python Direct, OpenAI Runtime, Bedrock Runtime and vLLM Runtime.
+Author-email: Jacobo Gerardo Gonzalez Leon <jacobogerardo.gonzalez@bbva.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.github.com/JacoboGGLeon/agentic_systems
+Project-URL: Repository, https://www.github.com/JacoboGGLeon/agentic_systems
+Project-URL: LinkedIn, https://www.linkedin.com/in/jacoboggleon/
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.7.0
+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"
+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"
+Provides-Extra: tutorials
+Requires-Dist: ipykernel>=6.0.0; extra == "tutorials"
+Requires-Dist: jupyterlab>=4.0.0; extra == "tutorials"
+Requires-Dist: pandas>=2.0.0; extra == "tutorials"
+Requires-Dist: rich>=13.0.0; extra == "tutorials"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: ruff>=0.6.1; extra == "dev"
+Provides-Extra: all
+Requires-Dist: boto3>=1.34.0; extra == "all"
+Requires-Dist: botocore>=1.34.0; extra == "all"
+Requires-Dist: langgraph>=0.2.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: ipykernel>=6.0.0; extra == "all"
+Requires-Dist: jupyterlab>=4.0.0; extra == "all"
+Requires-Dist: pytest>=8.0.0; extra == "all"
+Requires-Dist: pytest-cov>=5.0.0; extra == "all"
+Requires-Dist: ruff>=0.6.1; extra == "all"
+
+# Agentic Systems
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/JacoboGGLeon/agentic_systems/main/docs/assets/logo_agentic_systems.png" alt="Agentic Systems logo" width="360" />
+</p>
+
+
+Agentic Systems is a Python library for building, running and evaluating
+auditable agentic systems with tools, skills, agents, systems, graphs,
+environments, evals, contracts, lineage memory and stable human output.
+
+Use the public facade as the stable entry point:
+
+```python
+import agentic_systems as toolkit
+```
+
+Agentic Systems exposes five practical routes:
+
+```text
+toolkit       top-level public facade for normal user code
+primitives    Tool, Skill, Agent, RunResult, contracts, runtime and lineage
+providers     execution backends: python-runtime, openai-runtime, bedrock-runtime, vllm-runtime or auto
+system        AgenticSystem as the native composition layer
+integrations  bridges to external agent frameworks such as LangGraph, Strands and OpenAI Agents
+```
+
+The recommended path is to start with `toolkit`, choose a provider with
+`toolkit.runtime(provider=...)`, use primitives when you need fine control, move
+to `AgenticSystem` when you need a complete auditable system, and use
+integrations only when an external framework should own orchestration. Providers
+can cross with either native systems or integrations: the framework owns the
+loop, while the provider decides where inference or deterministic execution runs.
+
+Agentic Systems supports two agent styles:
+
+```text
+deterministic agents  execute explicit tools and local Python policies with python-runtime
+reasoning agents      use language-model providers such as openai-runtime, bedrock-runtime or vllm-runtime
+```
+
+Both styles share the same lifecycle: tools expose executable capabilities,
+agents transform context into actions, systems/graphs coordinate agents,
+environments run episodes, and evals validate behavior with empirical evidence.
+
+## Quality Gate
+
+Current verified test status is documented in [`docs/PYTEST_COVERAGE_REPORT.md`](docs/PYTEST_COVERAGE_REPORT.md):
+
+```text
+295 passed, 1 skipped
+Coverage: 100.00%
+TOTAL statements: 5173
+TOTAL missing: 0
+```
+
+## What It Exposes
+
+```text
+Tool        executable capability
+Skill       package of tools, instructions, contracts and assets
+Agent       deterministic or reasoning unit that turns context into actions
+System      workspace that registers and composes tools, skills and agents
+Graph       state + nodes + edges orchestration
+Environment episodic execution with reward and history
+Eval        empirical validation and scoring over cases or episodes
+```
+
+Cross-cutting APIs:
+
+```text
+runtime/provider     python-runtime, openai-runtime, bedrock-runtime, vllm-runtime or auto
+scheduler            execution budgets, retries, turns, timeouts and concurrency
+contracts/policies   expected tools, strictness, repair and finalization rules
+Lineage Memory       traceability, context, memory and audit trail
+RunResult            stable execution envelope and final answer
+human_result         readable output for users, notebooks and reviews
+CLI diagnostics      doctor, runtime, API inventory and contact
+```
+
+## Providers And Integrations
+
+Canonical providers:
+
+```text
+python-runtime     deterministic local execution for tools and policies
+openai-runtime    native OpenAI language-model provider
+bedrock-runtime   AWS Bedrock Runtime language-model provider
+vllm-runtime      OpenAI-compatible vLLM provider for local or Colab GPU inference
+auto              environment-based provider selection
+```
+
+Optional integrations:
+
+```text
+LangGraph       graph orchestration framework
+Strands         external agent framework integration
+OpenAI Agents   OpenAI Agents-style framework integration
+```
+
+`provider="auto"` is explicit selection mode. Use `runtime.describe()` or the
+CLI to see what the current environment selects before executing a model. The
+current priority is `vllm-runtime`, then `openai-runtime`, then
+`bedrock-runtime`.
+
+OpenAI runtime reads `OPENAI_API_KEY`, `AGENTIC_SYSTEMS_OPENAI_MODEL_ID`,
+`OPENAI_MODEL_ID`, `OPENAI_MODEL`, `OPENAI_BASE_URL`, `OPENAI_ORG_ID` and
+`OPENAI_PROJECT` from the environment or `.env`. Diagnostics show safe flags,
+not secret values.
+
+vLLM runtime reads `VLLM_BASE_URL`, `VLLM_API_BASE`,
+`AGENTIC_SYSTEMS_VLLM_BASE_URL`, `VLLM_MODEL_ID`, `VLLM_MODEL`,
+`AGENTIC_SYSTEMS_VLLM_MODEL_ID`, `VLLM_API_KEY` and
+`AGENTIC_SYSTEMS_VLLM_API_KEY`. It talks to a running vLLM OpenAI-compatible
+server; the package does not start or install the GPU server by default.
+
+## Quick Start
+
+### Route 1: Toolkit And Primitives
+
+Use this when you want direct control over tools, agents, provider/runtime and results.
+
+```python
+import agentic_systems as toolkit
+
+@toolkit.tool
+def add(a: int, b: int) -> dict:
+    return {"result": a + b}
+
+runtime = toolkit.runtime(provider="python-runtime")
+agent = toolkit.agent(name="calc", tools=[add], runtime=runtime)
+
+result = agent.run({"tool": "add", "input": {"a": 2, "b": 3}}, mode="eval")
+toolkit.human_result(result)
+```
+
+### Route 2: Native System
+
+Use this when you want a complete Agentic Systems workspace that registers and
+composes tools, skills and agents under one auditable system boundary. The
+system still receives a provider through `toolkit.runtime(...)`.
+
+```python
+import agentic_systems as toolkit
+
+system = toolkit.AgenticSystem(model="local-python", runtime=toolkit.runtime(provider="python-runtime"))
+
+@system.tool
+def add(a: int, b: int) -> dict:
+    return {"result": a + b}
+
+agent = system.agent(name="calc", instructions="Use the registered calculator tools.")
+result = agent.run({"tool": "add", "input": {"a": 2, "b": 3}}, mode="eval")
+
+toolkit.human_result(result)
+```
+
+### Route 3: Environment And Evals
+
+Use an environment when execution is episodic: each record becomes a step, the
+system graph updates state, a reward function scores the transition, and history
+keeps auditable evidence. Use evals when you want batch validation over declared
+cases with pass/fail statistics.
+
+```python
+import agentic_systems as toolkit
+
+runtime = toolkit.runtime(provider="python-runtime")
+system = toolkit.AgenticSystem(model="local-python", runtime=runtime)
+
+@system.tool
+def double(value: int) -> dict:
+    return {"value": value * 2, "ok": True}
+
+agent = system.agent(
+    name="doubler",
+    instructions="Call double when the input asks for a doubled value.",
+    tools=["double"],
+)
+
+graph = toolkit.build_single_agent_step_graph(agent)
+records = [
+    {"input": {"tool": "double", "input": {"value": 21}}},
+]
+
+def reward_fn(state, row, action, env) -> float:
+    return 1.0 if state.get("result", {}).get("ok") else 0.0
+
+environment = system.environment(records, graph=graph, reward_fn=reward_fn)
+observation, info = environment.reset(seed=0)
+observation, reward, terminated, truncated, info = environment.step()
+
+toolkit.show(toolkit.environment_summary(environment), title="Environment summary")
+```
+
+```python
+cases = [
+    {
+        "name": "double_21",
+        "input": {"tool": "double", "input": {"value": 21}},
+        "expected": {"data_contains": {"value": 42, "ok": True}},
+    }
+]
+
+report = system.eval(agent, cases)
+toolkit.human_result(report)
+report.raise_if_failed()
+```
+
+### Route 4: Integrations
+
+Use integrations when LangGraph, Strands or OpenAI Agents should own the outer
+framework loop while Agentic Systems keeps the same tools, provider/runtime,
+contracts, lineage and human output conventions.
+
+```python
+runtime = toolkit.runtime(provider="auto")
+agent = toolkit.agent(
+    name="portable_agent",
+    runtime=runtime,
+    framework="openai-agents",
+)
+```
+
+## CLI
+
+```bash
+agentic-systems version
+agentic-systems contact
+agentic-systems doctor --json
+agentic-systems runtime --provider auto --json
+agentic-systems api --tier public --json
+agentic-systems public-api --all --json
+```
+
+## Tutorials
+
+The official learning path is `tutorials/`:
+
+```text
+tutorials/00_runtime_api.ipynb
+tutorials/00_runtime_bedrock_provider_api.ipynb
+tutorials/00_runtime_openai_provider_api.ipynb
+tutorials/00_runtime_vllm_provider_api.ipynb
+tutorials/00_runtime_scheduler_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
+```
+
+There is no active `examples/` root. Tutorials both explain and exercise the API.
+
+## Docs
+
+```text
+docs/API.md
+docs/CLI.md
+docs/ARCHITECTURE.md
+docs/BOUNDARIES.md
+docs/ONBOARDING_FIRST_RUN.md
+docs/RUNRESULT_FINAL_ANSWER.md
+docs/SMOKE_CHECKLIST_2_4_9.md
+docs/CONTRIBUTING_CHECKLIST.md
+docs/ROADMAP_CHECKPOINTS.md
+```
+
+## Validation
+
+```bash
+python -m pytest -q
+python -m compileall -q src tests tutorials
+agentic-systems doctor --json
+```
+
+## Contact
+
+Author: Jacobo Gerardo González León
+
+E-Mail 1: jacobogerardo.gonzalez@bbva.com
+
+E-Mail 2: jacoboggleon@gmail.com
+
+LinkedIn: https://www.linkedin.com/in/jacoboggleon/
+
+Github Repo: https://www.github.com/JacoboGGLeon/agentic_systems

agentic_systems-1.0.0/README.md

@@ -0,0 +1,292 @@
+# Agentic Systems
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/JacoboGGLeon/agentic_systems/main/docs/assets/logo_agentic_systems.png" alt="Agentic Systems logo" width="360" />
+</p>
+
+
+Agentic Systems is a Python library for building, running and evaluating
+auditable agentic systems with tools, skills, agents, systems, graphs,
+environments, evals, contracts, lineage memory and stable human output.
+
+Use the public facade as the stable entry point:
+
+```python
+import agentic_systems as toolkit
+```
+
+Agentic Systems exposes five practical routes:
+
+```text
+toolkit       top-level public facade for normal user code
+primitives    Tool, Skill, Agent, RunResult, contracts, runtime and lineage
+providers     execution backends: python-runtime, openai-runtime, bedrock-runtime, vllm-runtime or auto
+system        AgenticSystem as the native composition layer
+integrations  bridges to external agent frameworks such as LangGraph, Strands and OpenAI Agents
+```
+
+The recommended path is to start with `toolkit`, choose a provider with
+`toolkit.runtime(provider=...)`, use primitives when you need fine control, move
+to `AgenticSystem` when you need a complete auditable system, and use
+integrations only when an external framework should own orchestration. Providers
+can cross with either native systems or integrations: the framework owns the
+loop, while the provider decides where inference or deterministic execution runs.
+
+Agentic Systems supports two agent styles:
+
+```text
+deterministic agents  execute explicit tools and local Python policies with python-runtime
+reasoning agents      use language-model providers such as openai-runtime, bedrock-runtime or vllm-runtime
+```
+
+Both styles share the same lifecycle: tools expose executable capabilities,
+agents transform context into actions, systems/graphs coordinate agents,
+environments run episodes, and evals validate behavior with empirical evidence.
+
+## Quality Gate
+
+Current verified test status is documented in [`docs/PYTEST_COVERAGE_REPORT.md`](docs/PYTEST_COVERAGE_REPORT.md):
+
+```text
+295 passed, 1 skipped
+Coverage: 100.00%
+TOTAL statements: 5173
+TOTAL missing: 0
+```
+
+## What It Exposes
+
+```text
+Tool        executable capability
+Skill       package of tools, instructions, contracts and assets
+Agent       deterministic or reasoning unit that turns context into actions
+System      workspace that registers and composes tools, skills and agents
+Graph       state + nodes + edges orchestration
+Environment episodic execution with reward and history
+Eval        empirical validation and scoring over cases or episodes
+```
+
+Cross-cutting APIs:
+
+```text
+runtime/provider     python-runtime, openai-runtime, bedrock-runtime, vllm-runtime or auto
+scheduler            execution budgets, retries, turns, timeouts and concurrency
+contracts/policies   expected tools, strictness, repair and finalization rules
+Lineage Memory       traceability, context, memory and audit trail
+RunResult            stable execution envelope and final answer
+human_result         readable output for users, notebooks and reviews
+CLI diagnostics      doctor, runtime, API inventory and contact
+```
+
+## Providers And Integrations
+
+Canonical providers:
+
+```text
+python-runtime     deterministic local execution for tools and policies
+openai-runtime    native OpenAI language-model provider
+bedrock-runtime   AWS Bedrock Runtime language-model provider
+vllm-runtime      OpenAI-compatible vLLM provider for local or Colab GPU inference
+auto              environment-based provider selection
+```
+
+Optional integrations:
+
+```text
+LangGraph       graph orchestration framework
+Strands         external agent framework integration
+OpenAI Agents   OpenAI Agents-style framework integration
+```
+
+`provider="auto"` is explicit selection mode. Use `runtime.describe()` or the
+CLI to see what the current environment selects before executing a model. The
+current priority is `vllm-runtime`, then `openai-runtime`, then
+`bedrock-runtime`.
+
+OpenAI runtime reads `OPENAI_API_KEY`, `AGENTIC_SYSTEMS_OPENAI_MODEL_ID`,
+`OPENAI_MODEL_ID`, `OPENAI_MODEL`, `OPENAI_BASE_URL`, `OPENAI_ORG_ID` and
+`OPENAI_PROJECT` from the environment or `.env`. Diagnostics show safe flags,
+not secret values.
+
+vLLM runtime reads `VLLM_BASE_URL`, `VLLM_API_BASE`,
+`AGENTIC_SYSTEMS_VLLM_BASE_URL`, `VLLM_MODEL_ID`, `VLLM_MODEL`,
+`AGENTIC_SYSTEMS_VLLM_MODEL_ID`, `VLLM_API_KEY` and
+`AGENTIC_SYSTEMS_VLLM_API_KEY`. It talks to a running vLLM OpenAI-compatible
+server; the package does not start or install the GPU server by default.
+
+## Quick Start
+
+### Route 1: Toolkit And Primitives
+
+Use this when you want direct control over tools, agents, provider/runtime and results.
+
+```python
+import agentic_systems as toolkit
+
+@toolkit.tool
+def add(a: int, b: int) -> dict:
+    return {"result": a + b}
+
+runtime = toolkit.runtime(provider="python-runtime")
+agent = toolkit.agent(name="calc", tools=[add], runtime=runtime)
+
+result = agent.run({"tool": "add", "input": {"a": 2, "b": 3}}, mode="eval")
+toolkit.human_result(result)
+```
+
+### Route 2: Native System
+
+Use this when you want a complete Agentic Systems workspace that registers and
+composes tools, skills and agents under one auditable system boundary. The
+system still receives a provider through `toolkit.runtime(...)`.
+
+```python
+import agentic_systems as toolkit
+
+system = toolkit.AgenticSystem(model="local-python", runtime=toolkit.runtime(provider="python-runtime"))
+
+@system.tool
+def add(a: int, b: int) -> dict:
+    return {"result": a + b}
+
+agent = system.agent(name="calc", instructions="Use the registered calculator tools.")
+result = agent.run({"tool": "add", "input": {"a": 2, "b": 3}}, mode="eval")
+
+toolkit.human_result(result)
+```
+
+### Route 3: Environment And Evals
+
+Use an environment when execution is episodic: each record becomes a step, the
+system graph updates state, a reward function scores the transition, and history
+keeps auditable evidence. Use evals when you want batch validation over declared
+cases with pass/fail statistics.
+
+```python
+import agentic_systems as toolkit
+
+runtime = toolkit.runtime(provider="python-runtime")
+system = toolkit.AgenticSystem(model="local-python", runtime=runtime)
+
+@system.tool
+def double(value: int) -> dict:
+    return {"value": value * 2, "ok": True}
+
+agent = system.agent(
+    name="doubler",
+    instructions="Call double when the input asks for a doubled value.",
+    tools=["double"],
+)
+
+graph = toolkit.build_single_agent_step_graph(agent)
+records = [
+    {"input": {"tool": "double", "input": {"value": 21}}},
+]
+
+def reward_fn(state, row, action, env) -> float:
+    return 1.0 if state.get("result", {}).get("ok") else 0.0
+
+environment = system.environment(records, graph=graph, reward_fn=reward_fn)
+observation, info = environment.reset(seed=0)
+observation, reward, terminated, truncated, info = environment.step()
+
+toolkit.show(toolkit.environment_summary(environment), title="Environment summary")
+```
+
+```python
+cases = [
+    {
+        "name": "double_21",
+        "input": {"tool": "double", "input": {"value": 21}},
+        "expected": {"data_contains": {"value": 42, "ok": True}},
+    }
+]
+
+report = system.eval(agent, cases)
+toolkit.human_result(report)
+report.raise_if_failed()
+```
+
+### Route 4: Integrations
+
+Use integrations when LangGraph, Strands or OpenAI Agents should own the outer
+framework loop while Agentic Systems keeps the same tools, provider/runtime,
+contracts, lineage and human output conventions.
+
+```python
+runtime = toolkit.runtime(provider="auto")
+agent = toolkit.agent(
+    name="portable_agent",
+    runtime=runtime,
+    framework="openai-agents",
+)
+```
+
+## CLI
+
+```bash
+agentic-systems version
+agentic-systems contact
+agentic-systems doctor --json
+agentic-systems runtime --provider auto --json
+agentic-systems api --tier public --json
+agentic-systems public-api --all --json
+```
+
+## Tutorials
+
+The official learning path is `tutorials/`:
+
+```text
+tutorials/00_runtime_api.ipynb
+tutorials/00_runtime_bedrock_provider_api.ipynb
+tutorials/00_runtime_openai_provider_api.ipynb
+tutorials/00_runtime_vllm_provider_api.ipynb
+tutorials/00_runtime_scheduler_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
+```
+
+There is no active `examples/` root. Tutorials both explain and exercise the API.
+
+## Docs
+
+```text
+docs/API.md
+docs/CLI.md
+docs/ARCHITECTURE.md
+docs/BOUNDARIES.md
+docs/ONBOARDING_FIRST_RUN.md
+docs/RUNRESULT_FINAL_ANSWER.md
+docs/SMOKE_CHECKLIST_2_4_9.md
+docs/CONTRIBUTING_CHECKLIST.md
+docs/ROADMAP_CHECKPOINTS.md
+```
+
+## Validation
+
+```bash
+python -m pytest -q
+python -m compileall -q src tests tutorials
+agentic-systems doctor --json
+```
+
+## Contact
+
+Author: Jacobo Gerardo González León
+
+E-Mail 1: jacobogerardo.gonzalez@bbva.com
+
+E-Mail 2: jacoboggleon@gmail.com
+
+LinkedIn: https://www.linkedin.com/in/jacoboggleon/
+
+Github Repo: https://www.github.com/JacoboGGLeon/agentic_systems

agentic_systems-1.0.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentic-systems"
+version = "1.0.0"
+description = "Agentic Systems: auditable agentic systems with tools, skills, agents, systems, graphs, environments and evals across Python Direct, OpenAI Runtime, Bedrock Runtime and vLLM Runtime."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{name = "Jacobo Gerardo Gonzalez Leon", email = "jacobogerardo.gonzalez@bbva.com"}]
+dependencies = [
+    "pydantic>=2.7.0",
+    "pandas>=2.0.0",
+    "typing-extensions>=4.10.0",
+    "rich>=13.0.0",
+]
+
+
+[project.urls]
+Homepage = "https://www.github.com/JacoboGGLeon/agentic_systems"
+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"]
+langgraph = ["langgraph>=0.2.0", "typing-extensions>=4.10.0"]
+openai = ["openai>=1.0.0"]
+tutorials = ["ipykernel>=6.0.0", "jupyterlab>=4.0.0", "pandas>=2.0.0", "rich>=13.0.0"]
+dev = ["pytest>=8.0.0", "pytest-cov>=5.0.0", "ruff>=0.6.1"]
+all = [
+    "boto3>=1.34.0",
+    "botocore>=1.34.0",
+    "langgraph>=0.2.0",
+    "openai>=1.0.0",
+    "ipykernel>=6.0.0",
+    "jupyterlab>=4.0.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.6.1",
+]
+
+[project.scripts]
+agentic-systems = "agentic_systems.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["agentic_systems*"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+
+[tool.coverage.run]
+source = ["src/agentic_systems"]
+omit = [
+    "src/agentic_systems/providers/bedrock_runtime.py",
+]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false
+fail_under = 100
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "\\.\\.\\.",
+]