@jungjaehoon/mama-os 0.28.5 → 0.29.0

package/dist/multi-agent/multi-agent-base.d.ts

@@ -1,223 +0,0 @@
-/**
- * Multi-Agent Handler Base
- *
- * Abstract base class for platform-specific multi-agent handlers.
- * Contains shared infrastructure (orchestrator, process manager, queues,
- * delegation, background tasks) so Discord and Slack handlers only
- * implement platform-specific messaging and formatting.
- */
-import type { MultiAgentConfig, AgentPersonaConfig, ChainState, MultiAgentRuntimeOptions } from './types.js';
-import { MultiAgentOrchestrator } from './orchestrator.js';
-import { AgentProcessManager } from './agent-process-manager.js';
-import { type SharedContextManager } from './shared-context.js';
-import type { PersistentProcessOptions } from '../agent/persistent-cli-process.js';
-import { AgentMessageQueue } from './agent-message-queue.js';
-import { BackgroundTaskManager } from './background-task-manager.js';
-import { SystemReminderService } from './system-reminder.js';
-import { DelegationManager } from './delegation-manager.js';
-import { WorkTracker } from './work-tracker.js';
-import type { GatewayToolExecutor } from '../agent/gateway-tool-executor.js';
-import type { PromptCallbacks } from '../agent/types.js';
-import { WorkflowEngine } from './workflow-engine.js';
-import { CouncilEngine } from './council-engine.js';
-import type { WorkflowProgressEvent, CouncilProgressEvent } from './workflow-types.js';
-/** Default timeout for agent responses (5 minutes) */
-export declare const AGENT_TIMEOUT_MS: () => number;
-/**
- * Response from a single agent
- */
-export interface AgentResponse {
-    /** Agent ID */
-    agentId: string;
-    /** Agent configuration */
-    agent: AgentPersonaConfig;
-    /** Formatted content (with agent prefix) */
-    content: string;
-    /** Raw content from Claude */
-    rawContent: string;
-    /** Response duration in ms */
-    duration?: number;
-    /** Message ID (set after sending) */
-    messageId?: string;
-}
-/**
- * Multi-agent response result
- */
-export interface MultiAgentResponse {
-    /** Selected agent IDs */
-    selectedAgents: string[];
-    /** Selection reason */
-    reason: 'explicit_trigger' | 'keyword_match' | 'default_agent' | 'free_chat' | 'category_match' | 'delegation' | 'ultrawork' | 'mention_chain' | 'none';
-    /** Individual agent responses */
-    responses: AgentResponse[];
-}
-/**
- * Abstract base class for platform-specific multi-agent handlers.
- *
- * Subclasses must implement:
- * - getPlatformName() - 'discord' | 'slack'
- * - formatBold(text) - platform-specific bold formatting
- * - extractMentionedAgentIds(content) - platform-specific mention extraction
- * - platformCleanup() - platform-specific cleanup on stopAll()
- */
-export declare abstract class MultiAgentHandlerBase {
-    protected logger: {
-        debug: (message: string, ...args: unknown[]) => void;
-        log: (message: string, ...args: unknown[]) => void;
-        info: (message: string, ...args: unknown[]) => void;
-        warn: (message: string, ...args: unknown[]) => void;
-        error: (message: string, ...args: unknown[]) => void;
-    };
-    protected config: MultiAgentConfig;
-    protected orchestrator: MultiAgentOrchestrator;
-    protected processManager: AgentProcessManager;
-    protected sharedContext: SharedContextManager;
-    protected messageQueue: AgentMessageQueue;
-    protected backgroundTaskManager: BackgroundTaskManager;
-    protected systemReminder: SystemReminderService;
-    protected delegationManager: DelegationManager;
-    protected workTracker: WorkTracker;
-    protected gatewayToolExecutor: GatewayToolExecutor | null;
-    protected workflowEngine: WorkflowEngine;
-    protected councilEngine: CouncilEngine;
-    /** Whether multi-bot mode is initialized */
-    protected multiBotInitialized: boolean;
-    /** Dedup map for delegation mentions with timestamps (prevents double processing) */
-    protected processedMentions: Map<string, number>;
-    /** Cleanup interval handle for periodic tasks (queue expiry + mention dedup) */
-    private cleanupInterval;
-    /** TTL for processed mention entries (5 minutes) */
-    protected static get MENTION_TTL_MS(): number;
-    /** Cleanup interval period (1 minute) */
-    protected static get CLEANUP_INTERVAL_MS(): number;
-    /** Platform identifier for process manager calls */
-    protected abstract getPlatformName(): 'discord' | 'slack';
-    /** Platform-specific bold formatting */
-    abstract formatBold(text: string): string;
-    /** Platform-specific mention extraction from message content */
-    abstract extractMentionedAgentIds(content: string): string[];
-    /** Platform-specific cleanup called during stopAll() */
-    protected abstract platformCleanup(): Promise<void>;
-    /** Send a notification message to a channel (for background task status, queue expiry, etc.) */
-    protected abstract sendChannelNotification(channelId: string, message: string): Promise<void>;
-    constructor(config: MultiAgentConfig, processOptions?: Partial<PersistentProcessOptions>, runtimeOptions?: MultiAgentRuntimeOptions);
-    /**
-     * Setup idle event listeners for agent processes (F7)
-     */
-    protected setupIdleListeners(): void;
-    /**
-     * Try to drain queued messages immediately (when no idle process exists to trigger drain).
-     * Creates a new process if needed and drains if the process is idle.
-     */
-    protected tryDrainNow(agentId: string, source: string, channelId: string): Promise<void>;
-    /**
-     * Platform-specific queued response handler
-     */
-    protected abstract sendQueuedResponse(agentId: string, message: import('./agent-message-queue.js').QueuedMessage, response: string): Promise<void>;
-    /**
-     * Clean up old processed mention entries based on TTL
-     */
-    protected cleanupProcessedMentions(): void;
-    /**
-     * Check if multi-agent mode is enabled
-     */
-    isEnabled(): boolean;
-    /**
-     * Check if mention-based delegation is enabled
-     */
-    isMentionDelegationEnabled(): boolean;
-    /**
-     * Format agent response with display name prefix
-     */
-    protected formatAgentResponse(agent: AgentPersonaConfig, response: string): string;
-    /**
-     * Get orchestrator for direct access
-     */
-    getOrchestrator(): MultiAgentOrchestrator;
-    /**
-     * Get process manager for direct access
-     */
-    getProcessManager(): AgentProcessManager;
-    /**
-     * Get delegation manager for API access
-     */
-    getDelegationManager(): DelegationManager;
-    /**
-     * Get shared context manager
-     */
-    getSharedContext(): SharedContextManager;
-    getBackgroundTaskManager(): BackgroundTaskManager;
-    getSystemReminder(): SystemReminderService;
-    /**
-     * Get work tracker instance
-     */
-    getWorkTracker(): WorkTracker;
-    /**
-     * Set the gateway tool executor for handling tool_use blocks from agents.
-     */
-    setGatewayToolExecutor(executor: GatewayToolExecutor): void;
-    /**
-     * Parse ```tool_call blocks from response text (Gateway Tools mode).
-     * Returns array of parsed tool calls.
-     */
-    protected parseToolCallsFromText(text: string): Array<{
-        name: string;
-        input: Record<string, unknown>;
-    }>;
-    /**
-     * Remove ```tool_call blocks from text (to avoid showing raw JSON to users).
-     */
-    protected removeToolCallBlocks(text: string): string;
-    /**
-     * Parse and execute gateway tool calls from response text.
-     * Returns the cleaned text (with tool_call blocks removed).
-     * Tool calls are fire-and-forget (results not returned to Claude).
-     */
-    protected executeTextToolCalls(responseText: string): Promise<string>;
-    /**
-     * Build agent availability status section for prompt injection.
-     * Shows busy/idle state and queue size for each agent except the current one.
-     */
-    protected buildAgentStatusSection(excludeAgentId: string): string;
-    /**
-     * Get workflow engine instance
-     */
-    getWorkflowEngine(): WorkflowEngine;
-    /**
-     * Check if a Conductor response contains a workflow plan and execute it.
-     * Returns the workflow result or null if no plan was found.
-     */
-    tryExecuteWorkflow(conductorResponse: string, channelId: string, source: 'discord' | 'slack', onProgress?: (event: WorkflowProgressEvent) => void, createStepCallbacks?: (agentId: string) => {
-        callbacks: PromptCallbacks;
-        cleanup: () => Promise<void>;
-    }): Promise<{
-        result: string;
-        directMessage: string;
-        failed?: string;
-    } | null>;
-    /**
-     * Get council engine instance
-     */
-    getCouncilEngine(): CouncilEngine;
-    /**
-     * Check if a Conductor response contains a council_plan and execute it.
-     * Returns the council result or null if no plan was found.
-     */
-    tryExecuteCouncil(conductorResponse: string, channelId: string, source: 'discord' | 'slack', onProgress?: (event: CouncilProgressEvent) => void): Promise<{
-        result: string;
-        directMessage: string;
-    } | null>;
-    /**
-     * Format ephemeral agent response with workflow prefix
-     */
-    protected formatEphemeralAgentResponse(agentDisplayName: string, content: string): string;
-    /**
-     * Get chain state for a channel (for debugging)
-     */
-    getChainState(channelId: string): ChainState;
-    /**
-     * Stop all agent processes and bots
-     */
-    stopAll(): Promise<void>;
-}
-//# sourceMappingURL=multi-agent-base.d.ts.map

package/dist/multi-agent/multi-agent-base.d.ts.map

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