@holoscript/framework 6.0.3 → 6.0.4

package/dist/agents/index.d.ts

@@ -1,1788 +0,0 @@
-export { a as AgentCapability, c as AgentCategory, d as AgentConfig, e as AgentEndpoint, f as AgentLifespanContext, A as AgentManifest, g as AgentManifestBuilder, h as AgentMessage, i as AgentPhase, j as AgentPosition, k as AgentResponse, l as AgentSection, m as AgentState, n as AgentTraitContext, o as AgentValidationResult, p as AnyPhaseResult, q as ArchitectureAwareness, r as AssistantLifespanContext, B as BoundingBox, s as BudgetConfig, b as CapabilityDomain, C as CapabilityType, t as CompressResult, u as CuriosityConfig, v as CycleMetric, w as CycleResult, D as DEFAULT_PHASE_TIMINGS, E as EndpointProtocol, x as EvolveResult, y as ExecuteResult, G as GotchaEntry, z as GrowResult, I as IntakeResult, F as LATENCY_THRESHOLDS, L as LatencyProfile, M as MessagePriority, P as PHASE_ORDER, H as PatternEntry, J as PhaseConfig, K as PhaseResult, R as ReflectResult, N as ReintakeResult, O as ResourceCost, S as SpatialScope, T as TrustLevel, V as Vector3, Q as VerificationStatus, W as WisdomEntry, U as createAgentManifest, X as validateManifest } from '../AgentManifest-CB4xM-Ma.js';
-export { A as A2AAgentCard, a as A2ASkill, b as A2ATransportAdapter, c as AgentMatch, d as AgentRegistry, R as AgentRegistryConfig, C as CapabilityMatch, e as CapabilityMatcher, f as CapabilityQuery, D as DEFAULT_REGISTRY_CONFIG, g as DelegationRequest, h as DelegationResult, i as DelegationTraceEvent, j as DelegationTracePhase, k as DiscoveryMode, F as FederatedRegistryAdapter, l as FederatedRegistryConfig, O as OrchestratorAgent, m as OrchestratorConfig, P as ProgressCallback, n as RegistryEvents, S as SkillExecutor, o as SkillWorkflowEngine, p as SpatialQuery, T as TaskDelegationConfig, q as TaskDelegationService, W as WorkflowDefinition, r as WorkflowInput, s as WorkflowResult, t as WorkflowStep, u as WorkflowStepResult, v as WorkflowValidation, w as defaultMatcher, x as findAgents, y as findBestAgent, z as getDefaultRegistry, B as resetDefaultRegistry } from '../OrchestratorAgent-Q_CbVTmO.js';
-import { CulturalNorm, NormEnforcement } from '@holoscript/core';
-export { CulturalNorm, NormCategory, NormEnforcement, NormScope } from '@holoscript/core';
-import { EventEmitter } from 'events';
-import '../implementations-D9T3un9D.js';
-
-/**
- * @fileoverview Agent Wallet Registry
- * @module @holoscript/core
- *
- * PURPOSE:
- * Bridges autonomous agents spawned via uaa2-service with Base L2 wallets.
- * Allows agents to securely hold funds and autonomously purchase logic traits
- * on the HoloScript marketplace. Signing is delegated to a Web3Connector
- * implementation (see @holoscript/marketplace-api for the viem-based connector).
- */
-interface AgentWallet {
-    agentId: string;
-    walletAddress: string;
-    networkId: number;
-    balanceThreshold: number;
-}
-declare class AgentWalletRegistry {
-    private static instance;
-    private wallets;
-    private constructor();
-    static getInstance(): AgentWalletRegistry;
-    /**
-     * Registers a new agent wallet mapping
-     */
-    registerWallet(agentId: string, walletAddress: string, networkId?: number): AgentWallet;
-    /**
-     * Retrieves an agent's registered wallet
-     */
-    getWallet(agentId: string): AgentWallet | undefined;
-    /**
-     * Removes an agent's wallet from the registry
-     */
-    unregisterWallet(agentId: string): boolean;
-    /**
-     * Authorizes an agent transaction using EIP-712 signature fallback
-     * (Placeholder for Coinbase AgentKit KMS signing)
-     */
-    authorizeTransaction(agentId: string, payload: unknown): Promise<string>;
-}
-
-/**
- * @fileoverview Authenticated CRDTs — DID-Signed Conflict-Free State Sync
- * @module @holoscript/core/agents
- *
- * CRDTs (Conflict-free Replicated Data Types) for cross-device agent state.
- * Every operation is DID-signed, enabling trustworthy decentralized sync.
- *
- * Merge functions reject untrusted, revoked, or out-of-scope operations.
- * Overhead: ~0.1ms per merge operation.
- *
- * Implements:
- * - LWW-Register: Last-Writer-Wins for atomic values
- * - G-Counter: Grow-only counter for monotonic metrics
- * - OR-Set: Observed-Remove set for collections
- *
- * @version 1.0.0
- */
-/** A DID (Decentralized Identifier) for agent identity */
-interface DID {
-    /** The DID string (e.g., "did:key:z6Mk...") */
-    id: string;
-    /** Device ID that generated this signature */
-    deviceId: string;
-    /** Capability scope (what this DID is allowed to modify) */
-    scope: string[];
-    /** Whether this DID has been revoked */
-    revoked: boolean;
-}
-/** A signed operation */
-interface SignedOperation<T> {
-    /** The operation payload */
-    payload: T;
-    /** Signer DID */
-    signer: DID;
-    /** Timestamp (Lamport logical clock) */
-    timestamp: number;
-    /** Signature hash (hex string) */
-    signature: string;
-    /** Scope tag for capability checking */
-    scopeTag: string;
-}
-/**
- * Sign an operation with a DID.
- */
-declare function signOperation<T>(payload: T, signer: DID, scopeTag: string, timestamp: number): SignedOperation<T>;
-/**
- * Verify a signed operation: check non-revoked and scope.
- */
-declare function verifyOperation<T>(op: SignedOperation<T>): {
-    valid: boolean;
-    reason?: string;
-};
-/** A last-writer-wins register for a single value */
-declare class LWWRegister<T> {
-    private value;
-    private timestamp;
-    private lastSigner;
-    private history;
-    constructor(initialValue: T);
-    /** Get current value */
-    get(): T;
-    /** Get last write timestamp */
-    getTimestamp(): number;
-    /** Set value with a signed operation */
-    set(op: SignedOperation<T>): {
-        accepted: boolean;
-        reason?: string;
-    };
-    /** Merge with another register (LWW semantics) */
-    merge(other: LWWRegister<T>): void;
-    /** Get operation history */
-    getHistory(): SignedOperation<T>[];
-}
-/** A grow-only counter (each node can only increment) */
-declare class GCounter {
-    private counts;
-    /** Increment for a specific node */
-    increment(nodeId: string, amount?: number): void;
-    /** Get the total value */
-    value(): number;
-    /** Get the count for a specific node */
-    nodeValue(nodeId: string): number;
-    /** Merge with another counter (take max per node) */
-    merge(other: GCounter): void;
-    /** Export state */
-    toJSON(): Record<string, number>;
-    /** Import state */
-    static fromJSON(data: Record<string, number>): GCounter;
-}
-/** An observed-remove set: concurrent adds always win over removes */
-declare class ORSet<T> {
-    private elements;
-    private tombstones;
-    private tagCounter;
-    /** Add an element with a signed operation */
-    add(value: T, signer: DID, timestamp: number): string;
-    /** Remove an element by value (removes all copies) */
-    remove(value: T, _signer: DID): number;
-    /** Check if the set contains a value */
-    has(value: T): boolean;
-    /** Get all current values (deduplicated) */
-    values(): T[];
-    /** Size of the set (unique values) */
-    get size(): number;
-    /** Merge with another OR-Set (adds win over concurrent removes) */
-    merge(other: ORSet<T>): void;
-    private valueEquals;
-}
-/** A complete authenticated agent state document */
-interface AuthenticatedAgentState {
-    /** Agent DID */
-    agentDID: string;
-    /** State registers (key-value pairs) */
-    registers: Map<string, LWWRegister<unknown>>;
-    /** Counters */
-    counters: Map<string, GCounter>;
-    /** Sets */
-    sets: Map<string, ORSet<unknown>>;
-    /** Last sync timestamp */
-    lastSync: number;
-}
-/**
- * Create a new authenticated agent state.
- */
-declare function createAgentState(agentDID: string): AuthenticatedAgentState;
-/**
- * Set a register value with authentication.
- */
-declare function setRegister(state: AuthenticatedAgentState, key: string, value: unknown, signer: DID, timestamp: number): {
-    accepted: boolean;
-    reason?: string;
-};
-/**
- * Get a register value.
- */
-declare function getRegister<T>(state: AuthenticatedAgentState, key: string): T | undefined;
-/**
- * Increment a counter.
- */
-declare function incrementCounter(state: AuthenticatedAgentState, key: string, nodeId: string, amount?: number): void;
-/**
- * Get a counter value.
- */
-declare function getCounter(state: AuthenticatedAgentState, key: string): number;
-/**
- * Merge two agent states (CRDT merge — always converges).
- */
-declare function mergeStates(local: AuthenticatedAgentState, remote: AuthenticatedAgentState): void;
-
-/**
- * @fileoverview Cross-Reality Agent Handoff Protocol
- * @module @holoscript/core/agents
- *
- * Implements the Minimum Viable Continuity (MVC) handoff schema:
- * exactly 5 typed objects transferred during cross-device agent handoff.
- * Payload is <10KB. Full context is lazy-loaded after transition.
- *
- * The handoff protocol:
- * 1. Capability negotiation (source → target)
- * 2. MVC transfer (<10KB payload)
- * 3. Embodiment adaptation (Avatar3D ↔ VoiceHUD ↔ UI2D etc.)
- * 4. Lazy context loading (background)
- *
- * Geospatial coordinates (WGS84) are the universal spatial anchor.
- *
- * @version 1.0.0
- */
-type PlatformTarget = string;
-type PlatformCapabilities = {
-    spatialTracking?: boolean;
-    handTracking?: boolean;
-    eyeTracking?: boolean;
-    haptics?: boolean;
-    spatialAudio?: boolean;
-    gpu3D?: boolean;
-    arCamera?: boolean;
-    gps?: boolean;
-    npu?: boolean;
-    webxrSupport?: boolean;
-    [key: string]: boolean | undefined;
-};
-type EmbodimentType = 'Avatar3D' | 'VoiceHUD' | 'UI2D' | 'DataStream' | string;
-declare const PLATFORM_CAPABILITIES: Record<string, PlatformCapabilities>;
-declare const embodimentFor: (platform: PlatformTarget) => EmbodimentType;
-declare const platformCategory: (platform: PlatformTarget) => string;
-/** A decision the agent has made */
-interface DecisionEntry {
-    id: string;
-    /** What was decided */
-    action: string;
-    /** Why (reasoning trace) */
-    reasoning: string;
-    /** When (ISO timestamp) */
-    timestamp: string;
-    /** Confidence (0-1) */
-    confidence: number;
-    /** Outcome if known */
-    outcome?: 'success' | 'failure' | 'pending';
-}
-/** Active task state */
-interface TaskState {
-    /** Current task ID */
-    taskId: string;
-    /** Task description */
-    description: string;
-    /** Progress (0-1) */
-    progress: number;
-    /** Sub-tasks remaining */
-    subtasks: {
-        id: string;
-        label: string;
-        done: boolean;
-    }[];
-    /** Blocked on */
-    blockedOn?: string;
-    /** Priority */
-    priority: 'critical' | 'high' | 'medium' | 'low';
-}
-/** User preferences */
-interface UserPreferences {
-    /** Agent personality setting */
-    personality: 'professional' | 'casual' | 'minimal' | 'verbose';
-    /** Preferred interaction modality */
-    modality: 'voice' | 'text' | 'gesture' | 'gaze' | 'auto';
-    /** Language */
-    language: string;
-    /** Accessibility needs */
-    accessibility: {
-        highContrast?: boolean;
-        screenReader?: boolean;
-        reducedMotion?: boolean;
-    };
-    /** Custom key-value preferences */
-    custom: Record<string, string>;
-}
-/** Spatial context summary (WGS84 universal anchor) */
-interface SpatialContext {
-    /** WGS84 latitude */
-    latitude: number;
-    /** WGS84 longitude */
-    longitude: number;
-    /** Altitude in meters (WGS84 ellipsoid height) */
-    altitude: number;
-    /** Heading (degrees, 0=north) */
-    heading: number;
-    /** Indoor location hint (if available) */
-    indoor?: {
-        buildingId: string;
-        floor: number;
-        roomId?: string;
-    };
-    /** Spatial anchor IDs (platform-specific, for lazy resolution) */
-    anchorIds?: string[];
-    /** Timestamp of last spatial fix */
-    fixTimestamp: string;
-    /** Accuracy in meters */
-    accuracy: number;
-}
-/** Evidence trail entry */
-interface EvidenceEntry {
-    /** What was observed/received */
-    type: 'observation' | 'user_input' | 'api_response' | 'sensor_data' | 'agent_message';
-    /** Summary (keep brief for <10KB budget) */
-    summary: string;
-    /** Timestamp */
-    timestamp: string;
-    /** Source */
-    source: string;
-    /** Relevance score (0-1) */
-    relevance: number;
-}
-/**
- * Minimum Viable Continuity payload — the 5 typed objects.
- * Total serialized size MUST be <10KB.
- */
-interface MVCPayload {
-    /** Schema version */
-    version: '1.0';
-    /** Agent identity (DID) */
-    agentDID: string;
-    /** Session ID for continuity tracking */
-    sessionId: string;
-    /** 1. Decision history (last N decisions) */
-    decisions: DecisionEntry[];
-    /** 2. Active task state */
-    task: TaskState;
-    /** 3. User preferences */
-    preferences: UserPreferences;
-    /** 4. Spatial context (WGS84) */
-    spatial: SpatialContext;
-    /** 5. Evidence trail (most relevant entries) */
-    evidence: EvidenceEntry[];
-    /** Handoff metadata */
-    handoff: {
-        sourceDevice: string;
-        sourcePlatform: PlatformTarget;
-        sourceEmbodiment: EmbodimentType;
-        timestamp: string;
-    };
-}
-/** Device capabilities for handoff negotiation */
-interface DeviceCapabilities {
-    deviceId: string;
-    platform: PlatformTarget;
-    capabilities: PlatformCapabilities;
-    embodiment: EmbodimentType;
-    available: boolean;
-}
-/** Handoff negotiation result */
-interface HandoffNegotiation {
-    sourceDevice: DeviceCapabilities;
-    targetDevice: DeviceCapabilities;
-    /** Capabilities gained in transition */
-    gained: string[];
-    /** Capabilities lost in transition */
-    lost: string[];
-    /** Embodiment transition pair */
-    transition: {
-        from: EmbodimentType;
-        to: EmbodimentType;
-    };
-    /** Estimated transition latency (ms) */
-    estimatedLatencyMs: number;
-    /** Whether the handoff is feasible */
-    feasible: boolean;
-    /** Reason if not feasible */
-    reason?: string;
-}
-/**
- * Negotiate a handoff between two devices.
- */
-declare function negotiateHandoff(source: DeviceCapabilities, target: DeviceCapabilities): HandoffNegotiation;
-/**
- * Create an MVC payload for handoff.
- */
-declare function createMVCPayload(agentDID: string, sessionId: string, source: {
-    deviceId: string;
-    platform: PlatformTarget;
-}, data: {
-    decisions: DecisionEntry[];
-    task: TaskState;
-    preferences: UserPreferences;
-    spatial: SpatialContext;
-    evidence: EvidenceEntry[];
-}): MVCPayload;
-/**
- * Estimate the serialized size of an MVC payload in bytes.
- */
-declare function estimatePayloadSize(payload: MVCPayload): number;
-/**
- * Validate that an MVC payload is within the 10KB budget.
- */
-declare function validatePayloadBudget(payload: MVCPayload): {
-    valid: boolean;
-    sizeBytes: number;
-    budgetBytes: number;
-};
-
-/**
- * @fileoverview Cultural Memory — Dual Memory Architecture
- * @module @holoscript/core/agents
- *
- * Implements the dual memory model for emergent agent culture:
- * - Episodic Memory: Personal experiences with temporal decay
- * - Stigmergic Memory: Environmental traces visible to all agents
- *
- * Memory consolidation converts repeated episodic patterns into
- * Semantic SOPs (Standard Operating Procedures) — the mechanism
- * by which culture persists across sessions.
- *
- * Based on:
- * - P.025.03: Lifelong Team Memory Pattern
- * - MemAgents (ICLR 2026): Memory for LLM-Based Agentic Systems
- * - CRSEC Framework: Norm spreading through shared memory
- *
- * @version 1.0.0
- */
-/** An episodic memory entry — a single experience */
-interface EpisodicMemory {
-    id: string;
-    agentId: string;
-    /** What happened */
-    event: string;
-    /** Who was involved */
-    participants: string[];
-    /** Emotional valence (-1 = negative, 0 = neutral, 1 = positive) */
-    valence: number;
-    /** Importance score (0-1) */
-    importance: number;
-    /** When it happened (tick number) */
-    timestamp: number;
-    /** Current strength (decays over time) */
-    strength: number;
-    /** Associated norm (if this experience relates to a norm) */
-    normId?: string;
-    /** Tags for retrieval */
-    tags: string[];
-}
-/** A stigmergic trace — environmental memory visible to all */
-interface StigmergicTrace {
-    id: string;
-    /** Creator */
-    creatorId: string;
-    /** Spatial position */
-    position: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    /** Zone the trace belongs to */
-    zoneId: string;
-    /** Type of trace */
-    type: 'marker' | 'path' | 'signal' | 'artifact' | 'boundary';
-    /** What this trace communicates */
-    label: string;
-    /** Current intensity (decays toward 0) */
-    intensity: number;
-    /** Initial intensity */
-    initialIntensity: number;
-    /** Decay rate per tick */
-    decayRate: number;
-    /** Perception radius */
-    radius: number;
-    /** When created */
-    timestamp: number;
-    /** Reinforcement count (how many agents have "validated" this trace) */
-    reinforcements: number;
-}
-/** A semantic SOP — consolidated cultural knowledge */
-interface SemanticSOP {
-    id: string;
-    /** The norm or convention this SOP encodes */
-    normId: string;
-    /** Human-readable description */
-    description: string;
-    /** Conditions under which this SOP applies */
-    conditions: string[];
-    /** Recommended actions */
-    actions: string[];
-    /** Confidence (0-1, increases with more supporting episodes) */
-    confidence: number;
-    /** Number of episodes that contributed to this SOP */
-    episodeCount: number;
-    /** When consolidated */
-    createdAt: number;
-    /** Last updated */
-    updatedAt: number;
-}
-interface CulturalMemoryConfig {
-    /** Max episodic memories per agent */
-    episodicCapacity: number;
-    /** Decay rate per tick (0-1) */
-    episodicDecayRate: number;
-    /** Max stigmergic traces per zone */
-    stigmergicCapacity: number;
-    /** Default trace decay rate */
-    traceDecayRate: number;
-    /** Min episodes before SOP consolidation */
-    consolidationThreshold: number;
-    /** Min confidence for SOP retention */
-    sopRetentionThreshold: number;
-}
-/**
- * CulturalMemory — dual memory system for emergent agent culture.
- *
- * Manages three memory tiers:
- * 1. Episodic (per-agent, decaying personal experiences)
- * 2. Stigmergic (spatial, shared environmental traces)
- * 3. Semantic (consolidated SOPs from repeated patterns)
- */
-declare class CulturalMemory {
-    private config;
-    private episodic;
-    private stigmergic;
-    private sops;
-    private currentTick;
-    constructor(config?: Partial<CulturalMemoryConfig>);
-    /**
-     * Record an episodic memory for an agent.
-     */
-    record(agentId: string, event: string, opts?: Partial<Omit<EpisodicMemory, 'id' | 'agentId' | 'event' | 'strength' | 'timestamp'>>): EpisodicMemory;
-    /**
-     * Recall memories for an agent, optionally filtered.
-     */
-    recall(agentId: string, filter?: {
-        normId?: string;
-        tags?: string[];
-        minStrength?: number;
-    }): EpisodicMemory[];
-    /**
-     * Get the number of memories for an agent.
-     */
-    memoryCount(agentId: string): number;
-    /**
-     * Leave a stigmergic trace in the environment.
-     */
-    leaveTrace(creatorId: string, zoneId: string, label: string, position: {
-        x: number;
-        y: number;
-        z: number;
-    }, opts?: Partial<Omit<StigmergicTrace, 'id' | 'creatorId' | 'zoneId' | 'label' | 'position' | 'timestamp' | 'reinforcements'>>): StigmergicTrace;
-    /**
-     * Perceive nearby traces from a position.
-     */
-    perceiveTraces(zoneId: string, position: {
-        x: number;
-        y: number;
-        z: number;
-    }): StigmergicTrace[];
-    /**
-     * Reinforce a trace (another agent validates it).
-     * Increases intensity and slows decay.
-     */
-    reinforceTrace(traceId: string, zoneId: string): boolean;
-    /**
-     * Get all traces in a zone.
-     */
-    zoneTraces(zoneId: string): StigmergicTrace[];
-    /**
-     * Attempt to consolidate episodic memories into a semantic SOP.
-     * Finds repeated patterns (same normId, high frequency) and forms SOPs.
-     */
-    consolidate(agentId: string): SemanticSOP[];
-    /**
-     * Get all SOPs for an agent.
-     */
-    getSOPs(agentId: string): SemanticSOP[];
-    /**
-     * Get a specific SOP by agent and norm.
-     */
-    getSOP(agentId: string, normId: string): SemanticSOP | undefined;
-    /**
-     * Advance one tick: decay memories and traces, prune dead entries.
-     */
-    tick(): {
-        decayedMemories: number;
-        evaporatedTraces: number;
-    };
-    /**
-     * Get current tick.
-     */
-    getTick(): number;
-    /**
-     * Get global statistics.
-     */
-    stats(): {
-        agents: number;
-        totalMemories: number;
-        totalTraces: number;
-        totalSOPs: number;
-        zones: number;
-    };
-    /**
-     * Export full state for persistence / cross-session continuity.
-     */
-    exportState(): {
-        episodic: Record<string, EpisodicMemory[]>;
-        stigmergic: Record<string, StigmergicTrace[]>;
-        sops: SemanticSOP[];
-        tick: number;
-    };
-    /**
-     * Import state from persistence.
-     */
-    importState(state: ReturnType<CulturalMemory['exportState']>): void;
-}
-
-/**
- * @fileoverview Norm Engine — CRSEC Norm Lifecycle Manager
- * @module @holoscript/core/agents
- *
- * Implements the complete CRSEC norm lifecycle:
- * C - Creation: Agents propose new norms
- * R - Representation: Norms stored as structured objects
- * S - Spreading: Norms propagate through agent populations
- * E - Evaluation: Agents assess norm compliance
- * C - Compliance: Enforcement and feedback loops
- *
- * Key research findings implemented:
- * - Critical mass dynamics: 2% (weak) to 25-67% (strong) for norm change
- * - Metanorms: norms about enforcing norms (cultural ratchet)
- * - Model identity as cultural DNA (different base models → different cultures)
- * - The Governance Goldilocks Zone: structure without content
- *
- * @version 1.0.0
- */
-
-declare const BUILTIN_NORMS: CulturalNorm[];
-declare function criticalMassForChange(norm: CulturalNorm, populationSize: number): number;
-
-type VREffect = string;
-declare class EffectRow {
-    private effects;
-    constructor(effects: string[]);
-    has(effect: string): boolean;
-}
-/** Per-agent norm adoption state */
-interface AgentNormState {
-    agentId: string;
-    /** Norms this agent has adopted */
-    adopted: Set<string>;
-    /** Compliance score per norm (0-1) */
-    compliance: Map<string, number>;
-    /** Norms this agent is currently violating */
-    violations: Set<string>;
-    /** Norms this agent has proposed */
-    proposed: Set<string>;
-    /** Number of times this agent has enforced norms on others */
-    enforcementCount: number;
-}
-/** A norm violation event */
-interface NormViolation {
-    normId: string;
-    agentId: string;
-    effect: VREffect;
-    timestamp: number;
-    severity: NormEnforcement;
-    witnessed: string[];
-}
-/** A norm proposal from an agent */
-interface NormProposal {
-    id: string;
-    proposerId: string;
-    norm: CulturalNorm;
-    votes: Map<string, boolean>;
-    timestamp: number;
-    status: 'pending' | 'adopted' | 'rejected';
-}
-interface NormEngineConfig {
-    /** Minimum adoption rate for a norm to be "active" (0-1) */
-    activationThreshold: number;
-    /** Compliance score increase per compliant action */
-    complianceReward: number;
-    /** Compliance score decrease per violation */
-    violationPenalty: number;
-    /** Minimum vote ratio for a proposal to be adopted */
-    proposalThreshold: number;
-    /** Enable metanorm tracking */
-    enableMetanorms: boolean;
-}
-/**
- * NormEngine — manages the full CRSEC lifecycle for cultural norms.
- */
-declare class NormEngine {
-    private config;
-    private norms;
-    private agents;
-    private proposals;
-    private violationLog;
-    private adoptionHistory;
-    private currentTick;
-    constructor(config?: Partial<NormEngineConfig>);
-    /**
-     * Register a custom norm.
-     */
-    registerNorm(norm: CulturalNorm): void;
-    /**
-     * Agent proposes a new norm.
-     */
-    proposeNorm(proposerId: string, norm: CulturalNorm): NormProposal;
-    /**
-     * Vote on a pending proposal.
-     */
-    vote(proposalId: string, agentId: string, approve: boolean): boolean;
-    /**
-     * Get a norm by ID.
-     */
-    getNorm(normId: string): CulturalNorm | undefined;
-    /**
-     * List all registered norms.
-     */
-    listNorms(): CulturalNorm[];
-    /**
-     * Agent adopts a norm.
-     */
-    adopt(agentId: string, normId: string): boolean;
-    /**
-     * Agent abandons a norm.
-     */
-    abandon(agentId: string, normId: string): boolean;
-    /**
-     * Get adoption rate for a norm (0-1).
-     */
-    adoptionRate(normId: string): number;
-    /**
-     * Check if a norm is active (adoption > threshold).
-     */
-    isActive(normId: string): boolean;
-    /**
-     * Check if an agent's intended effects comply with active norms.
-     * Returns violations found.
-     */
-    evaluate(agentId: string, effects: VREffect[], zoneId?: string): NormViolation[];
-    /**
-     * Record that an agent complied with a norm.
-     */
-    recordCompliance(agentId: string, normId: string): void;
-    /**
-     * Record that an agent violated a norm.
-     */
-    recordViolation(violation: NormViolation): void;
-    /**
-     * Get compliance score for an agent on a norm.
-     */
-    getCompliance(agentId: string, normId: string): number;
-    /**
-     * Register an agent in the norm engine.
-     */
-    registerAgent(agentId: string, adoptNorms?: string[]): AgentNormState;
-    /**
-     * Advance one tick: record adoption history, snapshot state.
-     */
-    tick(): void;
-    /**
-     * Get adoption curve data for a norm.
-     */
-    adoptionCurve(normId: string): {
-        tick: number;
-        rate: number;
-    }[];
-    /**
-     * Get the cultural health score for the whole population (0-1).
-     * High = norms well-adopted, low violations. Low = cultural breakdown.
-     */
-    culturalHealth(): number;
-    /**
-     * Get statistics.
-     */
-    stats(): {
-        norms: number;
-        agents: number;
-        activeNorms: number;
-        violations: number;
-        proposals: number;
-        culturalHealth: number;
-    };
-    private getOrCreateAgent;
-    private witnessesIn;
-}
-
-/**
- * @holoscript/core - Spatial Agent Communication Protocol Types
- *
- * Three-layer communication stack for multi-agent VR world creation:
- * - Layer 1: Real-Time Layer (UDP/WebRTC) - <1ms latency, 90fps coordination
- * - Layer 2: Coordination Layer (A2A over HTTP/2) - Task assignment, conflict resolution
- * - Layer 3: Metadata Layer (MCP) - Tool access, high-level commands
- */
-/**
- * Real-time message types for 90fps coordination
- */
-type RealTimeMessageType = 'position_sync' | 'frame_budget' | 'spatial_conflict' | 'performance_metric';
-/**
- * Position synchronization message (90 messages/second per agent)
- */
-interface PositionSyncMessage {
-    type: 'position_sync';
-    agent_id: string;
-    timestamp: number;
-    position: [number, number, number];
-    rotation: [number, number, number, number];
-    scale: [number, number, number];
-    velocity?: [number, number, number];
-}
-/**
- * Frame budget status message
- */
-interface FrameBudgetMessage {
-    type: 'frame_budget';
-    agent_id: string;
-    timestamp: number;
-    frame_time_ms: number;
-    budget_remaining_ms: number;
-    target_fps: number;
-    actual_fps: number;
-    quality_level: 'high' | 'medium' | 'low' | 'minimal';
-}
-/**
- * Spatial conflict alert message
- */
-interface SpatialConflictMessage {
-    type: 'spatial_conflict';
-    agent_id: string;
-    timestamp: number;
-    conflict_type: 'overlap' | 'boundary_violation' | 'resource_contention' | 'performance_impact';
-    affected_region: {
-        center: [number, number, number];
-        radius: number;
-    };
-    conflicting_agents: string[];
-    severity: 'low' | 'medium' | 'high' | 'critical';
-    suggested_action?: 'pause' | 'relocate' | 'reduce_quality' | 'defer';
-}
-/**
- * Performance metric message
- */
-interface PerformanceMetricMessage {
-    type: 'performance_metric';
-    agent_id: string;
-    timestamp: number;
-    metric_name: string;
-    value: number;
-    unit: 'ms' | 'fps' | 'percent' | 'count' | 'bytes';
-}
-/**
- * Union type for all real-time messages
- */
-type RealTimeMessage = PositionSyncMessage | FrameBudgetMessage | SpatialConflictMessage | PerformanceMetricMessage;
-/**
- * Real-time message body — strips auto-generated fields for the `send()` method.
- */
-type RealTimeMessageBody = DistributiveOmit<RealTimeMessage, 'agent_id' | 'timestamp'>;
-/**
- * Binary protocol configuration for minimal overhead
- */
-interface RealTimeProtocolConfig {
-    /** Use binary encoding (vs JSON) */
-    binary: boolean;
-    /** Maximum message size in bytes */
-    maxMessageSize: number;
-    /** Target latency in milliseconds */
-    targetLatency: number;
-    /** Messages per second per agent */
-    messagesPerSecond: number;
-    /** Enable message compression */
-    compression: boolean;
-    /** UDP port for real-time messages */
-    udpPort?: number;
-    /** WebRTC configuration */
-    webrtc?: {
-        iceServers: RTCIceServer[];
-        dataChannelOptions?: RTCDataChannelInit;
-    };
-}
-/**
- * Default real-time protocol configuration
- */
-declare const DEFAULT_REALTIME_CONFIG: RealTimeProtocolConfig;
-/**
- * A2A message types for agent collaboration
- */
-type A2AMessageType = 'task_assignment' | 'task_complete' | 'spatial_claim' | 'conflict_resolution' | 'resource_request' | 'resource_release' | 'agent_handshake' | 'agent_disconnect';
-/**
- * Task specification for task assignment
- */
-interface TaskSpec {
-    task_id: string;
-    task_type: 'terrain' | 'assets' | 'physics' | 'lighting' | 'audio' | 'custom';
-    priority: 'low' | 'medium' | 'high' | 'critical';
-    parameters: Record<string, unknown>;
-    spatial_region?: {
-        center: [number, number, number];
-        size: [number, number, number];
-    };
-    frame_budget_ms?: number;
-    dependencies?: string[];
-    deadline?: number;
-}
-/**
- * Task assignment message
- */
-interface TaskAssignmentMessage {
-    type: 'task_assignment';
-    message_id: string;
-    from_agent: string;
-    to_agent: string;
-    timestamp: number;
-    task: TaskSpec;
-}
-/**
- * Task completion message
- */
-interface TaskCompleteMessage {
-    type: 'task_complete';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    task_id: string;
-    success: boolean;
-    result?: unknown;
-    error?: string;
-    performance_metrics?: {
-        duration_ms: number;
-        frame_time_avg_ms: number;
-        frame_time_max_ms: number;
-        quality_level: 'high' | 'medium' | 'low' | 'minimal';
-    };
-}
-/**
- * Spatial claim message
- */
-interface SpatialClaimMessage {
-    type: 'spatial_claim';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    claim_id: string;
-    bounding_box: {
-        min: [number, number, number];
-        max: [number, number, number];
-    };
-    priority: 'low' | 'medium' | 'high' | 'critical';
-    duration_ms?: number;
-    exclusive: boolean;
-}
-/**
- * Conflict resolution strategy
- */
-type ConflictResolutionStrategy = 'priority_based' | 'time_slicing' | 'spatial_partitioning' | 'quality_reduction' | 'agent_relocation';
-/**
- * Conflict resolution message
- */
-interface ConflictResolutionMessage {
-    type: 'conflict_resolution';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    conflict_id: string;
-    strategy: ConflictResolutionStrategy;
-    involved_agents: string[];
-    resolution_params?: Record<string, unknown>;
-}
-/**
- * Resource request message
- */
-interface ResourceRequestMessage {
-    type: 'resource_request';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    resource_id: string;
-    resource_type: 'mesh' | 'texture' | 'material' | 'audio' | 'compute' | 'memory';
-    amount?: number;
-    priority: 'low' | 'medium' | 'high' | 'critical';
-}
-/**
- * Resource release message
- */
-interface ResourceReleaseMessage {
-    type: 'resource_release';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    resource_id: string;
-}
-/**
- * Agent handshake message
- */
-interface AgentHandshakeMessage {
-    type: 'agent_handshake';
-    message_id: string;
-    from_agent: string;
-    to_agent: string;
-    timestamp: number;
-    capabilities: string[];
-    protocol_version: string;
-}
-/**
- * Agent disconnect message
- */
-interface AgentDisconnectMessage {
-    type: 'agent_disconnect';
-    message_id: string;
-    from_agent: string;
-    timestamp: number;
-    reason?: string;
-}
-/**
- * Union type for all A2A messages
- */
-type A2AMessage = TaskAssignmentMessage | TaskCompleteMessage | SpatialClaimMessage | ConflictResolutionMessage | ResourceRequestMessage | ResourceReleaseMessage | AgentHandshakeMessage | AgentDisconnectMessage;
-/**
- * Distributive Omit for discriminated unions — removes keys from each member individually.
- */
-type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
-/**
- * A2A message body type for the `send()` method.
- * Strips auto-generated fields so callers only provide the domain payload.
- */
-type A2AMessageBody = DistributiveOmit<A2AMessage, 'message_id' | 'from_agent' | 'timestamp'>;
-/**
- * A2A protocol configuration
- */
-interface A2AProtocolConfig {
-    /** HTTP/2 endpoint */
-    endpoint: string;
-    /** Request timeout in milliseconds */
-    timeout: number;
-    /** Maximum retry attempts */
-    maxRetries: number;
-    /** Exponential backoff base (ms) */
-    retryBackoffBase: number;
-    /** Enable acknowledgments */
-    requireAck: boolean;
-    /** Enable request batching */
-    enableBatching: boolean;
-    /** Batch size */
-    batchSize: number;
-}
-/**
- * Default A2A protocol configuration
- */
-declare const DEFAULT_A2A_CONFIG: A2AProtocolConfig;
-/**
- * A2A response
- */
-interface A2AResponse {
-    message_id: string;
-    success: boolean;
-    data?: unknown;
-    error?: string;
-    timestamp: number;
-}
-/**
- * MCP command types for high-level operations
- */
-type MCPCommandType = 'create_world' | 'get_world_status' | 'export_world' | 'get_agent_registry' | 'get_performance_metrics' | 'set_global_config' | 'trigger_event';
-/**
- * World specification for world creation
- */
-interface WorldSpec {
-    world_id?: string;
-    name: string;
-    template?: 'blank' | 'office' | 'gallery' | 'playground' | 'analytics' | 'collaboration';
-    dimensions: {
-        width: number;
-        height: number;
-        depth: number;
-    };
-    target_fps: number;
-    max_agents: number;
-    features?: {
-        terrain?: boolean;
-        physics?: boolean;
-        lighting?: boolean;
-        audio?: boolean;
-        networking?: boolean;
-    };
-    agent_roles?: {
-        role: string;
-        agent_type: string;
-        spatial_region?: {
-            center: [number, number, number];
-            size: [number, number, number];
-        };
-    }[];
-}
-/**
- * World status
- */
-interface WorldStatus {
-    world_id: string;
-    name: string;
-    status: 'initializing' | 'active' | 'paused' | 'error' | 'stopped';
-    active_agents: {
-        agent_id: string;
-        role: string;
-        status: 'online' | 'offline' | 'degraded';
-    }[];
-    performance: {
-        current_fps: number;
-        target_fps: number;
-        frame_time_avg_ms: number;
-        frame_time_max_ms: number;
-        quality_level: 'high' | 'medium' | 'low' | 'minimal';
-    };
-    spatial_conflicts: number;
-    resource_utilization: {
-        cpu_percent: number;
-        memory_mb: number;
-        gpu_percent: number;
-    };
-    uptime_ms: number;
-    created_at: string;
-}
-/**
- * Export format options
- */
-type ExportFormat = 'gltf' | 'fbx' | 'usdz' | 'vrm' | 'json' | 'holoscript';
-/**
- * Performance metrics
- */
-interface PerformanceMetrics {
-    timestamp: number;
-    agents: {
-        agent_id: string;
-        role: string;
-        frame_time_avg_ms: number;
-        frame_time_max_ms: number;
-        messages_sent: number;
-        messages_received: number;
-        spatial_conflicts: number;
-    }[];
-    system: {
-        total_fps: number;
-        target_fps: number;
-        frame_time_avg_ms: number;
-        frame_time_max_ms: number;
-        quality_level: 'high' | 'medium' | 'low' | 'minimal';
-        cpu_percent: number;
-        memory_mb: number;
-        gpu_percent: number;
-    };
-}
-/**
- * MCP command request
- */
-interface MCPCommandRequest {
-    command: MCPCommandType;
-    params: Record<string, unknown>;
-}
-/**
- * MCP command response
- */
-interface MCPCommandResponse {
-    success: boolean;
-    data?: unknown;
-    error?: string;
-    timestamp: number;
-}
-/**
- * MCP protocol configuration
- */
-interface MCPProtocolConfig {
-    /** MCP orchestrator endpoint */
-    endpoint: string;
-    /** API key for authentication */
-    apiKey: string;
-    /** Request timeout */
-    timeout: number;
-}
-/**
- * Default MCP protocol configuration
- */
-declare const DEFAULT_MCP_CONFIG: MCPProtocolConfig;
-/**
- * Complete three-layer protocol configuration
- */
-interface SpatialCommProtocolConfig {
-    layer1: RealTimeProtocolConfig;
-    layer2: A2AProtocolConfig;
-    layer3: MCPProtocolConfig;
-}
-/**
- * Default unified protocol configuration
- */
-declare const DEFAULT_SPATIAL_COMM_CONFIG: SpatialCommProtocolConfig;
-/**
- * Protocol version
- */
-declare const PROTOCOL_VERSION = "1.0.0";
-/**
- * Protocol compatibility
- */
-interface ProtocolCompatibility {
-    version: string;
-    minVersion: string;
-    maxVersion: string;
-}
-declare const PROTOCOL_COMPATIBILITY: ProtocolCompatibility;
-
-/**
- * @holoscript/core - Layer 1: Real-Time Communication Layer
- *
- * UDP/WebRTC-based real-time communication for 90fps agent coordination.
- * Features:
- * - <1ms latency for position sync and frame budget updates
- * - Binary protocol for minimal overhead
- * - 90 messages/second per agent capability
- * - Spatial conflict detection and alerts
- */
-
-/**
- * Encode real-time message to binary format
- */
-declare function encodeRealTimeMessage(message: RealTimeMessage): Buffer;
-/**
- * Decode binary message to RealTimeMessage
- */
-declare function decodeRealTimeMessage(buffer: Buffer): RealTimeMessage;
-/**
- * Real-time transport interface
- */
-interface RealTimeTransport {
-    send(buffer: Buffer, targetAgent?: string): Promise<void>;
-    broadcast(buffer: Buffer): Promise<void>;
-    close(): Promise<void>;
-}
-/**
- * UDP-based real-time transport (Node.js environment)
- */
-declare class UDPRealTimeTransport implements RealTimeTransport {
-    private socket?;
-    private port;
-    private targetHost;
-    constructor(port: number);
-    init(): Promise<void>;
-    send(buffer: Buffer, _targetAgent?: string): Promise<void>;
-    broadcast(buffer: Buffer): Promise<void>;
-    close(): Promise<void>;
-    onMessage(callback: (buffer: Buffer, rinfo: unknown) => void): void;
-}
-/**
- * WebRTC-based real-time transport (Browser environment)
- */
-declare class WebRTCRealTimeTransport implements RealTimeTransport {
-    private config;
-    private dataChannel?;
-    private peerConnection?;
-    constructor(config: RTCConfiguration);
-    init(remoteDescription?: RTCSessionDescriptionInit): Promise<void>;
-    send(buffer: Buffer, _targetAgent?: string): Promise<void>;
-    broadcast(buffer: Buffer): Promise<void>;
-    close(): Promise<void>;
-    onMessage(callback: (buffer: Buffer) => void): void;
-    createOffer(): Promise<RTCSessionDescriptionInit>;
-    createAnswer(): Promise<RTCSessionDescriptionInit>;
-}
-/**
- * Layer 1 Real-Time Communication Client
- */
-declare class Layer1RealTimeClient extends EventEmitter {
-    private config;
-    private transport?;
-    private agentId;
-    private messageCount;
-    private lastMessageTime;
-    private readonly _messageBuffer;
-    constructor(agentId: string, config?: Partial<RealTimeProtocolConfig>);
-    /**
-     * Initialize transport and start listening
-     */
-    init(useWebRTC?: boolean): Promise<void>;
-    /**
-     * Send real-time message
-     */
-    send(message: RealTimeMessageBody, targetAgent?: string): Promise<void>;
-    /**
-     * Send position sync message
-     */
-    sendPositionSync(position: [number, number, number], rotation: [number, number, number, number], scale: [number, number, number], velocity?: [number, number, number]): Promise<void>;
-    /**
-     * Send frame budget message
-     */
-    sendFrameBudget(frameTimeMs: number, budgetRemainingMs: number, targetFps: number, actualFps: number, qualityLevel: 'high' | 'medium' | 'low' | 'minimal'): Promise<void>;
-    /**
-     * Close transport
-     */
-    close(): Promise<void>;
-    /**
-     * Handle incoming message
-     */
-    private handleIncomingMessage;
-    /**
-     * Enforce rate limiting
-     */
-    private enforceRateLimit;
-    /**
-     * Get current time in microseconds
-     */
-    private getMicroseconds;
-}
-
-/**
- * @holoscript/core - Layer 2: A2A Coordination Layer
- *
- * JSON-RPC over HTTP/2 for agent-to-agent collaboration.
- * Features:
- * - Task assignment and completion tracking
- * - Spatial region claims and conflict resolution
- * - Resource request/release management
- * - Request/response with acknowledgments
- * - Retry with exponential backoff
- */
-
-interface SpatialClaim {
-    claim_id: string;
-    agent_id: string;
-    bounding_box: {
-        min: [number, number, number];
-        max: [number, number, number];
-    };
-    priority: 'low' | 'medium' | 'high' | 'critical';
-    exclusive: boolean;
-    expires_at?: number;
-}
-/**
- * Layer 2 A2A Coordination Client
- */
-declare class Layer2A2AClient extends EventEmitter {
-    private config;
-    private agentId;
-    private messageQueue;
-    private claimManager;
-    private messageHandlers;
-    private batchBuffer;
-    private batchTimer?;
-    constructor(agentId: string, config?: Partial<A2AProtocolConfig>);
-    /**
-     * Send A2A message with retry
-     */
-    send(message: A2AMessageBody): Promise<A2AResponse>;
-    /**
-     * Send task assignment
-     */
-    assignTask(toAgent: string, task: TaskSpec): Promise<A2AResponse>;
-    /**
-     * Send task completion
-     */
-    completeTask(taskId: string, success: boolean, result?: unknown, error?: string, performanceMetrics?: {
-        duration_ms: number;
-        frame_time_avg_ms: number;
-        frame_time_max_ms: number;
-        quality_level: 'high' | 'medium' | 'low' | 'minimal';
-    }): Promise<A2AResponse>;
-    /**
-     * Claim spatial region
-     */
-    claimSpatialRegion(claimId: string, boundingBox: {
-        min: [number, number, number];
-        max: [number, number, number];
-    }, priority: 'low' | 'medium' | 'high' | 'critical', durationMs?: number, exclusive?: boolean): Promise<A2AResponse>;
-    /**
-     * Resolve spatial conflict
-     */
-    resolveConflict(conflictId: string, involvedAgents: string[], strategy: ConflictResolutionStrategy, resolutionParams?: Record<string, unknown>): Promise<A2AResponse>;
-    /**
-     * Request resource
-     */
-    requestResource(resourceId: string, resourceType: 'mesh' | 'texture' | 'material' | 'audio' | 'compute' | 'memory', amount?: number, priority?: 'low' | 'medium' | 'high' | 'critical'): Promise<A2AResponse>;
-    /**
-     * Release resource
-     */
-    releaseResource(resourceId: string): Promise<A2AResponse>;
-    /**
-     * Perform agent handshake
-     */
-    handshake(toAgent: string, capabilities: string[], protocolVersion: string): Promise<A2AResponse>;
-    /**
-     * Register message handler
-     */
-    onMessage(messageType: string, handler: (message: A2AMessage) => Promise<A2AResponse>): void;
-    /**
-     * Handle incoming message
-     */
-    handleIncoming(message: A2AMessage): Promise<A2AResponse>;
-    /**
-     * Get spatial claims for this agent
-     */
-    getMyClaims(): SpatialClaim[];
-    /**
-     * Get all spatial claims
-     */
-    getAllClaims(): SpatialClaim[];
-    /**
-     * Send message with retry logic
-     */
-    private sendMessage;
-    /**
-     * Attempt to send message
-     */
-    private attemptSend;
-    /**
-     * HTTP/2 request
-     */
-    private httpRequest;
-    /**
-     * Add message to batch
-     */
-    private addToBatch;
-    /**
-     * Flush batch of messages
-     */
-    private flushBatch;
-    /**
-     * Generate unique message ID
-     */
-    private generateMessageId;
-    /**
-     * Get queue statistics
-     */
-    getQueueStats(): {
-        queueSize: number;
-        claimCount: number;
-    };
-    /**
-     * Shutdown client
-     */
-    shutdown(): Promise<void>;
-}
-
-/**
- * @holoscript/core - Layer 3: MCP Metadata Layer
- *
- * Model Context Protocol integration for high-level commands and tool access.
- * Features:
- * - World creation and management
- * - Agent registry queries
- * - Performance metrics collection
- * - Global configuration
- * - System event triggering
- */
-
-/**
- * MCP tool definition
- */
-interface MCPTool {
-    name: string;
-    description: string;
-    parameters: {
-        type: 'object';
-        properties: Record<string, any>;
-        required?: string[];
-    };
-}
-/**
- * Available MCP tools for spatial agent communication
- */
-declare const SPATIAL_MCP_TOOLS: MCPTool[];
-/**
- * Layer 3 MCP Metadata Client
- */
-declare class Layer3MCPClient extends EventEmitter {
-    private config;
-    private agentId;
-    constructor(agentId: string, config?: Partial<MCPProtocolConfig>);
-    /**
-     * Execute MCP command
-     */
-    execute(command: MCPCommandType, params: Record<string, any>): Promise<MCPCommandResponse>;
-    /**
-     * Create new VR world
-     */
-    createWorld(worldSpec: WorldSpec): Promise<{
-        world_id: string;
-        status: WorldStatus;
-    }>;
-    /**
-     * Get world status
-     */
-    getWorldStatus(worldId: string): Promise<WorldStatus>;
-    /**
-     * Export world
-     */
-    exportWorld(worldId: string, format: ExportFormat): Promise<{
-        url: string;
-        size: number;
-    }>;
-    /**
-     * Get agent registry
-     */
-    getAgentRegistry(filter?: {
-        status?: 'online' | 'offline' | 'degraded';
-        role?: string;
-        world_id?: string;
-    }): Promise<{
-        agents: Array<{
-            agent_id: string;
-            role: string;
-            status: 'online' | 'offline' | 'degraded';
-            world_id?: string;
-            capabilities: string[];
-        }>;
-        total: number;
-    }>;
-    /**
-     * Get performance metrics
-     */
-    getPerformanceMetrics(options?: {
-        world_id?: string;
-        agent_id?: string;
-    }): Promise<PerformanceMetrics>;
-    /**
-     * Set global configuration
-     */
-    setGlobalConfig(config: {
-        target_fps?: number;
-        max_agents?: number;
-        quality_level?: 'high' | 'medium' | 'low' | 'minimal';
-        enable_spatial_audio?: boolean;
-        enable_physics?: boolean;
-    }): Promise<void>;
-    /**
-     * Trigger system event
-     */
-    triggerEvent(eventType: string, eventData?: Record<string, any>): Promise<void>;
-    /**
-     * Call MCP tool directly
-     */
-    callTool(server: string, tool: string, args: Record<string, any>): Promise<MCPCommandResponse>;
-    /**
-     * Get available MCP tools
-     */
-    getAvailableTools(): MCPTool[];
-    /**
-     * Send MCP request
-     */
-    private sendMCPRequest;
-    /**
-     * Call MCP tool via orchestrator
-     */
-    private mcpToolCall;
-}
-/**
- * MCP command handler
- */
-type MCPCommandHandler = (params: Record<string, any>, context: {
-    agent_id: string;
-}) => Promise<any>;
-/**
- * Layer 3 MCP Server
- * Handles incoming MCP commands from agents
- */
-declare class Layer3MCPServer extends EventEmitter {
-    private handlers;
-    private worlds;
-    constructor();
-    /**
-     * Register command handler
-     */
-    registerHandler(command: MCPCommandType, handler: MCPCommandHandler): void;
-    /**
-     * Handle incoming MCP request
-     */
-    handleRequest(request: MCPCommandRequest, context: {
-        agent_id: string;
-    }): Promise<MCPCommandResponse>;
-    /**
-     * Register default handlers
-     */
-    private registerDefaultHandlers;
-    /**
-     * Get all worlds
-     */
-    getWorlds(): WorldStatus[];
-    /**
-     * Update world status
-     */
-    updateWorld(worldId: string, updates: Partial<WorldStatus>): void;
-}
-
-/**
- * Frame budget tracker for graceful degradation
- */
-declare class FrameBudgetTracker {
-    private targetFps;
-    private targetFrameTimeMs;
-    private frameTimeSamples;
-    private maxSamples;
-    private qualityLevel;
-    constructor(targetFps?: number);
-    /**
-     * Record frame time
-     */
-    recordFrameTime(frameTimeMs: number): void;
-    /**
-     * Get average frame time
-     */
-    getAverageFrameTime(): number;
-    /**
-     * Get maximum frame time
-     */
-    getMaxFrameTime(): number;
-    /**
-     * Get current FPS
-     */
-    getCurrentFps(): number;
-    /**
-     * Get budget remaining for current frame
-     */
-    getBudgetRemaining(): number;
-    /**
-     * Check if within budget
-     */
-    isWithinBudget(): boolean;
-    /**
-     * Get current quality level
-     */
-    getQualityLevel(): 'high' | 'medium' | 'low' | 'minimal';
-    /**
-     * Set quality level
-     */
-    setQualityLevel(level: 'high' | 'medium' | 'low' | 'minimal'): void;
-    /**
-     * Auto-adjust quality based on performance
-     */
-    private autoAdjustQuality;
-    /**
-     * Get frame budget stats
-     */
-    getStats(): {
-        targetFps: number;
-        currentFps: number;
-        avgFrameTimeMs: number;
-        maxFrameTimeMs: number;
-        budgetRemainingMs: number;
-        qualityLevel: 'high' | 'medium' | 'low' | 'minimal';
-        withinBudget: boolean;
-    };
-    /**
-     * Reset tracker
-     */
-    reset(): void;
-}
-/**
- * Unified spatial communication client
- */
-declare class SpatialCommClient extends EventEmitter {
-    private agentId;
-    private config;
-    private layer1?;
-    private layer2?;
-    private layer3?;
-    private frameBudget;
-    private initialized;
-    private currentWorldId?;
-    constructor(agentId: string, config?: Partial<SpatialCommProtocolConfig>);
-    /**
-     * Initialize all layers
-     */
-    init(options?: {
-        useWebRTC?: boolean;
-    }): Promise<void>;
-    /**
-     * Send position sync (Layer 1)
-     */
-    syncPosition(position: [number, number, number], rotation: [number, number, number, number], scale: [number, number, number], velocity?: [number, number, number]): Promise<void>;
-    /**
-     * Send frame budget update (Layer 1)
-     */
-    sendFrameBudget(): Promise<void>;
-    /**
-     * Record frame time (updates budget tracker)
-     */
-    recordFrameTime(frameTimeMs: number): void;
-    /**
-     * Get frame budget stats
-     */
-    getFrameBudgetStats(): {
-        targetFps: number;
-        currentFps: number;
-        avgFrameTimeMs: number;
-        maxFrameTimeMs: number;
-        budgetRemainingMs: number;
-        qualityLevel: "high" | "medium" | "low" | "minimal";
-        withinBudget: boolean;
-    };
-    /**
-     * Assign task to agent (Layer 2)
-     */
-    assignTask(toAgent: string, task: TaskSpec): Promise<A2AResponse>;
-    /**
-     * Complete task (Layer 2)
-     */
-    completeTask(taskId: string, success: boolean, result?: unknown, error?: string): Promise<A2AResponse>;
-    /**
-     * Claim spatial region (Layer 2)
-     */
-    claimSpatialRegion(claimId: string, boundingBox: {
-        min: [number, number, number];
-        max: [number, number, number];
-    }, priority: 'low' | 'medium' | 'high' | 'critical', durationMs?: number, exclusive?: boolean): Promise<A2AResponse>;
-    /**
-     * Request resource (Layer 2)
-     */
-    requestResource(resourceId: string, resourceType: 'mesh' | 'texture' | 'material' | 'audio' | 'compute' | 'memory', amount?: number, priority?: 'low' | 'medium' | 'high' | 'critical'): Promise<A2AResponse>;
-    /**
-     * Release resource (Layer 2)
-     */
-    releaseResource(resourceId: string): Promise<A2AResponse>;
-    /**
-     * Get spatial claims (Layer 2)
-     */
-    getMyClaims(): SpatialClaim[];
-    /**
-     * Create world (Layer 3)
-     */
-    createWorld(worldSpec: WorldSpec): Promise<{
-        world_id: string;
-        status: WorldStatus;
-    }>;
-    /**
-     * Get world status (Layer 3)
-     */
-    getWorldStatus(worldId?: string): Promise<WorldStatus>;
-    /**
-     * Export world (Layer 3)
-     */
-    exportWorld(format: ExportFormat, worldId?: string): Promise<{
-        url: string;
-        size: number;
-    }>;
-    /**
-     * Get agent registry (Layer 3)
-     */
-    getAgentRegistry(filter?: {
-        status?: 'online' | 'offline' | 'degraded';
-        role?: string;
-        world_id?: string;
-    }): Promise<{
-        agents: Array<{
-            agent_id: string;
-            role: string;
-            status: "online" | "offline" | "degraded";
-            world_id?: string;
-            capabilities: string[];
-        }>;
-        total: number;
-    }>;
-    /**
-     * Get performance metrics (Layer 3)
-     */
-    getPerformanceMetrics(options?: {
-        world_id?: string;
-        agent_id?: string;
-    }): Promise<PerformanceMetrics>;
-    /**
-     * Set global configuration (Layer 3)
-     */
-    setGlobalConfig(config: {
-        target_fps?: number;
-        max_agents?: number;
-        quality_level?: 'high' | 'medium' | 'low' | 'minimal';
-    }): Promise<void>;
-    /**
-     * Shutdown client
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Get client status
-     */
-    getStatus(): {
-        agentId: string;
-        initialized: boolean;
-        currentWorldId?: string;
-        frameBudget: ReturnType<FrameBudgetTracker['getStats']>;
-        queueStats: ReturnType<Layer2A2AClient['getQueueStats']>;
-    };
-}
-
-export { type A2AMessage, type A2AMessageBody, type A2AMessageType, type A2AProtocolConfig, type A2AResponse, type AgentDisconnectMessage, type AgentHandshakeMessage, type AgentNormState, type AgentWallet, AgentWalletRegistry, type AuthenticatedAgentState, BUILTIN_NORMS, type ConflictResolutionMessage, type ConflictResolutionStrategy, CulturalMemory, type CulturalMemoryConfig, DEFAULT_A2A_CONFIG, DEFAULT_MCP_CONFIG, DEFAULT_REALTIME_CONFIG, DEFAULT_SPATIAL_COMM_CONFIG, type DID, type DecisionEntry, type DeviceCapabilities, EffectRow, type EmbodimentType, type EpisodicMemory, type EvidenceEntry, type ExportFormat, type FrameBudgetMessage, FrameBudgetTracker, GCounter, type HandoffNegotiation, LWWRegister, Layer1RealTimeClient, Layer2A2AClient, Layer3MCPClient, Layer3MCPServer, type MCPCommandHandler, type MCPCommandRequest, type MCPCommandResponse, type MCPCommandType, type MCPProtocolConfig, type MCPTool, type MVCPayload, NormEngine, type NormEngineConfig, type NormProposal, type NormViolation, ORSet, PLATFORM_CAPABILITIES, PROTOCOL_COMPATIBILITY, PROTOCOL_VERSION, type PerformanceMetricMessage, type PerformanceMetrics, type PlatformCapabilities, type PlatformTarget, type PositionSyncMessage, type ProtocolCompatibility, type RealTimeMessage, type RealTimeMessageBody, type RealTimeMessageType, type RealTimeProtocolConfig, type RealTimeTransport, type ResourceReleaseMessage, type ResourceRequestMessage, SPATIAL_MCP_TOOLS, type SemanticSOP, type SignedOperation, type SpatialClaimMessage, SpatialCommClient, type SpatialCommProtocolConfig, type SpatialConflictMessage, type SpatialContext, type StigmergicTrace, type TaskAssignmentMessage, type TaskCompleteMessage, type TaskSpec, type TaskState, UDPRealTimeTransport, type UserPreferences, type VREffect, WebRTCRealTimeTransport, type WorldSpec, type WorldStatus, createAgentState, createMVCPayload, criticalMassForChange, decodeRealTimeMessage, embodimentFor, encodeRealTimeMessage, estimatePayloadSize, getCounter, getRegister, incrementCounter, mergeStates, negotiateHandoff, platformCategory, setRegister, signOperation, validatePayloadBudget, verifyOperation };