@withpica/mcp-server 2.51.0 → 2.52.0

package/dist/tools/explainability.js

@@ -1,137 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { formatSuccess } from "@withpica/mcp-utils";
-// Mirror of COUNT_SOURCES in lib/services/count-explain.ts. The lint
-// check at scripts/lint-mcp-tools.ts asserts this stays in sync with
-// the service-layer registry. Adding a value here without a registry
-// entry trips the lint at build time.
-const COUNT_SOURCES = [
-    "dashboard.registered_pro",
-    "dashboard.registered_nro",
-    "briefing.audio_pending",
-    "briefing.unconnected_collaborators",
-    "briefing.unverified_writers",
-    "briefing.works_without_credits",
-];
-export class ExplainabilityTools {
-    pica;
-    constructor(pica) {
-        this.pica = pica;
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_count_explain",
-                    tier: "read",
-                    description: "Use when the user asks: 'why does the dashboard say 80 but I counted 78?', 'where are the missing works?', 'explain this number'. " +
-                        "Generic explainer for dashboard / briefing count discrepancies. " +
-                        "Closed enum of 6 count sources (additive). Returns the canonical query, the computed value, and (when observed_value supplied) a delta_breakdown that sums to the absolute delta. " +
-                        "→ then: pica_works_query (drill into the specific rows), pica_dashboard_briefing (re-read the briefing now that you understand the count)",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            count_source: {
-                                type: "string",
-                                enum: [...COUNT_SOURCES],
-                                description: "Which count to explain. dashboard.registered_pro: works registered with any PRO (PRS, ASCAP, BMI, SACEM, GEMA, JASRAC, etc.). dashboard.registered_nro: works registered with any NRO (PPL, SoundExchange, GVL, etc.). briefing.audio_pending: audio_files where analysis_status='pending'. briefing.unconnected_collaborators: distinct credited people without a linked PICA user. briefing.unverified_writers: writer credits where attestation_status != 'attested'. briefing.works_without_credits: works with zero work_credits rows.",
-                            },
-                            observed_value: {
-                                type: "number",
-                                description: "Optional. The number the user is seeing somewhere else. When supplied, the response includes delta + delta_breakdown.",
-                            },
-                        },
-                        required: ["count_source"],
-                    },
-                    nextSteps: [
-                        {
-                            tool: "pica_works_query",
-                            reason: "Drill into the specific works the count covers when investigating a discrepancy.",
-                            when: "on_success",
-                        },
-                        {
-                            tool: "pica_dashboard_briefing",
-                            reason: "Re-read the briefing now that the count is explained.",
-                            when: "on_success",
-                        },
-                    ],
-                },
-                executor: this.countExplain.bind(this),
-            },
-        ];
-    }
-    async countExplain(args) {
-        const countSource = args.count_source;
-        const observedValueRaw = args.observed_value;
-        if (!countSource) {
-            return {
-                content: [{ type: "text", text: "count_source is required." }],
-                isError: true,
-            };
-        }
-        if (!COUNT_SOURCES.includes(countSource)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Invalid count_source '${countSource}'. Must be one of: ${COUNT_SOURCES.join(", ")}.`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        let observedValue;
-        if (observedValueRaw !== undefined && observedValueRaw !== null) {
-            const parsed = Number(observedValueRaw);
-            if (!Number.isFinite(parsed) ||
-                !Number.isInteger(parsed) ||
-                parsed < 0) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: "observed_value must be a non-negative integer.",
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            observedValue = parsed;
-        }
-        try {
-            const result = await this.pica.countExplain.explain({
-                count_source: countSource,
-                observed_value: observedValue,
-            });
-            const verdict = result.delta == null
-                ? `${result.source.name} = ${result.computed_value}`
-                : result.delta === 0
-                    ? `${result.source.name} = ${result.computed_value} (matches your observed value)`
-                    : `${result.source.name} = ${result.computed_value} (differs from observed by ${result.delta})`;
-            return formatSuccess(verdict, result);
-        }
-        catch (err) {
-            const errorMessage = err instanceof Error ? err.message : String(err);
-            // INVALID_INPUT bubbles up from the API — surface message as-is.
-            if (/INVALID_INPUT|invalid_input|400/i.test(errorMessage)) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `count_source not recognised. Allowed values: ${COUNT_SOURCES.join(", ")}.`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            return {
-                content: [
-                    { type: "text", text: `Failed to explain count: ${errorMessage}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-}
-//# sourceMappingURL=explainability.js.map

package/dist/tools/explainability.js.map

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

package/dist/tools/my-recent-questions.d.ts

@@ -1,25 +0,0 @@
-/**
- * My-Recent-Questions Tool — ADR-226 Phase 5.
- *
- * The user-facing auditability surface over the Phase 4 substrate. Lets the
- * caller see what they have been asking the AI to do, what tools ran, and
- * which client the request came from ("Claude Desktop did X / ChatGPT did
- * Y"). User-scoped via the `(user_id = auth.uid())` RLS policy added in
- * PR #255 + service-role + explicit user_id filter in the API route.
- *
- * Filters mirror the Atlas's "what did I ask the AI?" question shape — see
- * `creator-question-atlas.ts` entry resolving to this tool.
- */
-import { PicaClient } from "@withpica/mcp-sdk";
-import { Tier, ToolDefinition, ToolExecutor } from "./index.js";
-export declare class MyRecentQuestionsTools {
-    private pica;
-    private getTier;
-    constructor(pica: PicaClient, getTier: (name: string) => Tier | undefined);
-    getTools(): Array<{
-        definition: ToolDefinition;
-        executor: ToolExecutor;
-    }>;
-    private listMine;
-}
-//# sourceMappingURL=my-recent-questions.d.ts.map

package/dist/tools/my-recent-questions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"my-recent-questions.d.ts","sourceRoot":"","sources":["../../src/tools/my-recent-questions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AA0C5E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,OAAO,CAAqC;gBAGlD,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS;IAM7C,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAyD3D,QAAQ;CAqFvB"}

package/dist/tools/my-recent-questions.js

@@ -1,186 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-/**
- * ADR-230 — derive the dominant tier for a row in
- * `assistant_interactions`. The substrate stores `tools_used: text[]`
- * but no `tier` column of its own (Stage 1 decision: Option A — JOIN
- * at read time rather than denormalize).
- *
- * If a row's tools_used spans multiple tiers (e.g. a workflow that
- * runs `pica_works_query` then `pica_works_create` then
- * `pica_works_delete`), surface the most-impactful tier — agents
- * inspecting their own activity want to see the highest-stakes call,
- * not the first one. Order: destructive > write > draft > read.
- *
- * The tier resolver is injected so this module stays decoupled from
- * the registry it reads. ToolRegistry passes
- * `(name) => this.tools.get(name)?.definition.tier` — the declared
- * `tier` on each tool definition is the source of truth (lint Rule 13
- * makes it required for every customer MCP tool).
- */
-const TIER_RANK = {
-    read: 0,
-    draft: 1,
-    write: 2,
-    destructive: 3,
-};
-function dominantTier(tools, getTier) {
-    if (!Array.isArray(tools) || tools.length === 0)
-        return "read";
-    let highest = "read";
-    for (const t of tools) {
-        const tier = getTier(t) ?? "read";
-        if (TIER_RANK[tier] > TIER_RANK[highest]) {
-            highest = tier;
-        }
-    }
-    return highest;
-}
-export class MyRecentQuestionsTools {
-    pica;
-    getTier;
-    constructor(pica, getTier) {
-        this.pica = pica;
-        this.getTier = getTier;
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_my_recent_questions",
-                    tier: "read",
-                    description: "Use when the user asks: 'what did I ask the AI?', 'what have I been doing?', 'show me my recent activity', 'what AI tasks did I confirm?'. " +
-                        "Returns the user's recent questions, what tools the AI ran, and whether each succeeded. " +
-                        "Renders the originating client per row by joining mcp_sessions, so 'Claude Desktop did X / ChatGPT did Y' is visible at a glance. " +
-                        "Each row carries `tier` (read | draft | write | destructive — the most-impactful tier across the row's tools_used) so agents can scan stakes at a glance. " +
-                        "→ then: pica_continue (pick up where you left off)",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            session_id: {
-                                type: "string",
-                                description: "Optional. Filter to a single MCP session — useful for replaying one conversation.",
-                            },
-                            since: {
-                                type: "string",
-                                description: "Optional. ISO 8601 timestamp lower bound (e.g. '2026-05-01T00:00:00Z').",
-                            },
-                            success: {
-                                type: "boolean",
-                                description: "Optional. Pass `true` to see only successful interactions, `false` to see only failures.",
-                            },
-                            intent: {
-                                type: "string",
-                                description: "Optional. Filter to a specific intent (e.g. 'pica_works_create').",
-                            },
-                            limit: {
-                                type: "number",
-                                description: "Optional. Default 25, max 100.",
-                            },
-                        },
-                    },
-                    nextSteps: [
-                        {
-                            tool: "pica_continue",
-                            reason: "Pick up where you left off — surfaces specific named open loops from the same substrate.",
-                            when: "on_success",
-                        },
-                    ],
-                },
-                executor: this.listMine.bind(this),
-            },
-        ];
-    }
-    async listMine(args) {
-        const limitArg = typeof args.limit === "number" ? args.limit : undefined;
-        const limit = limitArg !== undefined ? Math.min(Math.max(limitArg, 1), 100) : undefined;
-        const rawRows = await this.pica.assistantInteractions.listRecent({
-            sessionId: typeof args.session_id === "string" ? args.session_id : undefined,
-            since: typeof args.since === "string" ? args.since : undefined,
-            success: typeof args.success === "boolean" ? args.success : undefined,
-            intent: typeof args.intent === "string" ? args.intent : undefined,
-            limit,
-        });
-        // ADR-230 — derive tier per row at read time from tools_used
-        // (assistant_interactions has no tier column; Stage 1 picked
-        // Option A — registry-derived lookup over column denormalisation).
-        const rows = Array.isArray(rawRows)
-            ? rawRows.map((r) => ({
-                ...r,
-                tier: dominantTier((Array.isArray(r.tools_used) ? r.tools_used : []), this.getTier),
-            }))
-            : rawRows;
-        if (!Array.isArray(rows) || rows.length === 0) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "No recent activity for your account. Once you start asking PICA to do things, this is where you'll see them.",
-                    },
-                ],
-                structuredContent: {
-                    kind: "pica.card.my_recent_questions",
-                    version: 1,
-                    data: { count: 0, interactions: [] },
-                },
-            };
-        }
-        const lines = rows.slice(0, 10).map((r) => {
-            const tag = r.success
-                ? r.required_confirmation && r.was_confirmed !== true
-                    ? "⏳ awaiting"
-                    : "✓"
-                : "✗";
-            const client = r.client_name
-                ? `${r.client_name}${r.client_version ? ` v${r.client_version}` : ""}`
-                : "unknown client";
-            const summary = r.result_summary ?? r.prompt_excerpt ?? r.intent;
-            const tools = Array.isArray(r.tools_used) && r.tools_used.length > 0
-                ? ` — \`${r.tools_used.slice(0, 3).join(", ")}\``
-                : "";
-            const when = formatWhen(r.created_at);
-            return `[${tag}] ${client} ${when}: ${truncate(summary, 140)}${tools}`;
-        });
-        const more = rows.length > 10
-            ? `\n\n_+${rows.length - 10} more — pass a higher limit to see them._`
-            : "";
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `${rows.length} recent interaction${rows.length === 1 ? "" : "s"}:\n\n` +
-                        `${lines.join("\n")}${more}`,
-                },
-            ],
-            structuredContent: {
-                kind: "pica.card.my_recent_questions",
-                version: 1,
-                data: {
-                    count: rows.length,
-                    interactions: rows,
-                },
-            },
-        };
-    }
-}
-function truncate(text, max) {
-    if (text.length <= max)
-        return text;
-    return text.slice(0, max - 1) + "…";
-}
-function formatWhen(iso) {
-    const then = new Date(iso).getTime();
-    const diffMs = Date.now() - then;
-    const minutes = Math.floor(diffMs / 60000);
-    if (minutes < 1)
-        return "just now";
-    if (minutes < 60)
-        return `${minutes}m ago`;
-    const hours = Math.floor(minutes / 60);
-    if (hours < 24)
-        return `${hours}h ago`;
-    const days = Math.floor(hours / 24);
-    return `${days}d ago`;
-}
-//# sourceMappingURL=my-recent-questions.js.map

