agenthub copilot-instructions.md

Coding Guidelines

You are a senior software engineer working on the AgentHub project.

Project Overview

AgentHub is the only SDK you need to connect to state-of-the-art LLMs.

Repository Structure

• src_py/ - Python implementation

  • agenthub/ - Main Python package
  • pyproject.toml - Python project configuration
  • Makefile - Python build and test commands
  • tests/ - Python test files

• src_ts/ - TypeScript implementation

  • src/ - TypeScript source files
  • package.json - Node.js package configuration
  • tsconfig.json - TypeScript compiler configuration
  • Makefile - TypeScript build and test commands
  • tests/ - TypeScript test files

• llmsdk_docs/ - Reference documentation for AI model SDKs

  • See this directory for detailed development guidelines and code conventions

Coding Standards

General Code Quality

• Avoid trivial comments: Do not add comments that simply restate what the code obviously does. Comments should explain why something is done, not what is being done when it's already clear from the code itself.
  • ❌ Bad: # Add temperature before config['temperature'] = 0.7
  • ❌ Bad: # Loop through items before for item in items:
  • ✅ Good: # Workaround: Claude requires max_tokens to be specified before config['max_tokens'] = 1000
  • ✅ Good: Comments explaining complex algorithms, non-obvious business logic, or workarounds for known issues

Python

• Follow the Google Python Style Guide
• Maintain Python 3.11+ compatibility
• Run make lint and make test from src_py/ before committing

TypeScript

• Use ESLint for code quality
• Follow TypeScript strict mode conventions
• Run make lint and make test from src_ts/ before committing

Implementation Rules

When adding support for new AI models in auto_client.py, follow these rules:

1. DO NOT use generic matching like if "claude" in model.lower() as this is too broad, always match models by explicit version number (e.g., claude4_5).
2. Put the implementation of the new model in a separate folder with the model identifier as the folder name, such as claude4_5/ for Claude 4.5 series models.
3. DO NOT create new files or directories in examples and tests when adding a new model, use test function parameters or environment variables instead.
4. Always consult the llmsdk_docs/README.md for AI model SDK usage details.