agentx-dev 3.4.0__tar.gz → 3.4.2__tar.gz

{agentx_dev-3.4.0 → agentx_dev-3.4.2}/CHANGELOG.md

@@ -4,6 +4,84 @@ All notable changes to `agentx-dev` are documented here. Format loosely
 follows [Keep a Changelog](https://keepachangelog.com/); versioning is
 [Semver](https://semver.org/).
 
+## [3.4.2] - 2026-09-19
+
+`media=` everywhere, CSV / text / Excel attachments, and structured output
+on models that need the Responses API. Non-breaking.
+
+### Added
+
+- **`media=` on chat models and structured output.** `llm.invoke`,
+  `llm.ainvoke`, and `with_structured_output(...).invoke` / `.ainvoke` take
+  `media=[...]` (paths, URLs, `Media`, part dicts), appended to the last
+  user turn, matching the agent runner. Media inside `content` lists
+  already worked; this adds the argument.
+- **CSV, text files, and Excel in `media=`.** Text-like files (CSV, TSV,
+  TXT, Markdown, JSON, XML, YAML, HTML) are read as text -- exactly as
+  written, UTF-8 or Windows-1252, CRLF normalised -- and spreadsheets
+  (.xlsx / .xls / .ods) are converted with pandas (`dtype=object`, so
+  cell values aren't re-inferred) to one CSV block per sheet. Both reach
+  GPT (chat and Responses) and Claude as a labelled text block, which
+  every model accepts. New `Media.text()` / `Media.spreadsheet()`; a
+  100,000-character cap (`max_chars=`, `truncate=True`). pandas and
+  openpyxl are now core dependencies, so spreadsheets work after a plain
+  `pip install agentx-dev` (`[excel]` still works). Date cells without a
+  time are written as dates, not `... 00:00:00`.
+- **Media docs section.** Its own nav group: Overview & flow, With chat
+  models, With agents, Reference (constructors, per-provider wire
+  formats, errors). `docs/guides/media.md` is now a pointer to it.
+
+### Fixed
+
+- **`with_structured_output` on models that need the Responses API.**
+  Structured output forces a single tool; if the Responses API rejects a
+  forced tool choice for the model, `GPT` retries with
+  `tool_choice="required"` (the same tool when there is only one), then
+  `"auto"`, remembering it per model. `StructuredOutputRunnable` also
+  accepts a JSON text answer that validates against the schema.
+- **`.txt` media failed on Claude.** 3.4.0 stored text files as base64
+  documents, which Anthropic only accepts for PDFs. Text files now go
+  out as text; older base64 text parts in saved histories are decoded
+  on the way out.
+- **Unsupported files reached the provider.** `Media.document()`
+  accepted any file type -- including CSV, which Windows' own type table
+  labels `application/vnd.ms-excel` -- and sent it as an attachment
+  neither provider accepts. Word, PowerPoint and archives now raise
+  `ValueError` with the fix before any request; a text file or
+  spreadsheet by URL raises too, since only PDFs can be fetched by URL.
+- **Misleading WARNING on recovered calls.** The retry wrapper logged
+  every non-retryable 400 at WARNING before the caller could recover, so a
+  call that switched to the Responses API and succeeded still printed the
+  original "Function tools with reasoning_effort are not supported" text.
+  Now DEBUG; recoveries log their own WARNING and real failures log ERROR.
+
+## [3.4.1] - 2026-09-18
+
+Tool calls on OpenAI models that require the Responses API.
+
+### Fixed
+
+- **Tool calls failed on models that need the Responses API.** Some
+  OpenAI models (e.g. `gpt-6-astra`) reject function tools combined with
+  reasoning on `/v1/chat/completions`, and the error's suggested fix --
+  `reasoning_effort='none'` -- is itself rejected by those models, so
+  3.4.0's parameter adaptation had nowhere to go. `GPT` now switches a
+  model's tool calls to `/v1/responses` when the provider says to,
+  retries, and remembers it (WARNING-logged). History is translated only
+  at the wire (`function_call` / `function_call_output` items paired by
+  `call_id`), so agents, `tool_calls`, and completions are unchanged.
+  Learned parameter fixes carry across endpoints (`reasoning.effort` maps
+  to `reasoning_effort`). Requests are sent with `store=False`, matching
+  chat completions. Plain text calls and streaming stay on chat
+  completions.
+- Requests chat completions can't express (a document URL) go to the
+  Responses API, which accepts `file_url`, instead of raising.
+
+### Added
+
+- `GPT(use_responses_api=None | True | False)`: automatic (default),
+  always, or never.
+
 ## [3.4.0] - 2026-09-18
 
 Media input for GPT and Claude, models that adapt to each generation's

{agentx_dev-3.4.0 → agentx_dev-3.4.2}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Bruce-Arhin Shadrach
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Bruce-Arhin Shadrach
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{agentx_dev-3.4.0 → agentx_dev-3.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentx-dev
-Version: 3.4.0
+Version: 3.4.2
 Summary: A production-grade Python framework for building LLM agents. Multi-provider chat, permission-gated tools, RAG (in-mem + Chroma/Qdrant/pgvector), semantic memory, Supervisor + Handoffs multi-agent orchestration with streaming, evals harness, prompt caching, Batch API, prompt-optimizer, MCP integration.
 Author-email: Bruce-Arhin Shadrach <brucearhin098@gmail.com>
 License: MIT License
@@ -35,6 +35,8 @@ Requires-Dist: openai>=1.0.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: PyYAML>=5.3.1
 Requires-Dist: rich>=10.0
+Requires-Dist: pandas>=1.5
+Requires-Dist: openpyxl>=3.1
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.36; extra == "anthropic"
 Provides-Extra: mcp
@@ -48,10 +50,15 @@ Provides-Extra: qdrant
 Requires-Dist: qdrant-client>=1.6; extra == "qdrant"
 Provides-Extra: pgvector
 Requires-Dist: psycopg[binary]>=3.1; extra == "pgvector"
+Provides-Extra: excel
+Requires-Dist: pandas>=1.5; extra == "excel"
+Requires-Dist: openpyxl>=3.1; extra == "excel"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: numpy>=1.24; extra == "dev"
+Requires-Dist: pandas>=1.5; extra == "dev"
+Requires-Dist: openpyxl>=3.1; extra == "dev"
 Provides-Extra: all
 Requires-Dist: anthropic>=0.36; extra == "all"
 Requires-Dist: mcp>=0.1; extra == "all"
@@ -60,6 +67,8 @@ Requires-Dist: opentelemetry-sdk>=1.20; extra == "all"
 Requires-Dist: chromadb>=0.4; extra == "all"
 Requires-Dist: qdrant-client>=1.6; extra == "all"
 Requires-Dist: psycopg[binary]>=3.1; extra == "all"
+Requires-Dist: pandas>=1.5; extra == "all"
+Requires-Dist: openpyxl>=3.1; extra == "all"
 Dynamic: license-file
 
 # agentx_dev
@@ -82,7 +91,7 @@ breaks — see [Upgrading](docs/guides/upgrading.md).
 
 | Feature | What you get |
 |---|---|
-| **Media input** | `runner.invoke("Describe this", media=["photo.jpg", "report.pdf"])`. Paths, URLs, bytes or `Media` objects. The same code works on `GPT()` and `Claude()`: each model gets its own format, and either provider's native part shape is accepted too. Unsupported pairs — audio to Claude, a PDF URL to GPT — fail fast with a clear `ValueError`. [Guide](docs/guides/media.md). |
+| **Media input** | `runner.invoke("Describe this", media=["photo.jpg", "report.pdf"])`. Paths, URLs, bytes or `Media` objects. The same code works on `GPT()` and `Claude()`: each model gets its own format, and either provider's native part shape is accepted too. Unsupported pairs — audio to Claude, a PDF URL to GPT — fail fast with a clear `ValueError`. [Media docs](docs/media/overview.md). |
 | **Models that adapt** | Parameter support changes between model generations — `reasoning_effort`'s allowed values, `max_tokens` vs `max_completion_tokens`, Claude's `temperature` + `top_p` conflict. When a model rejects a parameter, `GPT` and `Claude` make the smallest change the error asks for (`'none'` → `'low'`), retry, and remember it for that model. Logged at WARNING; `adapt_params=False` opts out. [Details](docs/concepts/models.md#old-and-new-models). |
 | **More Claude settings** | `Claude(top_p=, top_k=, thinking=, stop_sequences=)`. `temperature` is only sent when you set it. |
 | **Workspace paths** | With a workspace set, `/notes.txt` means the workspace's `notes.txt`, not `C:\notes.txt`. `run_python` now starts in the workspace, so `open("notes.txt")` finds it. |
@@ -972,10 +981,14 @@ llm.invoke([{"role": "user", "content": ["What's in this photo?", Media.image("c
 |---|---|---|
 | image (file or URL) | yes | yes |
 | PDF | file | file or URL |
+| CSV, TXT, JSON, Markdown ... | yes, as text | yes, as text |
+| Excel (`.xlsx`) | yes, CSV per sheet (pandas, installed with agentx-dev) | same |
 | audio (wav / mp3) | audio models | no — `ValueError` |
 
 Paths are relative to where your program runs, not the agent's
-workspace. See [Media](docs/guides/media.md).
+workspace. The same `media=` works on `llm.invoke(...)` and
+`llm.with_structured_output(Schema).invoke(...)`. See
+[Media](docs/media/overview.md).
 
 ## Get a typed result back
 

{agentx_dev-3.4.0 → agentx_dev-3.4.2}/README.md

@@ -18,7 +18,7 @@ breaks — see [Upgrading](docs/guides/upgrading.md).
 
 | Feature | What you get |
 |---|---|
-| **Media input** | `runner.invoke("Describe this", media=["photo.jpg", "report.pdf"])`. Paths, URLs, bytes or `Media` objects. The same code works on `GPT()` and `Claude()`: each model gets its own format, and either provider's native part shape is accepted too. Unsupported pairs — audio to Claude, a PDF URL to GPT — fail fast with a clear `ValueError`. [Guide](docs/guides/media.md). |
+| **Media input** | `runner.invoke("Describe this", media=["photo.jpg", "report.pdf"])`. Paths, URLs, bytes or `Media` objects. The same code works on `GPT()` and `Claude()`: each model gets its own format, and either provider's native part shape is accepted too. Unsupported pairs — audio to Claude, a PDF URL to GPT — fail fast with a clear `ValueError`. [Media docs](docs/media/overview.md). |
 | **Models that adapt** | Parameter support changes between model generations — `reasoning_effort`'s allowed values, `max_tokens` vs `max_completion_tokens`, Claude's `temperature` + `top_p` conflict. When a model rejects a parameter, `GPT` and `Claude` make the smallest change the error asks for (`'none'` → `'low'`), retry, and remember it for that model. Logged at WARNING; `adapt_params=False` opts out. [Details](docs/concepts/models.md#old-and-new-models). |
 | **More Claude settings** | `Claude(top_p=, top_k=, thinking=, stop_sequences=)`. `temperature` is only sent when you set it. |
 | **Workspace paths** | With a workspace set, `/notes.txt` means the workspace's `notes.txt`, not `C:\notes.txt`. `run_python` now starts in the workspace, so `open("notes.txt")` finds it. |
@@ -908,10 +908,14 @@ llm.invoke([{"role": "user", "content": ["What's in this photo?", Media.image("c
 |---|---|---|
 | image (file or URL) | yes | yes |
 | PDF | file | file or URL |
+| CSV, TXT, JSON, Markdown ... | yes, as text | yes, as text |
+| Excel (`.xlsx`) | yes, CSV per sheet (pandas, installed with agentx-dev) | same |
 | audio (wav / mp3) | audio models | no — `ValueError` |
 
 Paths are relative to where your program runs, not the agent's
-workspace. See [Media](docs/guides/media.md).
+workspace. The same `media=` works on `llm.invoke(...)` and
+`llm.with_structured_output(Schema).invoke(...)`. See
+[Media](docs/media/overview.md).
 
 ## Get a typed result back