framework-agents 0.1.0__py3-none-any.whl

framework_agents-0.1.0.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.5
+Name: framework-agents
+Version: 0.1.0
+Summary: Python agent framework: ReAct loop, tools, memory, streaming, budgets, middleware, multi-agent, semantic graph, A2A serving - parity with the TypeScript package
+Project-URL: Homepage, https://github.com/fab679/framework
+Project-URL: Documentation, https://fab679.github.io/framework/
+Project-URL: Repository, https://github.com/fab679/framework
+Project-URL: Changelog, https://github.com/fab679/framework/releases
+Author: Framework Agents
+License: MIT
+Keywords: a2a,agents,ai,asyncio,llm,mcp,semantic-web,streaming
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Provides-Extra: dev
+Requires-Dist: anyio>=4; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Python package — TS parity port (`framework_agents`)
+
+The TypeScript package (`packages/typescript`) is the reference implementation.
+This port targets API parity with the **fixed** TS semantics — every behavior
+that was a real bug during the TS line (and is regression-pinned there) is
+encoded here from day one:
+
+| Pinned semantic | Why |
+|---|---|
+| `reasoning_tokens` is a SUBSET of `output_tokens` | never double-billed in budgets/cost |
+| `cost_usd` only when a price is known | unknown models → `None`, never a fake $0 |
+| `save()` APPENDS; the loop does clear-then-save | history never duplicates across runs |
+| Structured `'auto'` resolves by capability | unresolved auto never throws STRUCTURED_NO_MATCH |
+| `finish_reason=length` + zero content → loud `MODEL_ERROR` | a thinking model burning its whole budget is not a silent empty answer |
+| Tool parameter schemas ride the wire | models see real argument shapes |
+| HITL decisions: exact key THEN bare tool name | resume converges even when models regenerate arg text |
+| Local `ollama:` pricing wins over name collisions | never bill cloud prices for free local models |
+| Storage keys/threadIds reject traversal (`..`) | no writes outside the root |
+| Remote SPARQL: descriptive UA + 429/5xx retry honoring Retry-After | public endpoints reject and rate-limit otherwise |
+
+No personal or brand names appear anywhere in this package.
+
+## Port status (mirroring the TS module map)
+
+| TS module | Python | State |
+|---|---|---|
+| types (messages/blocks/usage) | `types.py` | ✅ |
+| errors + retryable verdicts | `errors.py` | ✅ |
+| tools (define_tool/registry/schemas) | `tools.py` | ✅ |
+| memory (+compaction) | `memory.py`, `memory_compaction.py` | ✅ (MEMORY_CORRUPT loud, atomic unique-tmp writes) |
+| conversation managers | `conversation.py` | ✅ (order-preserving pin; model or fn summarizer) |
+| sessions + snapshots | `sessions.py` | ✅ (validated keys, TS-tested preset semantics) |
+| checkpoint + file locks | `checkpoint.py` | ✅ (O_EXCL + stale reclaim, threadId validation) |
+| runtime (abort/timeout) | `runtime.py` | ✅ |
+| models (mock + OpenAI-compatible + Anthropic + Ollama) | `models/` | ✅ (Together+OpenAI field unions, native Anthropic Messages API w/ thinking budgets + SSE machine, vision capability fail-fast, stream usage, truncation guard) |
+| state (AgentState + invocation) | `state.py`, `agent.py` | ✅ (validated JSON KV, custom-prototype rejection, snapshots/session restore, pause/resume, edit/branch/timelines, v1 reasoning blocks, `with_tools`) |
+| pricing | `pricing.py` | ✅ |
+| config + factory | `config.py` | ✅ (together/openai/ollama/custom) |
+| agent loop (budgets/structured/streaming) | `agent.py` | ✅ (calls stream via drain; budget price refusal; synthesized final answer) |
+| middleware (hooks, HITL, retries, limits, policy, todos, pii) | `middleware.py` | ✅ |
+| orchestration | `orchestration.py` | ✅ (sequential/parallel/router; routed result semantics) |
+| workflows | `workflows.py` | ✅ (dedup'd indegree, retries, propagation) |
+| swarm | `swarm.py` | ✅ (handoff tool + stream events + loop detection default) |
+| evals | `evals.py` | ✅ (JSONL + pass-rate reporter) |
+| skills + TF-IDF routing | `skills.py` | ✅ ($mention word-boundary wins) |
+| prompts (+A/B) | `prompts.py` | ✅ (CRLF/BOM tolerance) |
+| rag (tf-idf retriever + tool) | `rag.py` | ✅ |
+| semantic (store/SHACL/rules/graph memory/linking/JSON-LD/evolution) | `semantic.py`, `ontology_review.py` | ✅ (version graphs under `urn:framework:ontology:*`) |
+| remote SPARQL | `remote_sparql.py` | ✅ (UA + Retry-After retry) |
+| A2A clients (SSE + JSON-RPC) | `a2a_client.py` | ✅ (envelope + contextId chain + retry) |
+| A2A server (contexts/LRU/disconnect/SSE) | `a2a_server.py` | ✅ (stdio-of-asyncio raw HTTP, body caps, CORS) |
+| MCP clients + bridging | `mcp_client.py` | ✅ (stdio child lifecycle, no-id notification, per-tool degrade) |
+| observability + tracing sinks | `observability.py`, `tracing.py` | ✅ |
+| sandbox (JS + shell) | `sandbox.py` | ✅ (caveat: exec timeouts abandon a thread, no hard kill) |
+| serve (framework.json + CLI) | `serve.py` | ✅ (lazy model init, argparse CLI, per-context isolated agents) |
+| React SDK | — | n/a (React-specific; browser clients use A2A/SSE) |
+
+**Batch-2 middleware** (`model_fallback`, `summarization`, `context_editing` +
+`ClearToolUsesEdit`, `llm_tool_selector`, `tool_emulator`, `filesystem`,
+`create_sub_agent`, `pii` tool-results) is ported with deviations pinned in
+`middleware.py`'s docstring (feedback-strings instead of raises on escape
+misses; `older_than_steps` interpreted as a step gate).
+
+## Running
+
+```bash
+python3 -m venv .venv
+.venv/bin/pip install -e ".[dev]"
+.venv/bin/python -m pytest tests -q                 # offline parity suite (233 tests)
+E2E_MODEL=1 .venv/bin/python -m pytest tests -q -m live
+# live Together parity runs; OpenAI + Anthropic suites skip cleanly and go
+# live as soon as OPENAI_API_KEY / ANTHROPIC_API_KEY appear in framework/.env
+```
+
+## Known deviations (documented in module docstrings)
+
+- `Agent.stream()` yields a `done` event and stores the result (generators
+  can't return values); run() drains — wire contracts identical.
+- Async file IO runs via `asyncio.to_thread` in filesystem tools; storage
+  classes use blocking IO inside async methods (single-process locality).
+- Sandbox JS cannot hard-interrupt a thread mid-statement (node:vm can) —
+  the timeout surfaces per contract, the abandoned thread dies at exit.
+- Semantic version graphs use `urn:framework:ontology:<version>` (the TS
+  default `urn:fabisch:*` embeds a personal name; both are configurable).
+- Cross-language conformance: the Python A2A client speaks the exact wire
+  contract of the TS A2A server (envelope, SSE frames, [DONE]) and vice
+  versa — see `tests/test_servers_and_clients.py`.

framework_agents-0.1.0.dist-info/RECORD

@@ -0,0 +1,41 @@
+framework_agents/__init__.py,sha256=qnmBtJD0hYGkndKD-PoinUBgn6GoqxRrJNzD7wsa9W4,8480
+framework_agents/a2a_client.py,sha256=G-ZkjP1cUEmZbE6i3Fm3t8btYT-9a_xVtY4oybX-fa0,14681
+framework_agents/a2a_server.py,sha256=7alOMcJIOOhsFB1y2HZYgINom5iWZN_qzANwVIcQuJg,22531
+framework_agents/agent.py,sha256=KDH4ekh2J7Clb0buZ4U_y5hQbuk8b3BRPP1Yrvns5_g,41849
+framework_agents/checkpoint.py,sha256=5uLl-IIoKXWYZuqvssQA3UjZMP_lIqrQoONQe3X-SyQ,8626
+framework_agents/config.py,sha256=VkMUtgefhcyMfitCu22j--pmyUVXWAlgTAcGdTbadpM,7368
+framework_agents/conversation.py,sha256=JAdIeZxY8t8eFaew_DA7Lzzg3XqOG9VcjAoDb3UbHI4,8811
+framework_agents/errors.py,sha256=2Zo1XAhLoUF5SKh0Z2TEs4QfDqov-5yzOpJOi7FoX8E,1521
+framework_agents/evals.py,sha256=1ozPwKbqIYIFsadK4Z_tFdoAY15sEbVwsNSGXKxJUR4,3757
+framework_agents/mcp_client.py,sha256=PG7ao7v4TBZABTCFBR2wr3STW80XZW49ig0GAMEMeMA,19522
+framework_agents/memory.py,sha256=DFed_meLWKaboUIhzMhPWjcD4mzIR-tscuexxZwXpsE,3962
+framework_agents/memory_compaction.py,sha256=JbOdKy2VQtnSyMP1Wfz8wj0cgm91Ix6_8hvaHkzIlj4,2036
+framework_agents/middleware.py,sha256=QFBcLqRkKtV0NI_ZWLyEBlum5tIVU7UESO5csNqezdI,53431
+framework_agents/observability.py,sha256=hRUrf6S9gJfydf-8jdAUCkL_EuxszM9C2O4oxsccIKw,2963
+framework_agents/ontology_review.py,sha256=Q31RF51xxM6kLXOIylYsQzBS0JdiIOJky_KNzyq9dcs,12412
+framework_agents/orchestration.py,sha256=z24uhanparRVSiL4JOM9aTD2WgRQV-zSKhvWWo0pyQ8,6552
+framework_agents/pricing.py,sha256=XHdoavy2tqZk8eWVfUGTlmypwJMvJ86NJQV2lc1LQaI,2438
+framework_agents/prompts.py,sha256=aJqx9JwBRag2v_lcmv1aPP_qRoGs0ngEhFqC7mxbqCQ,4544
+framework_agents/rag.py,sha256=rS3WF3jNQhOtFcjl7bCy9jOaylhU_nDvNguNeAJ24fs,4239
+framework_agents/remote_sparql.py,sha256=BG3o02uWqwiMUc9jkNeVCrKyvnbAPom5YTN3WB-ANiU,8760
+framework_agents/runtime.py,sha256=XeZ3mph1qXO_zKvuZ5Nuv5wBR4goLFEPiHCSFUgkxj8,3212
+framework_agents/sandbox.py,sha256=gCasWJJCGk6R3QOj_S-s9caOI8Hy7x5UNYJSzhq8TUs,11794
+framework_agents/semantic.py,sha256=8VM6bfy7IoTHAcZYNwXxYqCmw8z-jCofFZXqX3oy-3o,62345
+framework_agents/serve.py,sha256=XEKNRajr6h6TFMdqHPoFDs4q85qlPX0rcASYba9fylQ,17231
+framework_agents/sessions.py,sha256=aJNNjLGKYQEoNZMHBK2pVHpiiAtOullDZi4HU77Z6MI,8422
+framework_agents/skills.py,sha256=4OU1Ti6NN17hiyjm8L8jrKBm1LX2qyT32wfHEx79mcs,6812
+framework_agents/state.py,sha256=vtpdMjeSY_Sgdm0b9dnIQoXjivvHlYY9-Y2pKIcQHSU,3709
+framework_agents/streaming.py,sha256=yzeeN3Z0LsGl-w1VKJmE3z7uEO9FoDJzPNICXFsU23A,2647
+framework_agents/swarm.py,sha256=V_HA6uUUks8sv2vEp3MAHJ4i-vTCnzzW-PIjTpI_H2k,13382
+framework_agents/tools.py,sha256=5hQLg1AHOtpRkrJBK68rmvHJbPPwOUDtK8tLkduPbdE,3748
+framework_agents/tracing.py,sha256=lkx1BjhZuIybWBdU-HxhwCrTVvEhtsHn6XA6n8wmb7w,4790
+framework_agents/types.py,sha256=44vtfoNJVZbeIk5BglvfVnJriAY7tK-o7A_81cHx-nk,8798
+framework_agents/workflows.py,sha256=mNLiohL3u6nRS0jwWIYfze_-GkRyOtG7IJWGApQvcDw,4430
+framework_agents/models/__init__.py,sha256=XOXdD3i5iDS4pS90rZBQ0rK8iR98e8IgOMz7WY7aQhQ,2757
+framework_agents/models/anthropic.py,sha256=XXHekpEl_qY2zixkFo6b2DcfxGJwJM7TNcnmL-2eQf0,15256
+framework_agents/models/capabilities.py,sha256=GS7Rxns9twQWJLJG3WEj4wNtueTdWZcwoHQe25Oa82M,1428
+framework_agents/models/ollama.py,sha256=QMRAtLt0weQG-MnEhe6w7w63X4P2ijAzmy6Sci5_0DY,1570
+framework_agents/models/openai_compatible.py,sha256=tOj5dSlGgFwdczsOqIDe1jv6P1QyxByh8mE7ZJRHQ2k,17816
+framework_agents-0.1.0.dist-info/METADATA,sha256=dTLgPgi5bgjN2wcc88WMMKG_PF_NNP4nsdPl5LQSfzY,7282
+framework_agents-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+framework_agents-0.1.0.dist-info/RECORD,,

framework_agents-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any