Add registry-driven Task tool and agent configuration loading

.github/template-version.txt

@@ -1 +1 @@
-reloaded-templates-rust:1.0.1
+reloaded-templates-rust:1.1.1

.github/workflows/models-dev-update.yml

@@ -0,0 +1,31 @@
+name: Update models.dev catalog
+
+on:
+  schedule:
+    - cron: "0 9 * * 1"
+  workflow_dispatch:
+
+jobs:
+  update-catalog:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+          cache: true
+      - name: Run models.dev updater
+        working-directory: src
+        run: cargo run -p llm-coding-tools-models-dev --bin models-dev-update
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          title: "chore: update models.dev catalog"
+          body: "Automated update of models.dev catalog snapshot."
+          commit-message: "chore: update models.dev catalog"
+          branch: "automation/models-dev-catalog"
+          add-paths: |
+            src/llm-coding-tools-models-dev/data/models.dev.min.json

AGENTS.md

@@ -0,0 +1 @@
+@src/AGENTS.md

README.MD

@@ -2,17 +2,17 @@
 
 [![Crates.io - llm-coding-tools-core](https://img.shields.io/crates/v/llm-coding-tools-core.svg)](https://crates.io/crates/llm-coding-tools-core)
 [![Crates.io - llm-coding-tools-serdesai](https://img.shields.io/crates/v/llm-coding-tools-serdesai.svg)](https://crates.io/crates/llm-coding-tools-serdesai)
-[![Docs.rs](https://docs.rs/llm-coding-tools-serdesai/badge.svg)](https://docs.rs/llm-coding-tools-serdesai)
-[![CI](https://github.com/Sewer56/llm-coding-tools/actions/workflows/rust.yml/badge.svg)](https://github.com/Sewer56/llm-coding-tools/actions)
+[![CI](https://github.com/Sewer56/llm-coding-tools/actions/workflows/rust.yml/badge.svg)](https://github.com/Sewer56/llm-coding-tools/actions/workflows/rust.yml)
 
-Lightweight, high-performance coding tool implementations for LLM-powered development agents. Plug and play into your favourite frameworks.
+Lightweight, high-performance coding tool implementations for LLM-powered development agents.
 
 ## About This Workspace
 
 This workspace contains multiple Rust crates for integrating coding tools with LLM agents:
 
 - **[llm-coding-tools-core](./src/llm-coding-tools-core/)**: Framework-agnostic core operations and utilities
 - **[llm-coding-tools-serdesai](./src/llm-coding-tools-serdesai/)**: serdesAI framework-specific Tool implementations
+- **[llm-coding-tools-agents](./src/llm-coding-tools-agents/)**: Agent configuration loading for registry-driven Task tools
 
 ## Features
 
@@ -30,50 +30,26 @@ This workspace contains multiple Rust crates for integrating coding tools with L
 
 ## Quick Start
 
-Add to your `Cargo.toml`:
-
-```toml
-[dependencies]
-llm-coding-tools-serdesai = "0.1"
-```
-
-```rust,no_run
-use llm_coding_tools_serdesai::{AgentBuilder, BashTool, TodoTools};
-use llm_coding_tools_serdesai::absolute::{ReadTool, WriteTool, EditTool, GlobTool, GrepTool};
-
-let mut builder = AgentBuilder::new();
-let todos = TodoTools::new();
-
-builder
-    .track(ReadTool::<true>::new())
-    .track(WriteTool::new())
-    .track(EditTool::<true>::new())
-    .track(GlobTool::new())
-    .track(GrepTool::<true>::new())
-    .track(BashTool::new())
-    .track(&todos.read)
-    .track(&todos.write);
-
-let mut agent = builder.build();
-
-// Use the agent
-// let response = agent.invoke("List all files").await?;
-```
+See [llm-coding-tools-serdesai](./src/llm-coding-tools-serdesai/README.md) for serdesAI framework support.
 
 ## Examples
 
 ```bash
 # serdesAI framework - Basic agent setup
-cargo run --example serdesai-agents -p llm-coding-tools-serdesai
+cargo run --example serdesai-basic -p llm-coding-tools-serdesai
 
 # serdesAI framework - Sandboxed file access
 cargo run --example serdesai-sandboxed -p llm-coding-tools-serdesai
+
+# serdesAI framework - Registry-driven agent invocation
+cargo run --example serdesai-agents -p llm-coding-tools-serdesai
 ```
 
 ## Documentation
 
 - [llm-coding-tools-core README](./src/llm-coding-tools-core/README.md)
 - [llm-coding-tools-serdesai README](./src/llm-coding-tools-serdesai/README.md)
+- [llm-coding-tools-agents README](./src/llm-coding-tools-agents/README.md)
 - [Developer Guidelines](./src/AGENTS.md)
 
 ## Contributing

src/AGENTS.md

@@ -1,4 +1,6 @@
-Basic coding oriented tools for LLM agents
+Basic coding oriented tools for LLM agents.
+
+This is a headless library, there is no TUI interaction model here, so interactive `ask` approval flows and autocomplete-style agent UX are out of scope.
 
 # Feature Flags (llm-coding-tools-core)
 
@@ -16,15 +18,14 @@ The `async` and `blocking` features are mutually exclusive - enabling both cause
   - `src/error.rs` - Unified error types
   - `src/output.rs` - Tool output formatting
   - `src/util.rs` - Shared utilities
+- `llm-coding-tools-agents/` - Agent config loading and permission model
+- `llm-coding-tools-models-dev/` - models.dev catalog integration and snapshot tooling
 - `llm-coding-tools-serdesai/` - serdesAI framework Tool implementations
-  - `src/absolute/` - Unrestricted file system tools
-  - `src/allowed/` - Sandboxed file system tools
-  - `src/schema.rs` - Schema building utilities
-  - `src/convert.rs` - Type conversions between core and serdesAI
 
 # Code & Performance Guidelines
 
-This is a high-performance library. Optimize aggressively.
+This is a high-performance library. Optimize aggressively. Use arrays instead of maps if size is known ahead of time.
+Optimize for memory. Preallocate or trim if possible. Minimize memory use. Use smaller integers/types where appropriate. Use any other tricks that improve CPU or memory efficiency.
 
 ## Memory & Allocation
 
@@ -66,6 +67,6 @@ This is a high-performance library. Optimize aggressively.
 - Focus comments on "why" not "what"
 - Use [`TypeName`] rustdoc links, not backticks.
 
-# Post-Change Verification
+# Verification
 
-After you make a change to source code, always run `.cargo/verify.sh` (`.cargo/verify.ps1` on Windows) before returning to the user.
+After code changes or for checks (testing/linting/building/docs/formatting), run `.cargo/verify.sh` (`.cargo/verify.ps1` on Windows). It echoes each command and runs the full suite, including core tests and any extra checks. Do this before returning to the user.

src/Cargo.toml

@@ -1,7 +1,7 @@
 
 [workspace]
 resolver = "2"
-members = ["llm-coding-tools-core", "llm-coding-tools-serdesai", "llm-coding-tools-agents"]
+members = ["llm-coding-tools-core", "llm-coding-tools-serdesai", "llm-coding-tools-agents", "llm-coding-tools-models-dev"]
 
 # Profile Build
 [profile.profile]

src/llm-coding-tools-models-dev/Cargo.toml

@@ -0,0 +1,32 @@
+[package]
+name = "llm-coding-tools-models-dev"
+version = "0.1.0"
+edition = "2021"
+description = "Bundled models.dev catalog snapshot and lookup API"
+repository = "https://github.com/Sewer56/llm-coding-tools"
+license = "Apache-2.0"
+readme = "README.md"
+include = ["src/**/*", "data/**/*", "build.rs", "README.md"]
+
+[dependencies]
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+thiserror = "2.0"
+reqwest = { version = "0.13", default-features = false, features = [
+    "rustls",
+    "rustls-native-certs",
+] }
+tokio = { version = "1.48", features = ["fs", "io-util", "rt", "macros", "sync"] }
+zstd = "0.13"
+
+[build-dependencies]
+zstd = "0.13"
+
+[dev-dependencies]
+tokio = { version = "1.48", features = ["rt", "macros", "sync"] }
+tempfile = "3.24"
+wiremock = "0.6"
+
+[[bin]]
+name = "models-dev-update"
+path = "src/bin/models-dev-update.rs"

src/llm-coding-tools-models-dev/README.md

@@ -0,0 +1,61 @@
+# llm-coding-tools-models-dev
+
+Bundled models.dev catalog snapshot and lookup API.
+
+This crate provides a standalone catalog for models.dev provider and model data, with embedded snapshot support and filtering capabilities.
+
+## Features
+
+- Bundled zstd-compressed snapshot (level 22)
+- Load from bundled, cached, or downloaded sources
+- Model → provider index with optional filtering
+- Provider metadata lookup
+- Deterministic JSON output for vendored snapshots
+
+## Usage
+
+```rust
+# fn main() -> Result<(), Box<dyn std::error::Error>> {
+use llm_coding_tools_models_dev::{CatalogSource, ModelLimits, ModelsDevCatalog};
+use std::collections::HashSet;
+
+// Load bundled snapshot
+let (catalog, source) = ModelsDevCatalog::from_bundled()?;
+assert!(matches!(source, CatalogSource::Bundled));
+
+// Resolve providers for a model
+let providers = catalog.resolve_provider_for_model("gpt-4o");
+if let Some(provider_ids) = providers {
+    for provider_id in provider_ids {
+        if let Some(metadata) = catalog.get_provider(provider_id) {
+            println!("Provider: {} - env: {:?}", metadata.id, metadata.env);
+        }
+    }
+}
+
+// Optional model-limit lookups
+if let Some(ModelLimits { context, output }) = catalog.get_model_limits("gpt-4o") {
+    println!("gpt-4o context={} output={:?}", context, output);
+}
+
+// Load with model filtering
+let mut filter = HashSet::new();
+filter.insert("gpt-4o".to_string());
+let (catalog, _) = ModelsDevCatalog::from_bundled_filtered(&filter)?;
+# Ok(())
+# }
+```
+
+## Update Binary
+
+Regenerate the vendored snapshot from models.dev:
+
+```bash
+cargo run -p llm-coding-tools-models-dev --bin models-dev-update
+```
+
+This fetches the latest data from <https://models.dev/api.json> and writes a minimal snapshot to `data/models.dev.min.json`.
+
+## License
+
+Apache-2.0

src/llm-coding-tools-models-dev/build.rs

@@ -0,0 +1,15 @@
+use std::{env, fs, path::PathBuf};
+use zstd::bulk::compress;
+
+fn main() {
+    let manifest_dir = PathBuf::from(env::var("CARGO_MANIFEST_DIR").expect("CARGO_MANIFEST_DIR"));
+    let input = manifest_dir.join("data/models.dev.min.json");
+    let out_dir = PathBuf::from(env::var("OUT_DIR").expect("OUT_DIR"));
+    let output = out_dir.join("models.dev.min.json.zst");
+
+    let json = fs::read(&input).expect("read models.dev.min.json");
+    let compressed = compress(&json, 22).expect("zstd compress");
+    fs::write(&output, compressed).expect("write models.dev.min.json.zst");
+
+    println!("cargo:rerun-if-changed={}", input.display());
+}