CRITICAL: Fix async initialization bugs in all examples

🐛 Fixed Critical Bugs:
- examples/example-usage.js: async initialization bug causing 'getCost is not a function'
- examples/langchain-example.js: same async bug fixed
- All examples now properly await agentGuard.init()

✅ New Developer Integration Test:
- examples/simple-integration-test.js: comprehensive test for developers
- Real NPM installation test: fully working
- Zero barriers to adoption now

�� Developer Experience:
- Fresh npm install works perfectly
- Two lines of code for integration
- Existing code works unchanged
- Cost tracking automatic
- 30-second learning curve

These fixes ensure any developer building an agent today can integrate
AgentGuard into their workflow with zero friction.

Author: dipampaul17

examples/example-usage.js

@@ -14,15 +14,17 @@
 // Initialize AgentGuard FIRST - before any other imports
 // Use require('agent-guard') if you installed via NPM
 const agentGuard = require('../agent-guard');
-const guard = agentGuard.init({ 
-  limit: 25,  // $25 limit for production agent
-  webhook: process.env.SLACK_WEBHOOK_URL // Optional: get notified when stopped
-});
 
-console.log('🤖 Starting AI Agent with AgentGuard protection...\n');
+async function initializeAgent() {
+  const guard = await agentGuard.init({ 
+    limit: 25,  // $25 limit for production agent
+    webhook: process.env.SLACK_WEBHOOK_URL // Optional: get notified when stopped
+  });
+
+  console.log('🤖 Starting AI Agent with AgentGuard protection...\n');
 
-// Simulate a real agent that makes multiple API calls
-class AIAgent {
+  // Simulate a real agent that makes multiple API calls
+  class AIAgent {
   constructor() {
     this.taskQueue = [];
     this.isRunning = false;
@@ -221,20 +223,30 @@ process.on('SIGINT', () => {
   process.exit(0);
 });
 
-// Show AgentGuard status periodically
-const statusInterval = setInterval(() => {
-  if (guard.getCost() > 0) {
-    process.stdout.write(`\r💸 Current cost: $${guard.getCost().toFixed(4)} / $${guard.getLimit()}    `);
-  }
-}, 2000);
+  // Show AgentGuard status periodically
+  const statusInterval = setInterval(() => {
+    if (guard && guard.getCost() > 0) {
+      process.stdout.write(`\r💸 Current cost: $${guard.getCost().toFixed(4)} / $${guard.getLimit()}  ${((guard.getCost() / guard.getLimit()) * 100).toFixed(1)}%              `);
+    }
+  }, 2000);
 
-// Clean up interval on exit
-process.on('exit', () => {
-  clearInterval(statusInterval);
-});
+  // Clean up interval on exit
+  process.on('exit', () => {
+    clearInterval(statusInterval);
+  });
+
+  process.on('SIGINT', () => {
+    console.log('\n\n👋 Shutting down agent...');
+    clearInterval(statusInterval);
+    process.exit(0);
+  });
+
+  // Start the agent
+  return main();
+}
 
-// Start the agent
-agent.run().catch(error => {
+// Initialize and run
+initializeAgent().catch(error => {
   console.error('\n💥 Agent crashed:', error.message);
   process.exit(1);
 });

examples/langchain-example.js

@@ -13,12 +13,14 @@
 
 // Initialize AgentGuard FIRST
 const agentGuard = require('../agent-guard');
-const guard = agentGuard.init({ 
-  limit: 5,  // $5 limit for this demo
-  mode: 'throw' // Throw error instead of killing process for demo
-});
 
-console.log('🦜🔗 LangChain + AgentGuard Example\n');
+async function runLangChainExample() {
+  const guard = await agentGuard.init({ 
+    limit: 5,  // $5 limit for this demo
+    mode: 'throw' // Throw error instead of killing process for demo
+  });
+
+  console.log('🦜🔗 LangChain + AgentGuard Example\n');
 
 // Simulate LangChain imports (in real usage, you'd use actual LangChain)
 // const { ChatOpenAI } = require('langchain/chat_models/openai');
@@ -268,5 +270,9 @@ async function main() {
   }
 }
 
-// Run the examples
-main().catch(console.error);
+  // Main execution
+  await main();
+}
+
+// Run the example
+runLangChainExample().catch(console.error);