boxcars 0.10.4 → 0.10.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +11 -0
- data/README.md +50 -649
- data/docs/agents_guide.md +623 -0
- data/docs/boxcars_guide.md +696 -0
- data/lib/boxcars/agent_event.rb +33 -0
- data/lib/boxcars/agent_runner.rb +95 -0
- data/lib/boxcars/train/station_agent.rb +229 -0
- data/lib/boxcars/train.rb +1 -0
- data/lib/boxcars/version.rb +1 -1
- data/lib/boxcars.rb +2 -0
- metadata +6 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 1a4667cabaaa8991ea85ef6f6aefa9b96c70b69bb49d6a64dab37a42cbb7cad6
|
|
4
|
+
data.tar.gz: da990b69194157b3105ea244d7fe406959d726bd9f880576ba4fc3b11289e783
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 77675993258e8b133550b310154a46fac2aaf3ab674c6f226853ce7320e669ee488480ed7832493bfa31c7bea6c88a5572b53fcebb5b565e60b0eafe6c86b53b
|
|
7
|
+
data.tar.gz: c355fffe87e8c42cb0b0759c6244f678ec4d9141d76b62a95241e816450aa6531a86d3bf09c7c03ee6359a7971a51454581df1bd5ed96cd4ec56d10e4c1c26d6
|
data/CHANGELOG.md
CHANGED
|
@@ -2,11 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [0.10.5] - 2026-03-03
|
|
6
|
+
|
|
5
7
|
### Added
|
|
6
8
|
|
|
9
|
+
- **`StationAgent`** — Agent abstraction with instructions/tools DSL, agent-as-tool nesting, lifecycle callbacks (`on_tool_call`, `on_tool_result`, `on_complete`), and handoff support.
|
|
10
|
+
- **`AgentRunner`** — Orchestrator that follows agent-to-agent handoff chains with configurable `max_handoffs`.
|
|
11
|
+
- **`AgentEvent` and event streaming** — Real-time agent lifecycle events via `on_event` callback and `run_stream` method (block and Enumerator forms).
|
|
7
12
|
- **`context:` parameter for ActiveRecord and SQL boxcars** — Pass runtime context (current user, tenant, permissions) into prompts so the LLM generates properly scoped queries. Available as a constructor keyword and an `attr_accessor` for per-request updates.
|
|
8
13
|
- **Read-only mode for SQL boxcars** — `SQLBase` (and subclasses `SQLActiveRecord`, `SQLSequel`) now default to read-only, rejecting write SQL (`INSERT`, `UPDATE`, `DELETE`, `DROP`, etc.) with `Boxcars::SecurityError`. Pass `read_only: false` to allow writes, or provide an `approval_callback:` proc that receives the SQL string for custom approval logic.
|
|
9
14
|
|
|
15
|
+
### Documentation
|
|
16
|
+
|
|
17
|
+
- **Boxcars Guide** (`docs/boxcars_guide.md`) — New comprehensive guide covering Engines, Boxcars, Trains, MCP, Observability, and configuration.
|
|
18
|
+
- **Agents Guide** (`docs/agents_guide.md`) — New guide for StationAgent, AgentRunner, handoffs, and event streaming.
|
|
19
|
+
- **Slimmed README** — Rewritten as a concise landing page with quick-start examples and links to dedicated guides.
|
|
20
|
+
|
|
10
21
|
## [0.10.3] - 2026-03-02
|
|
11
22
|
|
|
12
23
|
### Added
|