docs: Add documentation for eloquent-agents

[Lantum-Brendan]

Add docs.json manifest and 10 markdown files covering installation, quick start, harnesses, built-in tools, custom tools, security model, engine abstraction, MCP support, console commands, and prompts.

[sourceant]

Code Review Summary

The documentation for eloquent-agents is comprehensive, covering the entire lifecycle from installation to custom extensions. It provides clear examples for both configuration-driven and class-driven development.

🚀 Key Improvements

• Clear explanation of the SDK-agnostic engine abstraction.
• Detailed security section highlighting the importance of ToolContext and allowlisting.
• Useful Artisan command reference for debugging tool registration.

💡 Minor Suggestions

• Fix a namespace typo in the MCP documentation.
• Clarify the expected format for JSON strings in tool parameters.

[sourceant]

Review complete. No specific code suggestions were generated. See the overview comment for a summary.

[kofimokome]

Looks like you have a typo here. Are you trying to reference GROK?

[nfebe]

I think that's how its spelt, Elon is a weird dude you know

[kofimokome]

It's Grok with K. Check this article https://groq.com/blog/hey-elon-its-time-to-cease-de-grok Kofi Mokome, MTech LinkedIn <https://www.linkedin.com/in/kofimokome/> | X (Twitter) <https://twitter.com/kofimokome> | Website <https://kofimoko.me> | Medium ***@***.***> Le jeu. 2 juil. 2026 à 22:44, F. E Noel Nfebe ***@***.***> a écrit :

…

***@***.**** commented on this pull request. ------------------------------ In docs/installation.md <#3 (comment)> : > +# Groq +GROQ_API_KEY= I think that's how its spelt, Elon is a weird dude you know — Reply to this email directly, view it on GitHub <#3?email_source=notifications&email_token=AFA7S63PRS75LPBLVMG4T4T5C3JTDA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINRSGEZTINZQGEYKM4TFMFZW63VQOJSXM2LFO5PXEZLROVSXG5DFMSSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#discussion_r3516261497>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AFA7S64VHYIDMGMKQ5ZV47D5C3JTDAVCNFSNUABGKJSXA33TNF2G64TZHMYTENRZGM3TIMJYHA5US43TOVSTWNBXGQZDKMBQGUZTPILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AFA7S6Y32JIL4UKSWS6NVG35C3JTDA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINRSGEZTINZQGEYKM4TFMFZW63VQOJSXM2LFO5PXEZLROVSXG5DFMSSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/AFA7S66RXMVA662SMMQMLP35C3JTDA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINRSGEZTINZQGEYKM4TFMFZW63VQOJSXM2LFO5PXEZLROVSXG5DFMSSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because your review was requested.Message ID: ***@***.***>

[Lantum-Brendan]

@kofimokome updated to use (xAI/Grok provider) per your review. The original used which is for Groq Inc., not xAI.
Source: Groq API uses at api.groq.com; xAI Grok uses at api.x.ai (https://docs.x.ai/developers/quickstart)

[sourceant]

Review complete. See the overview comment for a summary.

[sourceant]

Clarify that the values parameter for eloquent.write should be a JSON-encoded string, as LLMs might try to pass a raw object depending on the engine implementation.

Suggested change

	- `id` (number, optional) - Record id, required for update.
	- `values` (string) - JSON object of column-value pairs.
	- `values` (string) - JSON-encoded object of column-value pairs (e.g., '{"amount": 10}').

[kofimokome]

@kofimokome updated to use (xAI/Grok provider) per your review. The original used which is for Groq Inc., not xAI. Source: Groq API uses at api.groq.com; xAI Grok uses at api.x.ai (https://docs.x.ai/developers/quickstart)

I don't think you needed to change it. I was simply asking a question. Anyway, let @nfebe confirm whether he intended to use Groq or Grok.