src/lib/sdk_example.ts

/**
 * Token Cost Guard SDK (Typescript)
 * Usage: npm install token-cost-guard
 */

export interface LogEntry {
  step: string;
  agent: string;
  prompt_tokens: number;
  completion_tokens: number;
  model: string;
  input: string;
  output: string;
}

export class TokenCostGuard {
  private apiKey: string;
  private endpoint: string = "https://your-domain.com/api/v1";

  constructor(apiKey: string) {
    if (!apiKey.startsWith("TCG-")) {
      throw new Error("Invalid API Key format");
    }
    this.apiKey = apiKey;
  }

  /**
   * Optimize a set of agent logs and return the execution plan
   */
  async optimize(logs: LogEntry[]) {
    const response = await fetch(`${this.endpoint}/optimize`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${this.apiKey}`
      },
      body: JSON.stringify({ logs })
    });

    if (!response.ok) {
      const err = await response.json();
      throw new Error(err.error || "Optimization failed");
    }

    return response.json();
  }

  /**
   * Get current usage and savings stats
   */
  async getStats() {
    const response = await fetch(`${this.endpoint}/usage`, {
      headers: {
        "Authorization": `Bearer ${this.apiKey}`
      }
    });

    return response.json();
  }
}

// Example Integration for AutoGen / LangChain
/*
const guardian = new TokenCostGuard("TCG-PRO-xxxx-xxxx");

async function onWorkflowComplete(logs) {
   const plan = await guardian.optimize(logs);
   console.log("Optimized Plan Readiness:", plan.actions);
   // Apply plan.executable_patch to the next run
}
*/