@phuetz/code-buddy 0.1.18 → 0.1.19

package/dist/security/sender-policies.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Per-Sender Policies & Agents List
+ * Tool access control per sender identity and agent registry.
+ */
+export interface SenderIdentity {
+    username?: string;
+    userId?: string;
+    phone?: string;
+    displayName?: string;
+}
+export interface SenderPolicy {
+    identity: SenderIdentity;
+    allowedTools: string[];
+    deniedTools: string[];
+    maxTurns?: number;
+}
+export declare class SenderPolicyManager {
+    private static instance;
+    private policies;
+    static getInstance(): SenderPolicyManager;
+    static resetInstance(): void;
+    addPolicy(policy: SenderPolicy): void;
+    removePolicy(identity: SenderIdentity): boolean;
+    getPolicy(identity: SenderIdentity): SenderPolicy | undefined;
+    isToolAllowed(identity: SenderIdentity, tool: string): boolean;
+    matchIdentity(sender: SenderIdentity, policy: SenderPolicy): boolean;
+    listPolicies(): SenderPolicy[];
+    clearPolicies(): void;
+}
+interface AgentInfo {
+    name: string;
+    description: string;
+    status: 'active' | 'inactive';
+}
+export declare class AgentListTool {
+    private static instance;
+    private agents;
+    static getInstance(): AgentListTool;
+    static resetInstance(): void;
+    listAgents(): AgentInfo[];
+    addAgent(name: string, description: string): void;
+    removeAgent(name: string): boolean;
+    getAgent(name: string): AgentInfo | undefined;
+    getAgentCount(): number;
+}
+export {};

package/dist/security/sender-policies.js

@@ -0,0 +1,90 @@
+/**
+ * Per-Sender Policies & Agents List
+ * Tool access control per sender identity and agent registry.
+ */
+import { logger } from '../utils/logger.js';
+export class SenderPolicyManager {
+    static instance = null;
+    policies = [];
+    static getInstance() {
+        if (!SenderPolicyManager.instance) {
+            SenderPolicyManager.instance = new SenderPolicyManager();
+        }
+        return SenderPolicyManager.instance;
+    }
+    static resetInstance() {
+        SenderPolicyManager.instance = null;
+    }
+    addPolicy(policy) {
+        // Remove existing policy for same identity
+        this.policies = this.policies.filter(p => !this.matchIdentity(policy.identity, p));
+        this.policies.push(policy);
+        logger.debug(`Added policy for sender: ${JSON.stringify(policy.identity)}`);
+    }
+    removePolicy(identity) {
+        const before = this.policies.length;
+        this.policies = this.policies.filter(p => !this.matchIdentity(identity, p));
+        return this.policies.length < before;
+    }
+    getPolicy(identity) {
+        return this.policies.find(p => this.matchIdentity(identity, p));
+    }
+    isToolAllowed(identity, tool) {
+        const policy = this.getPolicy(identity);
+        if (!policy)
+            return true; // No policy means no restrictions
+        if (policy.deniedTools.includes(tool))
+            return false;
+        if (policy.allowedTools.length > 0 && !policy.allowedTools.includes(tool))
+            return false;
+        return true;
+    }
+    matchIdentity(sender, policy) {
+        const pi = policy.identity;
+        if (sender.username && pi.username && sender.username === pi.username)
+            return true;
+        if (sender.userId && pi.userId && sender.userId === pi.userId)
+            return true;
+        if (sender.phone && pi.phone && sender.phone === pi.phone)
+            return true;
+        if (sender.displayName && pi.displayName && sender.displayName === pi.displayName)
+            return true;
+        return false;
+    }
+    listPolicies() {
+        return [...this.policies];
+    }
+    clearPolicies() {
+        this.policies = [];
+    }
+}
+export class AgentListTool {
+    static instance = null;
+    agents = new Map();
+    static getInstance() {
+        if (!AgentListTool.instance) {
+            AgentListTool.instance = new AgentListTool();
+        }
+        return AgentListTool.instance;
+    }
+    static resetInstance() {
+        AgentListTool.instance = null;
+    }
+    listAgents() {
+        return Array.from(this.agents.values());
+    }
+    addAgent(name, description) {
+        this.agents.set(name, { name, description, status: 'active' });
+        logger.debug(`Registered agent: ${name}`);
+    }
+    removeAgent(name) {
+        return this.agents.delete(name);
+    }
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    getAgentCount() {
+        return this.agents.size;
+    }
+}
+//# sourceMappingURL=sender-policies.js.map

