agentforge-py 0.2.1__tar.gz → 0.2.2__tar.gz

agentforge_py-0.2.2/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: agentforge-py
+Version: 0.2.2
+Summary: AgentForge — open-source plug-and-play framework for production AI agents
+Project-URL: Homepage, https://github.com/Scaffoldic/agentforge-py
+Project-URL: Repository, https://github.com/Scaffoldic/agentforge-py
+Project-URL: Documentation, https://github.com/Scaffoldic/agentforge-py
+Project-URL: Changelog, https://github.com/Scaffoldic/agentforge-py/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Scaffoldic/agentforge-py/issues
+Author: The AgentForge Authors
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: agent,agentic,ai,framework,llm,react,tools
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: agentforge-core~=0.2.2
+Requires-Dist: copier>=9.4
+Requires-Dist: pydantic>=2.10
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.15
+Provides-Extra: a2a
+Requires-Dist: agentforge-a2a~=0.2.2; extra == 'a2a'
+Provides-Extra: all
+Requires-Dist: agentforge-a2a~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-anthropic~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-bedrock~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-chat-history-postgres~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-chat-history-redis~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-chat-http~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-chat-slack~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-chat~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-eval-geval~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-evidently~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-guard-llamaguard~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-guard-llmguard~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-guard-nemo~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-guard-presidio~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-langfuse~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-litellm~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-mcp~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-memory-neo4j~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-memory-postgres~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-memory-sqlite~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-memory-surrealdb~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-ollama~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-openai~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-otel~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-phoenix~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-reranker-cohere~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-reranker-mixedbread~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-reranker-sentence-transformers~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-reranker-voyage~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-statsd~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-testing~=0.2.2; extra == 'all'
+Requires-Dist: agentforge-voyage~=0.2.2; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: agentforge-anthropic[anthropic]~=0.2.2; extra == 'anthropic'
+Provides-Extra: bedrock
+Requires-Dist: agentforge-bedrock[bedrock]~=0.2.2; extra == 'bedrock'
+Provides-Extra: chat
+Requires-Dist: agentforge-chat~=0.2.2; extra == 'chat'
+Provides-Extra: chat-history-postgres
+Requires-Dist: agentforge-chat-history-postgres~=0.2.2; extra == 'chat-history-postgres'
+Provides-Extra: chat-history-redis
+Requires-Dist: agentforge-chat-history-redis~=0.2.2; extra == 'chat-history-redis'
+Provides-Extra: chat-http
+Requires-Dist: agentforge-chat-http~=0.2.2; extra == 'chat-http'
+Provides-Extra: chat-slack
+Requires-Dist: agentforge-chat-slack~=0.2.2; extra == 'chat-slack'
+Provides-Extra: eval
+Requires-Dist: agentforge-eval-geval~=0.2.2; extra == 'eval'
+Provides-Extra: evidently
+Requires-Dist: agentforge-evidently~=0.2.2; extra == 'evidently'
+Provides-Extra: guard-llamaguard
+Requires-Dist: agentforge-guard-llamaguard~=0.2.2; extra == 'guard-llamaguard'
+Provides-Extra: guard-llmguard
+Requires-Dist: agentforge-guard-llmguard~=0.2.2; extra == 'guard-llmguard'
+Provides-Extra: guard-nemo
+Requires-Dist: agentforge-guard-nemo~=0.2.2; extra == 'guard-nemo'
+Provides-Extra: guard-presidio
+Requires-Dist: agentforge-guard-presidio~=0.2.2; extra == 'guard-presidio'
+Provides-Extra: langfuse
+Requires-Dist: agentforge-langfuse~=0.2.2; extra == 'langfuse'
+Provides-Extra: litellm
+Requires-Dist: agentforge-litellm~=0.2.2; extra == 'litellm'
+Provides-Extra: mcp
+Requires-Dist: agentforge-mcp~=0.2.2; extra == 'mcp'
+Provides-Extra: memory-neo4j
+Requires-Dist: agentforge-memory-neo4j~=0.2.2; extra == 'memory-neo4j'
+Provides-Extra: memory-postgres
+Requires-Dist: agentforge-memory-postgres~=0.2.2; extra == 'memory-postgres'
+Provides-Extra: memory-sqlite
+Requires-Dist: agentforge-memory-sqlite~=0.2.2; extra == 'memory-sqlite'
+Provides-Extra: memory-surrealdb
+Requires-Dist: agentforge-memory-surrealdb~=0.2.2; extra == 'memory-surrealdb'
+Provides-Extra: ollama
+Requires-Dist: agentforge-ollama~=0.2.2; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: agentforge-openai[openai]~=0.2.2; extra == 'openai'
+Provides-Extra: otel
+Requires-Dist: agentforge-otel~=0.2.2; extra == 'otel'
+Provides-Extra: phoenix
+Requires-Dist: agentforge-phoenix~=0.2.2; extra == 'phoenix'
+Provides-Extra: reranker-cohere
+Requires-Dist: agentforge-reranker-cohere~=0.2.2; extra == 'reranker-cohere'
+Provides-Extra: reranker-mixedbread
+Requires-Dist: agentforge-reranker-mixedbread~=0.2.2; extra == 'reranker-mixedbread'
+Provides-Extra: reranker-sentence-transformers
+Requires-Dist: agentforge-reranker-sentence-transformers~=0.2.2; extra == 'reranker-sentence-transformers'
+Provides-Extra: reranker-voyage
+Requires-Dist: agentforge-reranker-voyage~=0.2.2; extra == 'reranker-voyage'
+Provides-Extra: statsd
+Requires-Dist: agentforge-statsd~=0.2.2; extra == 'statsd'
+Provides-Extra: testing
+Requires-Dist: agentforge-testing~=0.2.2; extra == 'testing'
+Provides-Extra: voyage
+Requires-Dist: agentforge-voyage~=0.2.2; extra == 'voyage'
+Description-Content-Type: text/markdown
+
+# agentforge
+
+The default runtime for the AgentForge framework — `Agent`, `ReActLoop`,
+default tools, `SimpleFinding`, in-memory store, basic safety defaults,
+`BudgetPolicy`. Most users install this package and add module extras
+as needed.
+
+## Three-line agent (once feat-001 lands)
+
+```python
+from agentforge import Agent
+
+agent = Agent(model="anthropic:claude-sonnet-4.7")
+result = await agent.run("Say hello in three words.")
+```
+
+## Install
+
+```bash
+pip install agentforge-py                              # core runtime
+pip install "agentforge-py[anthropic]"                 # + Anthropic provider
+pip install "agentforge-py[anthropic,memory-postgres]" # + persistence
+```
+
+## Status
+
+v0.0 — pre-alpha. Repo bootstrapped; feat-001 (Core contracts &
+`Agent` orchestrator) is the next milestone.
+
+## License
+
+Apache 2.0.

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/pyproject.toml

