@withpica/mcp-server 1.3.0

package/dist/tools/custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custody.d.ts","sourceRoot":"","sources":["../../src/tools/custody.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAO3E,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA+N3D,KAAK;YAYL,OAAO;YAeP,IAAI;YA0BJ,OAAO;YAeP,cAAc;YAuBd,SAAS;CAgBxB"}

package/dist/tools/custody.js

@@ -0,0 +1,281 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatSuccess, withBillingGate, } from "@withpica/mcp-utils";
+export class CustodyTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            {
+                definition: {
+                    name: "pica_custody_claim",
+                    description: "Request custody of a work's composition or master chain. " +
+                        "If another org currently holds custody, creates a pending claim; the current " +
+                        "custodian has 7 days to accept, decline, or dispute before the claim auto-approves. " +
+                        "If you already hold custody, this errors. Admin/owner access required.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "UUID of the work to claim.",
+                            },
+                            chain: {
+                                type: "string",
+                                enum: ["composition", "master"],
+                                description: "'composition' = publishing rights; 'master' = recording rights.",
+                            },
+                            reason: {
+                                type: "string",
+                                description: "Optional freetext shown to the current custodian in the notification.",
+                            },
+                        },
+                        required: ["work_id", "chain"],
+                    },
+                    annotations: {
+                        title: "claim custody",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: withBillingGate(this.pica, "custody claim", this.claim.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_custody_respond",
+                    description: "Respond to an incoming custody claim. Actions: 'accept' transfers custody " +
+                        "to the claimant; 'decline' rejects the claim (custody unchanged); 'dispute' " +
+                        "freezes the claim for human review. reason is required for dispute. Only the " +
+                        "current custodian can accept or decline; the custodian OR any credited party " +
+                        "can dispute. Admin/owner access required.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            claim_id: {
+                                type: "string",
+                                description: "UUID of the custody_claims row to respond to.",
+                            },
+                            action: {
+                                type: "string",
+                                enum: ["accept", "decline", "dispute"],
+                                description: "How to respond to the claim",
+                            },
+                            reason: {
+                                type: "string",
+                                description: "Required when action='dispute'. Optional for decline.",
+                            },
+                        },
+                        required: ["claim_id", "action"],
+                    },
+                    annotations: {
+                        title: "respond to a custody claim",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: withBillingGate(this.pica, "custody response", this.respond.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_custody_list",
+                    description: "List custody claims for your catalog — both incoming " +
+                        "(claims others filed against your custody) and outgoing (claims you filed). " +
+                        "Defaults to pending claims only. Available to any authenticated org member.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            direction: {
+                                type: "string",
+                                enum: ["incoming", "outgoing", "both"],
+                                description: "Default: both.",
+                            },
+                            status: {
+                                type: "string",
+                                description: "Filter by status (pending|accepted|declined|disputed|auto_approved|withdrawn|expired|all). Default: pending.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "1..200. Default 50.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "list custody claims",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: this.list.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_history",
+                    description: "Return custody-related provenance_history rows for a work. Every row " +
+                        "includes an attestation_hash so the history is cryptographically anchored. " +
+                        "Use this to audit who changed custody when. Available to any authenticated org member.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            work_id: {
+                                type: "string",
+                                description: "UUID of the work whose history to fetch.",
+                            },
+                            change_type: {
+                                type: "string",
+                                description: "Filter to one change_type (custody_claimed|custody_transferred|custody_released|custody_expired|custody_transfer_auto) or 'all'. Default 'all'.",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "1..500. Default 100.",
+                            },
+                        },
+                        required: ["work_id"],
+                    },
+                    annotations: {
+                        title: "custody history",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: this.history.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_custody_resolve_pending",
+                    description: "Preview works where this org (or a specific global_publisher_id) is named " +
+                        "as canonical custodian via work_custodians.custodian_global_publisher_id but " +
+                        "has not yet been claimed via a PICA org membership. The 'Warner Chappell signs " +
+                        "up and finds 38 works waiting' view. Read-only — use pica_custody_reconcile " +
+                        "to actually claim them. Admin/owner access required.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            global_publisher_id: {
+                                type: "string",
+                                description: "Optional. If omitted, uses the caller org's own global_publisher_id bridge.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "resolve pending custody",
+                        readOnlyHint: true,
+                        idempotentHint: true,
+                    },
+                },
+                executor: withBillingGate(this.pica, "custody resolve", this.resolvePending.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_custody_reconcile",
+                    description: "Bulk-claim every work where your catalog (or a specific global_publisher_id) " +
+                        "is named as canonical custodian but hasn't been locally claimed yet. Writes " +
+                        "one custody_claims row per matching work. Default is dry-run — pass confirm=true " +
+                        "to execute. Admin/owner access required.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            global_publisher_id: { type: "string", description: "UUID of the global publisher to reconcile claims for. If omitted, reconciles for all publishers linked to your catalog." },
+                            confirm: {
+                                type: "boolean",
+                                description: "Required to actually write claims. Default false = dry-run.",
+                            },
+                        },
+                    },
+                    annotations: {
+                        title: "reconcile custody",
+                        destructiveHint: false,
+                        idempotentHint: false,
+                    },
+                },
+                executor: withBillingGate(this.pica, "custody reconcile", this.reconcile.bind(this)),
+            },
+        ];
+    }
+    async claim(args) {
+        const data = await this.pica.custody.claim({
+            work_id: args.work_id,
+            chain: args.chain,
+            reason: args.reason,
+        });
+        return formatSuccess(`Custody claim created (${args.chain} chain). The current custodian has 7 days to respond before the claim auto-approves.`, data);
+    }
+    async respond(args) {
+        const data = await this.pica.custody.respond({
+            claim_id: args.claim_id,
+            action: args.action,
+            reason: args.reason,
+        });
+        const verb = args.action === "accept"
+            ? "accepted"
+            : args.action === "decline"
+                ? "declined"
+                : "disputed";
+        return formatSuccess(`Custody claim ${verb}.`, data);
+    }
+    async list(args) {
+        const data = await this.pica.custody.list({
+            direction: args.direction,
+            status: args.status,
+            limit: args.limit,
+        });
+        const incoming = data?.incoming ?? [];
+        const outgoing = data?.outgoing ?? [];
+        const hints = [];
+        if (incoming.length > 0) {
+            hints.push({
+                gap: "custody_claims_incoming",
+                suggestion: `You have ${incoming.length} incoming custody claim(s) — respond via pica_custody_respond before the 7-day window closes.`,
+                count: incoming.length,
+                severity: "important",
+            });
+        }
+        return formatSuccess(`Found ${incoming.length} incoming + ${outgoing.length} outgoing custody claim(s).`, data, hints);
+    }
+    async history(args) {
+        const data = await this.pica.custody.history({
+            work_id: args.work_id,
+            change_type: args.change_type,
+            limit: args.limit,
+        });
+        const count = data?.count ?? 0;
+        return formatSuccess(count > 0
+            ? `Returned ${count} custody history row(s) for the work.`
+            : "No custody history rows for this work.", data);
+    }
+    async resolvePending(args) {
+        const data = await this.pica.custody.resolvePending({
+            global_publisher_id: args.global_publisher_id,
+        });
+        const count = data?.count ?? 0;
+        const hints = [];
+        if (count > 0) {
+            hints.push({
+                gap: "custody_inheritable",
+                suggestion: `${count} work(s) reference your publisher identity but haven't been claimed — run pica_custody_reconcile with confirm=true to claim them in bulk.`,
+                count,
+                severity: "important",
+            });
+        }
+        return formatSuccess(count > 0
+            ? `${count} inheritable work(s) found.`
+            : "No inheritable works found.", data, hints);
+    }
+    async reconcile(args) {
+        const data = await this.pica.custody.reconcile({
+            global_publisher_id: args.global_publisher_id,
+            confirm: args.confirm === true,
+        });
+        if (data?.dry_run) {
+            return formatSuccess(`Dry run — ${data.would_claim ?? 0} claim(s) would be created. Pass confirm=true to execute.`, data);
+        }
+        return formatSuccess(`Reconciliation complete — ${data?.claimed ?? 0} claimed, ${data?.failed ?? 0} failed.`, data);
+    }
+}
+//# sourceMappingURL=custody.js.map

