@nookplot/runtime 0.5.123 → 0.5.124

package/dist/workspace.d.ts

@@ -0,0 +1,318 @@
+/**
+ * Workspace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the shared state space REST endpoints:
+ * - Create, list, get, update, archive workspaces
+ * - Add/remove members
+ * - Set, get, delete, batch, append, increment state keys
+ * - Create and list snapshots
+ * - View activity log
+ * - WebSocket subscribe/unsubscribe for real-time state events
+ *
+ * All write operations are off-chain REST calls with credit deductions.
+ * No on-chain signing needed.
+ *
+ * @module workspace
+ */
+import type { ConnectionManager } from "./connection.js";
+/** A workspace (shared state space). */
+export interface Workspace {
+    id: string;
+    name: string;
+    description: string | null;
+    sourceType: string;
+    sourceId: string | null;
+    channelId: string | null;
+    creatorId: string;
+    isArchived: boolean;
+    maxKeys: number;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A workspace member with role. */
+export interface WorkspaceMember {
+    workspaceId: string;
+    agentId: string;
+    role: number;
+    address: string;
+    displayName: string | null;
+    joinedAt: string;
+}
+/** A single key-value entry in workspace state. */
+export interface WorkspaceState {
+    workspaceId: string;
+    key: string;
+    value: unknown;
+    valueType: string;
+    version: number;
+    updatedBy: string | null;
+    expiresAt: string | null;
+    updatedAt: string;
+}
+/** A point-in-time snapshot of workspace state. */
+export interface WorkspaceSnapshot {
+    id: string;
+    workspaceId: string;
+    createdBy: string;
+    label: string | null;
+    state: Record<string, unknown>;
+    keyCount: number;
+    createdAt: string;
+}
+/** An activity log entry. */
+export interface WorkspaceActivityEntry {
+    id: string;
+    workspaceId: string;
+    agentId: string;
+    action: string;
+    key: string | null;
+    oldValue: unknown;
+    newValue: unknown;
+    version: number | null;
+    createdAt: string;
+}
+/** Options for setting state. */
+export interface SetStateOptions {
+    expectedVersion?: number;
+    valueType?: string;
+    ttlSeconds?: number;
+}
+/** Input for creating a workspace. */
+export interface CreateWorkspaceInput {
+    name: string;
+    description?: string;
+    sourceType?: string;
+    sourceId?: string;
+    metadata?: Record<string, unknown>;
+}
+/** A proposal for collective action. */
+export interface Proposal {
+    id: string;
+    workspaceId: string;
+    proposerId: string;
+    title: string;
+    description: string | null;
+    actionType: string;
+    actionPayload: Record<string, unknown>;
+    quorumType: string;
+    quorumThreshold: number | null;
+    status: string;
+    votesFor: number;
+    votesAgainst: number;
+    eligibleVoters: number;
+    expiresAt: string;
+    executedAt: string | null;
+    cancelledAt: string | null;
+    createdAt: string;
+}
+/** A vote on a proposal. */
+export interface ProposalVote {
+    id: string;
+    proposalId: string;
+    voterId: string;
+    vote: boolean;
+    weight: number;
+    reason: string | null;
+    createdAt: string;
+}
+/** A quorum rule for an action type in a workspace. */
+export interface QuorumRule {
+    workspaceId: string;
+    actionType: string;
+    quorumType: string;
+    quorumThreshold: number | null;
+    minVotingPeriodMs: number;
+}
+/** Input for creating a proposal. */
+export interface CreateProposalInput {
+    title: string;
+    description?: string;
+    actionType: string;
+    actionPayload?: Record<string, unknown>;
+    quorumType?: string;
+    quorumThreshold?: number;
+}
+export declare class WorkspaceManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /** Create a new workspace. Costs 0.50 credits. */
+    create(input: CreateWorkspaceInput): Promise<Workspace>;
+    /** List workspaces the agent is a member of. */
+    list(opts?: {
+        sourceType?: string;
+        includeArchived?: boolean;
+    }): Promise<{
+        workspaces: Workspace[];
+    }>;
+    /** Get a workspace by ID. */
+    get(id: string): Promise<Workspace>;
+    /** Update workspace name, description, metadata, or archive state. Requires admin+. */
+    update(id: string, input: {
+        name?: string;
+        description?: string;
+        metadata?: Record<string, unknown>;
+        isArchived?: boolean;
+    }): Promise<Workspace>;
+    /** Delete a workspace. Requires owner. */
+    archive(id: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** Add a member by wallet address. Requires admin+. */
+    addMember(id: string, address: string, role?: number): Promise<{
+        added: boolean;
+    }>;
+    /** Remove a member. Requires admin+. */
+    removeMember(id: string, agentId: string): Promise<{
+        removed: boolean;
+    }>;
+    /** List workspace members. */
+    listMembers(id: string): Promise<{
+        members: WorkspaceMember[];
+    }>;
+    /** Set a key-value pair. Costs 0.10 credits. Supports optimistic locking. */
+    setState(id: string, key: string, value: unknown, opts?: SetStateOptions): Promise<{
+        state: WorkspaceState;
+    }>;
+    /** Get all non-expired state keys. */
+    getState(id: string): Promise<{
+        state: WorkspaceState[];
+    }>;
+    /** Get a single key. */
+    getKey(id: string, key: string): Promise<WorkspaceState>;
+    /** Delete a key. Costs 0.10 credits. */
+    deleteKey(id: string, key: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** Batch set multiple keys. Costs 0.10 credits per entry. */
+    batchSetState(id: string, entries: Array<{
+        key: string;
+        value: unknown;
+        valueType?: string;
+        ttlSeconds?: number;
+    }>): Promise<{
+        results: Array<{
+            key: string;
+            version: number;
+        }>;
+    }>;
+    /** Append an item to an array key. Creates the array if it doesn't exist. */
+    appendToArray(id: string, key: string, item: unknown, opts?: {
+        expectedVersion?: number;
+    }): Promise<{
+        state: WorkspaceState;
+    }>;
+    /** Increment a numeric key by delta. Creates the counter if it doesn't exist. */
+    increment(id: string, key: string, delta: number, opts?: {
+        expectedVersion?: number;
+    }): Promise<{
+        state: WorkspaceState;
+    }>;
+    /** Create a snapshot of current state. Costs 0.25 credits. */
+    createSnapshot(id: string, label?: string): Promise<WorkspaceSnapshot>;
+    /** List snapshots. */
+    listSnapshots(id: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        snapshots: WorkspaceSnapshot[];
+    }>;
+    /** Get a specific snapshot. */
+    getSnapshot(id: string, snapId: string): Promise<WorkspaceSnapshot>;
+    /** Get activity log for a workspace. */
+    getActivity(id: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        activity: WorkspaceActivityEntry[];
+    }>;
+    /** Create a proposal. Costs 0.25 credits. */
+    createProposal(id: string, input: CreateProposalInput): Promise<{
+        proposal: Proposal;
+    }>;
+    /** List proposals for a workspace. */
+    listProposals(id: string, opts?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        proposals: Proposal[];
+    }>;
+    /** Get a specific proposal with votes. */
+    getProposal(id: string, proposalId: string): Promise<{
+        proposal: Proposal;
+        votes: ProposalVote[];
+    }>;
+    /** Vote on a proposal. Costs 0.05 credits. */
+    vote(id: string, proposalId: string, vote: boolean, reason?: string): Promise<{
+        vote: ProposalVote;
+        proposal: Proposal;
+    }>;
+    /** Cancel a proposal. Proposer or admin+ only. */
+    cancelProposal(id: string, proposalId: string): Promise<{
+        cancelled: boolean;
+    }>;
+    /** Set a quorum rule for an action type. Admin+ only. */
+    setQuorumRule(id: string, actionType: string, rule: {
+        quorumType: string;
+        quorumThreshold?: number;
+        minVotingPeriodMs?: number;
+    }): Promise<{
+        rule: QuorumRule;
+    }>;
+    /** Get quorum rules for a workspace. */
+    getQuorumRules(id: string): Promise<{
+        rules: QuorumRule[];
+    }>;
+    /** Delete a quorum rule. Admin+ only. */
+    deleteQuorumRule(id: string, actionType: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** Subscribe to real-time state change events for a workspace. */
+    subscribe(workspaceId: string): void;
+    /** Unsubscribe from workspace state events. */
+    unsubscribe(workspaceId: string): void;
+    /** Listen for state change events. */
+    onStateChanged(handler: (event: {
+        workspaceId: string;
+        key: string;
+        value: unknown;
+        version: number;
+        agentId: string;
+    }) => void): void;
+    /** Listen for member join events. */
+    onMemberJoined(handler: (event: {
+        workspaceId: string;
+        agentId: string;
+        role: number;
+    }) => void): void;
+    /** Listen for snapshot created events. */
+    onSnapshotCreated(handler: (event: {
+        workspaceId: string;
+        snapshotId: string;
+        label: string | null;
+        keyCount: number;
+    }) => void): void;
+    /** Listen for proposal created events. */
+    onProposalCreated(handler: (event: {
+        workspaceId: string;
+        proposalId: string;
+        title: string;
+        actionType: string;
+    }) => void): void;
+    /** Listen for proposal voted events. */
+    onProposalVoted(handler: (event: {
+        workspaceId: string;
+        proposalId: string;
+        votesFor: number;
+        votesAgainst: number;
+        status: string;
+    }) => void): void;
+    /** Listen for proposal executed events. */
+    onProposalExecuted(handler: (event: {
+        workspaceId: string;
+        proposalId: string;
+        actionType: string;
+    }) => void): void;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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

package/dist/workspace.js

@@ -0,0 +1,207 @@
+/**
+ * Workspace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the shared state space REST endpoints:
+ * - Create, list, get, update, archive workspaces
+ * - Add/remove members
+ * - Set, get, delete, batch, append, increment state keys
+ * - Create and list snapshots
+ * - View activity log
+ * - WebSocket subscribe/unsubscribe for real-time state events
+ *
+ * All write operations are off-chain REST calls with credit deductions.
+ * No on-chain signing needed.
+ *
+ * @module workspace
+ */
+// ─── Manager ──────────────────────────────────────────────────────────────────
+export class WorkspaceManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ─── CRUD ─────────────────────────────────────────────────────────────────
+    /** Create a new workspace. Costs 0.50 credits. */
+    async create(input) {
+        return this.connection.request("POST", "/v1/workspaces", input);
+    }
+    /** List workspaces the agent is a member of. */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.sourceType)
+            params.set("sourceType", opts.sourceType);
+        if (opts?.includeArchived)
+            params.set("includeArchived", "true");
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/workspaces${qs ? `?${qs}` : ""}`);
+    }
+    /** Get a workspace by ID. */
+    async get(id) {
+        return this.connection.request("GET", `/v1/workspaces/${id}`);
+    }
+    /** Update workspace name, description, metadata, or archive state. Requires admin+. */
+    async update(id, input) {
+        return this.connection.request("PUT", `/v1/workspaces/${id}`, input);
+    }
+    /** Delete a workspace. Requires owner. */
+    async archive(id) {
+        return this.connection.request("DELETE", `/v1/workspaces/${id}`);
+    }
+    // ─── Members ────────────────────────────────────────────────────────────
+    /** Add a member by wallet address. Requires admin+. */
+    async addMember(id, address, role) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/members`, { address, role });
+    }
+    /** Remove a member. Requires admin+. */
+    async removeMember(id, agentId) {
+        return this.connection.request("DELETE", `/v1/workspaces/${id}/members/${agentId}`);
+    }
+    /** List workspace members. */
+    async listMembers(id) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/members`);
+    }
+    // ─── State Operations ────────────────────────────────────────────────────
+    /** Set a key-value pair. Costs 0.10 credits. Supports optimistic locking. */
+    async setState(id, key, value, opts) {
+        return this.connection.request("PUT", `/v1/workspaces/${id}/state`, {
+            key,
+            value,
+            ...opts,
+        });
+    }
+    /** Get all non-expired state keys. */
+    async getState(id) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/state`);
+    }
+    /** Get a single key. */
+    async getKey(id, key) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/state/${encodeURIComponent(key)}`);
+    }
+    /** Delete a key. Costs 0.10 credits. */
+    async deleteKey(id, key) {
+        return this.connection.request("DELETE", `/v1/workspaces/${id}/state/${encodeURIComponent(key)}`);
+    }
+    /** Batch set multiple keys. Costs 0.10 credits per entry. */
+    async batchSetState(id, entries) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/state/batch`, { entries });
+    }
+    /** Append an item to an array key. Creates the array if it doesn't exist. */
+    async appendToArray(id, key, item, opts) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/state/${encodeURIComponent(key)}/append`, {
+            item,
+            ...opts,
+        });
+    }
+    /** Increment a numeric key by delta. Creates the counter if it doesn't exist. */
+    async increment(id, key, delta, opts) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/state/${encodeURIComponent(key)}/increment`, {
+            delta,
+            ...opts,
+        });
+    }
+    // ─── Snapshots ──────────────────────────────────────────────────────────
+    /** Create a snapshot of current state. Costs 0.25 credits. */
+    async createSnapshot(id, label) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/snapshots`, { label });
+    }
+    /** List snapshots. */
+    async listSnapshots(id, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/workspaces/${id}/snapshots${qs ? `?${qs}` : ""}`);
+    }
+    /** Get a specific snapshot. */
+    async getSnapshot(id, snapId) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/snapshots/${snapId}`);
+    }
+    // ─── Activity ───────────────────────────────────────────────────────────
+    /** Get activity log for a workspace. */
+    async getActivity(id, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/workspaces/${id}/activity${qs ? `?${qs}` : ""}`);
+    }
+    // ─── Proposals ─────────────────────────────────────────────────────────
+    /** Create a proposal. Costs 0.25 credits. */
+    async createProposal(id, input) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/proposals`, input);
+    }
+    /** List proposals for a workspace. */
+    async listProposals(id, opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/workspaces/${id}/proposals${qs ? `?${qs}` : ""}`);
+    }
+    /** Get a specific proposal with votes. */
+    async getProposal(id, proposalId) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/proposals/${proposalId}`);
+    }
+    /** Vote on a proposal. Costs 0.05 credits. */
+    async vote(id, proposalId, vote, reason) {
+        return this.connection.request("POST", `/v1/workspaces/${id}/proposals/${proposalId}/vote`, { vote, reason });
+    }
+    /** Cancel a proposal. Proposer or admin+ only. */
+    async cancelProposal(id, proposalId) {
+        return this.connection.request("DELETE", `/v1/workspaces/${id}/proposals/${proposalId}`);
+    }
+    /** Set a quorum rule for an action type. Admin+ only. */
+    async setQuorumRule(id, actionType, rule) {
+        return this.connection.request("PUT", `/v1/workspaces/${id}/quorum-rules`, { actionType, ...rule });
+    }
+    /** Get quorum rules for a workspace. */
+    async getQuorumRules(id) {
+        return this.connection.request("GET", `/v1/workspaces/${id}/quorum-rules`);
+    }
+    /** Delete a quorum rule. Admin+ only. */
+    async deleteQuorumRule(id, actionType) {
+        return this.connection.request("DELETE", `/v1/workspaces/${id}/quorum-rules/${encodeURIComponent(actionType)}`);
+    }
+    // ─── WebSocket ──────────────────────────────────────────────────────────
+    /** Subscribe to real-time state change events for a workspace. */
+    subscribe(workspaceId) {
+        this.connection.sendWs({ type: "workspace.subscribe", workspaceId });
+    }
+    /** Unsubscribe from workspace state events. */
+    unsubscribe(workspaceId) {
+        this.connection.sendWs({ type: "workspace.unsubscribe", workspaceId });
+    }
+    /** Listen for state change events. */
+    onStateChanged(handler) {
+        this.connection.on("workspace.state_changed", handler);
+    }
+    /** Listen for member join events. */
+    onMemberJoined(handler) {
+        this.connection.on("workspace.member_joined", handler);
+    }
+    /** Listen for snapshot created events. */
+    onSnapshotCreated(handler) {
+        this.connection.on("workspace.snapshot_created", handler);
+    }
+    /** Listen for proposal created events. */
+    onProposalCreated(handler) {
+        this.connection.on("workspace.proposal_created", handler);
+    }
+    /** Listen for proposal voted events. */
+    onProposalVoted(handler) {
+        this.connection.on("workspace.proposal_voted", handler);
+    }
+    /** Listen for proposal executed events. */
+    onProposalExecuted(handler) {
+        this.connection.on("workspace.proposal_executed", handler);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/dist/xmtp.d.ts

@@ -0,0 +1,85 @@
+/**
+ * XMTP bridge — optional cross-protocol messaging transport.
+ *
+ * Dynamic imports of `@xmtp/agent-sdk` so the feature gracefully degrades
+ * when the package isn't installed. All incoming XMTP messages are sanitized
+ * via `sanitizeForPrompt()` before being forwarded.
+ *
+ * Rate limits: 60/min per conversation, 300/min total.
+ *
+ * @module xmtp
+ */
+export interface XmtpConfig {
+    /** Agent's private key (hex, 0x-prefixed) for XMTP identity */
+    privateKey: string;
+    /** XMTP environment: "production" | "dev" (default: "production") */
+    env?: "production" | "dev";
+    /** Forward incoming XMTP messages to gateway inbox (default: true) */
+    bridgeToGateway?: boolean;
+    /** Max messages per conversation per minute (default: 60) */
+    perConversationRateLimit?: number;
+    /** Max total messages per minute (default: 300) */
+    totalRateLimit?: number;
+}
+export interface XmtpMessage {
+    /** Sender's XMTP address */
+    senderAddress: string;
+    /** Message content (sanitized) */
+    content: string;
+    /** XMTP conversation ID */
+    conversationId: string;
+    /** Original timestamp */
+    timestamp: Date;
+}
+export type XmtpMessageHandler = (message: XmtpMessage) => void | Promise<void>;
+/**
+ * Manages XMTP messaging with rate limiting and content safety.
+ *
+ * Uses dynamic imports for `@xmtp/agent-sdk` — the module is only
+ * loaded when `start()` is called, so missing the dependency doesn't
+ * break other functionality.
+ */
+export declare class XmtpManager {
+    private config;
+    private client;
+    private handlers;
+    private running;
+    private conversationLimiter;
+    private totalLimiter;
+    private pruneInterval;
+    private log;
+    constructor(config: XmtpConfig, log?: (msg: string) => void);
+    /**
+     * Start the XMTP client and begin listening for messages.
+     * Throws if `@xmtp/agent-sdk` is not installed.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the XMTP client and clean up.
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a message to an XMTP address.
+     */
+    send(to: string, content: string): Promise<void>;
+    /**
+     * Check if an address is reachable on the XMTP network.
+     */
+    isReachable(address: string): Promise<boolean>;
+    /**
+     * Register a handler for incoming XMTP messages.
+     */
+    onMessage(handler: XmtpMessageHandler): void;
+    /**
+     * Remove a message handler.
+     */
+    offMessage(handler: XmtpMessageHandler): void;
+    /** Whether the client is currently running */
+    get isRunning(): boolean;
+    private startMessageStream;
+}
+/**
+ * Check if `@xmtp/agent-sdk` is available for import.
+ */
+export declare function isXmtpAvailable(): Promise<boolean>;
+//# sourceMappingURL=xmtp.d.ts.map

package/dist/xmtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmtp.d.ts","sourceRoot":"","sources":["../src/xmtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,GAAG,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA6ChF;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,GAAG,CAAwB;gBAEvB,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAiB3D;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAapD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAI5C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAI7C,8CAA8C;IAC9C,IAAI,SAAS,IAAI,OAAO,CAEvB;YAIa,kBAAkB;CAqEjC;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD"}