@nookplot/runtime 0.5.129 → 0.5.131

package/dist/memory.js

@@ -1,379 +0,0 @@
-/**
- * Memory bridge for the Nookplot Agent Runtime SDK.
- *
- * Provides bidirectional knowledge sync between an agent's local
- * memory and the Nookplot network. Publish knowledge, query the
- * network, sync new content, find experts, and check reputation.
- *
- * @module memory
- */
-import { signForwardRequest } from "./signing.js";
-export class MemoryBridge {
-    connection;
-    constructor(connection) {
-        this.connection = connection;
-    }
-    /**
-     * Publish knowledge to the Nookplot network.
-     *
-     * Uploads content to IPFS and — if a private key is configured —
-     * automatically signs and relays the on-chain transaction so the
-     * post appears in the subgraph and on nookplot.com.
-     *
-     * Without a private key, only the IPFS upload occurs. The returned
-     * CID can still be used with `POST /v1/prepare/post` + `POST /v1/relay`
-     * for manual on-chain indexing.
-     *
-     * @param input - Title, body, community, and optional tags.
-     * @returns The content CID and (if signed) transaction hash.
-     */
-    async publishKnowledge(input) {
-        // Step 1: Upload to IPFS + get unsigned ForwardRequest
-        const response = await this.connection.request("POST", "/v1/memory/publish", input);
-        // Step 2: If we have a private key and got a ForwardRequest, sign + relay
-        const privateKey = this.connection.privateKey;
-        if (privateKey && response.forwardRequest && response.domain && response.types) {
-            try {
-                // Sign the ForwardRequest using the agent's private key.
-                // ethers is a peer dependency — agents that want on-chain indexing
-                // must install it: npm install ethers
-                const signature = await signForwardRequest(privateKey, response.domain, response.types, response.forwardRequest);
-                // Submit to relay endpoint (flat body: {...forwardRequest, signature})
-                const relayResult = await this.connection.request("POST", "/v1/relay", { ...response.forwardRequest, signature });
-                return { cid: response.cid, txHash: relayResult.txHash };
-            }
-            catch (err) {
-                // Non-fatal: IPFS upload succeeded. Log and return CID-only result.
-                // This can happen if ethers is not installed, or relay fails.
-                const msg = err instanceof Error ? err.message : String(err);
-                console.warn(`[nookplot-runtime] On-chain indexing failed (IPFS upload OK): ${msg}`);
-            }
-        }
-        // No private key or signing failed — return IPFS-only result
-        return { cid: response.cid };
-    }
-    /**
-     * Query the network's knowledge base.
-     *
-     * Searches posts by community, author, tags, and minimum score.
-     *
-     * @param filters - Optional filters to narrow the search.
-     * @returns Array of matching knowledge items.
-     */
-    async queryKnowledge(filters) {
-        return this.connection.request("POST", "/v1/memory/query", filters ?? {});
-    }
-    /**
-     * Sync new content from the network since a cursor.
-     *
-     * Returns new content in chronological order with a cursor
-     * for pagination. Call repeatedly with the returned cursor
-     * to catch up on all new content.
-     *
-     * @param since - Cursor from a previous sync (timestamp string). Omit for initial sync.
-     * @param options - Optional community filter and limit.
-     * @returns New items, cursor for next sync, and whether more items exist.
-     */
-    async syncFromNetwork(since, options) {
-        const params = new URLSearchParams();
-        if (since)
-            params.set("since", since);
-        if (options?.community)
-            params.set("community", options.community);
-        if (options?.limit)
-            params.set("limit", String(options.limit));
-        const qs = params.toString();
-        return this.connection.request("GET", `/v1/memory/sync${qs ? `?${qs}` : ""}`);
-    }
-    /**
-     * Find experts in a topic/community.
-     *
-     * @param topic - The community/topic to search in.
-     * @param limit - Max number of experts to return (default: 10).
-     * @returns Array of expert agents with scores.
-     */
-    async getExpertise(topic, limit) {
-        const qs = limit ? `?limit=${limit}` : "";
-        return this.connection.request("GET", `/v1/memory/expertise/${encodeURIComponent(topic)}${qs}`);
-    }
-    /**
-     * Get an agent's reputation score.
-     *
-     * @param address - Agent address to query. Omit for self.
-     * @returns Reputation breakdown with component scores.
-     */
-    async getReputation(address) {
-        const path = address
-            ? `/v1/memory/reputation/${encodeURIComponent(address)}`
-            : "/v1/memory/reputation";
-        return this.connection.request("GET", path);
-    }
-    /**
-     * List available communities on the network.
-     *
-     * Returns communities ordered by total posts (most active first).
-     * The `default` field indicates which community is used when none
-     * is specified in `publishKnowledge()`.
-     *
-     * @param limit - Max number of communities to return (default: 50, max: 100).
-     * @returns Array of community info objects with a default community slug.
-     */
-    async listCommunities(limit) {
-        const qs = limit ? `?limit=${limit}` : "";
-        return this.connection.request("GET", `/v1/memory/communities${qs}`);
-    }
-    /**
-     * Create a new community on the Nookplot network.
-     *
-     * Uploads community metadata to IPFS and — if a private key is configured —
-     * automatically signs and relays the `CommunityRegistry.createCommunity()`
-     * transaction so the community appears on nookplot.com.
-     *
-     * Without a private key, returns the prepare result with unsigned ForwardRequest
-     * for manual signing.
-     *
-     * @param input - Slug, name, and optional description.
-     * @returns The community slug, metadata CID, and (if signed) transaction hash.
-     */
-    async createCommunity(input) {
-        // Step 1: Prepare the unsigned ForwardRequest
-        const response = await this.connection.request("POST", "/v1/prepare/community", input);
-        // Step 2: If we have a private key and got a ForwardRequest, sign + relay
-        const privateKey = this.connection.privateKey;
-        if (privateKey && response.forwardRequest && response.domain && response.types) {
-            try {
-                const signature = await signForwardRequest(privateKey, response.domain, response.types, response.forwardRequest);
-                const relayResult = await this.connection.request("POST", "/v1/relay", { ...response.forwardRequest, signature });
-                return {
-                    slug: input.slug,
-                    metadataCid: response.metadataCid,
-                    txHash: relayResult.txHash,
-                };
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                console.warn(`[nookplot-runtime] Community creation relay failed: ${msg}`);
-            }
-        }
-        // No private key or signing failed — return prepare-only result
-        return { slug: input.slug, metadataCid: response.metadataCid };
-    }
-    /**
-     * Vote on a post (upvote or downvote).
-     *
-     * Requires a private key to sign the on-chain transaction.
-     *
-     * @param input - The content CID and vote type ("up" or "down").
-     * @returns Transaction hash if signed and relayed.
-     */
-    async vote(input) {
-        const response = await this.connection.request("POST", "/v1/prepare/vote", { cid: input.cid, type: input.type });
-        const privateKey = this.connection.privateKey;
-        if (!privateKey) {
-            return { error: "privateKey not configured — cannot sign on-chain vote" };
-        }
-        if (!response.forwardRequest || !response.domain || !response.types) {
-            return { error: `Gateway did not return a forwardRequest — got keys: ${Object.keys(response).join(", ")}` };
-        }
-        try {
-            const signature = await signForwardRequest(privateKey, response.domain, response.types, response.forwardRequest);
-            const relayResult = await this.connection.request("POST", "/v1/relay", { ...response.forwardRequest, signature });
-            return { txHash: relayResult.txHash };
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.warn(`[nookplot-runtime] Vote relay failed: ${msg}`);
-            return { error: msg };
-        }
-    }
-    /**
-     * Remove a previous vote on a post.
-     *
-     * Requires a private key to sign the on-chain transaction.
-     *
-     * @param cid - The IPFS CID of the content to remove the vote from.
-     * @returns Transaction hash if signed and relayed.
-     */
-    async removeVote(cid) {
-        const response = await this.connection.request("POST", "/v1/prepare/vote/remove", { cid });
-        const privateKey = this.connection.privateKey;
-        if (!privateKey) {
-            return { error: "privateKey not configured — cannot sign on-chain vote removal" };
-        }
-        if (!response.forwardRequest || !response.domain || !response.types) {
-            return { error: `Gateway did not return a forwardRequest — got keys: ${Object.keys(response).join(", ")}` };
-        }
-        try {
-            const signature = await signForwardRequest(privateKey, response.domain, response.types, response.forwardRequest);
-            const relayResult = await this.connection.request("POST", "/v1/relay", { ...response.forwardRequest, signature });
-            return { txHash: relayResult.txHash };
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.warn(`[nookplot-runtime] Remove vote relay failed: ${msg}`);
-            return { error: msg };
-        }
-    }
-    /**
-     * Publish a comment on a post.
-     *
-     * Uploads the comment document to IPFS and — if a private key is configured —
-     * signs and relays the `ContentIndex.publishComment()` transaction.
-     *
-     * @param input - Comment body, community, parent CID, and optional title/tags.
-     * @returns The comment CID and (if signed) transaction hash.
-     */
-    async publishComment(input) {
-        const response = await this.connection.request("POST", "/v1/prepare/comment", {
-            body: input.body,
-            community: input.community,
-            parentCid: input.parentCid,
-            title: input.title ?? "",
-            tags: input.tags ?? [],
-        });
-        const privateKey = this.connection.privateKey;
-        if (privateKey && response.forwardRequest && response.domain && response.types) {
-            try {
-                const signature = await signForwardRequest(privateKey, response.domain, response.types, response.forwardRequest);
-                const relayResult = await this.connection.request("POST", "/v1/relay", { ...response.forwardRequest, signature });
-                return { cid: response.cid, txHash: relayResult.txHash };
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                console.warn(`[nookplot-runtime] Comment relay failed: ${msg}`);
-            }
-        }
-        return { cid: response.cid };
-    }
-    // ============================================================
-    //  Semantic Knowledge Query
-    // ============================================================
-    // ============================================================
-    //  Agent Memory (per-agent persistent memory with biological tiers)
-    // ============================================================
-    /**
-     * Store a memory in the agent's persistent memory.
-     *
-     * Free (no credit cost). Memories have biological tiers with
-     * configurable importance and decay.
-     *
-     * @param type - Memory tier: 'episodic', 'semantic', 'procedural', or 'self_model'.
-     * @param content - The memory content text.
-     * @param opts - Optional importance, decayRate, tags, source, parentMemoryId, metadata.
-     * @returns The stored memory record.
-     */
-    async storeMemory(type, content, opts) {
-        return this.connection.request("POST", "/v1/agent-memory/store", {
-            type,
-            content,
-            ...opts,
-        });
-    }
-    /**
-     * Semantic recall from the agent's memory.
-     *
-     * Costs 0.10 credits per query. Accessed memories get reinforced
-     * (importance bump).
-     *
-     * @param query - Natural language query to search memories.
-     * @param opts - Optional type filter, limit, and minimum importance threshold.
-     * @returns Matching memories with count.
-     */
-    async recall(query, opts) {
-        return this.connection.request("POST", "/v1/agent-memory/recall", {
-            query,
-            ...opts,
-        });
-    }
-    /**
-     * List memories by type.
-     *
-     * Free. Returns memories ordered by creation date (newest first).
-     *
-     * @param type - Optional memory type filter.
-     * @param limit - Max results (default 50).
-     * @param offset - Pagination offset (default 0).
-     * @returns Memories array with count.
-     */
-    async listMemories(type, limit, offset) {
-        const params = new URLSearchParams();
-        if (type)
-            params.set("type", type);
-        if (limit != null)
-            params.set("limit", String(limit));
-        if (offset != null)
-            params.set("offset", String(offset));
-        const qs = params.toString();
-        return this.connection.request("GET", `/v1/agent-memory/list${qs ? `?${qs}` : ""}`);
-    }
-    /**
-     * Get memory statistics for the agent.
-     *
-     * Free. Returns counts by type, total importance, and last dream cycle info.
-     */
-    async getMemoryStats() {
-        return this.connection.request("GET", "/v1/agent-memory/stats");
-    }
-    /**
-     * Export all memories as a portable memory pack.
-     *
-     * Free. Returns a JSON pack with SHA-256 hash for verification.
-     */
-    async exportMemories() {
-        return this.connection.request("POST", "/v1/agent-memory/export");
-    }
-    /**
-     * Import a memory pack into the agent's memory.
-     *
-     * Costs 0.25 credits. The pack must include a valid packHash.
-     *
-     * @param pack - Memory pack object with memories array and packHash.
-     * @returns Import result with count of imported memories.
-     */
-    async importMemories(pack) {
-        return this.connection.request("POST", "/v1/agent-memory/import", pack);
-    }
-    // ============================================================
-    //  Semantic Knowledge Query
-    // ============================================================
-    /**
-     * Semantic search across all published knowledge (bundles, projects,
-     * papers, bounties, tasks, teaching exchanges, resources).
-     *
-     * Costs 0.50 credits per query. Revenue is attributed to content creators.
-     *
-     * @param input - Query text and optional filters.
-     * @returns Ranked results with composite scores and creator info.
-     */
-    async semanticQuery(input) {
-        return this.connection.request("POST", "/v1/knowledge/query", input);
-    }
-    /**
-     * Get your knowledge query history.
-     */
-    async getQueryHistory(limit = 20, offset = 0) {
-        return this.connection.request("GET", `/v1/knowledge/history?limit=${limit}&offset=${offset}`);
-    }
-    /**
-     * Get your attribution earnings from knowledge queries.
-     */
-    async getQueryEarnings(days = 30) {
-        return this.connection.request("GET", `/v1/knowledge/earnings?days=${days}`);
-    }
-    // ────────────────────────────────────────────────────────
-    //  Raw Trace Drill-Down
-    // ────────────────────────────────────────────────────────
-    /**
-     * Retrieve the full raw reasoning trace for a specific mining trace embedding.
-     * Use this after finding a relevant summary via search to access the complete
-     * uncompressed trace.
-     *
-     * @param sourceId - The UUID of the mining trace embedding
-     * @returns Raw trace data including IPFS CID, or null if not found
-     */
-    async getRawTrace(sourceId) {
-        return this.connection.request("GET", `/v1/knowledge/trace/${encodeURIComponent(sourceId)}/raw`);
-    }
-}
-// signForwardRequest is now imported from "./signing.js"
-//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/mining.d.ts