package/dist/security/sender-policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender-policies.js","sourceRoot":"","sources":["../../src/security/sender-policies.ts"],"names":[],"mappings":"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"}

package/dist/server/dashboard.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Web Control UI Dashboard
+ *
+ * Provides an HTTP-based admin dashboard for monitoring
+ * agent status, sessions, channels, tools, and system health.
+ */
+export interface DashboardConfig {
+    port?: number;
+    authToken?: string;
+}
+export interface DashboardStatus {
+    running: boolean;
+    port: number;
+    uptime: number;
+    connectedClients: number;
+}
+export interface DashboardMetrics {
+    agent: {
+        status: string;
+        model: string;
+        mode: string;
+    };
+    sessions: number;
+    channels: string[];
+    tools: number;
+    memory: {
+        used: number;
+        total: number;
+    };
+    system: {
+        cpuPercent: number;
+        memoryPercent: number;
+    };
+}
+export declare class Dashboard {
+    private static instance;
+    private config;
+    private running;
+    private startTime;
+    private connectedClients;
+    constructor(config?: DashboardConfig);
+    static getInstance(config?: DashboardConfig): Dashboard;
+    static resetInstance(): void;
+    start(port?: number): void;
+    stop(): void;
+    isRunning(): boolean;
+    getPort(): number;
+    getUrl(): string;
+    getStatus(): DashboardStatus;
+    generateDashboardHtml(): string;
+    getMetrics(): DashboardMetrics;
+    setConnectedClients(count: number): void;
+}

package/dist/server/dashboard.js

@@ -0,0 +1,93 @@
+/**
+ * Web Control UI Dashboard
+ *
+ * Provides an HTTP-based admin dashboard for monitoring
+ * agent status, sessions, channels, tools, and system health.
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Dashboard
+// ============================================================================
+export class Dashboard {
+    static instance = null;
+    config;
+    running = false;
+    startTime = 0;
+    connectedClients = 0;
+    constructor(config) {
+        this.config = config || { port: 8080 };
+    }
+    static getInstance(config) {
+        if (!Dashboard.instance) {
+            Dashboard.instance = new Dashboard(config);
+        }
+        return Dashboard.instance;
+    }
+    static resetInstance() {
+        Dashboard.instance = null;
+    }
+    start(port) {
+        if (port !== undefined) {
+            this.config.port = port;
+        }
+        logger.info(`Starting dashboard on port ${this.config.port || 8080}`);
+        this.running = true;
+        this.startTime = Date.now();
+        this.connectedClients = 0;
+    }
+    stop() {
+        logger.info('Stopping dashboard');
+        this.running = false;
+        this.startTime = 0;
+        this.connectedClients = 0;
+    }
+    isRunning() {
+        return this.running;
+    }
+    getPort() {
+        return this.config.port || 8080;
+    }
+    getUrl() {
+        return `http://localhost:${this.getPort()}`;
+    }
+    getStatus() {
+        return {
+            running: this.running,
+            port: this.getPort(),
+            uptime: this.running ? Math.floor((Date.now() - this.startTime) / 1000) : 0,
+            connectedClients: this.connectedClients,
+        };
+    }
+    generateDashboardHtml() {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Code Buddy Dashboard</title>
+</head>
+<body>
+  <h1>Code Buddy Admin Dashboard</h1>
+  <section id="agent-status"><h2>Agent Status</h2></section>
+  <section id="active-sessions"><h2>Active Sessions</h2></section>
+  <section id="channel-status"><h2>Channel Status</h2></section>
+  <section id="tool-usage"><h2>Tool Usage</h2></section>
+  <section id="memory-stats"><h2>Memory Stats</h2></section>
+  <section id="system-health"><h2>System Health</h2></section>
+</body>
+</html>`;
+    }
+    getMetrics() {
+        return {
+            agent: { status: 'idle', model: 'grok-3', mode: 'code' },
+            sessions: 0,
+            channels: ['telegram', 'discord', 'slack'],
+            tools: 25,
+            memory: { used: 0, total: 1024 },
+            system: { cpuPercent: 0, memoryPercent: 0 },
+        };
+    }
+    setConnectedClients(count) {
+        this.connectedClients = count;
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/server/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/server/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/services/system-prompt-override.d.ts

@@ -0,0 +1,34 @@
+/**
+ * System Prompt Override
+ *
+ * Handles CLI flags for replacing or appending to the system prompt:
+ * - --system-prompt <text>         → replace entire prompt
+ * - --system-prompt-file <path>    → replace from file
+ * - --append-system-prompt <text>  → append text to default prompt
+ * - --append-system-prompt-file <path> → append file contents
+ */
+export interface OverrideOptions {
+    /** Replace the entire system prompt with this text */
+    systemPrompt?: string;
+    /** Replace the entire system prompt with contents of this file */
+    systemPromptFile?: string;
+    /** Append this text to the default system prompt */
+    appendSystemPrompt?: string;
+    /** Append contents of this file to the default system prompt */
+    appendSystemPromptFile?: string;
+}
+export declare class SystemPromptOverride {
+    /**
+     * Apply override options to a base system prompt.
+     *
+     * - If systemPrompt or systemPromptFile is set, the base prompt is REPLACED.
+     * - If appendSystemPrompt or appendSystemPromptFile is set, content is APPENDED.
+     * - Cannot use both replace and append simultaneously.
+     * - If no overrides, returns the base prompt unchanged.
+     */
+    apply(basePrompt: string, options: OverrideOptions): string;
+    /**
+     * Read a file from disk. Throws if the file does not exist.
+     */
+    private readFile;
+}