@@ -14,7 +14,7 @@
 
 [project]
 name = "agentforge-py"
-version = "0.2.1"
+version = "0.2.2"
 description = "AgentForge — open-source plug-and-play framework for production AI agents"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -36,7 +36,7 @@ classifiers = [
 ]
 
 dependencies = [
-    "agentforge-core ~= 0.2.1",
+    "agentforge-core ~= 0.2.2",
     "pydantic>=2.10",
     "pyyaml>=6.0",
     "typer>=0.15",
@@ -55,94 +55,98 @@ dependencies = [
 # resolves to `agentforge-py + agentforge-anthropic`, etc.
 # Add a new entry here every time a new sister package ships.
 
-# LLM providers
-anthropic = ["agentforge-anthropic ~= 0.2.1"]
-openai = ["agentforge-openai ~= 0.2.1"]
-bedrock = ["agentforge-bedrock ~= 0.2.1"]
-ollama = ["agentforge-ollama ~= 0.2.1"]
-litellm = ["agentforge-litellm ~= 0.2.1"]
+# LLM providers — for providers with a vendor-SDK extra
+# (anthropic / openai / bedrock), the extra is included so a single
+# `pip install "agentforge-py[<provider>]"` lands both the framework
+# wrapper AND the underlying SDK. ollama / litellm bundle their SDK
+# as a hard dep, so no `[<sdk>]` extra is needed.
+anthropic = ["agentforge-anthropic[anthropic] ~= 0.2.2"]
+openai = ["agentforge-openai[openai] ~= 0.2.2"]
+bedrock = ["agentforge-bedrock[bedrock] ~= 0.2.2"]
+ollama = ["agentforge-ollama ~= 0.2.2"]
+litellm = ["agentforge-litellm ~= 0.2.2"]
 
 # Embeddings
-voyage = ["agentforge-voyage ~= 0.2.1"]
+voyage = ["agentforge-voyage ~= 0.2.2"]
 
 # Memory backends
-memory-sqlite = ["agentforge-memory-sqlite ~= 0.2.1"]
-memory-postgres = ["agentforge-memory-postgres ~= 0.2.1"]
-memory-neo4j = ["agentforge-memory-neo4j ~= 0.2.1"]
-memory-surrealdb = ["agentforge-memory-surrealdb ~= 0.2.1"]
+memory-sqlite = ["agentforge-memory-sqlite ~= 0.2.2"]
+memory-postgres = ["agentforge-memory-postgres ~= 0.2.2"]
+memory-neo4j = ["agentforge-memory-neo4j ~= 0.2.2"]
+memory-surrealdb = ["agentforge-memory-surrealdb ~= 0.2.2"]
 
 # Chat surface
-chat = ["agentforge-chat ~= 0.2.1"]
-chat-http = ["agentforge-chat-http ~= 0.2.1"]
-chat-slack = ["agentforge-chat-slack ~= 0.2.1"]
-chat-history-postgres = ["agentforge-chat-history-postgres ~= 0.2.1"]
-chat-history-redis = ["agentforge-chat-history-redis ~= 0.2.1"]
+chat = ["agentforge-chat ~= 0.2.2"]
+chat-http = ["agentforge-chat-http ~= 0.2.2"]
+chat-slack = ["agentforge-chat-slack ~= 0.2.2"]
+chat-history-postgres = ["agentforge-chat-history-postgres ~= 0.2.2"]
+chat-history-redis = ["agentforge-chat-history-redis ~= 0.2.2"]
 
 # Rerankers
-reranker-cohere = ["agentforge-reranker-cohere ~= 0.2.1"]
-reranker-voyage = ["agentforge-reranker-voyage ~= 0.2.1"]
-reranker-mixedbread = ["agentforge-reranker-mixedbread ~= 0.2.1"]
-reranker-sentence-transformers = ["agentforge-reranker-sentence-transformers ~= 0.2.1"]
+reranker-cohere = ["agentforge-reranker-cohere ~= 0.2.2"]
+reranker-voyage = ["agentforge-reranker-voyage ~= 0.2.2"]
+reranker-mixedbread = ["agentforge-reranker-mixedbread ~= 0.2.2"]
+reranker-sentence-transformers = ["agentforge-reranker-sentence-transformers ~= 0.2.2"]
 
 # Guardrails
-guard-llmguard = ["agentforge-guard-llmguard ~= 0.2.1"]
-guard-presidio = ["agentforge-guard-presidio ~= 0.2.1"]
-guard-nemo = ["agentforge-guard-nemo ~= 0.2.1"]
-guard-llamaguard = ["agentforge-guard-llamaguard ~= 0.2.1"]
+guard-llmguard = ["agentforge-guard-llmguard ~= 0.2.2"]
+guard-presidio = ["agentforge-guard-presidio ~= 0.2.2"]
+guard-nemo = ["agentforge-guard-nemo ~= 0.2.2"]
+guard-llamaguard = ["agentforge-guard-llamaguard ~= 0.2.2"]
 
 # Observability
-langfuse = ["agentforge-langfuse ~= 0.2.1"]
-phoenix = ["agentforge-phoenix ~= 0.2.1"]
-otel = ["agentforge-otel ~= 0.2.1"]
-statsd = ["agentforge-statsd ~= 0.2.1"]
-evidently = ["agentforge-evidently ~= 0.2.1"]
+langfuse = ["agentforge-langfuse ~= 0.2.2"]
+phoenix = ["agentforge-phoenix ~= 0.2.2"]
+otel = ["agentforge-otel ~= 0.2.2"]
+statsd = ["agentforge-statsd ~= 0.2.2"]
+evidently = ["agentforge-evidently ~= 0.2.2"]
 
 # Protocols
-mcp = ["agentforge-mcp ~= 0.2.1"]
-a2a = ["agentforge-a2a ~= 0.2.1"]
+mcp = ["agentforge-mcp ~= 0.2.2"]
+a2a = ["agentforge-a2a ~= 0.2.2"]
 
 # Eval
-eval = ["agentforge-eval-geval ~= 0.2.1"]
+eval = ["agentforge-eval-geval ~= 0.2.2"]
 
 # Testing
-testing = ["agentforge-testing ~= 0.2.1"]
+testing = ["agentforge-testing ~= 0.2.2"]
 
 # Everything (development / docs / smoke-test convenience — not
 # recommended for production deploys; pick the actual integrations
 # you use to keep the dependency tree small).
 all = [
-    "agentforge-anthropic ~= 0.2.1",
-    "agentforge-openai ~= 0.2.1",
-    "agentforge-bedrock ~= 0.2.1",
-    "agentforge-ollama ~= 0.2.1",
-    "agentforge-litellm ~= 0.2.1",
-    "agentforge-voyage ~= 0.2.1",
-    "agentforge-memory-sqlite ~= 0.2.1",
-    "agentforge-memory-postgres ~= 0.2.1",
-    "agentforge-memory-neo4j ~= 0.2.1",
-    "agentforge-memory-surrealdb ~= 0.2.1",
-    "agentforge-chat ~= 0.2.1",
-    "agentforge-chat-http ~= 0.2.1",
-    "agentforge-chat-slack ~= 0.2.1",
-    "agentforge-chat-history-postgres ~= 0.2.1",
-    "agentforge-chat-history-redis ~= 0.2.1",
-    "agentforge-reranker-cohere ~= 0.2.1",
-    "agentforge-reranker-voyage ~= 0.2.1",
-    "agentforge-reranker-mixedbread ~= 0.2.1",
-    "agentforge-reranker-sentence-transformers ~= 0.2.1",
-    "agentforge-guard-llmguard ~= 0.2.1",
-    "agentforge-guard-presidio ~= 0.2.1",
-    "agentforge-guard-nemo ~= 0.2.1",
-    "agentforge-guard-llamaguard ~= 0.2.1",
-    "agentforge-langfuse ~= 0.2.1",
-    "agentforge-phoenix ~= 0.2.1",
-    "agentforge-otel ~= 0.2.1",
-    "agentforge-statsd ~= 0.2.1",
-    "agentforge-evidently ~= 0.2.1",
-    "agentforge-mcp ~= 0.2.1",
-    "agentforge-a2a ~= 0.2.1",
-    "agentforge-eval-geval ~= 0.2.1",
-    "agentforge-testing ~= 0.2.1",
+    "agentforge-anthropic ~= 0.2.2",
+    "agentforge-openai ~= 0.2.2",
+    "agentforge-bedrock ~= 0.2.2",
+    "agentforge-ollama ~= 0.2.2",
+    "agentforge-litellm ~= 0.2.2",
+    "agentforge-voyage ~= 0.2.2",
+    "agentforge-memory-sqlite ~= 0.2.2",
+    "agentforge-memory-postgres ~= 0.2.2",
+    "agentforge-memory-neo4j ~= 0.2.2",
+    "agentforge-memory-surrealdb ~= 0.2.2",
+    "agentforge-chat ~= 0.2.2",
+    "agentforge-chat-http ~= 0.2.2",
+    "agentforge-chat-slack ~= 0.2.2",
+    "agentforge-chat-history-postgres ~= 0.2.2",
+    "agentforge-chat-history-redis ~= 0.2.2",
+    "agentforge-reranker-cohere ~= 0.2.2",
+    "agentforge-reranker-voyage ~= 0.2.2",
+    "agentforge-reranker-mixedbread ~= 0.2.2",
+    "agentforge-reranker-sentence-transformers ~= 0.2.2",
+    "agentforge-guard-llmguard ~= 0.2.2",
+    "agentforge-guard-presidio ~= 0.2.2",
+    "agentforge-guard-nemo ~= 0.2.2",
+    "agentforge-guard-llamaguard ~= 0.2.2",
+    "agentforge-langfuse ~= 0.2.2",
+    "agentforge-phoenix ~= 0.2.2",
+    "agentforge-otel ~= 0.2.2",
+    "agentforge-statsd ~= 0.2.2",
+    "agentforge-evidently ~= 0.2.2",
+    "agentforge-mcp ~= 0.2.2",
+    "agentforge-a2a ~= 0.2.2",
+    "agentforge-eval-geval ~= 0.2.2",
+    "agentforge-testing ~= 0.2.2",
 ]
 
 [project.scripts]

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/__init__.py

@@ -11,7 +11,7 @@ This package is the default runtime. It ships:
 
 For provider clients, persistence drivers, MCP, observability backends,
 and safety modules, install the corresponding `agentforge-<X>` packages
-or use the `agentforge[<extra>]` install (per ADR-0003).
+or use the `agentforge-py[<extra>]` install (per ADR-0003).
 
 See the project docs at `docs/README.md` (in the design workspace) and
 the per-feature specs under `docs/features/`.
@@ -69,7 +69,7 @@ from agentforge.strategies import (
     get_runtime,
 )
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 __all__ = [
     "RUNTIME_KEY",

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/agent.py

@@ -239,10 +239,10 @@ class Agent:
             return strategy
         if strategy is None:
             raise ModuleError(
-                "No reasoning strategy provided. feat-001 ships only the "
-                "ReasoningStrategy ABC; install agentforge[react] (when feat-002 "
-                "ships) or pass a custom ReasoningStrategy instance via "
-                "Agent(strategy=...)."
+                'No reasoning strategy provided. Set `agent.strategy: "react"` '
+                'in agentforge.yaml, pass `strategy="react"` to `Agent(...)`, '
+                "or pass a custom `ReasoningStrategy` instance via "
+                "`Agent(strategy=...)`."
             )
         # String name — look up in the resolver (feat-002 will register
         # ReActLoop here when it ships).

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/code-reviewer/README.md

@@ -5,7 +5,7 @@
 ```bash
 uv sync
 cp .env.example .env
-python -m {{ project_slug | replace('-', '_') }} "review the diff at /path/to.patch"
+uv run {{ project_slug }} "review the diff at /path/to.patch"
 ```
 
 Drop in evaluator graders (faithfulness / correctness) once you

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/code-reviewer/agentforge.yaml

@@ -1,6 +1,7 @@
 agent:
   name: "{{ project_slug }}"
   model: "{% if llm_provider == 'bedrock' %}bedrock:us.anthropic.claude-sonnet-4-5-20250929{% elif llm_provider == 'anthropic' %}anthropic:claude-sonnet-4-5{% else %}openai:gpt-4o{% endif %}"
+  strategy: "react"
   system_prompt: |
     You are a careful code reviewer. For each issue, emit a
     SimpleFinding with severity, category, file, line, and a

{agentforge_py-0.2.1/src/agentforge/templates/patch-bot → agentforge_py-0.2.2/src/agentforge/templates/code-reviewer}/pyproject.toml

@@ -5,11 +5,13 @@ description = "{{ description }}"
 requires-python = ">=3.13"
 dependencies = [
     "agentforge-py",
-{%- if llm_provider == 'bedrock' %}
-    "agentforge-bedrock",
-{%- endif %}
+    "agentforge-{{ llm_provider }}[{{ llm_provider }}]",
+    "python-dotenv>=1.0",
 ]
 
+[project.scripts]
+{{ project_slug }} = "{{ project_slug | replace('-', '_') }}.main:main"
+
 [build-system]
 requires = ["hatchling>=1.27"]
 build-backend = "hatchling.build"

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/code-reviewer/src/{{project_slug.replace('-', '_')}}/main.py

@@ -10,9 +10,13 @@ from __future__ import annotations
 import asyncio
 import sys
 
+from dotenv import load_dotenv
+
 from agentforge import Agent
 from agentforge.tools import file_read
 
+load_dotenv()
+
 
 async def run_agent(task: str) -> str:
     async with Agent(tools=[file_read]) as agent:
@@ -22,7 +26,7 @@ async def run_agent(task: str) -> str:
 
 def main() -> None:
     if len(sys.argv) < 2:
-        print('Usage: python -m {{ project_slug | replace("-", "_") }} "<task>"')
+        print('Usage: {{ project_slug }} "<task>"')
         sys.exit(1)
     output = asyncio.run(run_agent(" ".join(sys.argv[1:])))
     print(output)

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/docs-qa/README.md

@@ -6,7 +6,7 @@ Outputs `NarrativeFinding`s — markdown prose with citations.
 ```bash
 uv sync
 cp .env.example .env
-python -m {{ project_slug | replace('-', '_') }} "how does the auth flow work?"
+uv run {{ project_slug }} "how does the auth flow work?"
 ```
 
 For real RAG, install `agentforge-memory-sqlite` (or postgres),

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/docs-qa/agentforge.yaml

@@ -1,6 +1,7 @@
 agent:
   name: "{{ project_slug }}"
   model: "{% if llm_provider == 'bedrock' %}bedrock:us.anthropic.claude-sonnet-4-5-20250929{% elif llm_provider == 'anthropic' %}anthropic:claude-sonnet-4-5{% else %}openai:gpt-4o{% endif %}"
+  strategy: "react"
   system_prompt: |
     You answer questions using only the supplied documentation /
     source. Emit a `NarrativeFinding` with the answer as `body`

{agentforge_py-0.2.1/src/agentforge/templates/code-reviewer → agentforge_py-0.2.2/src/agentforge/templates/docs-qa}/pyproject.toml

@@ -5,11 +5,13 @@ description = "{{ description }}"
 requires-python = ">=3.13"
 dependencies = [
     "agentforge-py",
-{%- if llm_provider == 'bedrock' %}
-    "agentforge-bedrock",
-{%- endif %}
+    "agentforge-{{ llm_provider }}[{{ llm_provider }}]",
+    "python-dotenv>=1.0",
 ]
 
+[project.scripts]
+{{ project_slug }} = "{{ project_slug | replace('-', '_') }}.main:main"
+
 [build-system]
 requires = ["hatchling>=1.27"]
 build-backend = "hatchling.build"

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/docs-qa/src/{{project_slug.replace('-', '_')}}/main.py

@@ -10,9 +10,13 @@ from __future__ import annotations
 import asyncio
 import sys
 
+from dotenv import load_dotenv
+
 from agentforge import Agent
 from agentforge.tools import file_read, web_search
 
+load_dotenv()
+
 
 async def run_agent(task: str) -> str:
     async with Agent(tools=[file_read, web_search]) as agent:
@@ -22,7 +26,7 @@ async def run_agent(task: str) -> str:
 
 def main() -> None:
     if len(sys.argv) < 2:
-        print('Usage: python -m {{ project_slug | replace("-", "_") }} "<question>"')
+        print('Usage: {{ project_slug }} "<question>"')
         sys.exit(1)
     output = asyncio.run(run_agent(" ".join(sys.argv[1:])))
     print(output)

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/minimal/README.md

@@ -8,7 +8,7 @@
 uv sync
 cp .env.example .env
 # Fill in credentials in .env, then:
-python -m {{ project_slug | replace('-', '_') }} "your task here"
+uv run {{ project_slug }} "your task here"
 ```
 
 ## Configuration

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/minimal/agentforge.yaml

@@ -1,6 +1,7 @@
 agent:
   name: "{{ project_slug }}"
   model: "{% if llm_provider == 'bedrock' %}bedrock:us.anthropic.claude-sonnet-4-5-20250929{% elif llm_provider == 'anthropic' %}anthropic:claude-sonnet-4-5{% else %}openai:gpt-4o{% endif %}"
+  strategy: "react"
   budget:
     usd: 2.0
   max_iterations: 25

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/minimal/pyproject.toml

@@ -5,11 +5,13 @@ description = "{{ description }}"
 requires-python = ">=3.13"
 dependencies = [
     "agentforge-py",
-{%- if llm_provider == 'bedrock' %}
-    "agentforge-bedrock",
-{%- endif %}
+    "agentforge-{{ llm_provider }}[{{ llm_provider }}]",
+    "python-dotenv>=1.0",
 ]
 
+[project.scripts]
+{{ project_slug }} = "{{ project_slug | replace('-', '_') }}.main:main"
+
 [build-system]
 requires = ["hatchling>=1.27"]
 build-backend = "hatchling.build"

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/minimal/src/{{project_slug.replace('-', '_')}}/main.py

@@ -11,8 +11,12 @@ from __future__ import annotations
 import asyncio
 import sys
 
+from dotenv import load_dotenv
+
 from agentforge import Agent
 
+load_dotenv()
+
 
 async def run_agent(task: str) -> str:
     """Run the agent against `task` and return its output."""
@@ -23,7 +27,7 @@ async def run_agent(task: str) -> str:
 
 def main() -> None:
     if len(sys.argv) < 2:
-        print('Usage: python -m {{ project_slug | replace("-", "_") }} "<task>"')
+        print('Usage: {{ project_slug }} "<task>"')
         sys.exit(1)
     task = " ".join(sys.argv[1:])
     output = asyncio.run(run_agent(task))

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/patch-bot/README.md

@@ -6,7 +6,7 @@ with rationale + confidence — for downstream consumers to apply.
 ```bash
 uv sync
 cp .env.example .env
-python -m {{ project_slug | replace('-', '_') }} "replace deprecated time.clock() in src/"
+uv run {{ project_slug }} "replace deprecated time.clock() in src/"
 ```
 
 The agent does NOT apply the patches itself — the consumer (CI

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/patch-bot/agentforge.yaml

@@ -1,6 +1,7 @@
 agent:
   name: "{{ project_slug }}"
   model: "{% if llm_provider == 'bedrock' %}bedrock:us.anthropic.claude-sonnet-4-5-20250929{% elif llm_provider == 'anthropic' %}anthropic:claude-sonnet-4-5{% else %}openai:gpt-4o{% endif %}"
+  strategy: "react"
   system_prompt: |
     You generate patches. For each fix, emit a `PatchFinding` with
     a unified-diff `patch`, a one-line `rationale`, and a

{agentforge_py-0.2.1/src/agentforge/templates/docs-qa → agentforge_py-0.2.2/src/agentforge/templates/patch-bot}/pyproject.toml

@@ -5,11 +5,13 @@ description = "{{ description }}"
 requires-python = ">=3.13"
 dependencies = [
     "agentforge-py",
-{%- if llm_provider == 'bedrock' %}
-    "agentforge-bedrock",
-{%- endif %}
+    "agentforge-{{ llm_provider }}[{{ llm_provider }}]",
+    "python-dotenv>=1.0",
 ]
 
+[project.scripts]
+{{ project_slug }} = "{{ project_slug | replace('-', '_') }}.main:main"
+
 [build-system]
 requires = ["hatchling>=1.27"]
 build-backend = "hatchling.build"

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/patch-bot/src/{{project_slug.replace('-', '_')}}/main.py

@@ -10,9 +10,13 @@ from __future__ import annotations
 import asyncio
 import sys
 
+from dotenv import load_dotenv
+
 from agentforge import Agent
 from agentforge.tools import file_read
 
+load_dotenv()
+
 
 async def run_agent(task: str) -> str:
     async with Agent(tools=[file_read]) as agent:
@@ -22,7 +26,7 @@ async def run_agent(task: str) -> str:
 
 def main() -> None:
     if len(sys.argv) < 2:
-        print('Usage: python -m {{ project_slug | replace("-", "_") }} "<task>"')
+        print('Usage: {{ project_slug }} "<task>"')
         sys.exit(1)
     output = asyncio.run(run_agent(" ".join(sys.argv[1:])))
     print(output)

{agentforge_py-0.2.1 → agentforge_py-0.2.2}/src/agentforge/templates/research/README.md

@@ -7,7 +7,7 @@ into sub-tasks, then synthesises a `NarrativeFinding`.
 ```bash
 uv sync
 cp .env.example .env
-python -m {{ project_slug | replace('-', '_') }} "what changed in claude-sonnet 4.5 vs 4.7?"
+uv run {{ project_slug }} "what changed in claude-sonnet 4.5 vs 4.7?"
 ```
 
 Defaults to `web_search` (DuckDuckGo HTML scrape). Replace with a

agentforge_py-0.2.2/src/agentforge/templates/research/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "{{ project_slug }}"
+version = "0.0.0"
+description = "{{ description }}"
+requires-python = ">=3.13"
+dependencies = [
+    "agentforge-py",
+    "agentforge-{{ llm_provider }}[{{ llm_provider }}]",
+    "python-dotenv>=1.0",
+]
+
+[project.scripts]
+{{ project_slug }} = "{{ project_slug | replace('-', '_') }}.main:main"
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/{{ project_slug | replace('-', '_') }}"]