[franciscojavierarceo]

Summary

Register and execute the Responses file_search built-in tool through the existing typed gateway tool loop. The handler searches the configured file-search service, keeps retrieved passages private for model continuation, exposes file_search_call.results only when requested, and restores typed file citations in completed and streamed output. This is the top layer of a smaller stack; the Files and vector-store APIs, provider contracts, SQLite-vec adapter, and protocol types are reviewed below it.

Review order: #483 (storage contracts and portable SQL/local providers) → #484 (SQLite-vec) → #485 (Files and vector-store HTTP APIs and provider configuration) → #486 (Responses protocol and stream lifecycle) → this PR. The existing PostgreSQL/pgvector follow-up is #278; later retrieval and lifecycle work remains stacked above it.

The storage service accepts injected FileSearchRepository and FileBlobStore implementations. The lower layers configure SQLite-vec for semantic retrieval; Milvus and remote blob stores remain adapter extension points.

Test Plan

• cargo test -p agentic-server-core --test file_search_tool_test: 6 passed, covering blocking and streaming calls, citations, opt-in results, mixed client tools, failures, and selector validation.
• cargo test -p agentic-server-core --lib: 1,385 passed, 6 ignored on the corrected, restacked file tree. Full workspace cargo test --offline also passed on that tree.
• Changed-crate all-target Clippy with warnings denied, formatting, and all-file pre-commit hooks passed on the corrected, restacked file tree.
• The failing Rust CI check at 33b20ba came from an output-item test fixture missing the typed logprobs: [] field. The corrected citation projection test passes locally; CI is running on the cleanly restacked head.
• SQLite-vec review fixes from feat: add sqlite-vec file search provider #484 are carried through the stack: atomic publication, safe orphan cleanup, empty/unpublished row handling, and exact fallback above sqlite-vec's candidate limit.

[ashwing]

@franciscojavierarceo Is this still in-progress or ready for review? Happy to take a look when you're ready — especially interested in how the OGX VectorSearch trait maps to the dispatch interface we're building.

[franciscojavierarceo]

@ashwing I'm waiting for #46 to land to incorporate it and then mark as ready for review as I need the agentic loop and to update the Responses structs.