package/dist/tools/my-recent-questions.js.map

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

package/dist/tools/share-send.d.ts

@@ -1,28 +0,0 @@
-/**
- * ADR-231 — User-Initiated Asset Sharing via Creator MCP.
- *
- * Tool: pica_share_send
- *
- * Atlas vernacular phrasings (registered separately via Atlas seed,
- * but documented here for traceability):
- *   - "send <asset> to <name>"
- *   - "share <asset> with <name>"
- *   - "email <asset> to <person>"
- *   - "shoot <asset> over to <name>"
- *   - "send <asset> to <email>"
- *   - "forward <asset> to <person>"
- *
- * Per ADR-226 vernacular Atlas substrate.
- */
-import { PicaClient } from "@withpica/mcp-sdk";
-import { ToolDefinition, ToolExecutor } from "./index.js";
-export declare class ShareSendTools {
-    private pica;
-    constructor(pica: PicaClient);
-    getTools(): Array<{
-        definition: ToolDefinition;
-        executor: ToolExecutor;
-    }>;
-    private shareSend;
-}
-//# sourceMappingURL=share-send.d.ts.map

package/dist/tools/share-send.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"share-send.d.ts","sourceRoot":"","sources":["../../src/tools/share-send.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAmF3D,SAAS;CA+BxB"}