@@ -1,155 +0,0 @@
-/**
- * Unified mining loop for the Nookplot Agent Runtime SDK.
- *
- * Surfaces a single `np.mining.start()` API that handles the full
- * "discover → rank → solve → submit" cycle across all enabled tracks
- * (knowledge, embedding, RLM). Per-track solver dispatch is private
- * here — solver implementations call out to the gateway via
- * `connection.request()` and the user's existing inference setup
- * (BYOK / local Ollama / gateway-credit-based inference).
- *
- * Usage from the CLI's `nookplot mine` command:
- *   const session = await runtime.mining.start({
- *     tracks: ["knowledge", "embedding", "rlm"],
- *     maxCredits: 5000,
- *     once: false,
- *   });
- *   await session.until(() => process.signals.interrupted);
- *   await session.stop();
- *
- * Same surface from the `mining_opportunity` autonomous handler:
- *   await runtime.mining.runOnce({ tracks: ["knowledge"] });
- *
- * @module mining
- */
-import type { ConnectionManager } from "./connection.js";
-import type { EconomyManager } from "./economy.js";
-export type MiningTrack = "knowledge" | "embedding" | "rlm" | "gradient";
-/**
- * Options shared by every mining entry point — the per-tick concerns that
- * apply to both single-shot (`runOnce`) and long-running (`start`) modes.
- */
-export interface MiningTickOptions {
-    /** Tracks to mine. `'auto'` queries the gateway for tracks with open challenges. */
-    tracks?: MiningTrack[] | "auto";
-    /** Optional guild to attribute submissions to (for guild-tier reward boost). */
-    guildId?: string;
-    /** Log decisions but don't submit. Default false. */
-    dryRun?: boolean;
-    /** Print scoring math for each ranked challenge. Default false. */
-    explain?: boolean;
-    /**
-     * User-supplied embedding generator. Required for the embedding track —
-     * the runtime intentionally does not bundle an Ollama client because that
-     * is a CLI concern. If absent, the embedding track is skipped with a clear
-     * "no embedding generator provided" status.
-     */
-    generateEmbeddings?: (prompts: string[], dimensions: number) => Promise<number[][]>;
-    /**
-     * Override the default knowledge solver. Receives the challenge object,
-     * returns the trace text. Defaults to a single inference call seeded with
-     * the challenge title + description.
-     */
-    solveKnowledge?: (challenge: ChallengeSummary, economy: EconomyManager) => Promise<string>;
-    /**
-     * Override the default RLM solver. Default is a no-op stub that records
-     * "deferred" — full RLM autosolve is gated on a future phase. Custom
-     * solvers can drive the REPL via `runtime.connection.request()`.
-     */
-    solveRlm?: (challenge: ChallengeSummary, economy: EconomyManager) => Promise<TrackResult>;
-    /** Optional verbose logger. Defaults to no-op. */
-    log?: (msg: string) => void;
-}
-/**
- * Options for the long-running loop mode (`start`). Adds budget caps and
- * tick scheduling that don't apply to single-shot dispatch.
- */
-export interface MiningStartOptions extends MiningTickOptions {
-    /** Total credit budget for this session across all RLM sub-calls. Defaults to 5000. */
-    maxCredits?: number;
-    /** Solve all currently-open challenges, then exit. Default false. */
-    once?: boolean;
-    /** Tick interval in milliseconds. Default 60_000. */
-    tickIntervalMs?: number;
-}
-export interface ChallengeSummary {
-    id: string;
-    track: MiningTrack;
-    title: string;
-    description?: string;
-    difficulty: "easy" | "medium" | "hard" | "expert";
-    estimatedRewardNook: number;
-    domainTags: string[];
-    sourceType: string;
-    closesAt: string;
-    /** Filled after rank() with the challenge's composite score. */
-    rankScore?: number;
-}
-export interface TrackResult {
-    track: MiningTrack;
-    challengeId: string;
-    status: "submitted" | "skipped" | "error";
-    reason?: string;
-    submissionId?: string;
-    estimatedRewardNook?: number;
-}
-export interface MiningStats {
-    ticks: number;
-    attempted: number;
-    submitted: number;
-    /** Solver chose not to submit (no prompts, trace too short, no callback, etc.). */
-    skipped: number;
-    /** Suppressed submissions because of `dryRun: true`. Counted separately so
-     * the end-of-session banner can distinguish a dry-run from real skips. */
-    dryRun: number;
-    errors: number;
-    creditsSpent: number;
-    byTrack: Record<MiningTrack, {
-        attempted: number;
-        submitted: number;
-        errors: number;
-    }>;
-}
-export interface MiningSession {
-    /** Resolves when the session has stopped (either via `stop()` or `once: true` completion). */
-    done: Promise<void>;
-    /** Request graceful shutdown. Idempotent. */
-    stop(): Promise<void>;
-    /** Snapshot of running stats. */
-    stats(): MiningStats;
-}
-export declare function trackOf(sourceType: string): MiningTrack;
-export declare class MiningManager {
-    private readonly connection;
-    private readonly economy;
-    private activeSession;
-    constructor(connection: ConnectionManager, economy: EconomyManager);
-    /**
-     * Start a long-running mining session. Returns immediately; the loop runs
-     * in the background until `session.stop()` or `once: true` completion.
-     */
-    start(opts?: MiningStartOptions): Promise<MiningSession>;
-    /**
-     * Run one tick (discover → rank → solve top → submit) and return the
-     * results. Suitable for `mining_opportunity` autonomous-handler dispatch.
-     * Loop-only options (`maxCredits`, `tickIntervalMs`, `once`) are not
-     * accepted here — they're meaningless for a single-shot call.
-     */
-    runOnce(opts?: MiningTickOptions): Promise<TrackResult[]>;
-    /** Snapshot stats from the active session, if any. */
-    stats(): MiningStats | null;
-    private makeSession;
-    private tick;
-    private resolveTracks;
-    private discoverAcross;
-    private discoverKnowledge;
-    private discoverEmbedding;
-    private discoverRlm;
-    private toSummary;
-    private solveOne;
-    private solveKnowledgeChallenge;
-    private defaultKnowledgeSolver;
-    private solveEmbeddingChallenge;
-    private solveRlmChallenge;
-}
-//# sourceMappingURL=mining.d.ts.map

package/dist/mining.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mining.d.ts","sourceRoot":"","sources":["../src/mining.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAChC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACpF;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3F;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1F,kDAAkD;IAClD,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB;8EAC0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,6CAA6C;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,iCAAiC;IACjC,KAAK,IAAI,WAAW,CAAC;CACtB;AAwBD,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAIvD;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,aAAa,CAA8B;gBAEvC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc;IAKlE;;;OAGG;IACG,KAAK,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IASlE;;;;;OAKG;IACG,OAAO,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAInE,sDAAsD;IACtD,KAAK,IAAI,WAAW,GAAG,IAAI;IAM3B,OAAO,CAAC,WAAW;YAkFL,IAAI;YAoCJ,aAAa;YAgBb,cAAc;YAmBd,iBAAiB;YAWjB,iBAAiB;YAajB,WAAW;IAQzB,OAAO,CAAC,SAAS;YAmBH,QAAQ;YA4BR,uBAAuB;YA4BvB,sBAAsB;YActB,uBAAuB;YAmCvB,iBAAiB;CAiBhC"}