package/dist/services/system-prompt-override.js

@@ -0,0 +1,64 @@
+/**
+ * System Prompt Override
+ *
+ * Handles CLI flags for replacing or appending to the system prompt:
+ * - --system-prompt <text>         → replace entire prompt
+ * - --system-prompt-file <path>    → replace from file
+ * - --append-system-prompt <text>  → append text to default prompt
+ * - --append-system-prompt-file <path> → append file contents
+ */
+import * as fs from 'fs';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Implementation
+// ============================================================================
+export class SystemPromptOverride {
+    /**
+     * Apply override options to a base system prompt.
+     *
+     * - If systemPrompt or systemPromptFile is set, the base prompt is REPLACED.
+     * - If appendSystemPrompt or appendSystemPromptFile is set, content is APPENDED.
+     * - Cannot use both replace and append simultaneously.
+     * - If no overrides, returns the base prompt unchanged.
+     */
+    apply(basePrompt, options) {
+        const hasReplace = options.systemPrompt !== undefined || options.systemPromptFile !== undefined;
+        const hasAppend = options.appendSystemPrompt !== undefined || options.appendSystemPromptFile !== undefined;
+        // Validate: can't use both replace and append simultaneously
+        if (hasReplace && hasAppend) {
+            throw new Error('Cannot use both replace (--system-prompt / --system-prompt-file) and append (--append-system-prompt / --append-system-prompt-file) simultaneously');
+        }
+        // No overrides — return base prompt unchanged
+        if (!hasReplace && !hasAppend) {
+            return basePrompt;
+        }
+        // Replace mode
+        if (hasReplace) {
+            if (options.systemPromptFile) {
+                return this.readFile(options.systemPromptFile);
+            }
+            return options.systemPrompt;
+        }
+        // Append mode
+        let result = basePrompt;
+        if (options.appendSystemPrompt) {
+            result += '\n\n' + options.appendSystemPrompt;
+        }
+        if (options.appendSystemPromptFile) {
+            const fileContent = this.readFile(options.appendSystemPromptFile);
+            result += '\n\n' + fileContent;
+        }
+        return result;
+    }
+    /**
+     * Read a file from disk. Throws if the file does not exist.
+     */
+    readFile(filePath) {
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`System prompt file not found: ${filePath}`);
+        }
+        logger.debug('Reading system prompt file', { path: filePath });
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+}
+//# sourceMappingURL=system-prompt-override.js.map

