linguclaw 0.4.2 → 0.5.0

package/dist/api-integrations.d.ts

@@ -0,0 +1,137 @@
+/**
+ * API Integration Framework - Connect to external services
+ *
+ * Core capabilities:
+ * - GitHub: Repository management, issues, PRs, code search
+ * - Slack: Send messages, read channels
+ * - Google Calendar: Create/read events
+ * - Generic REST API: Call any HTTP endpoint
+ * - Webhook: Receive and send webhooks
+ * - Rate limiting and retry built-in
+ */
+export interface APICredentials {
+    type: 'bearer' | 'basic' | 'api_key' | 'oauth2' | 'none';
+    token?: string;
+    username?: string;
+    password?: string;
+    apiKey?: string;
+    apiKeyHeader?: string;
+}
+export interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    status?: number;
+    headers?: Record<string, string>;
+    error?: string;
+    duration?: number;
+}
+export interface IntegrationConfig {
+    name: string;
+    baseUrl: string;
+    credentials: APICredentials;
+    timeout?: number;
+    retries?: number;
+    rateLimitPerMinute?: number;
+    headers?: Record<string, string>;
+}
+export declare class APIClient {
+    private client;
+    private config;
+    private rateLimiter;
+    constructor(config: IntegrationConfig);
+    request<T = any>(method: string, path: string, data?: any, extraHeaders?: Record<string, string>): Promise<APIResponse<T>>;
+    get<T = any>(path: string, params?: Record<string, any>): Promise<APIResponse<T>>;
+    post<T = any>(path: string, data?: any): Promise<APIResponse<T>>;
+    put<T = any>(path: string, data?: any): Promise<APIResponse<T>>;
+    delete<T = any>(path: string): Promise<APIResponse<T>>;
+    patch<T = any>(path: string, data?: any): Promise<APIResponse<T>>;
+}
+export declare class GitHubIntegration {
+    private client;
+    constructor(token: string);
+    getRepo(owner: string, repo: string): Promise<APIResponse>;
+    listIssues(owner: string, repo: string, state?: 'open' | 'closed' | 'all'): Promise<APIResponse>;
+    createIssue(owner: string, repo: string, title: string, body: string, labels?: string[]): Promise<APIResponse>;
+    searchCode(query: string): Promise<APIResponse>;
+    getFileContent(owner: string, repo: string, path: string, ref?: string): Promise<APIResponse>;
+    createPullRequest(owner: string, repo: string, title: string, body: string, head: string, base: string): Promise<APIResponse>;
+    listPullRequests(owner: string, repo: string, state?: 'open' | 'closed' | 'all'): Promise<APIResponse>;
+}
+export declare class SlackIntegration {
+    private client;
+    constructor(token: string);
+    sendMessage(channel: string, text: string, blocks?: any[]): Promise<APIResponse>;
+    listChannels(): Promise<APIResponse>;
+    getChannelHistory(channel: string, limit?: number): Promise<APIResponse>;
+    uploadFile(channel: string, content: string, filename: string, title?: string): Promise<APIResponse>;
+}
+export declare class GenericAPI {
+    private client;
+    constructor(config: IntegrationConfig);
+    call(method: string, path: string, data?: any, headers?: Record<string, string>): Promise<APIResponse>;
+    get(path: string, params?: Record<string, any>): Promise<APIResponse>;
+    post(path: string, data?: any): Promise<APIResponse>;
+}
+export interface WebhookEvent {
+    id: string;
+    source: string;
+    event: string;
+    payload: any;
+    timestamp: Date;
+    headers: Record<string, string>;
+}
+export declare class WebhookHandler {
+    private handlers;
+    private eventLog;
+    private maxLogSize;
+    /**
+     * Register a handler for a specific event type
+     */
+    on(eventType: string, handler: (event: WebhookEvent) => Promise<void>): void;
+    /**
+     * Process an incoming webhook
+     */
+    process(source: string, event: string, payload: any, headers?: Record<string, string>): Promise<void>;
+    /**
+     * Get recent webhook events
+     */
+    getRecentEvents(limit?: number): WebhookEvent[];
+    /**
+     * Send a webhook to an external URL
+     */
+    send(url: string, payload: any, headers?: Record<string, string>): Promise<APIResponse>;
+}
+export declare class IntegrationRegistry {
+    private integrations;
+    private webhookHandler;
+    /**
+     * Register a GitHub integration
+     */
+    registerGitHub(token: string): GitHubIntegration;
+    /**
+     * Register a Slack integration
+     */
+    registerSlack(token: string): SlackIntegration;
+    /**
+     * Register a generic API integration
+     */
+    registerAPI(name: string, config: IntegrationConfig): GenericAPI;
+    /**
+     * Get an integration by name
+     */
+    get<T = any>(name: string): T | undefined;
+    /**
+     * Get the webhook handler
+     */
+    getWebhookHandler(): WebhookHandler;
+    /**
+     * List all registered integrations
+     */
+    list(): string[];
+    /**
+     * Auto-register integrations from environment variables
+     */
+    autoRegister(): string[];
+}
+export declare function getIntegrationRegistry(): IntegrationRegistry;
+//# sourceMappingURL=api-integrations.d.ts.map

