@mandible-ai/mandible 0.2.0

package/dist/src/core/signal.js

@@ -0,0 +1,127 @@
+// ============================================================
+// Signal Factory & Utilities
+// ============================================================
+let idCounter = 0;
+const generateId = () => {
+    const ts = Date.now().toString(36);
+    const seq = (idCounter++).toString(36).padStart(4, '0');
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `sig_${ts}_${seq}_${rand}`;
+};
+/**
+ * Create a new signal with sensible defaults.
+ */
+export function createSignal(type, payload, options) {
+    const now = Date.now();
+    return {
+        id: generateId(),
+        type,
+        payload,
+        meta: {
+            deposited_at: now,
+            deposited_by: options?.deposited_by ?? 'unknown',
+            concentration: options?.concentration ?? 1.0,
+            ttl: options?.ttl,
+            tags: options?.tags,
+            caused_by: options?.caused_by,
+        },
+    };
+}
+/**
+ * Check if a signal matches a query.
+ */
+export function matchesQuery(signal, query) {
+    // Type matching (supports glob with *)
+    if (query.type) {
+        const types = Array.isArray(query.type) ? query.type : [query.type];
+        const typeMatches = types.some(pattern => matchType(signal.type, pattern));
+        if (!typeMatches)
+            return false;
+    }
+    // Concentration threshold
+    if (query.minConcentration !== undefined) {
+        if (signal.meta.concentration < query.minConcentration)
+            return false;
+    }
+    // Unclaimed filter
+    if (query.unclaimed === true) {
+        if (signal.meta.claimed_by)
+            return false;
+    }
+    // Tags filter (all specified tags must be present)
+    if (query.tags && query.tags.length > 0) {
+        const signalTags = new Set(signal.meta.tags ?? []);
+        if (!query.tags.every(t => signalTags.has(t)))
+            return false;
+    }
+    // Time filter
+    if (query.after !== undefined) {
+        if (signal.meta.deposited_at <= query.after)
+            return false;
+    }
+    // Custom filter
+    if (query.filter) {
+        if (!query.filter(signal))
+            return false;
+    }
+    return true;
+}
+/**
+ * Glob-style type matching. Supports:
+ *   'task:ready'   — exact match
+ *   'task:*'       — matches any task signal
+ *   '*:ready'      — matches any domain with state 'ready'
+ *   '*'            — matches everything
+ */
+function matchType(signalType, pattern) {
+    if (pattern === '*')
+        return true;
+    // Convert glob to regex
+    const regexStr = '^' + pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex special chars
+        .replace(/\*/g, '[^:]*') // * matches within a segment
+        .replace(/\*\*/g, '.*') // ** matches across segments
+        + '$';
+    return new RegExp(regexStr).test(signalType);
+}
+/**
+ * Apply concentration decay to a signal based on elapsed time.
+ * Returns the new concentration value (does not mutate the signal).
+ */
+export function decayConcentration(signal, ratePerSecond, now = Date.now()) {
+    const elapsedMs = now - signal.meta.deposited_at;
+    const elapsedSeconds = elapsedMs / 1000;
+    const newConcentration = signal.meta.concentration - (ratePerSecond * elapsedSeconds);
+    return Math.max(0, newConcentration);
+}
+/**
+ * Check if a signal has expired based on its TTL.
+ */
+export function isExpired(signal, now = Date.now()) {
+    if (!signal.meta.ttl)
+        return false;
+    return now - signal.meta.deposited_at > signal.meta.ttl;
+}
+/**
+ * Check if a signal's claim lease has expired.
+ */
+export function isClaimExpired(signal, now = Date.now()) {
+    if (!signal.meta.claimed_by || !signal.meta.claimed_at || !signal.meta.claim_lease) {
+        return false;
+    }
+    return now - signal.meta.claimed_at > signal.meta.claim_lease;
+}
+/**
+ * Sort signals by concentration (highest first), then by age (newest first).
+ */
+export function prioritize(signals) {
+    return [...signals].sort((a, b) => {
+        // Higher concentration first
+        const concDiff = b.meta.concentration - a.meta.concentration;
+        if (Math.abs(concDiff) > 0.001)
+            return concDiff;
+        // Then newer first
+        return b.meta.deposited_at - a.meta.deposited_at;
+    });
+}
+//# sourceMappingURL=signal.js.map