package/dist/services/system-prompt-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-override.js","sourceRoot":"","sources":["../../src/services/system-prompt-override.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAiB5C,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;OAOG;IACH,KAAK,CAAC,UAAkB,EAAE,OAAwB;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC;QAChG,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,KAAK,SAAS,IAAI,OAAO,CAAC,sBAAsB,KAAK,SAAS,CAAC;QAE3G,6DAA6D;QAC7D,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,mJAAmJ,CACpJ,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,eAAe;QACf,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,OAAO,CAAC,YAAa,CAAC;QAC/B,CAAC;QAED,cAAc;QACd,IAAI,MAAM,GAAG,UAAU,CAAC;QAExB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAC/B,MAAM,IAAI,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;YAClE,MAAM,IAAI,MAAM,GAAG,WAAW,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,QAAgB;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/skills/skill-enhancements.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Skill Enhancements
+ *
+ * SkillVariableResolver: replaces template variables ($ARGUMENTS, $WORKING_DIR, etc.)
+ * SkillBudgetCalculator: computes char budgets for skill content injection
+ */
+export interface SkillContext {
+    arguments?: string[];
+    sessionId?: string;
+    workingDir?: string;
+    gitBranch?: string;
+}
+export declare class SkillVariableResolver {
+    /**
+     * Parse indexed argument reference like $ARGUMENTS[0]
+     * Returns the index or -1 if not an indexed reference
+     */
+    parseIndexedArgument(varRef: string): number;
+    /**
+     * Resolve template variables in a skill template string
+     */
+    resolve(template: string, context: SkillContext): string;
+}
+export declare class SkillBudgetCalculator {
+    /**
+     * Calculate budget as 2% of context window size (in characters)
+     */
+    calculateBudget(contextWindowSize: number): number;
+    /**
+     * Truncate content to fit within the character budget
+     */
+    truncateToLimit(content: string, budget: number): string;
+    /**
+     * Get default budget for 200k context window
+     */
+    getDefaultBudget(): number;
+}

package/dist/skills/skill-enhancements.js

@@ -0,0 +1,69 @@
+/**
+ * Skill Enhancements
+ *
+ * SkillVariableResolver: replaces template variables ($ARGUMENTS, $WORKING_DIR, etc.)
+ * SkillBudgetCalculator: computes char budgets for skill content injection
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// SkillVariableResolver
+// ============================================================================
+export class SkillVariableResolver {
+    /**
+     * Parse indexed argument reference like $ARGUMENTS[0]
+     * Returns the index or -1 if not an indexed reference
+     */
+    parseIndexedArgument(varRef) {
+        const match = varRef.match(/^\$ARGUMENTS\[(\d+)\]$/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+        return -1;
+    }
+    /**
+     * Resolve template variables in a skill template string
+     */
+    resolve(template, context) {
+        let result = template;
+        // Replace indexed arguments first: $ARGUMENTS[0], $ARGUMENTS[1], etc.
+        result = result.replace(/\$ARGUMENTS\[(\d+)\]/g, (_match, indexStr) => {
+            const index = parseInt(indexStr, 10);
+            const args = context.arguments || [];
+            return index < args.length ? args[index] : '';
+        });
+        // Replace $ARGUMENTS with all arguments joined
+        result = result.replace(/\$ARGUMENTS/g, (context.arguments || []).join(' '));
+        // Replace other variables
+        result = result.replace(/\$CLAUDE_SESSION_ID/g, context.sessionId || '');
+        result = result.replace(/\$WORKING_DIR/g, context.workingDir || process.cwd());
+        result = result.replace(/\$GIT_BRANCH/g, context.gitBranch || 'main');
+        logger.debug('Skill variables resolved');
+        return result;
+    }
+}
+// ============================================================================
+// SkillBudgetCalculator
+// ============================================================================
+export class SkillBudgetCalculator {
+    /**
+     * Calculate budget as 2% of context window size (in characters)
+     */
+    calculateBudget(contextWindowSize) {
+        return Math.floor(contextWindowSize * 0.02);
+    }
+    /**
+     * Truncate content to fit within the character budget
+     */
+    truncateToLimit(content, budget) {
+        if (content.length <= budget)
+            return content;
+        return content.slice(0, budget - 3) + '...';
+    }
+    /**
+     * Get default budget for 200k context window
+     */
+    getDefaultBudget() {
+        return this.calculateBudget(200000);
+    }
+}
+//# sourceMappingURL=skill-enhancements.js.map

