kemdicode-mcp 1.15.0

package/dist/config/types.d.ts

@@ -0,0 +1,189 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Configuration Types
+ *
+ * TypeScript interfaces for all configuration groups.
+ *
+ * @module config/types
+ */
+/** Server configuration */
+export interface ServerConfig {
+    /** HTTP server port */
+    port: number;
+    /** HTTP server host */
+    host: string;
+    /** Primary AI model */
+    primaryModel: string;
+    /** Fallback model for quota exceeded */
+    fallbackModel: string;
+    /** AI API base URL for hot-reload (optional) */
+    apiBaseUrl?: string;
+    /** AI API key (optional) */
+    apiKey?: string;
+}
+/** Redis configuration */
+export interface RedisConfig {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Redis database number */
+    db: number;
+    /** Redis password (optional) */
+    password?: string;
+}
+/** Timeout configuration in milliseconds */
+export interface TimeoutConfig {
+    /** Default command timeout (5 min) */
+    command: number;
+    /** Short operation timeout (2 min) */
+    short: number;
+    /** Long operation timeout (10 min) */
+    long: number;
+    /** SSE keepalive interval */
+    keepalive: number;
+    /** Force kill delay after SIGTERM */
+    forceKill: number;
+    /** Safe exec default timeout */
+    safeExec: number;
+}
+/** Cache configuration */
+export interface CacheConfig {
+    /** Default max entries */
+    maxEntries: number;
+    /** Default TTL in ms */
+    defaultTtl: number;
+    /** Git cache max entries */
+    gitSize: number;
+    /** Git cache TTL in ms */
+    gitTtl: number;
+    /** FS cache max entries */
+    fsSize: number;
+    /** FS cache TTL in ms */
+    fsTtl: number;
+    /** Project cache max entries */
+    projectSize: number;
+    /** Project cache TTL in ms */
+    projectTtl: number;
+}
+/** Session configuration in seconds */
+export interface SessionConfig {
+    /** Active session TTL */
+    activeTtl: number;
+    /** Idle session timeout */
+    idleTtl: number;
+    /** Cleanup check interval */
+    cleanupInterval: number;
+}
+/** Context TTL configuration in seconds */
+export interface ContextTtlConfig {
+    /** Schema TTL */
+    schema: number;
+    /** API docs TTL */
+    apiDocs: number;
+    /** Query TTL */
+    query: number;
+    /** Analysis TTL */
+    analysis: number;
+    /** Session TTL */
+    session: number;
+    /** Default TTL */
+    default: number;
+}
+/** File/buffer limits */
+export interface LimitsConfig {
+    /** Max file size for reading (bytes) */
+    maxFileSize: number;
+    /** Max diff buffer size (bytes) */
+    maxDiffBuffer: number;
+    /** Max git output buffer (bytes) */
+    maxBuffer: number;
+    /** Binary sample size for detection (bytes) */
+    binarySampleSize: number;
+}
+/** Retry configuration */
+export interface RetryConfig {
+    /** Max retry attempts */
+    maxAttempts: number;
+    /** Base delay in ms */
+    baseDelay: number;
+    /** Max delay in ms */
+    maxDelay: number;
+}
+/** RL (Reinforcement Learning) configuration */
+export interface RlConfig {
+    /** Max state history entries */
+    maxHistorySize: number;
+    /** State history TTL in seconds */
+    historyTtl: number;
+    /** Max dopamine signals */
+    maxSignals: number;
+    /** Dopamine signal TTL in seconds */
+    signalTtl: number;
+    /** Reward history TTL in seconds */
+    rewardHistoryTtl: number;
+}
+/** Loci/Graph configuration */
+export interface LociConfig {
+    /** Graph node TTL in seconds */
+    nodeTtl: number;
+    /** Graph edge TTL in seconds */
+    edgeTtl: number;
+}
+/** Single provider entry configuration */
+export interface ProviderEntry {
+    /** API key for this provider */
+    apiKey?: string;
+    /** Custom base URL override */
+    baseURL?: string;
+    /** Whether this provider is enabled */
+    enabled?: boolean;
+}
+/** Multi-provider configuration */
+export interface ProvidersConfig {
+    /** Default provider when no prefix is specified */
+    defaultProvider: string;
+    /** Per-provider settings */
+    openai: ProviderEntry;
+    anthropic: ProviderEntry;
+    gemini: ProviderEntry;
+    groq: ProviderEntry;
+    deepseek: ProviderEntry;
+    ollama: ProviderEntry;
+    openrouter: ProviderEntry;
+}
+/** Complete application configuration */
+export interface AppConfig {
+    server: ServerConfig;
+    redis: RedisConfig;
+    timeouts: TimeoutConfig;
+    cache: CacheConfig;
+    session: SessionConfig;
+    context: ContextTtlConfig;
+    limits: LimitsConfig;
+    retry: RetryConfig;
+    rl: RlConfig;
+    loci: LociConfig;
+    providers: ProvidersConfig;
+}
+/** Config group names */
+export type ConfigGroup = keyof AppConfig;
+/** All config group names as array */
+export declare const CONFIG_GROUPS: ConfigGroup[];
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,32 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/** All config group names as array */
+export const CONFIG_GROUPS = [
+    'server',
+    'redis',
+    'timeouts',
+    'cache',
+    'session',
+    'context',
+    'limits',
+    'retry',
+    'rl',
+    'loci',
+    'providers',
+];
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA0LH,sCAAsC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,QAAQ;IACR,OAAO;IACP,UAAU;IACV,OAAO;IACP,SAAS;IACT,SAAS;IACT,QAAQ;IACR,OAAO;IACP,IAAI;IACJ,MAAM;IACN,WAAW;CACZ,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,92 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+export type { BaseToolArguments as ToolArguments } from './types/tool-types.js';
+/** Log prefix for all log messages */
+export declare const LOG_PREFIX = "[OMCP]";
+/**
+ * Error messages used throughout the application
+ */
+export declare const ERROR_MESSAGES: {
+    readonly QUOTA_EXCEEDED: "quota exceeded";
+    readonly NO_PROMPT: "Prompt is required. Use @filepath to include files or ask general questions.";
+};
+/**
+ * CLI configuration
+ */
+export declare const CLI: {
+    readonly COMMANDS: {};
+    readonly SUBCOMMANDS: {};
+    readonly FLAGS: {
+        readonly MODEL: "-m";
+        readonly AGENT: "--agent";
+    };
+};
+/**
+ * MCP protocol configuration
+ *
+ * Note: KEEPALIVE_INTERVAL is now a getter that reads from config.
+ * This allows runtime configuration changes while maintaining backward compatibility.
+ */
+export declare const PROTOCOL: {
+    readonly KEEPALIVE_INTERVAL: number;
+    readonly NOTIFICATIONS: {
+        readonly PROGRESS: "notifications/progress";
+    };
+};
+/**
+ * Logging configuration
+ *
+ * Environment variables:
+ * - KEMDICODE_LOG_LEVEL: debug | info | warn | error (default: info)
+ * - KEMDICODE_LOG_FORMAT: text | json (default: text)
+ * - KEMDICODE_LOG_MEMORY: true | false (default: false)
+ *
+ * @example
+ * ```bash
+ * # Enable debug logging with JSON format
+ * KEMDICODE_LOG_LEVEL=debug KEMDICODE_LOG_FORMAT=json node dist/index.js
+ *
+ * # Enable memory logging for performance debugging
+ * KEMDICODE_LOG_LEVEL=debug KEMDICODE_LOG_MEMORY=true node dist/index.js
+ * ```
+ */
+export declare const LOGGING: {
+    /** Environment variable names */
+    readonly ENV_VARS: {
+        /** Log level: debug, info, warn, error */
+        readonly LEVEL: "KEMDICODE_LOG_LEVEL";
+        /** Log format: text, json */
+        readonly FORMAT: "KEMDICODE_LOG_FORMAT";
+        /** Enable memory logging: true, false */
+        readonly MEMORY: "KEMDICODE_LOG_MEMORY";
+    };
+    /** Default values */
+    readonly DEFAULTS: {
+        readonly LEVEL: "info";
+        readonly FORMAT: "text";
+        readonly MEMORY: false;
+    };
+    /** Log level numeric values for comparison */
+    readonly LEVELS: {
+        readonly DEBUG: 0;
+        readonly INFO: 1;
+        readonly WARN: 2;
+        readonly ERROR: 3;
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,YAAY,EAAE,iBAAiB,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,sCAAsC;AACtC,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;CAON,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;iCACO,MAAM;;;;CAIxB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO;IAClB,iCAAiC;;QAE/B,0CAA0C;;QAE1C,6BAA6B;;QAE7B,yCAAyC;;;IAG3C,qBAAqB;;;;;;IAMrB,8CAA8C;;;;;;;CAOtC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,100 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Constants Module
+ *
+ * Central location for application-wide constants including
+ * error messages, CLI configuration, protocol settings, and logging configuration.
+ *
+ * @module constants
+ */
+import { config } from './config/index.js';
+/** Log prefix for all log messages */
+export const LOG_PREFIX = '[OMCP]';
+/**
+ * Error messages used throughout the application
+ */
+export const ERROR_MESSAGES = {
+    QUOTA_EXCEEDED: 'quota exceeded',
+    NO_PROMPT: 'Prompt is required. Use @filepath to include files or ask general questions.',
+};
+/**
+ * CLI configuration
+ */
+export const CLI = {
+    COMMANDS: {},
+    SUBCOMMANDS: {},
+    FLAGS: {
+        MODEL: '-m',
+        AGENT: '--agent',
+    },
+};
+/**
+ * MCP protocol configuration
+ *
+ * Note: KEEPALIVE_INTERVAL is now a getter that reads from config.
+ * This allows runtime configuration changes while maintaining backward compatibility.
+ */
+export const PROTOCOL = {
+    get KEEPALIVE_INTERVAL() {
+        return config.get('timeouts').keepalive;
+    },
+    NOTIFICATIONS: { PROGRESS: 'notifications/progress' },
+};
+/**
+ * Logging configuration
+ *
+ * Environment variables:
+ * - KEMDICODE_LOG_LEVEL: debug | info | warn | error (default: info)
+ * - KEMDICODE_LOG_FORMAT: text | json (default: text)
+ * - KEMDICODE_LOG_MEMORY: true | false (default: false)
+ *
+ * @example
+ * ```bash
+ * # Enable debug logging with JSON format
+ * KEMDICODE_LOG_LEVEL=debug KEMDICODE_LOG_FORMAT=json node dist/index.js
+ *
+ * # Enable memory logging for performance debugging
+ * KEMDICODE_LOG_LEVEL=debug KEMDICODE_LOG_MEMORY=true node dist/index.js
+ * ```
+ */
+export const LOGGING = {
+    /** Environment variable names */
+    ENV_VARS: {
+        /** Log level: debug, info, warn, error */
+        LEVEL: 'KEMDICODE_LOG_LEVEL',
+        /** Log format: text, json */
+        FORMAT: 'KEMDICODE_LOG_FORMAT',
+        /** Enable memory logging: true, false */
+        MEMORY: 'KEMDICODE_LOG_MEMORY',
+    },
+    /** Default values */
+    DEFAULTS: {
+        LEVEL: 'info',
+        FORMAT: 'text',
+        MEMORY: false,
+    },
+    /** Log level numeric values for comparison */
+    LEVELS: {
+        DEBUG: 0,
+        INFO: 1,
+        WARN: 2,
+        ERROR: 3,
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAK3C,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,8EAA8E;CACjF,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;IACf,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;KACjB;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,kBAAkB;QACpB,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC;IACD,aAAa,EAAE,EAAE,QAAQ,EAAE,wBAAwB,EAAE;CAC7C,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,iCAAiC;IACjC,QAAQ,EAAE;QACR,0CAA0C;QAC1C,KAAK,EAAE,qBAAqB;QAC5B,6BAA6B;QAC7B,MAAM,EAAE,sBAAsB;QAC9B,yCAAyC;QACzC,MAAM,EAAE,sBAAsB;KAC/B;IACD,qBAAqB;IACrB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,KAAK;KACd;IACD,8CAA8C;IAC9C,MAAM,EAAE;QACN,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;KACT;CACO,CAAC"}

package/dist/context/agent-monitor.d.ts

@@ -0,0 +1,173 @@
+/**
+ * KemdiCode MCP Server
+ * Copyright (C) 2025-2026 Kemdi Sp. z o.o.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import { McpAgent, AgentMessage, SupervisorAlert, ConversationSnapshot, RedisConfig, AgentStatus, AgentRole, MessageType, MessagePriority, ServerIdentifier, AgentSummary, QueuedMessage, SessionOverview, AgentOverview } from './types.js';
+type MessageHandler = (message: AgentMessage) => void;
+type AlertHandler = (alert: SupervisorAlert) => void;
+type StatusHandler = (agent: McpAgent) => void;
+export declare class AgentMonitor {
+    private readonly config;
+    private redis;
+    private subscriber;
+    private connected;
+    private messageHandlers;
+    private alertHandlers;
+    private statusHandlers;
+    private messageHandlerRegistered;
+    private alertHandlerRegistered;
+    private statusHandlerRegistered;
+    constructor(config?: RedisConfig);
+    /**
+     * Initialize Redis connections (main + subscriber)
+     */
+    connect(): Promise<boolean>;
+    isConnected(): boolean;
+    disconnect(): Promise<void>;
+    /**
+     * Register a new agent in the system
+     */
+    registerAgent(name: string, role: AgentRole, sessionId: string, serverId: ServerIdentifier, model?: string, metadata?: Record<string, unknown>): Promise<McpAgent | null>;
+    /**
+     * Update agent status
+     */
+    updateAgentStatus(agentId: string, status: AgentStatus, currentTask?: string): Promise<boolean>;
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): Promise<McpAgent | null>;
+    /**
+     * List all active agents (optionally filtered by session)
+     */
+    listAgents(sessionId?: string): Promise<McpAgent[]>;
+    /**
+     * Send heartbeat for an agent
+     */
+    heartbeat(agentId: string): Promise<boolean>;
+    /**
+     * Send a message between agents or from supervisor
+     */
+    sendMessage(fromAgentId: string, toAgentId: string, sessionId: string, content: string, type?: MessageType, priority?: MessagePriority, data?: Record<string, unknown>, replyTo?: string): Promise<AgentMessage | null>;
+    /**
+     * Send an alert from supervisor (e.g., "[ALERT: Słowo od Claude Opus 4.5]")
+     */
+    sendAlert(targetAgentIds: string[] | '*', content: string, source?: string, priority?: MessagePriority, interrupt?: boolean, sessionId?: string): Promise<SupervisorAlert | null>;
+    /**
+     * Inject context into an agent's stream
+     */
+    injectContext(agentId: string, sessionId: string, context: string, data?: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Send directive to change agent behavior
+     */
+    sendDirective(agentId: string, sessionId: string, directive: string, data?: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Get message history for a session
+     */
+    getMessageHistory(sessionId: string, limit?: number, since?: number): Promise<AgentMessage[]>;
+    /**
+     * Get recent messages for an agent
+     */
+    getAgentMessages(agentId: string, sessionId: string, limit?: number): Promise<AgentMessage[]>;
+    /**
+     * Get pending alerts for an agent
+     */
+    getPendingAlerts(agentId: string, sessionId?: string): Promise<SupervisorAlert[]>;
+    /**
+     * Get full conversation snapshot
+     */
+    getConversationSnapshot(sessionId: string, messageLimit?: number): Promise<ConversationSnapshot>;
+    /**
+     * Subscribe to real-time message updates
+     */
+    subscribeToMessages(handler: MessageHandler): Promise<void>;
+    /**
+     * Subscribe to alerts
+     */
+    subscribeToAlerts(handler: AlertHandler): Promise<void>;
+    /**
+     * Subscribe to agent status changes
+     */
+    subscribeToStatusUpdates(handler: StatusHandler): Promise<void>;
+    private publishStatusUpdate;
+    /**
+     * Update agent activity summary (agent reports what they're doing)
+     */
+    updateAgentSummary(agentId: string, summary: Omit<AgentSummary, 'agentId' | 'updatedAt'>): Promise<boolean>;
+    /**
+     * Get current activity summary for an agent
+     */
+    getAgentSummary(agentId: string): Promise<AgentSummary | null>;
+    /**
+     * Get all activity summaries for agents in a session
+     */
+    getSessionSummaries(sessionId: string): Promise<AgentSummary[]>;
+    /**
+     * Queue a message for an agent
+     * Messages are stored in a ZSET with priority-based scoring
+     */
+    queueMessage(targetAgentId: string, sessionId: string, content: string, options?: {
+        priority?: MessagePriority;
+        files?: string[];
+        context?: Record<string, unknown>;
+        forceContextChange?: boolean;
+        fromAgentId?: string;
+        expiresAt?: number;
+    }): Promise<QueuedMessage | null>;
+    /**
+     * Get messages from agent's queue without removing them
+     */
+    getMessageQueue(agentId: string, options?: {
+        limit?: number;
+        priority?: MessagePriority;
+    }): Promise<QueuedMessage[]>;
+    /**
+     * Pop the next message from agent's queue (removes it)
+     */
+    popMessage(agentId: string): Promise<QueuedMessage | null>;
+    /**
+     * Clear all messages from agent's queue
+     */
+    clearMessageQueue(agentId: string): Promise<number>;
+    /**
+     * Get queue depth (number of pending messages) for an agent
+     */
+    getQueueDepth(agentId: string): Promise<number>;
+    /**
+     * Get comprehensive overview of a session
+     * Includes: workspaces, boards, agents, tasks, activity
+     */
+    getSessionOverview(sessionId: string): Promise<SessionOverview>;
+    /**
+     * Get detailed overview of a single agent
+     */
+    getAgentOverview(agentId: string): Promise<AgentOverview | null>;
+    /**
+     * Helper: Get total pending messages for multiple agents
+     */
+    private getTotalPendingMessages;
+    /**
+     * Helper: Create empty session overview
+     */
+    private emptySessionOverview;
+    /**
+     * Watch session in real-time (returns formatted output)
+     */
+    watchSession(sessionId: string, durationMs?: number, onUpdate?: (output: string) => void): Promise<string>;
+}
+export declare function getAgentMonitor(config?: RedisConfig): AgentMonitor;
+export declare function initAgentMonitor(config?: RedisConfig): Promise<AgentMonitor>;
+export {};
+//# sourceMappingURL=agent-monitor.d.ts.map

package/dist/context/agent-monitor.d.ts.map

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