package/dist/api-integrations.d.ts.map

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

package/dist/api-integrations.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * API Integration Framework - Connect to external services
+ *
+ * Core capabilities:
+ * - GitHub: Repository management, issues, PRs, code search
+ * - Slack: Send messages, read channels
+ * - Google Calendar: Create/read events
+ * - Generic REST API: Call any HTTP endpoint
+ * - Webhook: Receive and send webhooks
+ * - Rate limiting and retry built-in
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationRegistry = exports.WebhookHandler = exports.GenericAPI = exports.SlackIntegration = exports.GitHubIntegration = exports.APIClient = void 0;
+exports.getIntegrationRegistry = getIntegrationRegistry;
+const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("./logger");
+const resilience_1 = require("./resilience");
+const logger = (0, logger_1.getLogger)();
+// ==================== Rate Limiter ====================
+class RateLimiter {
+    timestamps = [];
+    limit;
+    windowMs;
+    constructor(requestsPerMinute) {
+        this.limit = requestsPerMinute;
+        this.windowMs = 60000;
+    }
+    async acquire() {
+        const now = Date.now();
+        this.timestamps = this.timestamps.filter(t => now - t < this.windowMs);
+        if (this.timestamps.length >= this.limit) {
+            const waitMs = this.windowMs - (now - this.timestamps[0]);
+            logger.debug(`[RateLimiter] Waiting ${waitMs}ms`);
+            await new Promise(resolve => setTimeout(resolve, waitMs));
+        }
+        this.timestamps.push(Date.now());
+    }
+}
+// ==================== Base API Client ====================
+class APIClient {
+    client;
+    config;
+    rateLimiter;
+    constructor(config) {
+        this.config = config;
+        this.rateLimiter = config.rateLimitPerMinute
+            ? new RateLimiter(config.rateLimitPerMinute)
+            : null;
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'LinguClaw/0.4.3',
+            ...config.headers,
+        };
+        // Apply credentials
+        if (config.credentials.type === 'bearer' && config.credentials.token) {
+            headers['Authorization'] = `Bearer ${config.credentials.token}`;
+        }
+        else if (config.credentials.type === 'api_key' && config.credentials.apiKey) {
+            headers[config.credentials.apiKeyHeader || 'X-API-Key'] = config.credentials.apiKey;
+        }
+        else if (config.credentials.type === 'basic' && config.credentials.username) {
+            const encoded = Buffer.from(`${config.credentials.username}:${config.credentials.password || ''}`).toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        this.client = axios_1.default.create({
+            baseURL: config.baseUrl,
+            timeout: config.timeout || 30000,
+            headers,
+        });
+    }
+    async request(method, path, data, extraHeaders) {
+        if (this.rateLimiter)
+            await this.rateLimiter.acquire();
+        const startTime = Date.now();
+        try {
+            const response = await (0, resilience_1.withRetry)(() => this.client.request({
+                method,
+                url: path,
+                data,
+                headers: extraHeaders,
+            }), { maxRetries: this.config.retries || 2 }, `${this.config.name}:${method}:${path}`);
+            return {
+                success: true,
+                data: response.data,
+                status: response.status,
+                headers: response.headers,
+                duration: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                status: error.response?.status,
+                error: error.response?.data?.message || error.message,
+                duration: Date.now() - startTime,
+            };
+        }
+    }
+    async get(path, params) {
+        const query = params ? '?' + new URLSearchParams(params).toString() : '';
+        return this.request('GET', path + query);
+    }
+    async post(path, data) {
+        return this.request('POST', path, data);
+    }
+    async put(path, data) {
+        return this.request('PUT', path, data);
+    }
+    async delete(path) {
+        return this.request('DELETE', path);
+    }
+    async patch(path, data) {
+        return this.request('PATCH', path, data);
+    }
+}
+exports.APIClient = APIClient;
+// ==================== GitHub Integration ====================
+class GitHubIntegration {
+    client;
+    constructor(token) {
+        this.client = new APIClient({
+            name: 'GitHub',
+            baseUrl: 'https://api.github.com',
+            credentials: { type: 'bearer', token },
+            rateLimitPerMinute: 30,
+            retries: 2,
+            headers: { Accept: 'application/vnd.github.v3+json' },
+        });
+    }
+    async getRepo(owner, repo) {
+        return this.client.get(`/repos/${owner}/${repo}`);
+    }
+    async listIssues(owner, repo, state = 'open') {
+        return this.client.get(`/repos/${owner}/${repo}/issues`, { state, per_page: '30' });
+    }
+    async createIssue(owner, repo, title, body, labels) {
+        return this.client.post(`/repos/${owner}/${repo}/issues`, { title, body, labels });
+    }
+    async searchCode(query) {
+        return this.client.get('/search/code', { q: query });
+    }
+    async getFileContent(owner, repo, path, ref) {
+        const params = {};
+        if (ref)
+            params.ref = ref;
+        return this.client.get(`/repos/${owner}/${repo}/contents/${path}`, params);
+    }
+    async createPullRequest(owner, repo, title, body, head, base) {
+        return this.client.post(`/repos/${owner}/${repo}/pulls`, { title, body, head, base });
+    }
+    async listPullRequests(owner, repo, state = 'open') {
+        return this.client.get(`/repos/${owner}/${repo}/pulls`, { state, per_page: '30' });
+    }
+}
+exports.GitHubIntegration = GitHubIntegration;
+// ==================== Slack Integration ====================
+class SlackIntegration {
+    client;
+    constructor(token) {
+        this.client = new APIClient({
+            name: 'Slack',
+            baseUrl: 'https://slack.com/api',
+            credentials: { type: 'bearer', token },
+            rateLimitPerMinute: 50,
+            retries: 1,
+        });
+    }
+    async sendMessage(channel, text, blocks) {
+        return this.client.post('/chat.postMessage', { channel, text, blocks });
+    }
+    async listChannels() {
+        return this.client.get('/conversations.list', { types: 'public_channel,private_channel', limit: '100' });
+    }
+    async getChannelHistory(channel, limit = 20) {
+        return this.client.get('/conversations.history', { channel, limit: limit.toString() });
+    }
+    async uploadFile(channel, content, filename, title) {
+        return this.client.post('/files.upload', { channels: channel, content, filename, title });
+    }
+}
+exports.SlackIntegration = SlackIntegration;
+// ==================== Generic REST API ====================
+class GenericAPI {
+    client;
+    constructor(config) {
+        this.client = new APIClient(config);
+    }
+    async call(method, path, data, headers) {
+        return this.client.request(method, path, data, headers);
+    }
+    async get(path, params) {
+        return this.client.get(path, params);
+    }
+    async post(path, data) {
+        return this.client.post(path, data);
+    }
+}
+exports.GenericAPI = GenericAPI;
+class WebhookHandler {
+    handlers = new Map();
+    eventLog = [];
+    maxLogSize = 100;
+    /**
+     * Register a handler for a specific event type
+     */
+    on(eventType, handler) {
+        if (!this.handlers.has(eventType)) {
+            this.handlers.set(eventType, []);
+        }
+        this.handlers.get(eventType).push(handler);
+    }
+    /**
+     * Process an incoming webhook
+     */
+    async process(source, event, payload, headers = {}) {
+        const webhookEvent = {
+            id: `wh-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`,
+            source,
+            event,
+            payload,
+            timestamp: new Date(),
+            headers,
+        };
+        this.eventLog.push(webhookEvent);
+        if (this.eventLog.length > this.maxLogSize) {
+            this.eventLog = this.eventLog.slice(-this.maxLogSize);
+        }
+        const handlers = this.handlers.get(event) || [];
+        const wildcardHandlers = this.handlers.get('*') || [];
+        for (const handler of [...handlers, ...wildcardHandlers]) {
+            try {
+                await handler(webhookEvent);
+            }
+            catch (error) {
+                logger.error(`[Webhook] Handler error for ${event}: ${error.message}`);
+            }
+        }
+        logger.info(`[Webhook] Processed: ${source}/${event}`);
+    }
+    /**
+     * Get recent webhook events
+     */
+    getRecentEvents(limit = 20) {
+        return this.eventLog.slice(-limit);
+    }
+    /**
+     * Send a webhook to an external URL
+     */
+    async send(url, payload, headers) {
+        try {
+            const response = await axios_1.default.post(url, payload, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'LinguClaw-Webhook/0.4.3',
+                    ...headers,
+                },
+                timeout: 10000,
+            });
+            return { success: true, status: response.status, data: response.data };
+        }
+        catch (error) {
+            return { success: false, error: error.message, status: error.response?.status };
+        }
+    }
+}
+exports.WebhookHandler = WebhookHandler;
+// ==================== Integration Registry ====================
+class IntegrationRegistry {
+    integrations = new Map();
+    webhookHandler = new WebhookHandler();
+    /**
+     * Register a GitHub integration
+     */
+    registerGitHub(token) {
+        const integration = new GitHubIntegration(token);
+        this.integrations.set('github', integration);
+        logger.info('[Integrations] GitHub registered');
+        return integration;
+    }
+    /**
+     * Register a Slack integration
+     */
+    registerSlack(token) {
+        const integration = new SlackIntegration(token);
+        this.integrations.set('slack', integration);
+        logger.info('[Integrations] Slack registered');
+        return integration;
+    }
+    /**
+     * Register a generic API integration
+     */
+    registerAPI(name, config) {
+        const integration = new GenericAPI(config);
+        this.integrations.set(name, integration);
+        logger.info(`[Integrations] ${name} registered`);
+        return integration;
+    }
+    /**
+     * Get an integration by name
+     */
+    get(name) {
+        return this.integrations.get(name);
+    }
+    /**
+     * Get the webhook handler
+     */
+    getWebhookHandler() {
+        return this.webhookHandler;
+    }
+    /**
+     * List all registered integrations
+     */
+    list() {
+        return Array.from(this.integrations.keys());
+    }
+    /**
+     * Auto-register integrations from environment variables
+     */
+    autoRegister() {
+        const registered = [];
+        if (process.env.GITHUB_TOKEN) {
+            this.registerGitHub(process.env.GITHUB_TOKEN);
+            registered.push('github');
+        }
+        if (process.env.SLACK_BOT_TOKEN) {
+            this.registerSlack(process.env.SLACK_BOT_TOKEN);
+            registered.push('slack');
+        }
+        if (registered.length > 0) {
+            logger.info(`[Integrations] Auto-registered: ${registered.join(', ')}`);
+        }
+        return registered;
+    }
+}
+exports.IntegrationRegistry = IntegrationRegistry;
+// ==================== Singleton ====================
+let registryInstance = null;
+function getIntegrationRegistry() {
+    if (!registryInstance) {
+        registryInstance = new IntegrationRegistry();
+    }
+    return registryInstance;
+}
+//# sourceMappingURL=api-integrations.js.map

