Add developer debug panel for inspecting agent execution

[Copilot]

Implements a console-based debug panel for inspecting AI agent execution during development, analogous to Chrome DevTools but for backend agent workflows.

Core Changes

• Dev Panel Module (packages/sdk/src/devpanel.ts)

  • Tracks agent config, messages, tool calls, responses, and errors
  • Configurable log levels: verbose, normal, minimal
  • Auto-enables when NODE_ENV=development
  • Visual panel with formatted output

• Agent Integration (packages/sdk/src/agent.ts)

  • Added .devMode(enabled?: boolean) to agent builder
  • Integrated logging throughout agent execution flow

• Type Definitions (packages/core/src/types/agent.types.ts)

  • Added optional devMode() method to Agent interface

Usage

import { agent, initDevPanel, showDevPanel } from '@agentage/sdk';

// Initialize (optional - auto-enabled in NODE_ENV=development)
initDevPanel({ enabled: true, logLevel: 'verbose' });

// Enable dev mode on agent
const bot = agent('assistant')
  .model('gpt-4')
  .devMode(true);  // <-- Enable debug logging

await bot.send('What is the weather?');

// Display visual summary
showDevPanel();

Output Format

[2026-01-06T22:41:39.654Z] 🔧 Agent Configuration: { name: 'assistant', model: 'gpt-4' }
[2026-01-06T22:41:39.656Z] 💬 Message: { role: 'user', content: 'What is the weather?' }
[2026-01-06T22:41:39.656Z] 🔨 Tool Call: { name: 'get_weather', arguments: {...} }
[2026-01-06T22:41:39.656Z] ✅ Response: { content: 'Currently 72°F and sunny' }

╔════════════════════════════════════════════════════════╗
║            AgentKit Developer Panel                   ║
╚════════════════════════════════════════════════════════╝
  Total Events: 4
  [10:41:39 PM] 🔧 config
  [10:41:39 PM] 💬 message
  [10:41:39 PM] 🔨 tool_call
  [10:41:39 PM] ✅ response

Testing & Documentation

• Comprehensive test suite (13 tests) in packages/sdk/src/devpanel.test.ts
• Full documentation in docs/dev-panel.md
• Working example in examples/agent-sdk-devpanel-example/

Note

One pre-existing test failure in agent.test.ts (Zod schema description preservation) remains unaddressed per minimal-change directive.

Original prompt

add button - menu item - visible in dev mode ONLY - that show chrome dev panel

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.