package/dist/tools/share-send.js

@@ -1,131 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { formatStructured, formatSuccess } from "@withpica/mcp-utils";
-export class ShareSendTools {
-    pica;
-    constructor(pica) {
-        this.pica = pica;
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_share_send",
-                    tier: "write",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    description: "Use when the user asks: 'send this song to my publisher', " +
-                        "'share this work with sarah', 'email the report to my manager', " +
-                        "'shoot this over to <name>', 'forward to <email>'. " +
-                        "Sends a withPICA-branded email containing a scoped, expirable " +
-                        "share-link to a named recipient. Recipients can be PICA users, " +
-                        "existing org collaborators (people you've credited on works), " +
-                        "or any external email address. " +
-                        "First send to a NEW external email returns " +
-                        "FIRST_EXTERNAL_SEND_CONFIRMATION_REQUIRED — re-call with " +
-                        "confirm_first_external_send: true to proceed (deliberate friction " +
-                        "against typo-driven phishing). Sender capped at 20 external " +
-                        "sends / 24h. Recipient capped at 20 marketing+share emails / 30d " +
-                        "via marketing-guard. Email From is always noreply@withpica.com; " +
-                        "Reply-to is the sender's email; recipient can report unwanted " +
-                        "contact via a footer link in the email. v1 supports entity_type " +
-                        "= 'work' only (other types declared but reserved).",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            entity_type: {
-                                type: "string",
-                                enum: ["recording", "work", "audio_file", "document"],
-                                description: "Asset class. v1: only 'work' is supported; other values return ENTITY_TYPE_NOT_SUPPORTED.",
-                            },
-                            entity_id: {
-                                type: "string",
-                                description: "UUID of the asset being shared.",
-                            },
-                            recipient: {
-                                type: "object",
-                                description: "Who to send to. { kind: 'user_id' | 'collaborator_id' | 'email', value: <id-or-email> }. Internal users and existing org collaborators are detected automatically when kind='email'; otherwise the address is classified external and goes through the first-send confirmation + marketing-guard.",
-                                properties: {
-                                    kind: {
-                                        type: "string",
-                                        enum: ["user_id", "collaborator_id", "email"],
-                                        description: "user_id = existing PICA user; collaborator_id = a person from the sender's org; email = arbitrary address (internal user / collaborator detected automatically; otherwise classified external).",
-                                    },
-                                    value: { type: "string" },
-                                },
-                                required: ["kind", "value"],
-                            },
-                            note: {
-                                type: "string",
-                                description: "Optional message from the sender (≤500 chars). Rendered in italic above the share-link CTA.",
-                            },
-                            expires_in_days: {
-                                type: "number",
-                                description: "Share-link TTL in days. Default 30, max 90.",
-                            },
-                            scope: {
-                                type: "string",
-                                enum: ["view", "view+download"],
-                                description: "Default 'view'. 'view+download' allows the recipient to download attached files.",
-                            },
-                            confirm_first_external_send: {
-                                type: "boolean",
-                                description: "Required on the second call when the first attempt returned FIRST_EXTERNAL_SEND_CONFIRMATION_REQUIRED — confirms the recipient address is correct.",
-                            },
-                        },
-                        required: ["entity_type", "entity_id", "recipient"],
-                    },
-                    annotations: { destructiveHint: true, openWorldHint: true },
-                },
-                executor: this.shareSend.bind(this),
-            },
-        ];
-    }
-    async shareSend(args) {
-        try {
-            const result = await this.pica.shareSend.send({
-                entity_type: args.entity_type,
-                entity_id: args.entity_id,
-                recipient: args.recipient,
-                note: args.note,
-                expires_in_days: args.expires_in_days,
-                scope: args.scope,
-                confirm_first_external_send: args.confirm_first_external_send === true ? true : undefined,
-            });
-            return formatSuccess(`shared via withPICA — ${result.recipient_resolution.classification}`, result);
-        }
-        catch (e) {
-            const errCode = e?.error_code ?? e?.code ?? "SHARE_SEND_ERROR";
-            const status = e?.status ?? e?.statusCode;
-            return formatStructured({
-                error: e?.message ?? String(e),
-                error_code: errCode,
-                ...(typeof status === "number" ? { status } : {}),
-                suggestion: suggestionFor(errCode),
-                next_tool: "pica_share_send",
-            }, "pica_share_send — error");
-        }
-    }
-}
-function suggestionFor(code) {
-    switch (code) {
-        case "FIRST_EXTERNAL_SEND_CONFIRMATION_REQUIRED":
-            return "First time sending to this external address. Confirm the recipient is correct, then re-call with confirm_first_external_send: true.";
-        case "ROLE_ADDRESS_REJECTED":
-            return "The address looks like a role/system inbox (noreply@, postmaster@, abuse@, etc). Pick the recipient's personal email instead.";
-        case "RECIPIENT_VOLUME_EXCEEDED":
-            return "Recipient is at withPICA's 30-day inbound volume limit. Wait for the window to clear, or contact them via another channel.";
-        case "SENDER_RATE_LIMIT_EXCEEDED":
-            return "You've sent 20+ external shares in the last 24h. Wait an hour and retry, or send to internal collaborators in the meantime.";
-        case "ENTITY_NOT_FOUND":
-            return "The asset wasn't found in your catalog. Verify entity_id with pica_works_get.";
-        case "ENTITY_TYPE_NOT_SUPPORTED":
-            return "v1 supports entity_type='work' only. Recording/audio_file/document share-send is on the roadmap.";
-        case "FORBIDDEN":
-            return "You're not a member of the asset's organisation. Switch context with pica_organisations_switch or share an asset you own.";
-        case "RECIPIENT_NOT_FOUND":
-            return "The recipient lookup failed. For collaborator_id, verify it's in your current org. For user_id, confirm the user exists.";
-        default:
-            return "Re-check the entity_id, recipient shape, and confirm_first_external_send flag against the tool description.";
-    }
-}
-//# sourceMappingURL=share-send.js.map

