@withpica/mcp-server 2.7.0 → 2.9.0

package/dist/tools/metadata.js

@@ -0,0 +1,1106 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * Metadata registry for all 193 MCP tools.
+ *
+ * Categories: catalog, enrichment, business, discovery, media, comms, settings
+ * Risk: safe (read-only), mutating (creates/modifies), destructive (deletes/merges)
+ * retry_safe: true for safe tools, false for destructive, varies for mutating
+ */
+export const TOOL_METADATA = {
+    // ── Works ──────────────────────────────────────────────────────────────────
+    pica_works_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find works",
+    },
+    pica_works_inspect: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a work",
+    },
+    pica_works_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new work",
+    },
+    pica_works_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a work",
+    },
+    pica_works_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a work",
+    },
+    pica_works_verify: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "verify work metadata",
+    },
+    pica_works_bulk_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "bulk delete works",
+    },
+    pica_works_bulk_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "bulk update works",
+    },
+    // ── People ─────────────────────────────────────────────────────────────────
+    pica_people_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find people",
+    },
+    pica_people_inspect: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a person",
+    },
+    pica_people_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new person",
+    },
+    pica_people_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a person",
+    },
+    pica_people_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a person",
+    },
+    pica_people_enrich_isni: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich person via isni",
+    },
+    pica_people_enrich_musicbrainz: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich person via musicbrainz",
+    },
+    pica_people_bulk_update_roles: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "bulk update people roles",
+    },
+    // ── Recordings ─────────────────────────────────────────────────────────────
+    pica_recordings_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find recordings",
+    },
+    pica_recordings_inspect: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a recording",
+    },
+    pica_recordings_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new recording",
+    },
+    pica_recordings_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a recording",
+    },
+    pica_recordings_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a recording",
+    },
+    // ── Credits ────────────────────────────────────────────────────────────────
+    pica_credits_balance: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check credits balance",
+    },
+    pica_credits_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list credits on a work",
+    },
+    pica_credits_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update credits on a work",
+    },
+    // ── Agreements ─────────────────────────────────────────────────────────────
+    pica_agreements_query: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find agreements",
+    },
+    pica_agreements_inspect: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect an agreement",
+    },
+    pica_agreements_create: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new agreement",
+    },
+    pica_agreements_update: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update an agreement",
+    },
+    pica_agreements_delete: {
+        category: "business",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete an agreement",
+    },
+    pica_agreements_link_work: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "link a work to an agreement",
+    },
+    // ── Agreement Types (unified) ──────────────────────────────────────────────
+    pica_agreement_types_query: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find agreement types",
+    },
+    pica_agreement_types_inspect: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect an agreement type",
+    },
+    pica_agreement_types_create: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create an agreement type",
+    },
+    pica_agreement_types_update: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update an agreement type",
+    },
+    pica_agreement_types_delete: {
+        category: "business",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete an agreement type",
+    },
+    pica_agreement_templates_render: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "render an agreement template",
+    },
+    pica_agreement_templates_duplicate: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "duplicate an agreement template",
+    },
+    pica_agreement_templates_set_default: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "set default agreement template",
+    },
+    // ── Split Sheets & Recording Splits ────────────────────────────────────────
+    pica_split_sheet_list: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list split sheets",
+    },
+    pica_split_sheet_get: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a split sheet",
+    },
+    pica_split_sheet_generate: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "generate a split sheet",
+    },
+    pica_split_sheet_send: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send a split sheet for signing",
+    },
+    pica_recording_splits_list: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list recording splits",
+    },
+    pica_recording_splits_create: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create recording splits",
+    },
+    pica_recording_splits_verify: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "verify recording splits total 100%",
+    },
+    // ── Royalties & Statements ─────────────────────────────────────────────────
+    pica_royalties_list: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list royalty entries",
+    },
+    pica_royalties_get: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a royalty entry",
+    },
+    pica_royalties_summary: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get royalties summary",
+    },
+    pica_statements_list: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list royalty statements",
+    },
+    pica_statements_get: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a royalty statement",
+    },
+    // ── Disputes ───────────────────────────────────────────────────────────────
+    pica_disputes_list: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list disputes",
+    },
+    // ── Custody (ADR-158 Plan C) ───────────────────────────────────────────────
+    pica_custody_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list custody claims",
+    },
+    pica_custody_history: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "custody history",
+    },
+    pica_custody_claim: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "claim custody",
+    },
+    pica_custody_respond: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "respond to a custody claim",
+    },
+    pica_custody_resolve_pending: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "resolve pending custody",
+    },
+    pica_custody_reconcile: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "reconcile custody",
+    },
+    // ── Enrichment ─────────────────────────────────────────────────────────────
+    pica_enrichment_candidates: {
+        category: "enrichment",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list enrichment candidates",
+    },
+    pica_enrich_work_mlc: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich work via mlc",
+        credits_required: 1,
+    },
+    pica_enrich_work_musicbrainz: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich work via musicbrainz",
+    },
+    pica_enrich_work_discogs: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich work via discogs",
+    },
+    pica_enrich_work_spotify: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich work via spotify",
+    },
+    pica_enrich_work_youtube: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "enrich work via youtube",
+    },
+    pica_enrichment_compare: {
+        category: "enrichment",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "compare enrichment sources",
+    },
+    pica_registrations_compare: {
+        category: "enrichment",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "compare registrations across sources",
+    },
+    // ── Search & Discovery ─────────────────────────────────────────────────────
+    pica_search_all: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "search across everything",
+    },
+    pica_catalog_stats: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get catalog statistics",
+    },
+    pica_graph_traverse: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "traverse the identity graph",
+    },
+    pica_search_for_sync: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "search works for sync licensing",
+    },
+    pica_submit_license_enquiry: {
+        category: "discovery",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "submit a license enquiry",
+    },
+    pica_discoveries_query: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find discoveries",
+    },
+    pica_discoveries_review: {
+        category: "discovery",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "review a discovery",
+    },
+    pica_dashboard_attention: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get items needing attention",
+    },
+    pica_dashboard_briefing: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get your daily briefing",
+    },
+    pica_dashboard_pulse: {
+        category: "discovery",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get your catalog pulse",
+    },
+    // ── App Tools (MCP Apps) ──────────────────────────────────────────────────
+    pica_upload: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "upload files",
+    },
+    pica_download: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "download a file",
+    },
+    pica_car_preview: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "preview catalog asset report",
+    },
+    // ── Audio Files ────────────────────────────────────────────────────────────
+    pica_audio_query: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find audio files",
+    },
+    pica_audio_inspect: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect an audio file",
+    },
+    pica_audio_analyze: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "analyze an audio file",
+        credits_required: 1,
+    },
+    pica_audio_presigned_upload: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "get presigned upload url for audio",
+    },
+    pica_audio_complete_upload: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "complete an audio upload",
+    },
+    pica_audio_identify: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "identify an audio file",
+        credits_required: 3,
+    },
+    // ── Multimedia ─────────────────────────────────────────────────────────────
+    pica_multimedia_search: {
+        category: "media",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "search multimedia",
+    },
+    pica_multimedia_create: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a multimedia entry",
+    },
+    pica_multimedia_import_url: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "import multimedia from url",
+    },
+    pica_multimedia_link_youtube: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "link a youtube video",
+    },
+    pica_multimedia_link_work: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "link multimedia to a work",
+    },
+    // ── Documents ──────────────────────────────────────────────────────────────
+    pica_documents_analyse: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "analyse a document with ai",
+    },
+    // ── Uploads ────────────────────────────────────────────────────────────────
+    pica_upload_file: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "get upload url for a file",
+    },
+    pica_upload_complete: {
+        category: "media",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "complete a file upload",
+    },
+    // ── Exports ────────────────────────────────────────────────────────────────
+    pica_export_catalog_csv: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "export catalog as csv",
+    },
+    pica_export_song_registration: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export for song registration",
+        credits_required: 1,
+    },
+    pica_export_industry_ready: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export industry-ready package",
+        credits_required: 1,
+    },
+    pica_export_catalog_asset_report: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export catalog asset report",
+        credits_required: 5,
+    },
+    pica_export_ai_consent: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export ai consent declaration",
+    },
+    // ── Calendar ───────────────────────────────────────────────────────────────
+    pica_calendar_events: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list calendar events",
+    },
+    // ── Duplicates ─────────────────────────────────────────────────────────────
+    pica_find_duplicates: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find potential duplicates",
+    },
+    pica_merge_duplicates: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "merge duplicate records",
+    },
+    // ── Projects ───────────────────────────────────────────────────────────────
+    pica_projects_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list your projects",
+    },
+    pica_projects_get: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a project",
+    },
+    pica_projects_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new project",
+    },
+    pica_projects_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a project",
+    },
+    pica_projects_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a project",
+    },
+    // ── Releases ───────────────────────────────────────────────────────────────
+    pica_releases_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list your releases",
+    },
+    pica_releases_get: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a release",
+    },
+    pica_releases_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a new release",
+    },
+    pica_releases_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a release",
+    },
+    // ── Sessions ───────────────────────────────────────────────────────────────
+    pica_sessions_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list work sessions",
+    },
+    pica_sessions_get: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a work session",
+    },
+    pica_sessions_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a work session",
+    },
+    pica_sessions_types: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list session types",
+    },
+    // ── Notes ──────────────────────────────────────────────────────────────────
+    pica_notes_list: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list notes",
+    },
+    pica_notes_get: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a note",
+    },
+    pica_notes_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a note",
+    },
+    pica_notes_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a note",
+    },
+    // ── Physical Assets ────────────────────────────────────────────────────────
+    pica_physical_assets_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find physical assets",
+    },
+    pica_physical_assets_inspect: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a physical asset",
+    },
+    pica_physical_assets_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a physical asset",
+    },
+    pica_physical_assets_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a physical asset",
+    },
+    pica_physical_assets_delete: {
+        category: "catalog",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a physical asset",
+    },
+    pica_physical_assets_stats: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get physical assets statistics",
+    },
+    pica_physical_assets_export: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "export physical assets",
+    },
+    // ── Analytics (Carbon, Provenance, Diligence) ──────────────────────────────
+    pica_carbon_footprint: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get carbon footprint",
+    },
+    pica_carbon_live: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get live carbon metrics",
+    },
+    pica_provenance_stats: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get provenance statistics",
+    },
+    pica_provenance_work: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get provenance for a work",
+    },
+    pica_provenance_certificate: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "generate provenance certificate",
+    },
+    pica_catalog_diligence: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "run catalog due diligence",
+    },
+    // ── Import ─────────────────────────────────────────────────────────────────
+    pica_import_analyze: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "analyze an import file",
+    },
+    pica_import_validate: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "validate import data",
+    },
+    pica_import_execute: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "execute a catalog import",
+    },
+    pica_import_fields: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list available import fields",
+    },
+    pica_import_template: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get import template",
+    },
+    pica_import_streaming_link: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "import from streaming link",
+    },
+    pica_import_from_spotify: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "import from spotify",
+    },
+    // ── Import Documents ───────────────────────────────────────────────────────
+    pica_import_documents_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find import documents",
+    },
+    pica_import_documents_inspect: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect an import document",
+    },
+    pica_ingest_statement: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "ingest a royalty statement",
+    },
+    // ── Notifications ──────────────────────────────────────────────────────────
+    pica_notifications_list: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list notifications",
+    },
+    pica_notify_person: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send notification to a person",
+    },
+    pica_notifications_mark_read: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "mark notifications as read",
+    },
+    // ── Collaborators ──────────────────────────────────────────────────────────
+    pica_collaborators_invite: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "invite a collaborator",
+    },
+    pica_collaborators_invites_list: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list collaborator invites",
+    },
+    pica_collaborators_invite_resend: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "resend a collaborator invite",
+    },
+    // ── Send Hub ───────────────────────────────────────────────────────────────
+    pica_send_message: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send a message",
+    },
+    pica_send_query: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find sent messages",
+    },
+    pica_send_resend: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "resend a message",
+    },
+    // ── Share Links ────────────────────────────────────────────────────────────
+    pica_share_links_list: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list share links",
+    },
+    pica_share_links_create: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a share link",
+    },
+    // ── Telegram ───────────────────────────────────────────────────────────────
+    pica_telegram_status: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check telegram connection status",
+    },
+    pica_notify_user: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send notification to user via telegram",
+    },
+    // ── Publishers ─────────────────────────────────────────────────────────────
+    pica_publishers_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find publishers",
+    },
+    pica_publishers_create: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a publisher",
+    },
+    // ── Licensing (enquiry read/update) ────────────────────────────────────────
+    pica_list_license_enquiries: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list license enquiries",
+    },
+    pica_get_license_enquiry: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a license enquiry",
+    },
+    pica_update_license_enquiry_status: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update license enquiry status",
+    },
+    // ── Team ───────────────────────────────────────────────────────────────────
+    pica_team_list: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list team members",
+    },
+    pica_team_get: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get a team member",
+    },
+    pica_team_invite: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "invite a team member",
+    },
+    pica_team_update_role: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update team member role",
+    },
+    pica_team_remove: {
+        category: "settings",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "remove a team member",
+    },
+    // ── Memory ─────────────────────────────────────────────────────────────────
+    pica_memory_list: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list saved memories",
+    },
+    pica_memory_search: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "search memories",
+    },
+    pica_memory_save: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "save a memory",
+    },
+    pica_memory_delete: {
+        category: "settings",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a memory",
+    },
+    // ── Settings ───────────────────────────────────────────────────────────────
+    pica_credits_history: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view credits history",
+    },
+    pica_credits_purchase: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "get credits purchase link",
+    },
+    pica_storage_status: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check storage usage",
+    },
+    pica_organisation_profile: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view organisation profile",
+    },
+    pica_user_profile: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view your profile",
+    },
+    pica_directory_settings: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view directory settings",
+    },
+    pica_integrations_status: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check integrations status",
+    },
+};
+/**
+ * Look up metadata for a tool by name.
+ * Returns undefined if the tool is not registered.
+ */
+export function getToolMetadata(name) {
+    return TOOL_METADATA[name];
+}
+//# sourceMappingURL=metadata.js.map