@langwatch/better-agents 0.1.3-beta.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 LangWatch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,111 @@
+# Better Agents
+
+Better Agents is a CLI tool and a set of standards for agent building.
+
+It supercharges your coding assistant (Kilocode, Claude Code, Cursor, etc), making it an expert in any agent framework you choose (Agno, Mastra, etc) and all their best practices.
+
+It's the best way to start any new agent project.
+
+![](/images/cover-image.png)
+
+The Better Agent Structure and generated AGENTS.md ensures industry best practices, making your agent ready for production:
+- [Scenario](https://github.com/langwatch/scenario) agent tests written for every feature to ensure agent behaviour
+- Versioning of the prompts for collaboration
+- Evaluation notebooks for measuring specific prompts performance
+- Already instrumented for full observability
+- Standardization of structure for better project maintainability
+
+## The Better Agent Structure
+
+```
+my-agent-project/
+├── app/ (or src/)           # The actual agent code, according to the chosen framework
+├── tests/
+│   ├── evaluations/         # Jupyter notebooks for evaluations
+│   │   └── example_eval.ipynb
+│   └── scenarios/           # End-to-end scenario tests
+│       └── example_scenario.test.{py,ts}
+├── prompts/                 # Versioned prompt files for team collaboration
+│   └── sample_prompt.yaml
+├── prompts.json             # Prompt registry
+├── .mcp.json                # MCP server configuration
+├── AGENTS.md                # Development guidelines
+├── .env                     # Environment variables
+└── .gitignore
+```
+
+The structure and guidelines on `AGENTS.md` ensure every new feature required for the coding assistant is properly tested, evaluated, and that the prompts are versioned.
+
+The `.mcp.json` comes with all the right MCPs set up so you coding assistant becomes an expert in your framework of choice and know where to find new tools.
+
+[`scenarios/`](https://github.com/langwatch/scenario) tests guarantee the agent behaves as expected, which simulates a conversation with the agent making sure it does what expected.
+
+[`evaluations/`](https://docs.langwatch.ai/llm-evaluation/offline/code/evaluation-api) notebooks holds dataset and notebooks for evaluating pieces of your agent pipeline such as a RAG or classification tasks it must do
+
+Finally, [`prompts/`](https://docs.langwatch.ai/prompt-management/cli) hold all your versioned prompts in yaml format, synced and controlled by `prompts.json`, to allow for playground and team collaboration.
+
+## Getting Started
+
+### Installation
+
+```bash
+npm install -g @langwatch/better-agents
+```
+
+Or use with npx:
+
+```bash
+npx @langwatch/better-agents init my-agent-project
+```
+
+### Initialize a new project
+
+```bash
+# In current directory
+better-agents init .
+
+# In a new directory
+better-agents init my-awesome-agent
+```
+
+The CLI will guide you through selecting your programming language, agent framework, coding assistant, LLM provider, and API keys.
+
+## Documentation
+
+- **[Getting Started](docs/GETTING-STARTED.md)** - Quick start guide (2 minutes)
+- **[Walkthrough](docs/WALKTHROUGH.md)** - Detailed step-by-step guide
+- **[Project Structure](docs/STRUCTURE.md)** - Understanding the Better Agent structure
+- **[Features](docs/FEATURES.md)** - Key features and capabilities
+- **[Usage](docs/USAGE.md)** - CLI usage and examples
+- **[Philosophy](docs/PHILOSOPHY.md)** - Agent Testing Pyramid approach
+- **[Contributing](docs/CONTRIBUTING.md)** - How to contribute to Better Agents
+- **[Changelog](CHANGELOG.md)** - Version history
+
+## Requirements
+
+- Node.js 22+
+- npm or pnpm
+- A coding assistant (one of the following):
+  - [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code-agent) (`claude` CLI)
+  - [Cursor](https://www.cursor.com/)
+  - [Kilocode CLI](https://www.kilocode.ai/) (`kilocode`)
+- API Keys:
+  - Your chosen LLM Provider API key
+  - LangWatch API key (get one at https://app.langwatch.ai/authorize)
+  - Smithery API key (optional - for MCP tool auto-discovery, get one at https://smithery.ai/account/api-keys)
+
+## Resources
+
+- [LangWatch](https://langwatch.ai)
+- [Scenario Documentation](https://scenario.langwatch.ai/)
+- [Agent Testing Pyramid](https://scenario.langwatch.ai/best-practices/the-agent-testing-pyramid)
+- [Agno](https://agno.com)
+- [Mastra](https://mastra.ai)
+
+## License
+
+MIT
+
+---
+
+Built with ❤️ by the LangWatch team

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }