Interface IGMI

IGMI

Description

Defines the contract for a Generalized Mind Instance (GMI).

interface IGMI {
    gmiId: string;
    creationTimestamp: Date;
    initialize(persona, config): Promise<void>;
    getPersona(): IPersonaDefinition;
    getCurrentPrimaryPersonaId(): string;
    getGMIId(): string;
    getCurrentState(): GMIPrimeState;
    processTurnStream(turnInput): AsyncGenerator<GMIOutputChunk, GMIOutput, undefined>;
    handleToolResult(toolCallId, toolName, resultPayload, userId, userApiKeys?): Promise<GMIOutput>;
    getReasoningTrace(): Readonly<ReasoningTrace>;
    _triggerAndProcessSelfReflection(): Promise<void>;
    onMemoryLifecycleEvent(event): Promise<LifecycleActionResponse>;
    analyzeAndReportMemoryHealth(): Promise<undefined | {
        overallStatus: "DEGRADED" | "ERROR" | "OPERATIONAL" | "LIMITED";
        workingMemoryStats?: {
            itemCount: number;
            [key: string]: any;
        };
        ragSystemStats?: {
            isHealthy: boolean;
            details?: any;
        };
        lifecycleManagerStats?: {
            isHealthy: boolean;
            details?: any;
        };
        issues?: {
            severity: "critical" | "warning" | "info";
            description: string;
            component: string;
            details?: any;
        }[];
    }>;
    getOverallHealth(): Promise<GMIHealthReport>;
    shutdown(): Promise<void>;
}

Methods

  • Returns Promise<undefined | {
        overallStatus: "DEGRADED" | "ERROR" | "OPERATIONAL" | "LIMITED";
        workingMemoryStats?: {
            itemCount: number;
            [key: string]: any;
        };
        ragSystemStats?: {
            isHealthy: boolean;
            details?: any;
        };
        lifecycleManagerStats?: {
            isHealthy: boolean;
            details?: any;
        };
        issues?: {
            severity: "critical" | "warning" | "info";
            description: string;
            component: string;
            details?: any;
        }[];
    }>

Properties

gmiId: string
creationTimestamp: Date