package/dist/api-integrations.js.map

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

package/dist/chain-of-thought.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Chain of Thought - Transparent reasoning and action tracking system
+ *
+ * Core capabilities:
+ * - Thought Logs: See exactly what the agent is "thinking"
+ * - Action Tracking: Real-time visibility into which tools are being used
+ * - Reasoning Chain: Full audit trail of decisions and their outcomes
+ * - Event Streaming: WebSocket-compatible event emission for live UI updates
+ */
+import { EventEmitter } from 'events';
+export type ThoughtType = 'reasoning' | 'planning' | 'observation' | 'decision' | 'reflection' | 'correction' | 'hypothesis' | 'conclusion';
+export type ActionStatus = 'started' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface ThoughtEntry {
+    id: string;
+    sessionId: string;
+    timestamp: Date;
+    type: ThoughtType;
+    content: string;
+    confidence?: number;
+    relatedActionId?: string;
+    parentThoughtId?: string;
+    metadata?: Record<string, any>;
+}
+export interface ActionEntry {
+    id: string;
+    sessionId: string;
+    timestamp: Date;
+    tool: string;
+    operation: string;
+    input: string;
+    output?: string;
+    status: ActionStatus;
+    duration?: number;
+    error?: string;
+    metadata?: Record<string, any>;
+}
+export interface ReasoningStep {
+    thought: ThoughtEntry;
+    action?: ActionEntry;
+    result?: string;
+}
+export interface SessionSummary {
+    sessionId: string;
+    task: string;
+    startedAt: Date;
+    endedAt?: Date;
+    totalThoughts: number;
+    totalActions: number;
+    failedActions: number;
+    corrections: number;
+    reasoningChain: ReasoningStep[];
+    finalConclusion?: string;
+}
+export interface ChainOfThoughtConfig {
+    maxThoughtsPerSession: number;
+    maxActionsPerSession: number;
+    enableStreaming: boolean;
+    verboseLogging: boolean;
+    persistToDisk: boolean;
+    persistPath?: string;
+}
+export declare class ChainOfThought extends EventEmitter {
+    private config;
+    private sessions;
+    private activeSession;
+    private idCounter;
+    constructor(config?: Partial<ChainOfThoughtConfig>);
+    /**
+     * Start a new reasoning session
+     */
+    startSession(task: string, sessionId?: string): string;
+    /**
+     * End a reasoning session
+     */
+    endSession(sessionId?: string, conclusion?: string): SessionSummary | null;
+    /**
+     * Record a thought
+     */
+    think(sessionId: string | null, type: ThoughtType, content: string, meta?: {
+        confidence?: number;
+        relatedActionId?: string;
+        parentThoughtId?: string;
+        metadata?: Record<string, any>;
+    }): ThoughtEntry;
+    /**
+     * Record an action start
+     */
+    startAction(sessionId: string | null, tool: string, operation: string, input: string, metadata?: Record<string, any>): ActionEntry;
+    /**
+     * Update an action's status
+     */
+    updateAction(actionId: string, update: {
+        status?: ActionStatus;
+        output?: string;
+        error?: string;
+        duration?: number;
+    }): ActionEntry | null;
+    /**
+     * Complete an action
+     */
+    completeAction(actionId: string, output: string, startTime?: number): ActionEntry | null;
+    /**
+     * Fail an action
+     */
+    failAction(actionId: string, error: string, startTime?: number): ActionEntry | null;
+    /**
+     * Get the full reasoning chain for a session
+     */
+    getChain(sessionId?: string): ReasoningStep[];
+    /**
+     * Get all thoughts for a session
+     */
+    getThoughts(sessionId?: string, type?: ThoughtType): ThoughtEntry[];
+    /**
+     * Get all actions for a session
+     */
+    getActions(sessionId?: string, tool?: string): ActionEntry[];
+    /**
+     * Get session summary without ending it
+     */
+    getSessionSummary(sessionId?: string): SessionSummary | null;
+    /**
+     * Get a human-readable reasoning trace
+     */
+    getReadableTrace(sessionId?: string): string;
+    /**
+     * Get active session ID
+     */
+    getActiveSessionId(): string | null;
+    /**
+     * Clean up old sessions
+     */
+    cleanup(maxAge?: number): void;
+}
+export declare function getChainOfThought(config?: Partial<ChainOfThoughtConfig>): ChainOfThought;
+//# sourceMappingURL=chain-of-thought.d.ts.map

package/dist/chain-of-thought.d.ts.map

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