package/dist/skills/skill-enhancements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-enhancements.js","sourceRoot":"","sources":["../../src/skills/skill-enhancements.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAa5C,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,OAAO,qBAAqB;IAChC;;;OAGG;IACH,oBAAoB,CAAC,MAAc;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAgB,EAAE,OAAqB;QAC7C,IAAI,MAAM,GAAG,QAAQ,CAAC;QAEtB,sEAAsE;QACtE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;YACrC,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE7E,0BAA0B;QAC1B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QAEtE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACH,eAAe,CAAC,iBAAyB;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAe,EAAE,MAAc;QAC7C,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC;QAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/telemetry/otel-tracer.d.ts

@@ -0,0 +1,98 @@
+/**
+ * OpenTelemetry Tracer (Lightweight)
+ *
+ * Manual OTLP HTTP JSON exporter without @opentelemetry/* dependencies.
+ * Buffers spans in memory and flushes them to an OTLP-compatible endpoint.
+ *
+ * Enable via:
+ * - OTEL_ENDPOINT env var
+ * - --otel-endpoint CLI flag
+ * - Constructor config
+ */
+export interface OtelAttribute {
+    key: string;
+    value: {
+        stringValue?: string;
+        intValue?: number;
+        boolValue?: boolean;
+    };
+}
+export interface OtelSpanStatus {
+    code: number;
+    message?: string;
+}
+export interface OtelSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OtelAttribute[];
+    status: OtelSpanStatus;
+}
+export interface OtelTracerConfig {
+    /** OTLP HTTP endpoint (e.g., http://localhost:4318/v1/traces) */
+    endpoint?: string;
+    /** Service name reported in telemetry */
+    serviceName?: string;
+    /** Enable/disable the tracer */
+    enabled?: boolean;
+    /** Flush interval in milliseconds (default: 30000) */
+    flushIntervalMs?: number;
+    /** Maximum buffer size before auto-flush (default: 100) */
+    maxBufferSize?: number;
+}
+export declare class OtelTracer {
+    private readonly endpoint;
+    private readonly serviceName;
+    private readonly enabled;
+    private readonly maxBufferSize;
+    private buffer;
+    private flushTimer;
+    private currentTraceId;
+    constructor(config?: OtelTracerConfig);
+    /**
+     * Start a new span. Call endSpan() when the operation completes.
+     */
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): OtelSpan;
+    /**
+     * End a span and add it to the buffer for flushing.
+     */
+    endSpan(span: OtelSpan, status?: OtelSpanStatus): void;
+    /**
+     * Flush buffered spans to the OTLP endpoint.
+     */
+    flush(): Promise<void>;
+    /**
+     * Trace an LLM API call.
+     */
+    traceApiCall(model: string, tokens: number, duration: number): void;
+    /**
+     * Trace a tool execution.
+     */
+    traceToolExecution(toolName: string, duration: number, success: boolean): void;
+    /**
+     * Trace a conversation turn.
+     */
+    traceConversation(sessionId: string, messageCount: number): void;
+    /**
+     * Start a new trace (generates a new traceId).
+     */
+    newTrace(): string;
+    /**
+     * Get the number of buffered spans.
+     */
+    get pendingSpans(): number;
+    /**
+     * Check if the tracer is enabled.
+     */
+    get isEnabled(): boolean;
+    /**
+     * Dispose the tracer, flushing remaining spans.
+     */
+    dispose(): Promise<void>;
+}
+export declare function getOtelTracer(config?: OtelTracerConfig): OtelTracer;
+export declare function resetOtelTracer(): void;