agentforge-py 0.2.4__tar.gz → 0.3.1__tar.gz

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/.gitignore

@@ -47,3 +47,13 @@ Thumbs.db
 # Project-local
 *.local
 .agentforge-state/.session-cache
+
+# AI-assistant working state — local session tracking, not part of
+# the published project. The process docs under .claude/ (standards,
+# checklists, CLAUDE.md) are intentionally kept tracked; only the
+# churny per-session state files are ignored.
+.claude/state/
+
+# Launch / go-to-market drafts — local-only marketing material,
+# never published to the repo.
+launch/

agentforge_py-0.3.1/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: agentforge-py
+Version: 0.3.1
+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.3.1
+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.3.1; extra == 'a2a'
+Provides-Extra: all
+Requires-Dist: agentforge-a2a~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-anthropic[anthropic]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-bedrock~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-chat-history-postgres~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-chat-history-redis~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-chat-http~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-chat-slack~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-chat~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-eval-geval~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-evidently[evidently]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-guard-llamaguard~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-guard-llmguard~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-guard-nemo~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-guard-presidio~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-langfuse[langfuse]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-litellm[litellm]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-mcp[mcp]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-memory-neo4j~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-memory-postgres~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-memory-sqlite~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-memory-surrealdb~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-ollama[ollama]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-openai[openai]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-otel~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-phoenix[phoenix]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-reranker-cohere[cohere]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-reranker-mixedbread[mixedbread]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-reranker-sentence-transformers[sentence-transformers]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-reranker-voyage[voyage]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-statsd[statsd]~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-testing~=0.3.1; extra == 'all'
+Requires-Dist: agentforge-voyage[voyage]~=0.3.1; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: agentforge-anthropic[anthropic]~=0.3.1; extra == 'anthropic'
+Provides-Extra: bedrock
+Requires-Dist: agentforge-bedrock~=0.3.1; extra == 'bedrock'
+Provides-Extra: chat
+Requires-Dist: agentforge-chat~=0.3.1; extra == 'chat'
+Provides-Extra: chat-history-postgres
+Requires-Dist: agentforge-chat-history-postgres~=0.3.1; extra == 'chat-history-postgres'
+Provides-Extra: chat-history-redis
+Requires-Dist: agentforge-chat-history-redis~=0.3.1; extra == 'chat-history-redis'
+Provides-Extra: chat-http
+Requires-Dist: agentforge-chat-http~=0.3.1; extra == 'chat-http'
+Provides-Extra: chat-slack
+Requires-Dist: agentforge-chat-slack~=0.3.1; extra == 'chat-slack'
+Provides-Extra: eval
+Requires-Dist: agentforge-eval-geval~=0.3.1; extra == 'eval'
+Provides-Extra: evidently
+Requires-Dist: agentforge-evidently[evidently]~=0.3.1; extra == 'evidently'
+Provides-Extra: guard-llamaguard
+Requires-Dist: agentforge-guard-llamaguard~=0.3.1; extra == 'guard-llamaguard'
+Provides-Extra: guard-llmguard
+Requires-Dist: agentforge-guard-llmguard~=0.3.1; extra == 'guard-llmguard'
+Provides-Extra: guard-nemo
+Requires-Dist: agentforge-guard-nemo~=0.3.1; extra == 'guard-nemo'
+Provides-Extra: guard-presidio
+Requires-Dist: agentforge-guard-presidio~=0.3.1; extra == 'guard-presidio'
+Provides-Extra: langfuse
+Requires-Dist: agentforge-langfuse[langfuse]~=0.3.1; extra == 'langfuse'
+Provides-Extra: litellm
+Requires-Dist: agentforge-litellm[litellm]~=0.3.1; extra == 'litellm'
+Provides-Extra: mcp
+Requires-Dist: agentforge-mcp[mcp]~=0.3.1; extra == 'mcp'
+Provides-Extra: memory-neo4j
+Requires-Dist: agentforge-memory-neo4j~=0.3.1; extra == 'memory-neo4j'
+Provides-Extra: memory-postgres
+Requires-Dist: agentforge-memory-postgres~=0.3.1; extra == 'memory-postgres'
+Provides-Extra: memory-sqlite
+Requires-Dist: agentforge-memory-sqlite~=0.3.1; extra == 'memory-sqlite'
+Provides-Extra: memory-surrealdb
+Requires-Dist: agentforge-memory-surrealdb~=0.3.1; extra == 'memory-surrealdb'
+Provides-Extra: ollama
+Requires-Dist: agentforge-ollama[ollama]~=0.3.1; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: agentforge-openai[openai]~=0.3.1; extra == 'openai'
+Provides-Extra: otel
+Requires-Dist: agentforge-otel~=0.3.1; extra == 'otel'
+Provides-Extra: phoenix
+Requires-Dist: agentforge-phoenix[phoenix]~=0.3.1; extra == 'phoenix'
+Provides-Extra: reranker-cohere
+Requires-Dist: agentforge-reranker-cohere[cohere]~=0.3.1; extra == 'reranker-cohere'
+Provides-Extra: reranker-mixedbread
+Requires-Dist: agentforge-reranker-mixedbread[mixedbread]~=0.3.1; extra == 'reranker-mixedbread'
+Provides-Extra: reranker-sentence-transformers
+Requires-Dist: agentforge-reranker-sentence-transformers[sentence-transformers]~=0.3.1; extra == 'reranker-sentence-transformers'
+Provides-Extra: reranker-voyage
+Requires-Dist: agentforge-reranker-voyage[voyage]~=0.3.1; extra == 'reranker-voyage'
+Provides-Extra: statsd
+Requires-Dist: agentforge-statsd[statsd]~=0.3.1; extra == 'statsd'
+Provides-Extra: testing
+Requires-Dist: agentforge-testing~=0.3.1; extra == 'testing'
+Provides-Extra: voyage
+Requires-Dist: agentforge-voyage[voyage]~=0.3.1; 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.4 → agentforge_py-0.3.1}/pyproject.toml

@@ -14,7 +14,7 @@
 
 [project]
 name = "agentforge-py"
-version = "0.2.4"
+version = "0.3.1"
 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.4",
+    "agentforge-core ~= 0.3.1",
     "pydantic>=2.10",
     "pyyaml>=6.0",
     "typer>=0.15",
@@ -61,94 +61,94 @@ dependencies = [
 # installs the wrapper but not the SDK and the first call raises a
 # ModuleError (bug-015). bedrock hard-deps its SDK (aioboto3/botocore),
 # so it requests no extra — and must NOT request a phantom `[bedrock]`.
-anthropic = ["agentforge-anthropic[anthropic] ~= 0.2.4"]
-openai = ["agentforge-openai[openai] ~= 0.2.4"]
-bedrock = ["agentforge-bedrock ~= 0.2.4"]
-ollama = ["agentforge-ollama[ollama] ~= 0.2.4"]
-litellm = ["agentforge-litellm[litellm] ~= 0.2.4"]
+anthropic = ["agentforge-anthropic[anthropic] ~= 0.3.1"]
+openai = ["agentforge-openai[openai] ~= 0.3.1"]
+bedrock = ["agentforge-bedrock ~= 0.3.1"]
+ollama = ["agentforge-ollama[ollama] ~= 0.3.1"]
+litellm = ["agentforge-litellm[litellm] ~= 0.3.1"]
 
 # Embeddings
-voyage = ["agentforge-voyage[voyage] ~= 0.2.4"]
+voyage = ["agentforge-voyage[voyage] ~= 0.3.1"]
 
 # Memory backends (each hard-deps its driver SDK — no extra to chain)
-memory-sqlite = ["agentforge-memory-sqlite ~= 0.2.4"]
-memory-postgres = ["agentforge-memory-postgres ~= 0.2.4"]
-memory-neo4j = ["agentforge-memory-neo4j ~= 0.2.4"]
-memory-surrealdb = ["agentforge-memory-surrealdb ~= 0.2.4"]
+memory-sqlite = ["agentforge-memory-sqlite ~= 0.3.1"]
+memory-postgres = ["agentforge-memory-postgres ~= 0.3.1"]
+memory-neo4j = ["agentforge-memory-neo4j ~= 0.3.1"]
+memory-surrealdb = ["agentforge-memory-surrealdb ~= 0.3.1"]
 
 # Chat surface (chat hard-deps aiosqlite; history backends hard-dep their SDK)
-chat = ["agentforge-chat ~= 0.2.4"]
-chat-http = ["agentforge-chat-http ~= 0.2.4"]
-chat-slack = ["agentforge-chat-slack ~= 0.2.4"]
-chat-history-postgres = ["agentforge-chat-history-postgres ~= 0.2.4"]
-chat-history-redis = ["agentforge-chat-history-redis ~= 0.2.4"]
+chat = ["agentforge-chat ~= 0.3.1"]
+chat-http = ["agentforge-chat-http ~= 0.3.1"]
+chat-slack = ["agentforge-chat-slack ~= 0.3.1"]
+chat-history-postgres = ["agentforge-chat-history-postgres ~= 0.3.1"]
+chat-history-redis = ["agentforge-chat-history-redis ~= 0.3.1"]
 
 # Rerankers
-reranker-cohere = ["agentforge-reranker-cohere[cohere] ~= 0.2.4"]
-reranker-voyage = ["agentforge-reranker-voyage[voyage] ~= 0.2.4"]
-reranker-mixedbread = ["agentforge-reranker-mixedbread[mixedbread] ~= 0.2.4"]
-reranker-sentence-transformers = ["agentforge-reranker-sentence-transformers[sentence-transformers] ~= 0.2.4"]
+reranker-cohere = ["agentforge-reranker-cohere[cohere] ~= 0.3.1"]
+reranker-voyage = ["agentforge-reranker-voyage[voyage] ~= 0.3.1"]
+reranker-mixedbread = ["agentforge-reranker-mixedbread[mixedbread] ~= 0.3.1"]
+reranker-sentence-transformers = ["agentforge-reranker-sentence-transformers[sentence-transformers] ~= 0.3.1"]
 
 # Guardrails (each hard-deps its SDK — no extra to chain)
-guard-llmguard = ["agentforge-guard-llmguard ~= 0.2.4"]
-guard-presidio = ["agentforge-guard-presidio ~= 0.2.4"]
-guard-nemo = ["agentforge-guard-nemo ~= 0.2.4"]
-guard-llamaguard = ["agentforge-guard-llamaguard ~= 0.2.4"]
+guard-llmguard = ["agentforge-guard-llmguard ~= 0.3.1"]
+guard-presidio = ["agentforge-guard-presidio ~= 0.3.1"]
+guard-nemo = ["agentforge-guard-nemo ~= 0.3.1"]
+guard-llamaguard = ["agentforge-guard-llamaguard ~= 0.3.1"]
 
 # Observability
-langfuse = ["agentforge-langfuse[langfuse] ~= 0.2.4"]
-phoenix = ["agentforge-phoenix[phoenix] ~= 0.2.4"]
-otel = ["agentforge-otel ~= 0.2.4"]
-statsd = ["agentforge-statsd[statsd] ~= 0.2.4"]
-evidently = ["agentforge-evidently[evidently] ~= 0.2.4"]
+langfuse = ["agentforge-langfuse[langfuse] ~= 0.3.1"]
+phoenix = ["agentforge-phoenix[phoenix] ~= 0.3.1"]
+otel = ["agentforge-otel ~= 0.3.1"]
+statsd = ["agentforge-statsd[statsd] ~= 0.3.1"]
+evidently = ["agentforge-evidently[evidently] ~= 0.3.1"]
 
 # Protocols
-mcp = ["agentforge-mcp[mcp] ~= 0.2.4"]
-a2a = ["agentforge-a2a ~= 0.2.4"]
+mcp = ["agentforge-mcp[mcp] ~= 0.3.1"]
+a2a = ["agentforge-a2a ~= 0.3.1"]
 
 # Eval
-eval = ["agentforge-eval-geval ~= 0.2.4"]
+eval = ["agentforge-eval-geval ~= 0.3.1"]
 
 # Testing
-testing = ["agentforge-testing ~= 0.2.4"]
+testing = ["agentforge-testing ~= 0.3.1"]
 
 # Everything (development / docs / smoke-test convenience — not
 # recommended for production deploys; pick the actual integrations
 # you use to keep the dependency tree small). Vendor-SDK extras are
 # chained here too so `[all]` actually installs every SDK.
 all = [
-    "agentforge-anthropic[anthropic] ~= 0.2.4",
-    "agentforge-openai[openai] ~= 0.2.4",
-    "agentforge-bedrock ~= 0.2.4",
-    "agentforge-ollama[ollama] ~= 0.2.4",
-    "agentforge-litellm[litellm] ~= 0.2.4",
-    "agentforge-voyage[voyage] ~= 0.2.4",
-    "agentforge-memory-sqlite ~= 0.2.4",
-    "agentforge-memory-postgres ~= 0.2.4",
-    "agentforge-memory-neo4j ~= 0.2.4",
-    "agentforge-memory-surrealdb ~= 0.2.4",
-    "agentforge-chat ~= 0.2.4",
-    "agentforge-chat-http ~= 0.2.4",
-    "agentforge-chat-slack ~= 0.2.4",
-    "agentforge-chat-history-postgres ~= 0.2.4",
-    "agentforge-chat-history-redis ~= 0.2.4",
-    "agentforge-reranker-cohere[cohere] ~= 0.2.4",
-    "agentforge-reranker-voyage[voyage] ~= 0.2.4",
-    "agentforge-reranker-mixedbread[mixedbread] ~= 0.2.4",
-    "agentforge-reranker-sentence-transformers[sentence-transformers] ~= 0.2.4",
-    "agentforge-guard-llmguard ~= 0.2.4",
-    "agentforge-guard-presidio ~= 0.2.4",
-    "agentforge-guard-nemo ~= 0.2.4",
-    "agentforge-guard-llamaguard ~= 0.2.4",
-    "agentforge-langfuse[langfuse] ~= 0.2.4",
-    "agentforge-phoenix[phoenix] ~= 0.2.4",
-    "agentforge-otel ~= 0.2.4",
-    "agentforge-statsd[statsd] ~= 0.2.4",
-    "agentforge-evidently[evidently] ~= 0.2.4",
-    "agentforge-mcp[mcp] ~= 0.2.4",
-    "agentforge-a2a ~= 0.2.4",
-    "agentforge-eval-geval ~= 0.2.4",
-    "agentforge-testing ~= 0.2.4",
+    "agentforge-anthropic[anthropic] ~= 0.3.1",
+    "agentforge-openai[openai] ~= 0.3.1",
+    "agentforge-bedrock ~= 0.3.1",
+    "agentforge-ollama[ollama] ~= 0.3.1",
+    "agentforge-litellm[litellm] ~= 0.3.1",
+    "agentforge-voyage[voyage] ~= 0.3.1",
+    "agentforge-memory-sqlite ~= 0.3.1",
+    "agentforge-memory-postgres ~= 0.3.1",
+    "agentforge-memory-neo4j ~= 0.3.1",
+    "agentforge-memory-surrealdb ~= 0.3.1",
+    "agentforge-chat ~= 0.3.1",
+    "agentforge-chat-http ~= 0.3.1",
+    "agentforge-chat-slack ~= 0.3.1",
+    "agentforge-chat-history-postgres ~= 0.3.1",
+    "agentforge-chat-history-redis ~= 0.3.1",
+    "agentforge-reranker-cohere[cohere] ~= 0.3.1",
+    "agentforge-reranker-voyage[voyage] ~= 0.3.1",
+    "agentforge-reranker-mixedbread[mixedbread] ~= 0.3.1",
+    "agentforge-reranker-sentence-transformers[sentence-transformers] ~= 0.3.1",
+    "agentforge-guard-llmguard ~= 0.3.1",
+    "agentforge-guard-presidio ~= 0.3.1",
+    "agentforge-guard-nemo ~= 0.3.1",
+    "agentforge-guard-llamaguard ~= 0.3.1",
+    "agentforge-langfuse[langfuse] ~= 0.3.1",
+    "agentforge-phoenix[phoenix] ~= 0.3.1",
+    "agentforge-otel ~= 0.3.1",
+    "agentforge-statsd[statsd] ~= 0.3.1",
+    "agentforge-evidently[evidently] ~= 0.3.1",
+    "agentforge-mcp[mcp] ~= 0.3.1",
+    "agentforge-a2a ~= 0.3.1",
+    "agentforge-eval-geval ~= 0.3.1",
+    "agentforge-testing ~= 0.3.1",
 ]
 
 [project.scripts]

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/__init__.py

@@ -19,6 +19,11 @@ the per-feature specs under `docs/features/`.
 
 from __future__ import annotations
 
+# Version is sourced from the installed distribution metadata so it can
+# never drift from pyproject.toml (bug-024).
+from importlib.metadata import PackageNotFoundError as _PkgNotFound
+from importlib.metadata import version as _dist_version
+
 from agentforge_core import FallbackChain
 
 # feat-018: importing `agentforge.guardrails` here triggers the
@@ -69,7 +74,10 @@ from agentforge.strategies import (
     get_runtime,
 )
 
-__version__ = "0.2.3"
+try:
+    __version__ = _dist_version("agentforge-py")
+except _PkgNotFound:  # pragma: no cover - source tree without installed metadata
+    __version__ = "0.0.0+unknown"
 
 __all__ = [
     "RUNTIME_KEY",

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/_build.py

@@ -21,6 +21,7 @@ deterministic exit codes (per feat-017 §4 — config invalid → 2).
 from __future__ import annotations
 
 import contextlib
+import inspect
 from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
@@ -75,7 +76,7 @@ async def build_agent_from_config(
     Splits out from `load_and_build` for tests + reuse — tests build
     a `AgentForgeConfig` directly and skip the YAML parse.
     """
-    memory = build_memory_from_config(config)
+    memory = await build_memory_from_config(config)
     if memory is not None:
         await _maybe_init_schema(memory)
     evaluators = build_evaluators_from_config(config)
@@ -115,12 +116,18 @@ async def build_agent_from_config(
         raise
 
 
-def build_memory_from_config(config: AgentForgeConfig) -> MemoryStore | None:
-    """Resolve + instantiate `modules.memory`. Returns None when absent."""
+async def build_memory_from_config(config: AgentForgeConfig) -> MemoryStore | None:
+    """Resolve + instantiate `modules.memory`. Returns None when absent.
+
+    Async because the real memory backends (sqlite/postgres/neo4j/
+    surrealdb) open a connection at construction and expose an async
+    `from_config` factory (bug-022). Falls back to the sync
+    `_instantiate` path for stores that ship a plain/sync constructor.
+    """
     if config.modules.memory is None:
         return None
     cls = _resolve_class("memory", config.modules.memory.driver)
-    instance = _instantiate(cls, config.modules.memory.config)
+    instance = await _ainstantiate_memory(cls, config.modules.memory.config)
     if not isinstance(instance, MemoryStore):
         msg = (
             f"Resolved memory driver {config.modules.memory.driver!r} "
@@ -362,8 +369,12 @@ def _resolve_llm(config: AgentForgeConfig) -> LLMClient | str | None:
     We hand a string back to `Agent.__init__` when the model is a
     plain `"<provider>:<model>"` string — `Agent` already knows how
     to resolve that. When `agent.model` is missing but
-    `providers["default"]` is present, we synthesize the string from
-    the named-provider record.
+    `providers["default"]` is present, the named-provider record is
+    used — and its `config:` block is **passed through to the provider
+    constructor** (enh-004): a plain `type:model` string can only carry
+    the model id, so provider settings (`region`, `aws_profile`,
+    `role_arn`, `timeout_seconds`, …) have to ride the `config` block.
+    Without this they were silently dropped.
     """
     raw = config.agent.model
     if isinstance(raw, str):
@@ -371,7 +382,25 @@ def _resolve_llm(config: AgentForgeConfig) -> LLMClient | str | None:
     default = config.providers.get("default")
     if default is None or default.model is None:
         return None
-    return f"{default.type}:{default.model}"
+    if not default.config:
+        return f"{default.type}:{default.model}"
+    # Construct the provider directly with `model_id` + the `config`
+    # kwargs — the same `cls(model_id=...)` contract `Agent` uses to
+    # resolve a model string (every provider's __init__ accepts
+    # `model_id`), extended with the per-provider settings.
+    cls = _resolve_class("providers", default.type)
+    try:
+        instance = cls(model_id=default.model, **default.config)
+    except TypeError as exc:
+        msg = (
+            f"Provider {default.type!r} ({cls.__name__}) rejected "
+            f"providers.default.config keys {sorted(default.config)}: {exc}"
+        )
+        raise ModuleError(msg) from exc
+    if not isinstance(instance, LLMClient):
+        msg = f"Resolved provider {default.type!r} ({cls.__name__}) does not implement LLMClient."
+        raise ModuleError(msg)
+    return instance
 
 
 def _resolve_class(category: str, name: str) -> type:
@@ -402,6 +431,29 @@ def _instantiate(cls: type, cfg: dict[str, Any]) -> Any:
     return cls(**cfg)
 
 
+async def _ainstantiate_memory(cls: type, cfg: dict[str, Any]) -> Any:
+    """Async-aware construction for memory stores (bug-022).
+
+    Memory backends construct asynchronously (they open a connection)
+    and expose an awaitable `from_config`. Prefer it; if the resolved
+    class only offers a sync constructor (e.g. a test double), fall
+    back to the shared sync `_instantiate`.
+
+    Mirrors `_instantiate`'s keyword-then-positional `from_config`
+    shape so externally-shipped stores using either signature load.
+    """
+    from_config = getattr(cls, "from_config", None)
+    if callable(from_config):
+        try:
+            result = from_config(**cfg)
+        except TypeError:
+            result = from_config(cfg)
+        if inspect.isawaitable(result):
+            return await result
+        return result
+    return cls(**cfg)
+
+
 async def _maybe_init_schema(memory: MemoryStore) -> None:
     init = getattr(memory, "init_schema", None)
     if callable(init):

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/config_cmd.py

@@ -26,6 +26,7 @@ import yaml
 from agentforge_core.config import (
     AgentForgeConfig,
     load_config,
+    validate_app_config,
     validate_module_configs,
 )
 from agentforge_core.production.exceptions import ModuleError
@@ -128,6 +129,14 @@ def _run_validate(args: argparse.Namespace) -> int:
     except ModuleError as exc:
         sys.stderr.write(f"module config validation failed: {exc}\n")
         return 1
+    # Registered `app.<section>` schemas are always validated strictly
+    # (feat-026 Phase 2). Unregistered / not-installed sections are
+    # free-form, so `--strict-modules` governs only module resolution.
+    try:
+        validate_app_config(cfg)
+    except ModuleError as exc:
+        sys.stderr.write(f"app config validation failed: {exc}\n")
+        return 1
     sys.stdout.write("OK\n")
     return 0
 

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/db_cmd.py

@@ -83,7 +83,7 @@ async def _dispatch(args: argparse.Namespace) -> int:
     from agentforge_core.config.loader import load_config  # noqa: PLC0415
 
     config = load_config(args.path, env=args.env, overrides=list(args.override) or None)
-    memory = build_memory_from_config(config)
+    memory = await build_memory_from_config(config)
     if memory is None:
         sys.stderr.write("agentforge db: modules.memory must be configured.\n")
         return 1

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/debug_cmd.py

@@ -49,7 +49,7 @@ async def _dispatch(args: argparse.Namespace) -> int:
     from agentforge_core.config.loader import load_config  # noqa: PLC0415
 
     config = load_config(args.path, env=args.env, overrides=list(args.override) or None)
-    memory = build_memory_from_config(config)
+    memory = await build_memory_from_config(config)
     if memory is None:
         sys.stderr.write("agentforge debug: modules.memory must be configured.\n")
         return 1

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/health_cmd.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 import argparse
 import asyncio
+import inspect
 import json
 import sys
 from pathlib import Path
@@ -113,6 +114,8 @@ async def _check_backends(config: AgentForgeConfig) -> list[dict[str, Any]]:
 async def _probe(label: str, factory: Any) -> dict[str, Any]:
     try:
         instance = factory()
+        if inspect.isawaitable(instance):
+            instance = await instance
         if instance is None:
             return {"name": label, "kind": "backend", "ok": True, "detail": "none configured"}
         init = getattr(instance, "init_schema", None)

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/main.py

@@ -72,7 +72,7 @@ def main(argv: Sequence[str] | None = None) -> int:
 def _resolve_version() -> str:
     """Return the installed `agentforge` distribution's version."""
     try:
-        return version("agentforge")
+        return version("agentforge-py")
     except PackageNotFoundError:  # pragma: no cover - unusual at runtime
         return "0.0.0+unknown"
 

{agentforge_py-0.2.4 → agentforge_py-0.3.1}/src/agentforge/cli/module_cmd.py

@@ -5,13 +5,24 @@ PR #16. They edit `agentforge.yaml`, apply per-module manifest
 files, and shell out to `pip install` / `pip uninstall`.
 
 The pip subprocess is injected via the `pip_run` callable so tests
-can mock it without actually installing packages. Production uses
-`python -m pip` in the active venv.
+can mock it without actually installing packages. Production uses an
+environment-aware default runner (`_default_pip_runner`) that picks
+the right installer for the active environment:
+
+1. **uv-managed project** (a `uv.lock` exists in the cwd or any
+   parent): use `uv add` / `uv remove` so the dependency is persisted
+   to `pyproject.toml` + `uv.lock` and survives a later `uv sync`.
+2. **classic venv** (the `pip` module is importable): use
+   `python -m pip` so traditional pip-managed environments keep
+   working.
+3. **uv venv that isn't a project** (no `uv.lock`, no `pip` module):
+   fall back to `uv pip --python <interpreter>`.
 """
 
 from __future__ import annotations
 
 import argparse
+import importlib.util
 import subprocess  # nosec B404
 import sys
 from collections.abc import Callable, Sequence
@@ -239,9 +250,46 @@ def _print_next_steps(manifest: Manifest) -> None:
         sys.stdout.write(f"    - {step}\n")
 
 
+def _find_uv_lock(start: Path) -> bool:
+    """Return True if a `uv.lock` exists in `start` or any parent.
+
+    Walks from `start` up to the filesystem root. The presence of a
+    `uv.lock` is uv's signal that the current directory belongs to a
+    uv-managed project, where `uv add` / `uv remove` (which edit
+    `pyproject.toml` + `uv.lock`) are the correct install verbs.
+    """
+    return any((directory / "uv.lock").exists() for directory in (start, *start.parents))
+
+
 def _default_pip_runner(args: Sequence[str]) -> int:
-    """Run `python -m pip <args>` in the active venv."""
-    cmd = [sys.executable, "-m", "pip", *args]
+    """Install/uninstall a distribution using the right tool for the
+    active environment.
+
+    The runner receives pip-style args — `["install", <dist>]` or
+    `["uninstall", "-y", <dist>]` — and selects one of three commands:
+
+    1. **uv-managed project** (a `uv.lock` is found in the cwd or any
+       parent): translate to `uv add <dist>` / `uv remove <dist>`.
+       These edit `pyproject.toml` + `uv.lock`, so the dependency is
+       persisted and survives a later `uv sync` (plain `uv pip install`
+       does not — `uv sync` would uninstall it).
+    2. **classic venv** (the `pip` module is importable): use
+       `python -m pip <args>` so traditional pip-managed environments
+       keep working.
+    3. **uv venv that isn't a project** (no `uv.lock`, no `pip`
+       module): fall back to `uv pip --python <sys.executable> <args>`,
+       which installs into the active interpreter without needing a
+       `pip` module.
+    """
+    if _find_uv_lock(Path.cwd()):
+        verb = args[0]
+        distribution = args[-1]
+        uv_verb = "add" if verb == "install" else "remove"
+        cmd = ["uv", uv_verb, distribution]
+    elif importlib.util.find_spec("pip") is not None:
+        cmd = [sys.executable, "-m", "pip", *args]
+    else:
+        cmd = ["uv", "pip", "--python", sys.executable, *args]
     # No untrusted input — args is built from CLI arg `distribution`
     # which is just a distribution name string. shell=False (default).
     return subprocess.run(cmd, check=False).returncode  # noqa: S603  # nosec B603