@withpica/mcp-server 1.3.0

package/dist/tools/metadata.js

@@ -0,0 +1,1532 @@
+// 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_bulk_update_roles: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "bulk update people roles",
+    },
+    // ── Groups (member relationships on people, ADR-223) ─────────────────────
+    pica_group_add_member: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "add a member to a group",
+    },
+    pica_group_remove_member: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "remove a member from a group",
+    },
+    pica_group_list_members: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list group members",
+    },
+    pica_person_list_groups: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list groups a person belongs to",
+    },
+    // ── 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 / pica_credits_history / pica_credits_purchase
+    // removed 2026-04-22 — see docs/MCP_REFINEMENT_LOG.md entry B-001.
+    // pica_credits_list / pica_credits_update are work_credits, not billing.
+    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",
+    },
+    // ADR-213 Primitive B — first-party recording-side production credits.
+    // Distinct from pica_credits_update (work_credits / songwriter side).
+    pica_recording_credits_update: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "add a recording-side credit",
+    },
+    // ── 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",
+    },
+    // ADR-163 Tier B review queue + ADR-178 agent-proposed enrichment
+    pica_enrichment_proposals_list: {
+        category: "enrichment",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list pending enrichment proposals",
+    },
+    pica_enrichment_proposal_apply: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "apply an enrichment proposal",
+    },
+    pica_enrichment_proposal_reject: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "reject an enrichment proposal",
+    },
+    pica_enrichment_propose: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "propose an enrichment from research",
+    },
+    // ADR-179: outcome-shaped resolvers that replace the per-source enrich_* tools
+    pica_resolve_work: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "resolve a work against external sources",
+    },
+    pica_resolve_person: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "resolve a person against identity sources",
+    },
+    pica_resolve_recording: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "resolve a recording against external sources",
+    },
+    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",
+    },
+    // ADR-164 cascade re-run + health observability
+    pica_run_work_cascade: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "re-run cascade rules on a work",
+    },
+    pica_run_person_cascade: {
+        category: "enrichment",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "re-run cascade rules on a person",
+    },
+    pica_cascade_health: {
+        category: "enrichment",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check cascade health counters",
+    },
+    // ── 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_claim_credit: {
+        category: "discovery",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "claim discovered credit",
+    },
+    pica_claim_custody: {
+        category: "discovery",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "claim discovered custody",
+    },
+    pica_claim_artist: {
+        category: "discovery",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "claim discovered artist",
+    },
+    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",
+    },
+    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",
+    },
+    // ── 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",
+    },
+    pica_export_industry_ready: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export industry-ready package",
+    },
+    pica_export_catalog_asset_report: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "export catalog asset report",
+    },
+    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",
+    },
+    pica_projects_attach_works: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "attach works to 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",
+    },
+    pica_releases_attach_track: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "attach a track to a release",
+    },
+    pica_releases_list_tracks: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list tracks on a release",
+    },
+    pica_releases_detach_track: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "detach a track from a release",
+    },
+    pica_releases_reorder_tracks: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "reorder tracks on a release",
+    },
+    pica_releases_attach_recording_with_work: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "attach a recording (with linked work) to a release",
+    },
+    // ADR-175 release workflow tools
+    pica_releases_bulk_attach_tracks: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "bulk attach tracks to a release",
+    },
+    pica_releases_move_track: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "swap two track positions on a release",
+    },
+    pica_releases_attach_track_by_identifier: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "attach a track by external identifier",
+    },
+    pica_releases_create_with_tracks: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a release with its tracks in one call",
+    },
+    pica_releases_completeness_check: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "release completeness diligence report",
+    },
+    // ADR-208 Phase 3 Primitive D — rich render (image + markdown summary)
+    pica_release_show: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "render a release card (cover art + markdown)",
+    },
+    // ── 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",
+    },
+    // ADR-174 Phase 2 item 5: rich provenance links between assets and works/recordings
+    pica_physical_assets_link_work: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "link a physical asset to a work",
+    },
+    pica_physical_assets_link_recording: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "link a physical asset to a recording",
+    },
+    pica_physical_assets_unlink_work: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "unlink a physical asset from a work",
+    },
+    pica_physical_assets_unlink_recording: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "unlink a physical asset from a recording",
+    },
+    // ── 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",
+    },
+    pica_import_youtube_link: {
+        category: "catalog",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "import a youtube video as a recording",
+    },
+    // ── 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",
+    },
+    // ADR-218 cross-transport awareness — read + acknowledge the shared
+    // discovery_events ledger that backs MCP / Telegram / web / email
+    pica_notifications_recent: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "read recent cross-transport notifications",
+    },
+    pica_notification_acknowledge: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "acknowledge cross-transport notifications",
+    },
+    // ── 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",
+    },
+    // ADR-157 warm-path collaboration tools
+    pica_collaborators_incoming_list: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list invites addressed to you",
+    },
+    pica_collaborators_accept: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "accept a collaboration invite",
+    },
+    pica_collaborators_dispute: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "dispute a collaboration invite",
+    },
+    pica_collaborators_invite_bulk: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send multiple collaborator invites",
+    },
+    // ── 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_inspect: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a share link",
+    },
+    pica_share_links_update: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "update a share link",
+    },
+    pica_share_links_delete: {
+        category: "comms",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a share link",
+    },
+    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_telegram_connect: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "pair telegram with pica",
+    },
+    pica_notify_user: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "send notification to user via telegram",
+    },
+    // ADR-160 scheduled telegram reminders
+    pica_notify_user_at: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "schedule a telegram reminder",
+    },
+    pica_notify_user_list_pending: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list pending reminders",
+    },
+    pica_notify_user_cancel: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "cancel a scheduled reminder",
+    },
+    // ── 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",
+    },
+    // ── Labels (ADR-174 Decision 3) ────────────────────────────────────────────
+    pica_labels_query: {
+        category: "catalog",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find labels",
+    },
+    // ── 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_audit_list: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "review recent AI activity",
+    },
+    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 / pica_credits_purchase removed 2026-04-22.
+    pica_storage_status: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check storage usage and connection health",
+    },
+    // ADR-217 — BYOC storage configure + disconnect.
+    pica_storage_configure_start: {
+        category: "settings",
+        // Mints a JWT-bound URL only — no DB writes happen at the tool layer.
+        // The configure page (Phase 2) does the persistence after probe success.
+        risk: "safe",
+        retry_safe: true,
+        display_name: "set up your own cloud storage bucket (S3, GCS, Azure, R2, Backblaze)",
+    },
+    pica_storage_disconnect: {
+        category: "settings",
+        // Future uploads route differently — destructive in the same sense as
+        // pica_delete_my_account. Two-step gate handled by the dispatcher.
+        risk: "destructive",
+        retry_safe: true,
+        display_name: "revert storage to PICA-managed default",
+    },
+    pica_organisation_profile: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view account 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",
+    },
+    // ADR-184: user-facing self-service privacy & account tools
+    pica_get_privacy_settings: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check marketing opt-in state",
+    },
+    pica_update_privacy_settings: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "update marketing preferences",
+    },
+    pica_submit_feedback: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "submit feedback to the team",
+    },
+    pica_report_issue: {
+        category: "comms",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "report a workflow issue to the PICA team",
+    },
+    pica_my_reported_issues: {
+        category: "comms",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list issues you've reported and their resolution status",
+    },
+    pica_acknowledge_onboarding: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "acknowledge MCP onboarding (OAuth-arrived users only)",
+    },
+    pica_signup_start: {
+        // ADR-211 Phase 1 — agent-discoverable signup verb. Reachable in
+        // unauthenticated mode (lobby) on both stdio + HTTP transports.
+        // risk=safe because the tool itself only mints a JWT-bound URL — the
+        // org / trial / credentials are created by the page (Phase 2) after
+        // the user clicks the link and verifies email ownership.
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "start a withPICA signup (sends a magic link to verify email)",
+    },
+    // ADR-210 Phase 2 — explicit billing surface
+    pica_subscription_status: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "check your subscription status",
+    },
+    pica_subscription_manage: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "subscribe, upgrade, manage, or cancel",
+    },
+    pica_delete_my_account: {
+        category: "settings",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete your account",
+    },
+    pica_export_my_data: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "export your personal data (GDPR)",
+    },
+    // ADR-189 Phase 3 — self identity capture. Both are retry_safe
+    // because the writes are idempotent — re-applying the same IPI /
+    // ISNI leaves the row in the same final state. Rate-limited
+    // separately by checkActionRateLimit (20/hour per user).
+    pica_update_my_identity: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "capture your identifiers (IPI / ISNI / PRO)",
+    },
+    pica_update_organisation_profile: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "update your account profile",
+    },
+    // ── Agent Identity (ADR-185 Part 1) ───────────────────────────────────────
+    pica_create_agent_identity: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create an agent identity",
+    },
+    pica_issue_agent_grant: {
+        category: "settings",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "issue an agent grant",
+    },
+    pica_list_my_agent_grants: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "list your agent grants",
+    },
+    pica_revoke_agent_grant: {
+        category: "settings",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "revoke an agent grant",
+    },
+    pica_get_agent_activity: {
+        category: "settings",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "view your agent activity",
+    },
+    // ── ADR-222 Sync Placements ───────────────────────────────────────────────
+    pica_sync_placements_query: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "find sync placements",
+    },
+    pica_sync_placements_inspect: {
+        category: "business",
+        risk: "safe",
+        retry_safe: true,
+        display_name: "inspect a sync placement",
+    },
+    pica_sync_placements_create: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "create a sync placement",
+    },
+    pica_sync_placements_update: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: false,
+        display_name: "update a sync placement",
+    },
+    pica_sync_placements_delete: {
+        category: "business",
+        risk: "destructive",
+        retry_safe: false,
+        display_name: "delete a sync placement",
+    },
+    pica_sync_placements_cite: {
+        category: "business",
+        risk: "mutating",
+        retry_safe: true,
+        display_name: "attach evidence to a sync placement",
+    },
+};
+/**
+ * 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