package/dist/src/core/signal.js.map

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

package/dist/src/core/types.d.ts

@@ -0,0 +1,395 @@
+export interface Signal<T = Record<string, unknown>> {
+    /** Unique signal ID */
+    id: string;
+    /**
+     * Hierarchical signal type, e.g. 'task:ready', 'review:needed', 'artifact:shaped'
+     * Convention: {domain}:{state}
+     */
+    type: string;
+    /** Arbitrary structured payload */
+    payload: T;
+    /** Signal metadata — managed by the framework, not the agent */
+    meta: SignalMeta;
+}
+export interface SignalMeta {
+    /** When the signal was deposited (epoch ms) */
+    deposited_at: number;
+    /** Which colony deposited this signal */
+    deposited_by: string;
+    /**
+     * Signal strength: 1.0 = fresh, decays toward 0.0 over time.
+     * Agents can use concentration to prioritize work.
+     */
+    concentration: number;
+    /** Optional time-to-live in milliseconds. Signal evaporates after this. */
+    ttl?: number;
+    /** If claimed, which colony instance holds the claim */
+    claimed_by?: string;
+    /** When the claim was taken */
+    claimed_at?: number;
+    /** Claim lease duration in ms — auto-releases if holder dies */
+    claim_lease?: number;
+    /** Lineage: signal IDs that caused this signal to be deposited */
+    caused_by?: string[];
+    /** Arbitrary tags for filtering */
+    tags?: string[];
+    /**
+     * Ed25519 signature of the canonical signal content.
+     * Signs: hash(type + JSON(payload) + JSON(caused_by))
+     * Proves the depositing colony actually produced this signal.
+     */
+    signature?: string;
+    /**
+     * Public key (hex-encoded) of the colony that signed this signal.
+     * Used to look up the colony identity for verification.
+     */
+    signer?: string;
+    /**
+     * Attestation chain for bridged signals.
+     * Each bridge that transfers a signal appends its own attestation.
+     * Verification walks the chain from origin to current environment.
+     */
+    attestations?: Attestation[];
+    /**
+     * Trust level assigned by the receiving environment's trust policy.
+     * Set during deposit validation. Colonies can filter by trust level.
+     *   'verified'   — signature valid, attestation chain checks out
+     *   'attested'   — bridge attestation present but colony sig missing
+     *   'unverified' — no provenance metadata (local signals, legacy)
+     *   'rejected'   — failed verification (quarantined, not evicted)
+     */
+    trustLevel?: TrustLevel;
+    /**
+     * The environment where this signal originated.
+     * Set automatically by bridges when transferring signals.
+     * Undefined for signals deposited locally.
+     */
+    sourceEnvironment?: string;
+}
+export interface SignalQuery {
+    /** Match signal types (exact or glob pattern like 'task:*') */
+    type?: string | string[];
+    /** Only signals above this concentration threshold */
+    minConcentration?: number;
+    /** Only unclaimed signals */
+    unclaimed?: boolean;
+    /** Only signals with these tags */
+    tags?: string[];
+    /** Only signals deposited after this time */
+    after?: number;
+    /** Max results to return */
+    limit?: number;
+    /** Custom filter predicate */
+    filter?: (signal: Signal) => boolean;
+}
+export interface Environment {
+    /** Human-readable name for this environment instance */
+    readonly name: string;
+    /** Observe signals matching a query */
+    observe(query: SignalQuery): Promise<Signal[]>;
+    /** Deposit a new signal into the environment */
+    deposit(signal: Omit<Signal, 'id' | 'meta'> & {
+        meta?: Partial<SignalMeta>;
+    }): Promise<Signal>;
+    /** Withdraw (remove) a signal from the environment */
+    withdraw(signalId: string): Promise<void>;
+    /**
+     * Attempt to claim a signal. Returns true if claim succeeded.
+     * Supports optimistic concurrency — if two agents claim simultaneously,
+     * only one succeeds.
+     */
+    claim(signalId: string, claimant: string, leaseDuration?: number): Promise<boolean>;
+    /** Release a previously held claim */
+    release(signalId: string): Promise<void>;
+    /**
+     * Watch for signals matching a pattern. Callback fires when new signals appear.
+     * This is the reactive sensor mechanism.
+     */
+    watch(query: SignalQuery, callback: (signal: Signal) => void): Subscription;
+    /** Query historical signals (including withdrawn ones, if supported) */
+    history(query: SignalQuery & {
+        includeWithdrawn?: boolean;
+    }): Promise<Signal[]>;
+    /** Apply decay to all signals based on their age and TTL */
+    decay(): Promise<DecayResult>;
+    /** Get all active signals (primarily for debugging/observability) */
+    snapshot(): Promise<Signal[]>;
+}
+export interface Subscription {
+    unsubscribe(): void;
+}
+export interface DecayResult {
+    /** Number of signals that had their concentration reduced */
+    decayed: number;
+    /** Number of signals that were evaporated (removed) entirely */
+    evaporated: number;
+    /** Number of expired claims that were released */
+    claimsReleased: number;
+}
+export interface ColonyDefinition<T = Record<string, unknown>> {
+    /** Colony name — all instances share this identity */
+    name: string;
+    /** Which environment this colony operates in */
+    environment: Environment;
+    /** What signals this colony watches for */
+    sensors: SensorConfig[];
+    /** The rules that map stimuli to responses */
+    rules: Rule<T>[];
+    /** How many concurrent agents can run */
+    concurrency: number;
+    /** How to handle contention for the same signal */
+    claimStrategy: ClaimStrategy;
+    /** Colony-level configuration */
+    config?: ColonyConfig;
+}
+export interface SensorConfig {
+    /** Signal query to watch */
+    query: SignalQuery;
+    /** Polling interval in ms (for environments that don't support watch) */
+    pollInterval?: number;
+    /** Whether to use push-based watching (preferred) or polling */
+    mode?: 'watch' | 'poll';
+}
+export interface Rule<T = Record<string, unknown>> {
+    /** Human-readable rule name */
+    name: string;
+    /**
+     * Guard condition — if this returns false, the rule doesn't fire.
+     * Use for additional filtering beyond what the sensor query provides.
+     */
+    when?: (signal: Signal<T>) => boolean | Promise<boolean>;
+    /**
+     * The action to take when the rule fires.
+     * Receives the triggering signal and a context for depositing new signals.
+     */
+    do: (signal: Signal<T>, ctx: ActionContext) => Promise<void>;
+    /** Priority relative to other rules (higher = evaluated first) */
+    priority?: number;
+}
+export interface ActionContext {
+    /** The colony name performing this action */
+    colony: string;
+    /** Deposit a new signal into the environment */
+    deposit(type: string, payload?: Record<string, unknown>, options?: {
+        ttl?: number;
+        tags?: string[];
+        causedBy?: string[];
+    }): Promise<Signal>;
+    /** Withdraw a signal (typically the one being processed) */
+    withdraw(signalId: string): Promise<void>;
+    /** Log a message (routed through the framework's logging) */
+    log(message: string, level?: 'debug' | 'info' | 'warn' | 'error'): void;
+    /** Manually deposit a heartbeat signal (no-op if heartbeat not configured) */
+    heartbeat(payload?: Record<string, unknown>): Promise<void>;
+}
+export type ClaimStrategy = 'optimistic' | 'exclusive' | 'lease' | 'none';
+export interface ColonyConfig {
+    /** How often the sensor polls (if not using watch mode) */
+    defaultPollInterval?: number;
+    /** Whether to automatically withdraw signals after processing */
+    autoWithdraw?: boolean;
+    /** Decay configuration for signals this colony deposits */
+    decayRate?: number;
+    /** Max time a single rule action can take before timeout */
+    actionTimeout?: number;
+    /** Retry configuration for failed actions */
+    retry?: {
+        maxAttempts: number;
+        backoffMs: number;
+    };
+    /** Heartbeat configuration — deposits periodic signals during long-running actions */
+    heartbeat?: HeartbeatConfig;
+}
+export interface HeartbeatConfig {
+    /** Milliseconds between heartbeat deposits */
+    interval: number;
+    /** TTL in ms for heartbeat signals. Defaults to Math.round(interval * 2.5) */
+    ttl?: number;
+    /** Signal type for heartbeat. Defaults to 'heartbeat:{colonyName}' */
+    type?: string;
+}
+export interface ColonyRuntime {
+    /** Start the colony — begins sensor loops */
+    start(): Promise<void>;
+    /** Stop the colony gracefully */
+    stop(): Promise<void>;
+    /** Current runtime state */
+    readonly state: RuntimeState;
+    /** Number of currently active agent tasks */
+    readonly activeCount: number;
+    /** Runtime statistics */
+    readonly stats: RuntimeStats;
+    /** Subscribe to runtime events */
+    on(event: RuntimeEvent, handler: (...args: any[]) => void): void;
+}
+export type RuntimeState = 'idle' | 'running' | 'stopping' | 'stopped';
+export interface RuntimeStats {
+    signalsSensed: number;
+    signalsClaimed: number;
+    signalsProcessed: number;
+    signalsDeposited: number;
+    claimConflicts: number;
+    errors: number;
+    avgProcessingMs: number;
+}
+/**
+ * Runtime event types — the canonical set of events emitted by the stigmergy loop.
+ * Re-exported from events.ts as RuntimeEvent for backward compatibility.
+ */
+import type { RuntimeEventType } from './events.js';
+export type RuntimeEvent = RuntimeEventType;
+export interface DecayPolicy {
+    /** How fast concentration drops (units per second) */
+    rate: number;
+    /** Minimum concentration before signal is evaporated entirely */
+    floor: number;
+    /** Whether to auto-release expired claims */
+    releaseExpiredClaims: boolean;
+    /** How often to run the decay sweep (ms) */
+    interval: number;
+}
+export declare const DEFAULT_DECAY_POLICY: DecayPolicy;
+/**
+ * Trust levels assigned to signals based on provenance verification.
+ *   'verified'   — colony signature valid, full attestation chain checks out
+ *   'attested'   — bridge attestation present but colony signature missing
+ *   'unverified' — no provenance metadata (local signals, legacy systems)
+ *   'rejected'   — failed verification (quarantined, not evicted)
+ */
+export type TrustLevel = 'verified' | 'attested' | 'unverified' | 'rejected';
+/**
+ * A single attestation in the chain of custody for a bridged signal.
+ * Each bridge that transfers a signal appends its own attestation.
+ * Verification walks the chain from origin → current environment.
+ */
+export interface Attestation {
+    /** Identity of the bridge or environment that attests this transfer */
+    attester: string;
+    /** Public key (hex-encoded) of the attesting entity */
+    attesterKey: string;
+    /** Environment the signal was transferred FROM */
+    sourceEnvironment: string;
+    /** Environment the signal was transferred TO */
+    targetEnvironment: string;
+    /** When this attestation was created (epoch ms) */
+    timestamp: number;
+    /**
+     * Ed25519 signature over the attestation content.
+     * Signs: hash(signalId + sourceEnvironment + targetEnvironment + timestamp + previousSignature?)
+     * This creates a chain — each attestation signs over the previous one.
+     */
+    signature: string;
+    /** Optional human-readable note about the transfer */
+    note?: string;
+}
+/**
+ * Colony identity — the cryptographic identity of a colony.
+ * Generated once when a colony is first created, persisted across restarts.
+ * The private key stays with the colony; the public key is shared.
+ */
+export interface ColonyIdentity {
+    /** Colony name (must match ColonyDefinition.name) */
+    name: string;
+    /** Ed25519 public key, hex-encoded */
+    publicKey: string;
+    /** Ed25519 private key, hex-encoded. NEVER share or log this. */
+    privateKey: string;
+    /** Which environment this colony is registered in */
+    environment: string;
+    /** When the identity was created */
+    createdAt: number;
+    /** Optional metadata (version, capabilities, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Trust policy for an environment — defines how signals are evaluated.
+ * Phase 2 feature: environments will enforce these policies during deposit.
+ * For now, policies are advisory and used by Sentinel colonies.
+ */
+export interface TrustPolicy {
+    /** Policy name for logging/debugging */
+    name: string;
+    /** Default trust level for signals with no provenance metadata */
+    defaultTrust: TrustLevel;
+    /** Whether to accept signals below a certain trust level */
+    minimumTrust: TrustLevel;
+    /** Explicitly trusted colony public keys (always 'verified' if sig checks out) */
+    trustedColonies: string[];
+    /** Explicitly trusted bridge/attester public keys */
+    trustedBridges: string[];
+    /**
+     * Environments whose signals are accepted via bridge.
+     * Empty array = accept from any environment.
+     * Undefined = accept from any environment.
+     */
+    allowedSourceEnvironments?: string[];
+    /**
+     * Environments whose signals are rejected regardless of attestation.
+     */
+    blockedSourceEnvironments?: string[];
+    /** Whether to quarantine rejected signals (keep but mark) or drop them entirely */
+    quarantineRejected: boolean;
+    /**
+     * Maximum age of the oldest attestation in the chain (ms).
+     * Prevents replay attacks with ancient attestation chains.
+     */
+    maxAttestationAge?: number;
+    /**
+     * Maximum number of hops (attestations) allowed in the chain.
+     * Prevents signals from traveling through too many intermediaries.
+     */
+    maxAttestationDepth?: number;
+}
+/**
+ * Configuration for signal signing within a colony.
+ * Passed to colony runtime to enable automatic signing.
+ */
+export interface SigningConfig {
+    /** Colony identity with private key for signing */
+    identity: ColonyIdentity;
+    /** Whether to sign all deposited signals (default: true) */
+    signAll?: boolean;
+    /** Signal types to exclude from signing (e.g., debug signals) */
+    excludeTypes?: string[];
+}
+/**
+ * Result of verifying a signal's provenance.
+ */
+export interface VerificationResult {
+    /** The trust level determined by verification */
+    trustLevel: TrustLevel;
+    /** Whether the colony signature is valid (if present) */
+    signatureValid: boolean | null;
+    /** Whether the attestation chain is valid (if present) */
+    attestationChainValid: boolean | null;
+    /** Human-readable reason for the trust level */
+    reason: string;
+    /** Individual attestation verification results */
+    attestationResults?: Array<{
+        attester: string;
+        valid: boolean;
+        reason: string;
+    }>;
+}
+/**
+ * Bridge configuration for connecting two environments.
+ */
+export interface BridgeConfig {
+    /** Human-readable bridge name */
+    name: string;
+    /** Bridge identity for signing attestations */
+    identity: ColonyIdentity;
+    /** Source environment to mirror signals FROM */
+    source: Environment;
+    /** Target environment to mirror signals TO */
+    target: Environment;
+    /** Which signal types to bridge (glob patterns) */
+    signalTypes: string[];
+    /** Whether to bridge in both directions */
+    bidirectional?: boolean;
+    /** Transform signals during bridging (e.g., remap types, filter fields) */
+    transform?: (signal: Signal) => Signal | null;
+    /** How often to poll source for new signals (ms). Only if source doesn't support watch. */
+    pollInterval?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/types.d.ts.map

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

package/dist/src/core/types.js

@@ -0,0 +1,19 @@
+// ============================================================
+// @stigmergy/core — Type System
+// ============================================================
+// The fundamental primitives of stigmergic coordination.
+// Every concept maps to a biological analogy:
+//   Signal    = pheromone
+//   Environment = substrate (ground, nest, repo, filesystem)
+//   Colony    = ant colony (group of identical agents)
+//   Sensor    = antennae
+//   Actuator  = mandibles
+//   Rule      = instinct (stimulus → response)
+// ============================================================
+export const DEFAULT_DECAY_POLICY = {
+    rate: 0.01, // lose 1% per second
+    floor: 0.05, // evaporate below 5%
+    releaseExpiredClaims: true,
+    interval: 5_000, // sweep every 5 seconds
+};
+//# sourceMappingURL=types.js.map

package/dist/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAC/D,yDAAyD;AACzD,8CAA8C;AAC9C,0BAA0B;AAC1B,6DAA6D;AAC7D,uDAAuD;AACvD,yBAAyB;AACzB,0BAA0B;AAC1B,+CAA+C;AAC/C,+DAA+D;AAwW/D,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,IAAI,EAAE,IAAI,EAAW,qBAAqB;IAC1C,KAAK,EAAE,IAAI,EAAU,qBAAqB;IAC1C,oBAAoB,EAAE,IAAI;IAC1B,QAAQ,EAAE,KAAK,EAAM,wBAAwB;CAC9C,CAAC"}

package/dist/src/core/validation.d.ts

@@ -0,0 +1,10 @@
+import type { SignalMeta } from './types.js';
+export declare class SignalValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateSignalInput(input: {
+    type: string;
+    payload: unknown;
+    meta?: Partial<SignalMeta>;
+}): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/validation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,GACpE,IAAI,CAkCN"}

package/dist/src/core/validation.js

@@ -0,0 +1,40 @@
+// ============================================================
+// Signal Validation — reject malformed signals at deposit time
+// ============================================================
+export class SignalValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SignalValidationError';
+    }
+}
+export function validateSignalInput(input) {
+    if (typeof input.type !== 'string' || input.type.trim() === '') {
+        throw new SignalValidationError('Signal type must be a non-empty string');
+    }
+    if (input.payload === null || input.payload === undefined || typeof input.payload !== 'object' || Array.isArray(input.payload)) {
+        throw new SignalValidationError('Signal payload must be a plain object (not null, not array)');
+    }
+    if (input.meta) {
+        if (input.meta.deposited_by !== undefined) {
+            if (typeof input.meta.deposited_by !== 'string' || input.meta.deposited_by.trim() === '') {
+                throw new SignalValidationError('Signal meta.deposited_by must be a non-empty string');
+            }
+        }
+        if (input.meta.concentration !== undefined) {
+            if (typeof input.meta.concentration !== 'number' || input.meta.concentration < 0 || input.meta.concentration > 1) {
+                throw new SignalValidationError('Signal meta.concentration must be a number between 0 and 1');
+            }
+        }
+        if (input.meta.ttl !== undefined) {
+            if (typeof input.meta.ttl !== 'number' || input.meta.ttl <= 0) {
+                throw new SignalValidationError('Signal meta.ttl must be a positive number');
+            }
+        }
+        if (input.meta.tags !== undefined) {
+            if (!Array.isArray(input.meta.tags) || !input.meta.tags.every(t => typeof t === 'string')) {
+                throw new SignalValidationError('Signal meta.tags must be an array of strings');
+            }
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/core/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/core/validation.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,+DAA+D;AAI/D,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAqE;IAErE,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,qBAAqB,CAAC,wCAAwC,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/H,MAAM,IAAI,qBAAqB,CAAC,6DAA6D,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzF,MAAM,IAAI,qBAAqB,CAAC,qDAAqD,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;gBACjH,MAAM,IAAI,qBAAqB,CAAC,4DAA4D,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,qBAAqB,CAAC,2CAA2C,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC1F,MAAM,IAAI,qBAAqB,CAAC,8CAA8C,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}