@withpica/mcp-server 2.1.0

package/dist/prompts/index.js

@@ -0,0 +1,513 @@
+/**
+ * Prompt Registry for MCP Server
+ * Manages pre-configured prompts for common workflows
+ */
+export class PromptRegistry {
+    /**
+     * List all available prompts
+     */
+    listPrompts() {
+        return [
+            {
+                name: "analyze-catalog",
+                description: "Analyze the music catalog and provide insights about completeness, quality, and opportunities",
+                arguments: [],
+            },
+            {
+                name: "find-duplicates",
+                description: "Find potential duplicate works or people that might need merging",
+                arguments: [],
+            },
+            {
+                name: "enrich-metadata",
+                description: "Suggest works and people that could be enriched from external sources (ISNI, MusicBrainz)",
+                arguments: [],
+            },
+            {
+                name: "verify-works",
+                description: "Review unverified works and suggest which ones are ready for verification",
+                arguments: [],
+            },
+            {
+                name: "assess-catalog-health",
+                description: "Get the PICA Score and provide a detailed assessment of catalog health with prioritized improvement actions",
+                arguments: [],
+            },
+            {
+                name: "audit-credits",
+                description: "Find works with missing or incomplete credits and flag potential split issues",
+                arguments: [],
+            },
+            {
+                name: "new-catalog-setup",
+                description: "Get started with PICA — import your music however you like (Spotify link, spreadsheet, screenshot, or just describe your songs)",
+                arguments: [],
+            },
+            {
+                name: "close-the-loop",
+                description: "Check what's missing on a specific work and offer to fix each gap",
+                arguments: [
+                    {
+                        name: "work_id",
+                        description: "The work ID to check completeness for",
+                        required: true,
+                    },
+                ],
+            },
+            {
+                name: "register-my-works",
+                description: "Check registration status across PROs and help prepare works for registration",
+                arguments: [],
+            },
+            {
+                name: "prepare-for-sync",
+                description: "Get your catalog sync-ready — check audio analysis, mood tags, and completeness",
+                arguments: [],
+            },
+            {
+                name: "workspace-autopilot",
+                description: "Assess the workspace state and route to the right workflow — use this when you first connect or don't know where to start",
+                arguments: [],
+            },
+        ];
+    }
+    /**
+     * Get a prompt by name
+     */
+    async getPrompt(name, args) {
+        switch (name) {
+            case "analyze-catalog":
+                return this.getAnalyzeCatalogPrompt();
+            case "find-duplicates":
+                return this.getFindDuplicatesPrompt();
+            case "enrich-metadata":
+                return this.getEnrichMetadataPrompt();
+            case "verify-works":
+                return this.getVerifyWorksPrompt();
+            case "assess-catalog-health":
+                return this.getAssessCatalogHealthPrompt();
+            case "audit-credits":
+                return this.getAuditCreditsPrompt();
+            case "new-catalog-setup":
+                return this.getNewCatalogSetupPrompt();
+            case "close-the-loop":
+                return this.getCloseTheLoopPrompt(args?.work_id);
+            case "register-my-works":
+                return this.getRegisterMyWorksPrompt();
+            case "prepare-for-sync":
+                return this.getPrepareForSyncPrompt();
+            case "workspace-autopilot":
+                return this.getWorkspaceAutopilotPrompt();
+            default:
+                throw new Error(`Prompt not found: ${name}`);
+        }
+    }
+    /**
+     * Analyze catalog prompt
+     */
+    getAnalyzeCatalogPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please analyze my music catalog and provide a comprehensive report.
+
+Use the following tools to gather data:
+1. pica_catalog_stats - Get overall statistics
+2. pica_works_list - Review works data
+3. pica_people_list - Review people data
+4. pica_recordings_list - Review recordings data
+
+Analyze and report on:
+- Overall catalog size and composition
+- Data quality (missing ISWCs, ISRCs, metadata)
+- Verification status (how many works are verified/unverified)
+- Enrichment opportunities (people missing ISNI or MusicBrainz data)
+- Completeness (works with recordings, people with credits, etc.)
+- Recommendations for improvement
+
+Please provide specific, actionable insights.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Find duplicates prompt
+     */
+    getFindDuplicatesPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please help me find potential duplicate works and people in my catalog.
+
+Use these tools:
+1. pica_works_list - Get all works
+2. pica_people_list - Get all people
+
+Look for:
+- Works with very similar or identical titles
+- People with similar names (accounting for typos, different orderings)
+- Works with the same ISWC (if ISWC exists)
+- People with the same email address
+
+For each potential duplicate found:
+- List the IDs and key details
+- Explain why you think they might be duplicates
+- Suggest whether they should be merged or kept separate
+
+Be thorough but conservative - only flag items that have a strong likelihood of being duplicates.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Enrich metadata prompt
+     */
+    getEnrichMetadataPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please identify works and people that could benefit from metadata enrichment.
+
+Use these tools:
+1. pica_works_list - Get all works
+2. pica_people_list - Get all people
+
+Identify:
+- People without ISNI identifiers who might have one
+- People without MusicBrainz IDs who might have one
+- Works missing ISWCs that could potentially be looked up
+- People missing biographical information
+
+For each enrichment opportunity:
+- List the person/work details
+- Explain what data is missing
+- Suggest potential sources (ISNI, MusicBrainz, etc.)
+- Prioritize the most impactful enrichment opportunities
+
+Focus on people and works where enrichment would add the most value.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Verify works prompt
+     */
+    getVerifyWorksPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please review unverified works and suggest which ones are ready for verification.
+
+Use these tools:
+1. pica_works_list with verified: false - Get unverified works
+2. pica_recordings_by_work - Check if works have recordings
+3. pica_people_list - Check for associated people/credits
+
+For each unverified work, assess:
+- Does it have complete metadata (title, type, duration)?
+- Does it have an ISWC?
+- Does it have associated recordings?
+- Does it have proper credits/people assigned?
+
+Categorize unverified works into:
+1. Ready to verify - Has complete information
+2. Needs minor updates - Missing 1-2 pieces of information
+3. Needs significant work - Missing multiple key fields
+
+Provide specific recommendations for each category, including what's needed to move works forward.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Assess catalog health prompt
+     */
+    getAssessCatalogHealthPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please assess the health of my music catalog using the PICA Score.
+
+Use these tools:
+1. pica_score_get - Get the PICA Score with pillar breakdown
+2. pica_catalog_stats - Get raw catalog statistics for additional context
+3. pica_works_list - Sample works data to understand quality
+
+Analyze:
+- The composite score and grade — is this catalog ready for commercial use?
+- Each pillar (income, ownership, asset, verification) — which is weakest?
+- The top actions — prioritize them by effort vs impact
+- Compare pillar scores to identify the biggest gaps
+
+Provide:
+- A plain-language summary of catalog health (suitable for a non-technical stakeholder)
+- The top 3 highest-impact improvements with specific steps
+- An estimate of where the score could reach after those improvements
+- Any urgent issues that need immediate attention (e.g., missing ownership data, unverified high-value works)`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Audit credits prompt
+     */
+    getAuditCreditsPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Please audit the credits across my music catalog to find gaps and issues.
+
+Use these tools:
+1. pica_works_list - Get all works
+2. pica_credits_list - Check credits for each work (sample at least 20 works, prioritizing recent ones)
+3. pica_people_list - Cross-reference credited people
+
+Look for:
+- Works with no credits at all (no collaborators assigned)
+- Works where splits don't total 100%
+- Works with only one credited person (potential missing collaborators)
+- People who appear in multiple works — are their roles consistent?
+- Credits with generic roles (just "writer") vs specific roles ("composer", "lyricist")
+- People credited on works but missing key identifiers (IPI, ISNI)
+
+Report:
+- Summary statistics (% of works with credits, average collaborators per work)
+- List of works with no credits (highest priority to fix)
+- List of works with potential split issues
+- Recommendations for improving credit completeness
+- People who should be enriched with external identifiers for royalty collection`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * New catalog setup prompt — first-time onboarding
+     */
+    getNewCatalogSetupPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `I just connected to PICA. Help me get started with my music catalog.
+
+First, read the workspace://context resource to understand my current catalog state (is it empty or do I already have works?).
+
+If the catalog is empty, welcome me and explain that I can get my music into PICA however I like:
+1. Paste a Spotify or Deezer link — use pica_import_streaming_link to import tracks with ISRCs, credits, and artwork automatically
+2. Share a spreadsheet or PRO statement — use pica_import_analyze to read columns and import in bulk
+3. Send a screenshot of a track listing or release — you can read it and create the works from what you see
+4. Just describe my songs — use pica_works_create to add them as we talk
+
+Ask me what I've got and help me get started with whichever method I choose.
+
+After importing, guide me through closing the loop on each work:
+- Who wrote these songs? (pica_credits_update — add writers and set splits)
+- Are there publishing details registered? (pica_enrich_work_mlc — check MLC)
+- Do I have audio files to upload? (pica_audio_presigned_upload — for analysis)
+- What identifiers are missing? (pica_enrichment_status — check coverage)
+
+Don't push — let me stop whenever I want. But always let me know what the next valuable step would be.
+
+Also check pica_integrations_status to see if Google Calendar, Spotify, Gmail, or Telegram are connected. If not, mention that they can connect services at withpica.com/admin/settings to unlock calendar sync, email search, and notifications.
+
+If the catalog already has works, summarise what's there and ask what I'd like to do — import more, check health, or work on what's missing.
+
+Important: I can always log in at withpica.com to see, verify, and manage everything you create. The dashboard and MCP see the same catalog.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Close the loop — check a specific work's gaps and offer to fix each one
+     */
+    getCloseTheLoopPrompt(workId) {
+        const workInstruction = workId
+            ? `Check completeness for work ${workId} using pica_work_completeness.`
+            : `Ask me which work I'd like to check, or use pica_completeness_low to find works that need the most attention.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me close the loop on a work — find what's missing and offer to fix each gap.
+
+${workInstruction}
+
+For the work, check every aspect of completeness:
+1. pica_work_completeness — get the full gap analysis
+2. pica_credits_list — check if credits and splits are assigned
+3. pica_enrichment_status — check what enrichment sources have been tried
+
+For each gap found, offer a specific action:
+- Missing credits → "Want me to add writers? Who wrote this song?"
+- Splits not set → "What's the split between the writers?"
+- No ISWC → "Want me to check MLC for this work?" (pica_enrich_work_mlc)
+- No ISRC → "Do you have a recording with an ISRC for this?"
+- No audio → "Got a master recording to upload?"
+- Audio not analysed → "Want me to analyse the audio for BPM, key, and mood?"
+- No agreements → "Is there a publishing agreement for this work?"
+- Not registered → "Want me to check registration status?" (pica_registration_coverage)
+
+Work through each gap one at a time. Let me skip any I'm not ready for. After each fix, check if the completeness score improved.
+
+Keep it conversational — don't list all gaps at once. Start with the most important one and work down.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Register my works — check registration status and prepare for PRO submission
+     */
+    getRegisterMyWorksPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me check which of my works are registered and which still need registration.
+
+Steps:
+1. pica_registration_coverage — get an overview of registration status across PROs (PRS, MCPS, PPL, MLC)
+2. For works that aren't registered, use pica_work_registration_status on a sample to understand what's blocking registration
+3. Identify common blockers:
+   - Missing ISWC (needed for PRS/MCPS) → suggest pica_enrich_work_mlc
+   - Missing ISRC (needed for PPL) → check if recordings have ISRCs
+   - Missing credits (needed for all) → suggest adding writers
+   - Missing identifiers on people (IPI needed for PRO registration) → suggest enrichment
+
+Report:
+- How many works are fully registered vs partially vs not at all
+- The most common blocker and how to fix it
+- Which works are closest to being registration-ready (fewest gaps)
+
+Then offer:
+- "Want me to try enriching the works missing ISWCs from MLC?"
+- "Want me to export a CWR file for the works that are ready?" (pica_export_song_registration)
+- "Want me to check registration status for a specific work?"
+
+Focus on practical next steps, not just reporting.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Workspace autopilot — assess state and route to the right workflow
+     */
+    getWorkspaceAutopilotPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You've just connected to a PICA workspace. Assess its current state and guide me to the most valuable next action.
+
+Step 1 — Orient:
+Read the workspace://context resource to get a snapshot of the catalog: org info, catalog size, health score, and top priorities.
+
+Step 2 — Route based on what you find:
+
+If the catalog is EMPTY (0 works):
+→ Use the new-catalog-setup workflow. Welcome me, explain how to import music (Spotify link, spreadsheet, screenshot, or just describe songs), and get started.
+
+If the catalog has works but LOW completeness (PICA Score below 50 or many gaps):
+→ Use pica_completeness_low to find the works that need the most attention.
+→ Pick the top 3 and offer to run close-the-loop on them one at a time.
+→ Tell me: "Your catalog has [N] works but many have gaps. Want me to start closing the loop on the ones that need the most attention?"
+
+If there are DUPLICATE signals (workspace context mentions duplicates):
+→ Use the find-duplicates workflow. Tell me how many potential duplicates exist and offer to review them.
+
+If works are UNREGISTERED (registration coverage is low):
+→ Use the register-my-works workflow. Tell me how many works aren't registered and what's blocking them.
+
+If the catalog is HEALTHY (score above 70, few gaps):
+→ Use assess-catalog-health for a maintenance check. Tell me: "Your catalog looks solid. Here's a quick health check and what could still improve."
+
+If none of the above clearly applies:
+→ Use pica_catalog_stats and pica_score_get to give me a quick summary, then ask what I'd like to focus on.
+
+Step 3 — Explain your routing:
+Tell me WHY you chose the workflow you did, in one sentence. Example: "Your catalog has 42 works but 28 are missing credits, so let's close those gaps first."
+
+Step 4 — Offer alternatives:
+After explaining, mention 1-2 other things I could do instead. Example: "Or if you'd rather import more music first, I can help with that too."
+
+Important: Don't run all workflows at once. Pick the single most valuable action and commit to it. You can always switch later.`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Prepare for sync — get catalog sync-ready
+     */
+    getPrepareForSyncPrompt() {
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Help me get my catalog ready for sync licensing — make sure my works are discoverable and attractive to music supervisors.
+
+Steps:
+1. pica_catalog_stats — get an overview of the catalog
+2. pica_works_list — sample works to check what's missing for sync readiness
+3. For each work, check:
+   - Has audio been uploaded? (supervisors need to hear it)
+   - Has audio been analysed? (BPM, key, energy, mood — needed for search)
+   - Are mood tags and genre set? (how supervisors search)
+   - Is duration recorded? (supervisors filter by length)
+   - Are lyrics transcribed? (for lyrical content search)
+   - Is there a Spotify/YouTube link? (supervisors check existing presence)
+
+Report:
+- How many works have analysed audio vs unanalysed vs no audio at all
+- How many have mood tags and genre vs missing
+- The fastest path to sync-readiness (which works are closest)
+
+Then offer:
+- "Want me to trigger audio analysis on the tracks that have uploads but no analysis?"
+- "Want me to search for sync-ready tracks you already have?" (pica_search_for_sync)
+- "Want me to enrich works from Spotify to pull in genre and mood data?"
+
+The goal is making works findable by mood, BPM, key, and energy — that's what sync supervisors search by.`,
+                    },
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,OAAO,cAAc;IACzB;;OAEG;IACH,WAAW;QACT,OAAO;YACL;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,+FAA+F;gBACjG,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,kEAAkE;gBACpE,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,2FAA2F;gBAC7F,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EACT,2EAA2E;gBAC7E,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EACT,6GAA6G;gBAC/G,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,+EAA+E;gBACjF,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EACT,iIAAiI;gBACnI,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EACT,mEAAmE;gBACrE,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,uCAAuC;wBACpD,QAAQ,EAAE,IAAI;qBACf;iBACF;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EACT,+EAA+E;gBACjF,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,iFAAiF;gBACnF,SAAS,EAAE,EAAE;aACd;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,2HAA2H;gBAC7H,SAAS,EAAE,EAAE;aACd;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAA0B;QACtD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAExC,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAExC,KAAK,iBAAiB;gBACpB,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAExC,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAErC,KAAK,uBAAuB;gBAC1B,OAAO,IAAI,CAAC,4BAA4B,EAAE,CAAC;YAE7C,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAEtC,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAEzC,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAEnD,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAEzC,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAExC,KAAK,qBAAqB;gBACxB,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;YAE5C;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;8CAgB4B;qBACnC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;kGAiBgF;qBACvF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;qEAkBmD;qBAC1D;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;mGAkBiF;qBACxF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,4BAA4B;QAClC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;8GAiB4F;qBACnG;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;iFAoB+D;qBACtE;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,wBAAwB;QAC9B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;6IAwB2H;qBAClI;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,MAAe;QAC3C,MAAM,eAAe,GAAG,MAAM;YAC5B,CAAC,CAAC,+BAA+B,MAAM,gCAAgC;YACvE,CAAC,CAAC,+GAA+G,CAAC;QAEpH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;EAEhB,eAAe;;;;;;;;;;;;;;;;;;;uGAmBsF;qBAC5F;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,wBAAwB;QAC9B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;mDAqBiC;qBACxC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,2BAA2B;QACjC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gIAiC8G;qBACrH;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB;QAC7B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;0GAuBwF;qBAC/F;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Resource Registry for MCP Server
+ * Manages read-only data resources that AI assistants can access
+ */
+import { PicaClient } from "../pica-sdk.js";
+export interface ResourceDefinition {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}
+export interface ResourceContent {
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+}
+export type ResourceResult = any;
+export declare class ResourceRegistry {
+    private pica;
+    constructor(pica: PicaClient);
+    /**
+     * List all available resources
+     */
+    listResources(): ResourceDefinition[];
+    /**
+     * Read a resource by URI
+     */
+    readResource(uri: string): Promise<any>;
+    /**
+     * Get OpenAPI specification resource
+     */
+    private getOpenAPISpec;
+    /**
+     * Get works list resource
+     */
+    private getWorksList;
+    /**
+     * Get people list resource
+     */
+    private getPeopleList;
+    /**
+     * Get recordings list resource
+     */
+    private getRecordingsList;
+    /**
+     * Get catalog statistics resource
+     */
+    private getCatalogStats;
+    /**
+     * Get catalog health (PICA Score) resource
+     */
+    private getCatalogHealth;
+    /**
+     * Get workspace context resource — aggregated orientation for agents
+     */
+    private getWorkspaceContext;
+    /**
+     * Get recent events resource — webhook deliveries
+     */
+    private getRecentEvents;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC;AAEjC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAgErC;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA0C7C;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;YACW,YAAY;IA4B1B;;OAEG;YACW,aAAa;IA4B3B;;OAEG;YACW,iBAAiB;IA2B/B;;OAEG;YACW,eAAe;IAoD7B;;OAEG;YACW,gBAAgB;IAc9B;;OAEG;YACW,mBAAmB;IAcjC;;OAEG;YACW,eAAe;CAa9B"}