LeoYeAI/agent-master-skills / skills/agent-mode-upgrades
agentic-loop-upgrade
FlaggedEnhanced agentic loop with planning, parallel execution, confidence gates, semantic error recovery, and observable state machine. Includes Mode dashboard UI for easy configuration.
src/llm/caller.ts
View on GitHub/**
* Lightweight LLM Caller
*
* Makes API calls to Anthropic for plan generation and reflection.
* Uses fetch directly to avoid heavy SDK dependencies.
*/
import fs from "node:fs";
import path from "node:path";
// ============================================================================
// Types
// ============================================================================
export interface LLMMessage {
role: "user" | "assistant" | "system";
content: string;
}
export interface LLMCallOptions {
messages: LLMMessage[];
maxTokens?: number;
temperature?: number;
model?: string;
}
export interface LLMResponse {
content: string;
usage?: {
inputTokens: number;
outputTokens: number;
};
}
export interface LLMCallerConfig {
apiKey?: string;
model?: string;
maxTokens?: number;
baseUrl?: string;
}
// ============================================================================
// API Key Resolution
// ============================================================================
function resolveApiKey(config?: LLMCallerConfig): string | null {
// 1. Explicit config (from enhanced-loop-hook, which resolves via auth profile chain)
if (config?.apiKey) return config.apiKey;
// 2. Environment variable
if (process.env.ANTHROPIC_API_KEY) return process.env.ANTHROPIC_API_KEY;
// 3. Try to read from OpenClaw auth storage (with OAuth/token priority)
const home = process.env.HOME || process.env.USERPROFILE || "";
const authPaths = [
path.join(home, ".openclaw", "agents", "main", "agent", "auth-profiles.json"),
path.join(home, ".openclaw", "auth-profiles.json"),
path.join(home, ".config", "openclaw", "auth-profiles.json"),
];
for (const authPath of authPaths) {
try {
if (fs.existsSync(authPath)) {
const content = fs.readFileSync(authPath, "utf-8");
const auth = JSON.parse(content);
const profiles = auth.profiles || {};
const order = auth.order?.anthropic as string[] | undefined;
// Follow configured order if available
if (order?.length) {
for (const profileId of order) {
const p = profiles[profileId] as { provider?: string; type?: string; key?: string; token?: string; apiKey?: string } | undefined;
if (!p || p.provider !== "anthropic") continue;
const key = p.token || p.key || p.apiKey;
if (key) return key;
}
}
// Fallback: prefer token/oauth profiles over api_key
const sorted = Object.entries(profiles)
.filter(([, p]) => (p as { provider?: string }).provider === "anthropic")
.sort(([, a], [, b]) => {
const rank = (t: string) => (t === "token" || t === "oauth" ? 0 : 1);
return rank((a as { type?: string }).type ?? "api_key") - rank((b as { type?: string }).type ?? "api_key");
});
for (const [, profile] of sorted) {
const p = profile as { token?: string; key?: string; apiKey?: string };
const key = p.token || p.key || p.apiKey;
if (key) return key;
}
}
} catch {
// Continue to next path
}
}
return null;
}
/**
* Determine if the key is an OAuth/setup token (needs Authorization header)
* vs a standard API key (needs x-api-key header).
*/
function isOAuthToken(key: string): boolean {
return key.startsWith("sk-ant-oat") || key.startsWith("Bearer ");
}
// ============================================================================
// LLM Caller
// ============================================================================
const DEFAULT_MODEL = "claude-haiku-4-5";
const DEFAULT_MAX_TOKENS = 1024;
const ANTHROPIC_API_URL = "https://api.anthropic.com/v1/messages";
export class LLMCaller {
private apiKey: string | null;
private model: string;
private maxTokens: number;
private baseUrl: string;
constructor(config?: LLMCallerConfig) {
this.apiKey = resolveApiKey(config);
this.model = config?.model || DEFAULT_MODEL;
this.maxTokens = config?.maxTokens || DEFAULT_MAX_TOKENS;
this.baseUrl = config?.baseUrl || ANTHROPIC_API_URL;
}
/**
* Check if the caller is configured with an API key
*/
isConfigured(): boolean {
return !!this.apiKey;
}
/**
* Make an LLM call
*/
async call(options: LLMCallOptions): Promise<LLMResponse> {
if (!this.apiKey) {
throw new Error("No API key configured for LLM caller");
}
// Separate system message from other messages
const systemMessage = options.messages.find(m => m.role === "system");
const otherMessages = options.messages.filter(m => m.role !== "system");
const body = {
model: options.model || this.model,
max_tokens: options.maxTokens || this.maxTokens,
temperature: options.temperature ?? 0.7,
system: systemMessage?.content,
messages: otherMessages.map(m => ({
role: m.role,
content: m.content,
})),
};
// Use Authorization header for OAuth/setup tokens, x-api-key for standard API keys
const authHeaders: Record<string, string> = isOAuthToken(this.apiKey)
? {
"Authorization": `Bearer ${this.apiKey.replace(/^Bearer\s*/i, "")}`,
"anthropic-beta": "oauth-2025-04-20",
}
: { "x-api-key": this.apiKey };
const response = await fetch(this.baseUrl, {
method: "POST",
headers: {
"Content-Type": "application/json",
...authHeaders,
"anthropic-version": "2023-06-01",
},
body: JSON.stringify(body),
});
if (!response.ok) {
const errorText = await response.text();
throw new Error(`LLM API error (${response.status}): ${errorText}`);
}
const data = await response.json() as {
content: Array<{ type: string; text?: string }>;
usage?: { input_tokens: number; output_tokens: number };
};
const textContent = data.content
.filter(c => c.type === "text")
.map(c => c.text || "")
.join("");
return {
content: textContent,
usage: data.usage ? {
inputTokens: data.usage.input_tokens,
outputTokens: data.usage.output_tokens,
} : undefined,
};
}
/**
* Convenience method matching the LLMCaller type expected by orchestrator
*/
async invoke(options: {
messages: Array<{ role: string; content: string | unknown[] }>;
maxTokens?: number;
}): Promise<{ content: string }> {
const messages: LLMMessage[] = options.messages.map(m => ({
role: m.role as "user" | "assistant" | "system",
content: typeof m.content === "string" ? m.content : JSON.stringify(m.content),
}));
return this.call({ messages, maxTokens: options.maxTokens });
}
}
// ============================================================================
// Factory
// ============================================================================
let defaultCaller: LLMCaller | null = null;
export function getLLMCaller(config?: LLMCallerConfig): LLMCaller {
if (!defaultCaller) {
defaultCaller = new LLMCaller(config);
}
return defaultCaller;
}
export function createLLMCaller(config?: LLMCallerConfig): LLMCaller {
return new LLMCaller(config);
}
export function resetLLMCaller(): void {
defaultCaller = null;
}
// ============================================================================
// Wrapper for orchestrator compatibility
// ============================================================================
export function createOrchestratorLLMCaller(config?: LLMCallerConfig): (options: {
messages: Array<{ role: string; content: string | unknown[] }>;
maxTokens?: number;
}) => Promise<{ content: string }> {
const caller = createLLMCaller(config);
if (!caller.isConfigured()) {
// Return a no-op caller that throws helpful error
return async () => {
throw new Error(
"LLM caller not configured. Set ANTHROPIC_API_KEY environment variable " +
"or configure an Anthropic auth profile in OpenClaw."
);
};
}
return (options) => caller.invoke(options);
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |