feat: add octoagent package #930
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the You can disable this status message by setting the Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
raghavyuva
added
nixopus-documentation
nixopus-view
nixopus-config
Owner
Author
|
@coderabbitai update title and description |
Contributor
|
Tip For best results, initiate chat on the files or code changes. 🧩 Analysis chain@raghavyuva I'll examine the PR changes and update the title and description accordingly. 🏁 Script executed: Length of output: 18809 @raghavyuva I'll update the PR title and description based on the changes made. 🏁 Script executed: Length of output: 810 @raghavyuva I encountered a workflow restriction that prevents me from directly updating the PR. However, I've prepared the updated title and description for you. You can copy and paste these manually: Updated Title:Updated Description:#### Issue
_No related issue_
---
#### Description
This PR introduces **octoagent**, a new AI-powered assistant service for Nixopus built with the Mastra framework. The service provides intelligent agent capabilities to help users interact with Nixopus documentation and operations through natural language.
**Key Features:**
- 🤖 **Multi-agent system** with three specialized agents:
- **docs-search**: Searches and retrieves information from Nixopus documentation
- **mcp-client**: Integrates with Model Context Protocol servers
- **nixopus-agent**: Main assistant agent for Nixopus operations
- 🧠 Built on **Mastra framework** - a TypeScript framework for production AI agents
- 🔌 Supports multiple AI providers (OpenAI, Google, Anthropic, Mistral) via Vercel AI SDK
- 📚 Includes documentation index (llms.txt) with Nixopus knowledge base
- ⚙️ Production-ready with PostgreSQL storage, logging, and observability
- 🚀 Requires Node.js >=22.13.0
**Technical Stack:**
- TypeScript
- Mastra AI framework (@mastra/core, @mastra/mcp, @mastra/memory)
- Vercel AI SDK for LLM integrations
- PostgreSQL for state management
- Environment-based configuration
---
#### Scope of Change
_Select all applicable areas impacted by this PR:_
- [ ] View (UI/UX)
- [x] API
- [ ] CLI
- [x] Infra / Deployment
- [ ] Docs
- [x] Other (specify): AI Agent Service
---
#### Screenshot / Video / GIF (if applicable)
_N/A - Backend service_
---
#### Related PRs (if any)
_None_
---
#### Additional Notes for Reviewers (optional)
- The service requires configuration of AI provider API keys (see .env.sample)
- Default model is set to Google Gemini 2.5 Pro
- Database connection (PostgreSQL) required for production deployment
- The llms.txt file contains indexed Nixopus documentation for agent context
---
#### Developer Checklist
_To be completed by the developer who raised the PR._
- [x] Add valid/relevant title for the PR
- [x] Self-review done
- [ ] Manual dev testing done
- [x] No secrets exposed
- [x] No merge conflicts
- [ ] Docs added/updated (if applicable)
- [x] Removed debug prints / secrets / sensitive data
- [ ] Unit / Integration tests passing
- [ ] Follows all standards defined in **Nixopus Docs**
---
#### Reviewer Checklist
_To be completed by the reviewer before merge._
- [ ] Peer review done
- [ ] No console.logs / fmt.prints left
- [ ] No secrets exposed
- [ ] If any DB migrations, migration changes are verified
- [ ] Verified release changes are production-readyYou can update the PR by clicking the "Edit" button next to the title on the PR page, or you can grant me permission to edit PRs by adjusting the workflow restriction settings. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Issue
No related issue
Description
This PR introduces octoagent, a new AI-powered assistant service for Nixopus built with the Mastra framework. The service provides intelligent agent capabilities to help users interact with Nixopus documentation and operations through natural language.
Key Features:
Technical Stack:
Scope of Change
Select all applicable areas impacted by this PR:
Screenshot / Video / GIF (if applicable)
N/A - Backend service
Related PRs (if any)
None
Additional Notes for Reviewers (optional)
Developer Checklist
To be completed by the developer who raised the PR.
Reviewer Checklist
To be completed by the reviewer before merge.