{"_id":"@appsmithery/vscode-codechef","name":"@appsmithery/vscode-codechef","dist-tags":{"latest":"0.4.1"},"versions":{"0.4.1":{"name":"@appsmithery/vscode-codechef","displayName":"code/chef - AI Agent Orchestrator","description":"AI-powered task orchestration with LangGraph single-orchestrator architecture, 150+ MCP tools, and LangChain function calling. Submit development tasks via Copilot Chat.","version":"0.4.1","publisher":"appsmithery","license":"MIT","icon":"icon.png","private":false,"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/Appsmithery/Dev-Tools.git"},"bugs":{"url":"https://github.com/Appsmithery/Dev-Tools/issues"},"homepage":"https://codechef.appsmithery.co","badges":[{"url":"https://img.shields.io/badge/orchestrator-LangGraph-blue","description":"LangGraph Orchestrator (6 Agent Nodes)"},{"url":"https://img.shields.io/badge/MCP_tools-150+-green","description":"150+ MCP Tools"},{"url":"https://img.shields.io/badge/LangChain-enabled-orange","description":"LangChain Function Calling"}],"engines":{"vscode":"^1.85.0"},"categories":["AI","Other"],"keywords":["copilot","ai","codechef","orchestrator","mcp","langsmith","langchain","langgraph","workflow-engine","state-management","multi-agent","automation","code-generation","code-review","infrastructure","cicd","documentation","function-calling","progressive-disclosure"],"extensionDependencies":["linear.linear-connect"],"extensionPack":["graphql.vscode-graphql"],"activationEvents":["onStartupFinished","onCommand:codechef.orchestrate","onCommand:codechef.checkStatus","onCommand:codechef.configure","onCommand:codechef.showApprovals","onCommand:codechef.clearCache"],"main":"./out/extension.js","contributes":{"chatParticipants":[{"id":"codechef","name":"codechef","description":"LangGraph orchestrator with LangChain function calling. Access 150+ tools routed through internal agent nodes (feature-dev, code-review, infrastructure, cicd, documentation). 80-90% token cost reduction via progressive disclosure.","isSticky":true,"commands":[{"name":"orchestrate","description":"Submit a development task to the orchestrator"},{"name":"status","description":"Check the status of a submitted task"},{"name":"approve","description":"Approve a pending task"},{"name":"tools","description":"List available MCP tools"}]}],"commands":[{"command":"codechef.orchestrate","title":"Submit Task to Orchestrator","category":"code/chef"},{"command":"codechef.checkStatus","title":"Check Task Status","category":"code/chef"},{"command":"codechef.configure","title":"Configure Orchestrator URL","category":"code/chef"},{"command":"codechef.showApprovals","title":"Show Pending Approvals","category":"code/chef"},{"command":"codechef.clearCache","title":"Clear Tool Cache","category":"code/chef"},{"command":"codechef.copyPermalink","title":"Copy GitHub Permalink","category":"code/chef"}],"menus":{"editor/context":[{"command":"codechef.copyPermalink","group":"9_cutcopypaste","when":"editorTextFocus"}]},"configuration":{"title":"code/chef","properties":{"codechef.orchestratorUrl":{"type":"string","default":"https://codechef.appsmithery.co/api","description":"code/chef orchestrator endpoint","format":"uri"},"codechef.linearHubIssue":{"type":"string","default":"DEV-68","description":"Linear issue ID for approval notifications"},"codechef.linearWorkspaceSlug":{"type":"string","default":"dev-ops","description":"Linear workspace slug used when opening approval links (e.g., 'dev-ops' for /dev-ops/ URLs)"},"codechef.autoApproveThreshold":{"type":"string","enum":["low","medium","high","critical","never"],"default":"low","description":"Auto-approve tasks at or below this risk level"},"codechef.enableNotifications":{"type":"boolean","default":true,"description":"Show toast notifications for approval requests"},"codechef.langsmithUrl":{"type":"string","default":"https://smith.langchain.com/o/5029c640-3f73-480c-82f3-58e402ed4207/projects/p/f967bb5e-2e61-434f-8ee1-0df8c22bc046","description":"LangSmith project URL for viewing traces","format":"uri"}}}},"scripts":{"vscode:prepublish":"npm run compile","compile":"tsc -p ./","watch":"tsc -watch -p ./","pretest":"npm run compile && npm run lint","lint":"eslint src --ext ts","test":"node ./out/test/runTest.js","package":"vsce package","publish:vsce":"vsce publish","publish:npm":"npm publish --access public"},"dependencies":{"axios":"^1.6.0","eventsource":"^2.0.2"},"devDependencies":{"@types/vscode":"^1.85.0","@types/node":"^20.0.0","@types/eventsource":"^1.1.15","@typescript-eslint/eslint-plugin":"^6.0.0","@typescript-eslint/parser":"^6.0.0","eslint":"^8.50.0","typescript":"^5.3.0","@vscode/vsce":"^2.22.0"},"_id":"@appsmithery/vscode-codechef@0.4.1","gitHead":"40ee98930b376b4ddecdceada908eee028b2b4e0","_nodeVersion":"24.5.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-X3yEzNdIjHPWH/VF+SwiJfQvV0WpilBa8kf2ZZ8ukWeK8yBAPo8SBoruouCE25t8WMAnmWnnIsZfvauEifko0g==","shasum":"3d672b5dbb53bcfc05b05ef7f4bba6fefc901a8d","tarball":"https://registry.npmjs.org/@appsmithery/vscode-codechef/-/vscode-codechef-0.4.1.tgz","fileCount":49,"unpackedSize":4259114,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDphUYKn5qN78CvNFmX9/UZam8qE3MqnPApATr/aM6KbAIhAPRQSWMXZtP+8O3Tdp5bRtFuClroqzqfKc8nJS9qLhXM"}]},"_npmUser":{"name":"alextorelli","email":"Alex@appsmithery.co"},"directories":{},"maintainers":[{"name":"alextorelli","email":"Alex@appsmithery.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vscode-codechef_0.4.1_1764802815424_0.07265086002647014"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-03T23:00:15.349Z","0.4.1":"2025-12-03T23:00:15.733Z","modified":"2025-12-03T23:00:15.975Z"},"maintainers":[{"name":"alextorelli","email":"Alex@appsmithery.co"}],"description":"AI-powered task orchestration with LangGraph single-orchestrator architecture, 150+ MCP tools, and LangChain function calling. Submit development tasks via Copilot Chat.","homepage":"https://codechef.appsmithery.co","keywords":["copilot","ai","codechef","orchestrator","mcp","langsmith","langchain","langgraph","workflow-engine","state-management","multi-agent","automation","code-generation","code-review","infrastructure","cicd","documentation","function-calling","progressive-disclosure"],"repository":{"type":"git","url":"git+https://github.com/Appsmithery/Dev-Tools.git"},"bugs":{"url":"https://github.com/Appsmithery/Dev-Tools/issues"},"license":"MIT","readme":"# code/chef Multi-Agent Orchestrator\r\n\r\n[![Orchestrator](https://img.shields.io/badge/orchestrator-LangGraph-blue)](https://github.com/Appsmithery/code/chef)\r\n[![MCP Tools](https://img.shields.io/badge/tools-150%2B-green)](https://github.com/Appsmithery/code/chef/tree/main/shared/mcp/servers)\r\n[![LangChain](https://img.shields.io/badge/LangChain-enabled-purple)](https://www.langchain.com/)\r\n\r\nVS Code extension that integrates code/chef LangGraph orchestrator into Copilot Chat, enabling you to submit development tasks with LangChain-powered function calling and progressive tool disclosure from any workspace.\r\n\r\n## Features\r\n\r\n- **@codechef Chat Participant**: Submit tasks directly from Copilot Chat with natural language\r\n- **LangGraph Workflow Engine**: Single orchestrator with internal agent nodes and PostgreSQL checkpointing\r\n- **LangChain Function Calling**: Orchestrator can INVOKE 150+ MCP tools via LangChain's native tool binding\r\n- **Progressive Tool Disclosure**: 80-90% token reduction through intelligent tool filtering (minimal/agent_profile/progressive/full strategies)\r\n- **Agent Node Routing**: Routes tasks to internal agent nodes (feature-dev, code-review, infrastructure, cicd, documentation)\r\n- **Workspace Context Extraction**: Automatically gathers git branch, open files, project type\r\n- **Real-Time Approvals**: Linear integration for HITL approval workflow (<1s notification latency)\r\n- **Observability**: LangSmith LLM tracing + Prometheus HTTP metrics\r\n- **Session Management**: PostgreSQL-backed multi-turn conversations with workflow state retention\r\n\r\n## Quick Start\r\n\r\n### 1. Install Extension\r\n\r\n```bash\r\ncode --install-extension appsmithery.vscode-devtools-copilot\r\n```\r\n\r\n### 2. Configure Orchestrator\r\n\r\nPress `F1` → \"code/chef: Configure\" → Enter `https://codechef.appsmithery.co/api`\r\n\r\n### 3. Use in Copilot Chat\r\n\r\nOpen Copilot Chat (Ctrl+I) and type:\r\n\r\n```\r\n@codechef Add JWT authentication to my Express API\r\n```\r\n\r\nThe orchestrator will decompose your task into subtasks and route them to appropriate agents.\r\n\r\n## Commands\r\n\r\n### Chat Participant Commands\r\n\r\n- `@codechef <task>` - Submit development task\r\n- `@codechef /status [task-id]` - Check task status\r\n- `@codechef /approve <task-id> <approval-id>` - Approve pending task\r\n- `@codechef /tools` - List available MCP tools\r\n\r\n### Command Palette\r\n\r\n- **code/chef: Submit Task** - Submit task via input box\r\n- **code/chef: Check Status** - Check task status via input box\r\n- **code/chef: Configure** - Update orchestrator URL\r\n- **code/chef: Show Approvals** - Open Linear approval hub\r\n- **code/chef: Clear Cache** - Clear session cache\r\n\r\n## Configuration\r\n\r\n### Settings\r\n\r\n- `codechef.orchestratorUrl` - Orchestrator endpoint (default: `https://codechef.appsmithery.co/api`)\r\n- `codechef.mcpGatewayUrl` - MCP gateway endpoint (default: `https://codechef.appsmithery.co/api`)\r\n- `codechef.linearHubIssue` - Linear approval hub issue (default: `DEV-68`)\r\n- `codechef.linearWorkspaceSlug` - Linear workspace slug for approval links (default: `dev-ops`)\r\n- `codechef.autoApproveThreshold` - Auto-approve risk level (default: `low`)\r\n- `codechef.enableNotifications` - Show toast notifications (default: `true`)\r\n- `codechef.langsmithUrl` - LangSmith project URL for traces\r\n\r\n### Workspace Configuration\r\n\r\nCreate `.vscode/settings.json`:\r\n\r\n```json\r\n{\r\n  \"codechef.orchestratorUrl\": \"https://codechef.appsmithery.co/api\",\r\n  \"codechef.enableNotifications\": true,\r\n  \"codechef.autoApproveThreshold\": \"low\"\r\n}\r\n```\r\n\r\n## Examples\r\n\r\n### Basic Task Submission\r\n\r\n```\r\n@codechef Add authentication to my API\r\n```\r\n\r\nResponse:\r\n\r\n```\r\n✅ Task Submitted\r\n\r\nTask ID: abc123...\r\n\r\nSubtasks (4):\r\n💻 feature-dev: Implement JWT middleware\r\n💻 feature-dev: Add login/logout endpoints\r\n🔍 code-review: Security audit\r\n📚 documentation: Generate API docs\r\n\r\nEstimated Duration: 30 minutes\r\n```\r\n\r\n### Check Task Status\r\n\r\n```\r\n@codechef /status abc123\r\n```\r\n\r\nResponse:\r\n\r\n```\r\nTask Status: abc123\r\n\r\nStatus: in_progress\r\nProgress: 2/4 subtasks\r\n\r\n✅ feature-dev: Implement JWT middleware (completed)\r\n🔄 feature-dev: Add login/logout endpoints (in progress)\r\n⏳ code-review: Security audit (pending)\r\n⏳ documentation: Generate API docs (pending)\r\n```\r\n\r\n### List MCP Tools\r\n\r\n```\r\n@codechef /tools\r\n```\r\n\r\nResponse shows 150+ tools across 17 MCP servers:\r\n\r\n- **Development**: filesystem, github, gitlab, sequential-thinking\r\n- **Infrastructure**: docker (containaier), terraform, kubernetes, prometheus\r\n- **Documentation**: notion, context7, docs-langchain\r\n- **Memory**: mcp-memory, everything\r\n- **Database**: postgres, sqlite\r\n- **Productivity**: linear, slack, gmail\r\n- **AI**: fetch (web scraping)\r\n\r\n**Progressive Disclosure**: Only relevant tools (10-30) are loaded per task for 80-90% token savings while maintaining full tool invocation capability via LangChain function calling.\r\n\r\n## Approval Workflow\r\n\r\nHigh-risk tasks require human approval:\r\n\r\n1. **Task Submitted** → Risk assessed by guardrail system\r\n2. **Sub-Issue Created** → Linear creates sub-issue under DEV-68 (HITL Approvals Hub) using agent-specific template\r\n3. **User Notified** → Toast notification (if enabled) or status bar indicator with Linear link\r\n4. **Approve/Reject** → Change Linear sub-issue status to \"Done\" (approved) or \"Canceled\" (rejected)\r\n5. **Agents Proceed** → Execution continues after approval\r\n\r\n**Linear Integration:**\r\n\r\n- Parent Hub: [DEV-68](https://linear.app/dev-ops/issue/DEV-68)\r\n- Sub-issues include: Risk level emoji, task description, metadata, timestamp\r\n- Templates: `HITL_ORCHESTRATOR_TEMPLATE_UUID` (and per-agent variants)\r\n\r\n## Observability\r\n\r\nAll tasks are traced and monitored:\r\n\r\n- **LangSmith Traces**: [View Project](https://smith.langchain.com/o/5029c640-3f73-480c-82f3-58e402ed4207/projects/p/f967bb5e-2e61-434f-8ee1-0df8c22bc046)\r\n- **Prometheus Metrics**: https://codechef.appsmithery.co\r\n- **Linear Approvals**: https://linear.app/dev-ops/issue/DEV-68 (HITL Approvals Hub with sub-issues)\r\n\r\n## Troubleshooting\r\n\r\n### Cannot connect to orchestrator\r\n\r\n1. Check URL in settings: `code/chef: Configure`\r\n2. Verify service health: `curl https://codechef.appsmithery.co/api/health`\r\n3. Check firewall allows outbound connections\r\n\r\n### No tools appearing\r\n\r\n1. Clear cache: `code/chef: Clear Cache`\r\n2. Restart VS Code\r\n3. Check MCP gateway: `curl https://codechef.appsmithery.co/api/health`\r\n\r\n### Approval notifications not working\r\n\r\n1. Verify Linear OAuth token configured: `LINEAR_API_KEY` in `.env`\r\n2. Check HITL templates configured: `HITL_ORCHESTRATOR_TEMPLATE_UUID`, etc.\r\n3. Subscribe to DEV-68 issue in Linear for sub-issue notifications\r\n4. Verify approval hub setting: `LINEAR_APPROVAL_HUB_ISSUE_ID=DEV-68` (note: PR-68 is internal reference, DEV-68 is public identifier)\r\n\r\n## Development\r\n\r\n### Build from Source\r\n\r\n```bash\r\ncd extensions/vscode-devtools-copilot\r\nnpm install\r\nnpm run compile\r\n```\r\n\r\n### Run Extension Development Host\r\n\r\n```bash\r\ntask dev\r\n# or\r\ncode --extensionDevelopmentPath=$(pwd)\r\n```\r\n\r\n### Package Extension\r\n\r\n```bash\r\ntask package\r\n# Creates vscode-devtools-copilot-0.1.0.vsix\r\n```\r\n\r\n### Install Locally\r\n\r\n```bash\r\ntask install-local\r\n```\r\n\r\n## Architecture\r\n\r\n```\r\n┌─────────────────────────────────────┐\r\n│ VS Code Workspace                    │\r\n│                                      │\r\n│  ┌────────────────────────────────┐ │\r\n│  │ Copilot Chat                   │ │\r\n│  │  @codechef \"Add auth to API\"  │ │\r\n│  └──────────┬─────────────────────┘ │\r\n│             │                        │\r\n│  ┌──────────▼─────────────────────┐ │\r\n│  │ code/chef Chat Participant     │ │\r\n│  │ - Context extraction           │ │\r\n│  │ - Session management           │ │\r\n│  │ - Linear notifications         │ │\r\n│  └──────────┬─────────────────────┘ │\r\n└─────────────┼───────────────────────┘\r\n              │ HTTP POST\r\n              ▼\r\n┌──────────────────────────────────────────────────────────────┐\r\n│ code/chef Droplet (codechef.appsmithery.co)                             │\r\n│                                                               │\r\n│  ┌─────────────────────────────────────────────────────────┐ │\r\n│  │ LangGraph Orchestrator (:8001)                          │ │\r\n│  │ ┌─────────────────────────────────────────────────────┐ │ │\r\n│  │ │ LangChain Tool Binding (3-Layer Architecture)       │ │ │\r\n│  │ │ 1. Discovery: progressive_mcp_loader.py             │ │ │\r\n│  │ │    (150+ tools → 10-30 relevant, 80-90% saved)      │ │ │\r\n│  │ │ 2. Conversion: mcp_client.to_langchain_tools()      │ │ │\r\n│  │ │    (MCP schemas → LangChain BaseTool instances)     │ │ │\r\n│  │ │ 3. Binding: llm.bind_tools(tools)                   │ │ │\r\n│  │ │    (LLM can INVOKE tools via function calling)      │ │ │\r\n│  │ └─────────────────────────────────────────────────────┘ │ │\r\n│  │ ┌─────────────────────────────────────────────────────┐ │ │\r\n│  │ │ LangGraph StateGraph (Workflow Engine)              │ │ │\r\n│  │ │ - Task decomposition node                           │ │ │\r\n│  │ │ - Supervisor node (routing logic)                   │ │ │\r\n│  │ │ - 5 Agent nodes (internal workflow steps):          │ │ │\r\n│  │ │   • feature-dev (codellama-13b)                     │ │ │\r\n│  │ │   • code-review (llama-3.1-70b)                     │ │ │\r\n│  │ │   • infrastructure (llama-3.1-8b)                   │ │ │\r\n│  │ │   • cicd (llama-3.1-8b)                             │ │ │\r\n│  │ │   • documentation (mistral-7b)                      │ │ │\r\n│  │ │ - Approval gate node (HITL workflow interrupts)     │ │ │\r\n│  │ │ - PostgreSQL checkpointing (workflow state)         │ │ │\r\n│  │ └─────────────────────────────────────────────────────┘ │ │\r\n│  └───────────┬─────────────────────────────────────────────┘ │\r\n│              │                                                │\r\n│  ┌───────────▼──────────────────────────────────────────┐    │\r\n│  │ MCP Gateway (:8000)                                  │    │\r\n│  │ - 17 MCP servers, 150+ tools                         │    │\r\n│  │ - Stdio communication with orchestrator              │    │\r\n│  └──────────────────────────────────────────────────────┘    │\r\n└───────────────────────────────────────────────────────────────┘\r\n```\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create feature branch: `git checkout -b feature/new-capability`\r\n3. Commit changes: `git commit -am 'Add capability'`\r\n4. Push to branch: `git push origin feature/new-capability`\r\n5. Create Pull Request\r\n\r\n## License\r\n\r\nMIT License - see LICENSE file\r\n\r\n## Support\r\n\r\n- GitHub Issues: https://github.com/Appsmithery/code/chef/issues\r\n- Linear Project: https://linear.app/project-roadmaps/project/ai-devops-agent-platform-78b3b839d36b\r\n- Discord: https://discord.gg/appsmithery\r\n\r\n## Related\r\n\r\n### Documentation\r\n\r\n- [code/chef Repository](https://github.com/Appsmithery/code/chef)\r\n- [Progressive Tool Disclosure Architecture](https://github.com/Appsmithery/code/chef/blob/main/support/docs/PROGRESSIVE_TOOL_DISCLOSURE.md)\r\n- [Linear Integration Guide](https://github.com/Appsmithery/code/chef/blob/main/support/docs/LINEAR_INTEGRATION_GUIDE.md)\r\n- [Linear HITL Workflow](https://github.com/Appsmithery/code/chef/blob/main/support/docs/LINEAR_HITL_WORKFLOW.md)\r\n- [Deployment Guide](https://github.com/Appsmithery/code/chef/blob/main/support/docs/DEPLOYMENT_GUIDE.md)\r\n\r\n### Integrations\r\n\r\n- [LangChain LLM Framework](https://www.langchain.com/)\r\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)\r\n- [DigitalOcean Gradient AI](https://docs.digitalocean.com/products/ai/)\r\n- [LangSmith LLM Observability](https://smith.langchain.com/)\r\n\r\n### Packages\r\n\r\n- [MCP Bridge Client](https://www.npmjs.com/package/@appsmithery/mcp-bridge-client)\r\n","readmeFilename":"README.md","_rev":"1-d17567e9e81f5ba415a0d2f9b6a2e7a2"}