package/dist/tools/custody.js.map

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

package/dist/tools/dashboard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Dashboard & Discovery Tools — surface what needs attention, what PICA found, and daily briefings
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DashboardTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private claimCredit;
+    private claimCustody;
+    private claimArtist;
+    private queryDiscoveries;
+    private reviewDiscovery;
+    private attentionItems;
+    private briefing;
+    private pulse;
+}
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/tools/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AActE,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAsN3D,WAAW;YAYX,YAAY;YAYZ,WAAW;YAYX,gBAAgB;YA8BhB,eAAe;YAaf,cAAc;YAYd,QAAQ;YAMR,KAAK;CAIpB"}

package/dist/tools/dashboard.js

@@ -0,0 +1,258 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+import { formatAsText, formatSuccess, formatStructuredList, withBillingGate, CLAIM_CREDIT_WRITE_PROPERTIES, CLAIM_CREDIT_REQUIRED, CLAIM_CUSTODY_WRITE_PROPERTIES, CLAIM_CUSTODY_REQUIRED, CLAIM_ARTIST_WRITE_PROPERTIES, CLAIM_ARTIST_REQUIRED, } from "@withpica/mcp-utils";
+export class DashboardTools {
+    pica;
+    constructor(pica) {
+        this.pica = pica;
+    }
+    getTools() {
+        return [
+            // --- Discoveries ---
+            {
+                definition: {
+                    name: "pica_discoveries_query",
+                    description: "List pending discoveries in your catalog across credits, custody, " +
+                        "and artist links. Each row includes a `type` field " +
+                        "('credit' | 'custody' | 'artist') plus the discovery-specific " +
+                        "fields. Use the row id with the matching pica_claim_* tool to " +
+                        "resolve. Sorted by created_at DESC.",
+                    workflows: ["claim-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            status: {
+                                type: "string",
+                                enum: ["all", "pending", "reviewed"],
+                                description: "Filter by status: 'all' for everything, 'pending' for items needing review, 'reviewed' for already-handled (default: all)",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max results (default 50)",
+                            },
+                        },
+                    },
+                },
+                executor: this.queryDiscoveries.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_discoveries_review",
+                    description: "Accept or reject a pending discovery. " +
+                        "Accepted discoveries update your catalog automatically.",
+                    workflows: ["claim-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            discovery_id: {
+                                type: "string",
+                                description: "The discovery ID to review",
+                            },
+                            status: {
+                                type: "string",
+                                enum: ["accepted", "rejected"],
+                                description: "Accept or reject the discovery",
+                            },
+                        },
+                        required: ["discovery_id", "status"],
+                    },
+                },
+                executor: withBillingGate(this.pica, "discovery review", this.reviewDiscovery.bind(this)),
+            },
+            // --- ADR-189 Phase 4: Activation-loop claim tools ---
+            {
+                definition: {
+                    name: "pica_claim_credit",
+                    description: "Claim a discovered songwriting / publishing credit into your catalog. " +
+                        "Drains the pending discovered_credits row and inserts a work_credits row " +
+                        "in your catalog, giving you 'view' access to the linked work. " +
+                        "Rate-limited to 20 claims per hour. Idempotency: re-claiming an already-resolved " +
+                        "discovery returns DISCOVERY_ALREADY_RESOLVED (409) — re-run discovery first.",
+                    annotations: {
+                        title: "claim discovered credit",
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: false,
+                    },
+                    workflows: ["claim-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: CLAIM_CREDIT_WRITE_PROPERTIES,
+                        required: [...CLAIM_CREDIT_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "credit claim", this.claimCredit.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_claim_custody",
+                    description: "Claim a discovered custody/ownership candidate (composition or master side) for a work. " +
+                        "Drains the pending discovered_custody row into a pending custody_claims row and schedules " +
+                        "a +72h silent-consent auto-approve via scheduled_notifications. The current custodian keeps " +
+                        "the catalog row until the T+72h window elapses. " +
+                        "Rate-limited to 20 claims per hour. " +
+                        "Idempotency: re-claiming an already-resolved discovery returns DISCOVERY_ALREADY_RESOLVED (409) -- " +
+                        "re-run discovery first.",
+                    annotations: {
+                        title: "claim discovered custody",
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: false,
+                    },
+                    workflows: ["claim-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: CLAIM_CUSTODY_WRITE_PROPERTIES,
+                        required: [...CLAIM_CUSTODY_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "custody claim", this.claimCustody.bind(this)),
+            },
+            {
+                definition: {
+                    name: "pica_claim_artist",
+                    description: "Claim a discovered artist link on a pending discovered_artists row. " +
+                        "INSTANT path: identity evidence was validated at discovery time, so this " +
+                        "tool writes to work_claims (artist_claim_status / claimed_by_person_id / " +
+                        "claim_confirmed_at) and inserts a performer work_credits row in one go — " +
+                        "no +72h waiting window. Requires your identity to already be linked via " +
+                        "pica_update_my_identity. " +
+                        "Rate-limited to 20 claims per hour. " +
+                        "Refuses (409 ADMIN_REVIEW_IN_PROGRESS) when an open artist_claims review " +
+                        "row exists for the same (work, person) — resolve the review first. " +
+                        "Idempotency: re-claiming an already-resolved discovery returns " +
+                        "DISCOVERY_ALREADY_RESOLVED (409) -- re-run discovery first.",
+                    annotations: {
+                        title: "claim discovered artist",
+                        readOnlyHint: false,
+                        destructiveHint: false,
+                        idempotentHint: false,
+                        openWorldHint: false,
+                    },
+                    workflows: ["claim-required"],
+                    inputSchema: {
+                        type: "object",
+                        properties: CLAIM_ARTIST_WRITE_PROPERTIES,
+                        required: [...CLAIM_ARTIST_REQUIRED],
+                    },
+                },
+                executor: withBillingGate(this.pica, "artist claim", this.claimArtist.bind(this)),
+            },
+            // --- Dashboard ---
+            {
+                definition: {
+                    name: "pica_dashboard_attention",
+                    description: "What needs my attention? Shows items requiring action — " +
+                        "incomplete works, unsigned agreements, overdue tasks, " +
+                        "pending invites, and quality issues.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            door: {
+                                type: "string",
+                                enum: ["respond", "catalog"],
+                                description: "Focus area: 'respond' for urgent items, 'catalog' for data quality",
+                            },
+                            limit: {
+                                type: "number",
+                                description: "Max items (default 10)",
+                            },
+                        },
+                    },
+                },
+                executor: this.attentionItems.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_dashboard_briefing",
+                    description: "Get your daily briefing — a summary of catalog health, " +
+                        "recent activity, upcoming deadlines, and recommended actions.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.briefing.bind(this),
+            },
+            {
+                definition: {
+                    name: "pica_dashboard_pulse",
+                    description: "Get the pulse of your catalog — works needing attention, " +
+                        "upcoming deadlines, provenance status, and background task progress.",
+                    workflows: "infrastructure",
+                    inputSchema: {
+                        type: "object",
+                        properties: {},
+                    },
+                },
+                executor: this.pulse.bind(this),
+            },
+        ];
+    }
+    async claimCredit(args) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const pica = this.pica;
+        const result = await pica.discoveries.claimCredit(args.id);
+        return formatSuccess(result.is_first_claim
+            ? "first credit claimed — welcome to your catalog"
+            : "credit claimed", result);
+    }
+    async claimCustody(args) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const pica = this.pica;
+        const result = await pica.discoveries.claimCustody(args.id);
+        return formatSuccess(result.is_first_claim
+            ? "first custody claim submitted — auto-approves in 72h unless disputed"
+            : "custody claim submitted — auto-approves in 72h unless disputed", result);
+    }
+    async claimArtist(args) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const pica = this.pica;
+        const result = await pica.discoveries.claimArtist(args.id);
+        return formatSuccess(result.is_first_claim
+            ? "first artist claim confirmed — welcome to your catalog"
+            : "artist claim confirmed", result);
+    }
+    async queryDiscoveries(args) {
+        const status = args.status || "all";
+        // "pending" delegates to the dedicated pending endpoint
+        if (status === "pending") {
+            const result = await this.pica.dashboard.pendingDiscoveries();
+            const items = result?.data || result || [];
+            return formatStructuredList(Array.isArray(items) ? items : [], "pending discovery");
+        }
+        // "all" or "reviewed" use the general discoveries endpoint
+        const result = await this.pica.dashboard.discoveries({
+            unread: status === "all" ? undefined : false,
+            limit: args.limit,
+        });
+        const items = result?.data || result || [];
+        const unreadCount = result?.unreadCount ?? 0;
+        return formatStructuredList(Array.isArray(items) ? items : [], "discovery", { unreadCount });
+    }
+    async reviewDiscovery(args) {
+        const result = await this.pica.dashboard.reviewDiscovery(args.discovery_id, args.status);
+        return formatSuccess(`Discovery ${args.discovery_id} ${args.status}`, result);
+    }
+    async attentionItems(args) {
+        const result = await this.pica.dashboard.attentionItems({
+            door: args.door,
+            limit: args.limit,
+        });
+        const items = result?.data?.items || result?.items || [];
+        return formatStructuredList(Array.isArray(items) ? items : [], "attention item");
+    }
+    async briefing(_args) {
+        const result = await this.pica.dashboard.briefing();
+        const insights = result?.data?.insights || result?.insights || result;
+        return formatSuccess("Daily briefing", insights);
+    }
+    async pulse(_args) {
+        const result = await this.pica.dashboard.pulse();
+        return formatAsText(result);
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/tools/dashboard.js.map

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

package/dist/tools/directory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Directory Tools — manage directory visibility and settings
+ */
+import { PicaClient } from "@withpica/mcp-sdk";
+import { ToolDefinition, ToolExecutor } from "./index.js";
+export declare class DirectoryTools {
+    private pica;
+    constructor(pica: PicaClient);
+    getTools(): Array<{
+        definition: ToolDefinition;
+        executor: ToolExecutor;
+    }>;
+    private directorySettings;
+}
+//# sourceMappingURL=directory.d.ts.map

package/dist/tools/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/tools/directory.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YA8D3D,iBAAiB;CAkDhC"}