package/dist/tools/share-send.js.map

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

package/dist/tools/sharing.d.ts

@@ -1,29 +0,0 @@
-/**
- * Sharing MCP Tools — ADR-232 § Decision 2
- *
- * pica_share_trace — explainability aggregator. Returns the unioned
- * chain of reasons a viewer can see an entity, ranked by directness:
- *
- *   1. org_membership      (viewer is in the calling org)
- *   2. custody_chain       (viewer's org is on the work's custody chain)
- *   3. share_link          (an active link grants viewer access)
- *   4. cross_org_grant     (viewer's org has an ADR-204 grant)
- *
- * Two-axis access control:
- *   - Caller NOT owner of entity → 403 INSUFFICIENT_SCOPE (don't leak
- *     ownership existence). AC-3.
- *   - Caller IS owner but viewer can't see → has_access:false with
- *     reasons:[]. Don't leak why. AC-4.
- */
-import { PicaClient } from "@withpica/mcp-sdk";
-import type { ToolDefinition, ToolExecutor } from "./index.js";
-export declare class SharingTools {
-    private pica;
-    constructor(pica: PicaClient);
-    getTools(): Array<{
-        definition: ToolDefinition;
-        executor: ToolExecutor;
-    }>;
-    private shareTrace;
-}
-//# sourceMappingURL=sharing.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"sharing.d.ts","sourceRoot":"","sources":["../../src/tools/sharing.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAG3E,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;YA4D3D,UAAU;CA4EzB"}