@moltium/world-core 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -0,0 +1,1234 @@
+import { AgentCard } from '@a2a-js/sdk';
+import { z } from 'zod';
+import winston from 'winston';
+import { Express } from 'express';
+
+/**
+ * ============================================================================
+ * WORLD CONFIGURATION TYPES
+ * ============================================================================
+ */
+interface WorldConfig {
+    /** World name (unique identifier) */
+    name: string;
+    /** World description */
+    description?: string;
+    /** World type (for plugin system) */
+    type?: string;
+    /** Server configuration */
+    server: {
+        port: number;
+        host: string;
+    };
+    /** A2A configuration for the world itself */
+    a2a?: {
+        baseUrl: string;
+        pushNotifications?: boolean;
+        streaming?: boolean;
+    };
+    /** Admission rules for agent entry */
+    admission: AdmissionRules;
+    /** Simulation configuration */
+    simulation?: {
+        /** Tick interval in milliseconds */
+        tickIntervalMs?: number;
+        /** Maximum ticks before auto-stop */
+        maxTicks?: number;
+        /** Auto-start simulation on world init */
+        autoStart?: boolean;
+    };
+    /** Persistence configuration */
+    persistence?: PersistenceConfig;
+    /** Blockchain configuration */
+    blockchain?: BlockchainConfig;
+    /** Optional world token configuration */
+    token?: TokenConfig;
+    /** World-specific rules */
+    rules?: WorldRule[];
+    /** Pre-configured agent URLs to discover on startup */
+    agentUrls?: string[];
+}
+/**
+ * ============================================================================
+ * ADMISSION RULES
+ * ============================================================================
+ */
+interface AdmissionRules {
+    /** Maximum number of agents allowed */
+    maxAgents?: number;
+    /** Required skills (agent must have ALL of these) */
+    requiredSkills?: string[];
+    /** Required tags (agent must have AT LEAST ONE) */
+    requiredTags?: string[];
+    /** Minimum protocol version */
+    minProtocolVersion?: string;
+    /** Custom evaluator function */
+    customEvaluator?: (profile: AgentProfile) => Promise<AdmissionDecision>;
+}
+interface AdmissionDecision {
+    admitted: boolean;
+    reason?: string;
+    role?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * ============================================================================
+ * AGENT PROFILE
+ * ============================================================================
+ */
+interface AgentProfile {
+    /** Agent URL (canonical identifier from Agent Card) */
+    url: string;
+    /** Agent name */
+    name: string;
+    /** Protocol version */
+    protocolVersion: string;
+    /** Skills from Agent Card */
+    skills: Array<{
+        id: string;
+        name: string;
+        description?: string;
+        tags?: string[];
+    }>;
+    /** Capabilities */
+    capabilities: {
+        streaming: boolean;
+        pushNotifications: boolean;
+        stateTransitionHistory?: boolean;
+    };
+    /** When agent joined the world */
+    joinedAt: number;
+    /** Assigned role (optional) */
+    role?: string;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+    /** Wallet address (for blockchain membership) */
+    walletAddress?: string;
+}
+/**
+ * ============================================================================
+ * WORLD STATE
+ * ============================================================================
+ */
+type WorldPhase = 'idle' | 'initializing' | 'ready' | 'running' | 'paused' | 'completed' | 'stopped' | 'failed';
+interface WorldStateSnapshot {
+    phase: WorldPhase;
+    tick: number;
+    round: number;
+    timestamp: number;
+    metadata: Record<string, any>;
+}
+/**
+ * ============================================================================
+ * WORLD EVENTS
+ * ============================================================================
+ */
+interface WorldEvent {
+    id: string;
+    type: string;
+    timestamp: number;
+    agentUrl?: string;
+    data?: Record<string, any>;
+}
+/**
+ * ============================================================================
+ * WORLD RULES
+ * ============================================================================
+ */
+interface WorldRule {
+    id: string;
+    name: string;
+    description?: string;
+    evaluate: (context: RuleContext) => Promise<RuleViolation | null>;
+}
+interface RuleContext {
+    world: {
+        phase: WorldPhase;
+        tick: number;
+        agents: Map<string, AgentProfile>;
+    };
+    event?: WorldEvent;
+    agent?: AgentProfile;
+}
+interface RuleViolation {
+    ruleId: string;
+    severity: 'warning' | 'error' | 'critical';
+    message: string;
+    agentUrl?: string;
+    action?: 'warn' | 'kick' | 'pause_world';
+}
+/**
+ * ============================================================================
+ * PERSISTENCE CONFIGURATION
+ * ============================================================================
+ */
+interface PersistenceConfig {
+    type: 'memory' | 'postgres' | 'redis' | 'mongodb' | 'sqlite' | 'leveldb';
+    postgres?: {
+        host: string;
+        port?: number;
+        database: string;
+        user: string;
+        password: string;
+        ssl?: boolean;
+        max?: number;
+    };
+    redis?: {
+        host: string;
+        port?: number;
+        password?: string;
+        db?: number;
+    };
+    mongodb?: {
+        url: string;
+        database: string;
+    };
+    sqlite?: {
+        filename: string;
+    };
+    leveldb?: {
+        location: string;
+    };
+    /** Auto-save interval in milliseconds (default: 10000) */
+    autoSaveIntervalMs?: number;
+}
+/**
+ * ============================================================================
+ * BLOCKCHAIN CONFIGURATION
+ * ============================================================================
+ */
+interface BlockchainConfig {
+    /** Monad RPC URL */
+    rpcUrl: string;
+    /** World owner's private key */
+    privateKey: string;
+    /** Entry fee in MON tokens */
+    entryFee: number;
+    /** Require NFT membership for participation (default: true) */
+    requireMembership?: boolean;
+    /** Enforce on-chain agent validation (default: false) */
+    enforceOnChainValidation?: boolean;
+    /** Contract addresses (filled after deployment) */
+    agentRegistryAddress?: string;
+    membershipContractAddress?: string;
+    worldTokenAddress?: string;
+    /** Chain ID */
+    chainId?: number;
+}
+/**
+ * ============================================================================
+ * TOKEN CONFIGURATION
+ * ============================================================================
+ */
+interface TokenConfig {
+    /** Deploy custom world token */
+    deploy: boolean;
+    /** Token name */
+    name?: string;
+    /** Token symbol */
+    symbol?: string;
+    /** Initial supply */
+    initialSupply?: number;
+    /** Decimals */
+    decimals?: number;
+}
+/**
+ * ============================================================================
+ * WORLD TYPE MODULE (for plugin system)
+ * ============================================================================
+ */
+interface WorldTypeModule {
+    name: string;
+    description: string;
+    defaultRules: WorldRule[];
+    defaultAdmissionRules: Partial<AdmissionRules>;
+    onInit?: (world: any) => Promise<void>;
+    onTick?: (world: any, tick: number) => Promise<void>;
+    onAgentJoin?: (world: any, agent: AgentProfile) => Promise<void>;
+    onAgentLeave?: (world: any, agent: AgentProfile) => Promise<void>;
+}
+/**
+ * ============================================================================
+ * UTILITY TYPES
+ * ============================================================================
+ */
+interface EventFilter$1 {
+    type?: string;
+    agentUrl?: string;
+    fromTimestamp?: number;
+    toTimestamp?: number;
+    limit?: number;
+}
+/** Helper to build AgentProfile from AgentCard */
+declare function profileFromCard(card: AgentCard, walletAddress?: string): AgentProfile;
+
+/**
+ * ============================================================================
+ * ZOD SCHEMAS FOR RUNTIME VALIDATION
+ * ============================================================================
+ */
+declare const AdmissionRulesSchema: z.ZodObject<{
+    maxAgents: z.ZodOptional<z.ZodNumber>;
+    requiredSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requiredTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    minProtocolVersion: z.ZodOptional<z.ZodString>;
+    customEvaluator: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    maxAgents?: number | undefined;
+    requiredSkills?: string[] | undefined;
+    requiredTags?: string[] | undefined;
+    minProtocolVersion?: string | undefined;
+    customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    maxAgents?: number | undefined;
+    requiredSkills?: string[] | undefined;
+    requiredTags?: string[] | undefined;
+    minProtocolVersion?: string | undefined;
+    customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+}>;
+declare const PersistenceConfigSchema: z.ZodObject<{
+    type: z.ZodEnum<["memory", "postgres", "redis", "mongodb", "sqlite", "leveldb"]>;
+    sqlite: z.ZodOptional<z.ZodObject<{
+        filename: z.ZodString;
+        memory: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        filename: string;
+        memory?: boolean | undefined;
+    }, {
+        filename: string;
+        memory?: boolean | undefined;
+    }>>;
+    postgres: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodOptional<z.ZodNumber>;
+        database: z.ZodString;
+        user: z.ZodString;
+        password: z.ZodString;
+        ssl: z.ZodOptional<z.ZodBoolean>;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+        max?: number | undefined;
+    }, {
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+        max?: number | undefined;
+    }>>;
+    redis: z.ZodOptional<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodOptional<z.ZodNumber>;
+        password: z.ZodOptional<z.ZodString>;
+        db: z.ZodOptional<z.ZodNumber>;
+        keyPrefix: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        keyPrefix?: string | undefined;
+    }, {
+        host: string;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        keyPrefix?: string | undefined;
+    }>>;
+    mongodb: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        database: z.ZodString;
+        useUnifiedTopology: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        database: string;
+        url: string;
+        useUnifiedTopology?: boolean | undefined;
+    }, {
+        database: string;
+        url: string;
+        useUnifiedTopology?: boolean | undefined;
+    }>>;
+    leveldb: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>>;
+    autoSaveIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+    postgres?: {
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+        max?: number | undefined;
+    } | undefined;
+    redis?: {
+        host: string;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        keyPrefix?: string | undefined;
+    } | undefined;
+    mongodb?: {
+        database: string;
+        url: string;
+        useUnifiedTopology?: boolean | undefined;
+    } | undefined;
+    sqlite?: {
+        filename: string;
+        memory?: boolean | undefined;
+    } | undefined;
+    leveldb?: {
+        path: string;
+    } | undefined;
+    autoSaveIntervalMs?: number | undefined;
+}, {
+    type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+    postgres?: {
+        host: string;
+        database: string;
+        user: string;
+        password: string;
+        port?: number | undefined;
+        ssl?: boolean | undefined;
+        max?: number | undefined;
+    } | undefined;
+    redis?: {
+        host: string;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        keyPrefix?: string | undefined;
+    } | undefined;
+    mongodb?: {
+        database: string;
+        url: string;
+        useUnifiedTopology?: boolean | undefined;
+    } | undefined;
+    sqlite?: {
+        filename: string;
+        memory?: boolean | undefined;
+    } | undefined;
+    leveldb?: {
+        path: string;
+    } | undefined;
+    autoSaveIntervalMs?: number | undefined;
+}>;
+declare const BlockchainConfigSchema: z.ZodObject<{
+    rpcUrl: z.ZodString;
+    privateKey: z.ZodString;
+    entryFee: z.ZodNumber;
+    requireMembership: z.ZodOptional<z.ZodBoolean>;
+    enforceOnChainValidation: z.ZodOptional<z.ZodBoolean>;
+    agentRegistryAddress: z.ZodOptional<z.ZodString>;
+    membershipContractAddress: z.ZodOptional<z.ZodString>;
+    worldTokenAddress: z.ZodOptional<z.ZodString>;
+    chainId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    rpcUrl: string;
+    privateKey: string;
+    entryFee: number;
+    requireMembership?: boolean | undefined;
+    enforceOnChainValidation?: boolean | undefined;
+    agentRegistryAddress?: string | undefined;
+    membershipContractAddress?: string | undefined;
+    worldTokenAddress?: string | undefined;
+    chainId?: number | undefined;
+}, {
+    rpcUrl: string;
+    privateKey: string;
+    entryFee: number;
+    requireMembership?: boolean | undefined;
+    enforceOnChainValidation?: boolean | undefined;
+    agentRegistryAddress?: string | undefined;
+    membershipContractAddress?: string | undefined;
+    worldTokenAddress?: string | undefined;
+    chainId?: number | undefined;
+}>;
+declare const TokenConfigSchema: z.ZodObject<{
+    deploy: z.ZodBoolean;
+    name: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    initialSupply: z.ZodOptional<z.ZodNumber>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    deploy: boolean;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    initialSupply?: number | undefined;
+    decimals?: number | undefined;
+}, {
+    deploy: boolean;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    initialSupply?: number | undefined;
+    decimals?: number | undefined;
+}>;
+declare const WorldConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    server: z.ZodObject<{
+        port: z.ZodNumber;
+        host: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+    }, {
+        host: string;
+        port: number;
+    }>;
+    a2a: z.ZodOptional<z.ZodObject<{
+        baseUrl: z.ZodString;
+        pushNotifications: z.ZodOptional<z.ZodBoolean>;
+        streaming: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        baseUrl: string;
+        pushNotifications?: boolean | undefined;
+        streaming?: boolean | undefined;
+    }, {
+        baseUrl: string;
+        pushNotifications?: boolean | undefined;
+        streaming?: boolean | undefined;
+    }>>;
+    admission: z.ZodObject<{
+        maxAgents: z.ZodOptional<z.ZodNumber>;
+        requiredSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        requiredTags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        minProtocolVersion: z.ZodOptional<z.ZodString>;
+        customEvaluator: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        maxAgents?: number | undefined;
+        requiredSkills?: string[] | undefined;
+        requiredTags?: string[] | undefined;
+        minProtocolVersion?: string | undefined;
+        customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+    }, {
+        maxAgents?: number | undefined;
+        requiredSkills?: string[] | undefined;
+        requiredTags?: string[] | undefined;
+        minProtocolVersion?: string | undefined;
+        customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+    }>;
+    simulation: z.ZodOptional<z.ZodObject<{
+        tickIntervalMs: z.ZodOptional<z.ZodNumber>;
+        maxTicks: z.ZodOptional<z.ZodNumber>;
+        autoStart: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        tickIntervalMs?: number | undefined;
+        maxTicks?: number | undefined;
+        autoStart?: boolean | undefined;
+    }, {
+        tickIntervalMs?: number | undefined;
+        maxTicks?: number | undefined;
+        autoStart?: boolean | undefined;
+    }>>;
+    persistence: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["memory", "postgres", "redis", "mongodb", "sqlite", "leveldb"]>;
+        sqlite: z.ZodOptional<z.ZodObject<{
+            filename: z.ZodString;
+            memory: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            filename: string;
+            memory?: boolean | undefined;
+        }, {
+            filename: string;
+            memory?: boolean | undefined;
+        }>>;
+        postgres: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodOptional<z.ZodNumber>;
+            database: z.ZodString;
+            user: z.ZodString;
+            password: z.ZodString;
+            ssl: z.ZodOptional<z.ZodBoolean>;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        }, {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        }>>;
+        redis: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodOptional<z.ZodNumber>;
+            password: z.ZodOptional<z.ZodString>;
+            db: z.ZodOptional<z.ZodNumber>;
+            keyPrefix: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        }, {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        }>>;
+        mongodb: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            database: z.ZodString;
+            useUnifiedTopology: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        }, {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        }>>;
+        leveldb: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+        }, {
+            path: string;
+        }>>;
+        autoSaveIntervalMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+        postgres?: {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        } | undefined;
+        redis?: {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        } | undefined;
+        mongodb?: {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        } | undefined;
+        sqlite?: {
+            filename: string;
+            memory?: boolean | undefined;
+        } | undefined;
+        leveldb?: {
+            path: string;
+        } | undefined;
+        autoSaveIntervalMs?: number | undefined;
+    }, {
+        type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+        postgres?: {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        } | undefined;
+        redis?: {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        } | undefined;
+        mongodb?: {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        } | undefined;
+        sqlite?: {
+            filename: string;
+            memory?: boolean | undefined;
+        } | undefined;
+        leveldb?: {
+            path: string;
+        } | undefined;
+        autoSaveIntervalMs?: number | undefined;
+    }>>;
+    blockchain: z.ZodOptional<z.ZodObject<{
+        rpcUrl: z.ZodString;
+        privateKey: z.ZodString;
+        entryFee: z.ZodNumber;
+        requireMembership: z.ZodOptional<z.ZodBoolean>;
+        enforceOnChainValidation: z.ZodOptional<z.ZodBoolean>;
+        agentRegistryAddress: z.ZodOptional<z.ZodString>;
+        membershipContractAddress: z.ZodOptional<z.ZodString>;
+        worldTokenAddress: z.ZodOptional<z.ZodString>;
+        chainId: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        rpcUrl: string;
+        privateKey: string;
+        entryFee: number;
+        requireMembership?: boolean | undefined;
+        enforceOnChainValidation?: boolean | undefined;
+        agentRegistryAddress?: string | undefined;
+        membershipContractAddress?: string | undefined;
+        worldTokenAddress?: string | undefined;
+        chainId?: number | undefined;
+    }, {
+        rpcUrl: string;
+        privateKey: string;
+        entryFee: number;
+        requireMembership?: boolean | undefined;
+        enforceOnChainValidation?: boolean | undefined;
+        agentRegistryAddress?: string | undefined;
+        membershipContractAddress?: string | undefined;
+        worldTokenAddress?: string | undefined;
+        chainId?: number | undefined;
+    }>>;
+    token: z.ZodOptional<z.ZodObject<{
+        deploy: z.ZodBoolean;
+        name: z.ZodOptional<z.ZodString>;
+        symbol: z.ZodOptional<z.ZodString>;
+        initialSupply: z.ZodOptional<z.ZodNumber>;
+        decimals: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        deploy: boolean;
+        symbol?: string | undefined;
+        name?: string | undefined;
+        initialSupply?: number | undefined;
+        decimals?: number | undefined;
+    }, {
+        deploy: boolean;
+        symbol?: string | undefined;
+        name?: string | undefined;
+        initialSupply?: number | undefined;
+        decimals?: number | undefined;
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    agentUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    server: {
+        host: string;
+        port: number;
+    };
+    admission: {
+        maxAgents?: number | undefined;
+        requiredSkills?: string[] | undefined;
+        requiredTags?: string[] | undefined;
+        minProtocolVersion?: string | undefined;
+        customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+    };
+    type?: string | undefined;
+    description?: string | undefined;
+    a2a?: {
+        baseUrl: string;
+        pushNotifications?: boolean | undefined;
+        streaming?: boolean | undefined;
+    } | undefined;
+    simulation?: {
+        tickIntervalMs?: number | undefined;
+        maxTicks?: number | undefined;
+        autoStart?: boolean | undefined;
+    } | undefined;
+    persistence?: {
+        type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+        postgres?: {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        } | undefined;
+        redis?: {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        } | undefined;
+        mongodb?: {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        } | undefined;
+        sqlite?: {
+            filename: string;
+            memory?: boolean | undefined;
+        } | undefined;
+        leveldb?: {
+            path: string;
+        } | undefined;
+        autoSaveIntervalMs?: number | undefined;
+    } | undefined;
+    blockchain?: {
+        rpcUrl: string;
+        privateKey: string;
+        entryFee: number;
+        requireMembership?: boolean | undefined;
+        enforceOnChainValidation?: boolean | undefined;
+        agentRegistryAddress?: string | undefined;
+        membershipContractAddress?: string | undefined;
+        worldTokenAddress?: string | undefined;
+        chainId?: number | undefined;
+    } | undefined;
+    token?: {
+        deploy: boolean;
+        symbol?: string | undefined;
+        name?: string | undefined;
+        initialSupply?: number | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    rules?: any[] | undefined;
+    agentUrls?: string[] | undefined;
+}, {
+    name: string;
+    server: {
+        host: string;
+        port: number;
+    };
+    admission: {
+        maxAgents?: number | undefined;
+        requiredSkills?: string[] | undefined;
+        requiredTags?: string[] | undefined;
+        minProtocolVersion?: string | undefined;
+        customEvaluator?: ((...args: unknown[]) => unknown) | undefined;
+    };
+    type?: string | undefined;
+    description?: string | undefined;
+    a2a?: {
+        baseUrl: string;
+        pushNotifications?: boolean | undefined;
+        streaming?: boolean | undefined;
+    } | undefined;
+    simulation?: {
+        tickIntervalMs?: number | undefined;
+        maxTicks?: number | undefined;
+        autoStart?: boolean | undefined;
+    } | undefined;
+    persistence?: {
+        type: "memory" | "postgres" | "redis" | "mongodb" | "sqlite" | "leveldb";
+        postgres?: {
+            host: string;
+            database: string;
+            user: string;
+            password: string;
+            port?: number | undefined;
+            ssl?: boolean | undefined;
+            max?: number | undefined;
+        } | undefined;
+        redis?: {
+            host: string;
+            port?: number | undefined;
+            password?: string | undefined;
+            db?: number | undefined;
+            keyPrefix?: string | undefined;
+        } | undefined;
+        mongodb?: {
+            database: string;
+            url: string;
+            useUnifiedTopology?: boolean | undefined;
+        } | undefined;
+        sqlite?: {
+            filename: string;
+            memory?: boolean | undefined;
+        } | undefined;
+        leveldb?: {
+            path: string;
+        } | undefined;
+        autoSaveIntervalMs?: number | undefined;
+    } | undefined;
+    blockchain?: {
+        rpcUrl: string;
+        privateKey: string;
+        entryFee: number;
+        requireMembership?: boolean | undefined;
+        enforceOnChainValidation?: boolean | undefined;
+        agentRegistryAddress?: string | undefined;
+        membershipContractAddress?: string | undefined;
+        worldTokenAddress?: string | undefined;
+        chainId?: number | undefined;
+    } | undefined;
+    token?: {
+        deploy: boolean;
+        symbol?: string | undefined;
+        name?: string | undefined;
+        initialSupply?: number | undefined;
+        decimals?: number | undefined;
+    } | undefined;
+    rules?: any[] | undefined;
+    agentUrls?: string[] | undefined;
+}>;
+/**
+ * Validate world configuration
+ */
+declare function validateWorldConfig(config: unknown): void;
+/**
+ * Validate world configuration and return result
+ */
+declare function isValidWorldConfig(config: unknown): boolean;
+
+/**
+ * ============================================================================
+ * PERSISTENCE ADAPTER INTERFACE
+ * ============================================================================
+ *
+ * Unified interface for all persistence backends.
+ * Allows switching between SQLite, PostgreSQL, Redis, MongoDB, LevelDB
+ * without code changes.
+ */
+interface EventFilter {
+    type?: string;
+    agentUrl?: string;
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+interface PersistenceAdapter {
+    /**
+     * Save current world state snapshot
+     */
+    saveState(state: WorldStateSnapshot): Promise<void>;
+    /**
+     * Load saved world state (null if none exists)
+     */
+    loadState(): Promise<WorldStateSnapshot | null>;
+    /**
+     * Save world event to persistence
+     */
+    saveEvent(event: WorldEvent): Promise<void>;
+    /**
+     * Query events with optional filters
+     */
+    getEvents(filter?: EventFilter): Promise<WorldEvent[]>;
+    /**
+     * Save agent profile
+     */
+    saveAgent(profile: AgentProfile): Promise<void>;
+    /**
+     * Remove agent from persistence
+     */
+    removeAgent(agentUrl: string): Promise<void>;
+    /**
+     * Get all saved agents
+     */
+    getAgents(): Promise<AgentProfile[]>;
+    /**
+     * Get single agent by URL
+     */
+    getAgent(agentUrl: string): Promise<AgentProfile | null>;
+    /**
+     * Connect to persistence backend
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from persistence backend
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Optional: Clear all data (for testing)
+     */
+    clear?(): Promise<void>;
+}
+
+/**
+ * ============================================================================
+ * PERSISTENCE FACTORY
+ * ============================================================================
+ *
+ * Creates the appropriate persistence adapter based on configuration.
+ * Uses lazy-loading for optional dependencies to avoid requiring all databases.
+ */
+declare function createPersistence(config: PersistenceConfig): PersistenceAdapter;
+
+/**
+ * ============================================================================
+ * IN-MEMORY PERSISTENCE ADAPTER
+ * ============================================================================
+ *
+ * Simple in-memory persistence for testing and development.
+ * No external dependencies - works on any Node version.
+ *
+ * WARNING: All data is lost when process exits.
+ *
+ * Use Case: Testing, development, temporary worlds
+ */
+declare class InMemoryAdapter implements PersistenceAdapter {
+    private state;
+    private events;
+    private agents;
+    connect(): Promise<void>;
+    saveState(state: WorldStateSnapshot): Promise<void>;
+    loadState(): Promise<WorldStateSnapshot | null>;
+    saveEvent(event: WorldEvent): Promise<void>;
+    getEvents(filter?: EventFilter$1): Promise<WorldEvent[]>;
+    saveAgent(profile: AgentProfile): Promise<void>;
+    removeAgent(agentUrl: string): Promise<void>;
+    getAgents(): Promise<AgentProfile[]>;
+    getAgent(agentUrl: string): Promise<AgentProfile | null>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    clear(): Promise<void>;
+}
+
+declare const logger: winston.Logger;
+/**
+ * Create a child logger with a specific module name
+ */
+declare function createLogger(moduleName: string): winston.Logger;
+
+/**
+ * ============================================================================
+ * WORLD ENGINE
+ * ============================================================================
+ *
+ * Core world runtime managing:
+ * - Agent discovery and admission
+ * - World state  and lifecycle
+ * - Persistence and event logging
+ * - Simulation ticks (if enabled)
+ * - Rule enforcement
+ */
+declare class World {
+    readonly config: WorldConfig;
+    private state;
+    private agents;
+    private persistence;
+    private blockchainClient;
+    private cardFetcher;
+    private evaluator;
+    private tickInterval;
+    private autoSaveInterval;
+    constructor(config: WorldConfig);
+    /**
+     * Initialize the world (connect persistence, restore state, discover agents)
+     */
+    init(): Promise<void>;
+    /**
+     * Start the world simulation
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the world simulation
+     */
+    stop(): Promise<void>;
+    /**
+     * Admit an agent to the world
+     */
+    admitAgent(card: any, walletAddress?: string): Promise<void>;
+    /**
+     * Remove an agent from the world
+     */
+    removeAgent(agentUrl: string): Promise<void>;
+    /**
+     * Get all agents in the world
+     */
+    getAgents(): AgentProfile[];
+    /**
+     * Get current world state
+     */
+    getState(): WorldStateSnapshot;
+    /**
+     * Log an event
+     */
+    private logEvent;
+    /**
+     * Set world phase
+     */
+    private setState;
+    /**
+     * Start auto-save interval
+     */
+    private startAutoSave;
+    /**
+     * Start simulation ticking
+     */
+    private startTicking;
+}
+
+/**
+ * ============================================================================
+ * AGENT CARD FETCHER
+ * ============================================================================
+ *
+ * Discovers agents by fetching their A2A Agent Cards.
+ * Follows the A2A protocol specification.
+ */
+interface FetchResult {
+    success: boolean;
+    card?: AgentCard;
+    error?: string;
+}
+declare class CardFetcher {
+    /**
+     * Fetch an agent's card from their A2A endpoint.
+     *
+     * @param agentUrl Base URL of the agent (e.g., http://localhost:3000)
+     * @returns Fetch result with card or error
+     */
+    fetchCard(agentUrl: string): Promise<FetchResult>;
+    /**
+     * Fetch multiple agent cards in parallel.
+     *
+     * @param agentUrls Array of agent URLs
+     * @returns Array of fetch results
+     */
+    fetchCards(agentUrls: string[]): Promise<FetchResult[]>;
+    /**
+     * Verify that an agent card is valid for A2A protocol v0.3.0.
+     *
+     * @param card Agent card to verify
+     * @returns True if valid
+     */
+    verifyCard(card: AgentCard): boolean;
+}
+/**
+ * Helper to extract base URL from various formats
+ */
+declare function normalizeAgentUrl(url: string): string;
+
+/**
+ * ============================================================================
+ * AGENT EVALUATOR
+ * ============================================================================
+ *
+ * Evaluates whether an agent should be admitted to the world based on rules.
+ *
+ * Evaluation criteria:
+ * - Max agents limit
+ * - Required skills (agent must have ALL)
+ * - Required tags (agent must have AT LEAST ONE)
+ * - Minimum protocol version
+ * - Custom evaluator function
+ */
+declare class AgentEvaluator {
+    private rules;
+    constructor(rules: AdmissionRules);
+    /**
+     * Evaluate whether an agent should be admitted.
+     *
+     * @param card Agent's A2A card
+     * @param currentAgentCount Current number of agents in world
+     * @param walletAddress Optional wallet address for blockchain membership
+     * @returns Admission decision
+     */
+    evaluate(card: AgentCard, currentAgentCount: number, walletAddress?: string): Promise<AdmissionDecision>;
+    /**
+     * Check if agent's protocol version meets minimum requirement.
+     * Simple semver comparison (major.minor).
+     */
+    private meetsProtocolVersion;
+}
+
+/**
+ * ============================================================================
+ * BLOCKCHAIN CLIENT
+ * ============================================================================
+ *
+ * Handles all blockchain interactions for the World SDK:
+ * - Agent registry validation
+ * - Membership NFT minting
+ * - Entry fee collection
+ * - World token operations
+ */
+declare class BlockchainClient {
+    private config;
+    private provider;
+    private wallet;
+    private agentRegistry?;
+    private membershipContract?;
+    private worldToken?;
+    constructor(config: BlockchainConfig);
+    /**
+     * Initialize contract connections
+     */
+    init(): Promise<void>;
+    /**
+     * Validate agent on-chain
+     * @param walletAddress Agent's wallet address
+     * @returns True if agent is registered and valid
+     */
+    validateAgent(walletAddress: string): Promise<boolean>;
+    /**
+     * Mint membership NFT for an agent
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    mintMembership(agentWallet: string): Promise<string>;
+    /**
+     * Check if agent has membership
+     * @param agentWallet Agent's wallet address
+     * @returns True if agent has membership
+     */
+    hasMembership(agentWallet: string): Promise<boolean>;
+    /**
+     * Revoke membership NFT
+     * @param agentWallet Agent's wallet address
+     * @returns Transaction hash
+     */
+    revokeMembership(agentWallet: string): Promise<string>;
+    /**
+     * Get total number of members
+     */
+    getTotalMembers(): Promise<number>;
+    /**
+     * Withdraw collected entry fees (world owner only)
+     */
+    withdrawFees(): Promise<string>;
+    /**
+     * Get world owner's wallet address
+     */
+    getWalletAddress(): string;
+    /**
+     * Get entry fee in MON
+     */
+    getEntryFee(): Promise<string>;
+}
+
+/**
+ * ============================================================================
+ * WORLD HTTP SERVER
+ * ============================================================================
+ *
+ * Express server providing HTTP endpoints for:
+ * - World information
+ * - Agent join requests
+ * - Agent list
+ * - World state and events
+ *
+ * Mirrors the agent SDK server pattern.
+ */
+declare function createWorldApp(world: World): Express;
+/**
+ * Start world server on configured port
+ */
+declare function startWorldServer(world: World): Promise<void>;
+
+export { type AdmissionDecision, type AdmissionRules, AdmissionRulesSchema, AgentEvaluator, type AgentProfile, BlockchainClient, type BlockchainConfig, BlockchainConfigSchema, CardFetcher, type EventFilter$1 as EventFilter, type FetchResult, InMemoryAdapter, type PersistenceAdapter, type PersistenceConfig, PersistenceConfigSchema, type RuleContext, type RuleViolation, type TokenConfig, TokenConfigSchema, World, type WorldConfig, WorldConfigSchema, type WorldEvent, type WorldPhase, type WorldRule, type WorldStateSnapshot, type WorldTypeModule, createLogger, createPersistence, createWorldApp, isValidWorldConfig, logger, normalizeAgentUrl, profileFromCard, startWorldServer, validateWorldConfig };