@withpica/mcp-server 2.39.0 → 2.40.0

package/CHANGELOG.md

@@ -11,6 +11,104 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.40.0] - 2026-04-30
+
+### Changed
+
+- **ADR-214 W4 — `workflows` field is now required on `ToolDefinition`.**
+  Flips the optional `workflows?: WorkflowTag | WorkflowTag[]` field
+  introduced in W1 to a required `workflows: WorkflowTag | WorkflowTag[]`.
+  TypeScript compilation now enforces that every new tool authored
+  declares its workflow membership at the source site — no escape
+  hatch except the explicit `"infrastructure"` opt-out. Drift
+  prevention mechanism #1 from ADR-214 §"Drift prevention" is now
+  fully load-bearing. `lint-required-schemas.ts` hardened: the
+  parallel-window warning for untagged tools becomes a hard error
+  (defence-in-depth in case a tool somehow reaches the registry
+  without a `workflows` field at runtime).
+
+### Added
+
+- **ADR-214 W2 — agent-guide + required-fields schema resources.**
+  Two new resource families on the catalog `mcp-server`:
+  - `pica://docs/agent-guide` — workflow narrative for agents. Visible
+    in both lobby and authenticated modes; content branches on
+    `lobbyMode`. Lobby variant (~865 bytes) covers the signup → magic
+    link flow + what unlocks. Authenticated variant (~4.3 KB) lists the
+    five core workflows (register a work, add a recording, add audio,
+    add recording credits, enrich metadata) with verbatim tool sequences
+    and 8 common gotchas — verified against the live tool registry on
+    2026-04-30.
+  - `pica://schemas/work-required`, `pica://schemas/recording-required`,
+    `pica://schemas/work-credits-required`,
+    `pica://schemas/recording-credits-required`,
+    `pica://schemas/person-required` — JSON contracts derived at build
+    time from each tool's `inputSchema` (in `ToolRegistry`) joined with
+    `schema-mirror.json` for live CHECK constraint enums. Authenticated
+    mode only.
+- **Build-time generator + schema mirror.**
+  - `mcp-server/scripts/build-required-schemas.ts` — runs as part of
+    `npm run prebuild` (chained after `bundle-apps.ts`); reads
+    `required-schemas.source.ts` + `ToolRegistry` + `schema-mirror.json`
+    and emits the deterministic `required-schemas.generated.ts`
+    (committed to git so PR diffs surface drift, per
+    `feedback_type_regen_cumulative_drift`).
+  - `mcp-server/src/resources/schema-mirror.json` — committed snapshot
+    of CHECK constraint enums for `works`, `recordings`, `work_credits`,
+    `recording_credits`, `audio_files`. Refresh via
+    `mcp-server/scripts/refresh-schema-mirror.ts` (humans only; CI never
+    auto-regenerates).
+- **Inverse-coverage CI lint (`scripts/lint-required-schemas.ts`).**
+  Walks `ToolRegistry` and `REQUIRED_SCHEMAS_SOURCE` from both
+  directions: every tool whose `workflows` field tags it for a workflow
+  must appear in the source file; every source reference must resolve
+  to a real tool. During the parallel-development window (W1 still in
+  flight), tools missing the `workflows` field emit a single summary
+  warning (per coordinator decision Stage 1 §R2). Once W4 makes the
+  field required, the warning becomes an error.
+- **Agent-guide drift lint (`scripts/lint-agent-guide.ts`).** Greps
+  every `pica_*` token in `agent-guide.ts` against `ToolRegistry` (in
+  both `discoveryMode` settings, so meta-tools like `pica_discover` are
+  resolvable). Catches stale references after tool renames.
+- **Meta-tests** for both lints (per `feedback_meta_test_load_bearing`):
+  3 / 3 regressions caught and reverted before ship — see
+  `docs/follow-ups/2026-04-30-adr214-w2-meta-test-outcomes.md`.
+
+### Changed
+
+- `mcp-server/package.json` — `prebuild` now chains
+  `bundle-apps.ts && build-required-schemas.ts`. New scripts
+  `lint:required-schemas` and `lint:agent-guide` added; both wired into
+  `prepublishOnly` after the existing checks.
+- `mcp-server/src/resources/index.ts` — registers 6 new URIs across
+  `listResources()` (1 in the lobby branch, 5 in the authenticated
+  branch) and `readResource()` (1 case for the agent-guide variant
+  branch, 5 cases for the schema URIs).
+
+### Dependencies
+
+- `pg` + `@types/pg` added as devDependencies (used only by
+  `refresh-schema-mirror.ts` for direct Postgres CHECK-constraint pulls
+  against staging).
+
+### Internal
+
+- **ADR-214 W1 — `WorkflowTag` type + optional `workflows` field on tool
+  definitions.** Adds a union type
+  (`"work-required" | "recording-required" | "work-credits-required"
+| "recording-credits-required" | "person-required" | "infrastructure"`)
+  and a `workflows?: WorkflowTag | WorkflowTag[]` field to
+  `ToolDefinition` at `mcp-server/src/tools/index.ts`. All 231 tools now
+  carry the field — 8 catalog-core tools (`pica_works_create`,
+  `pica_works_update`, `pica_recordings_create`,
+  `pica_recordings_update`, `pica_people_create`, `pica_people_update`,
+  `pica_credits_update`, `pica_recording_credits_update`) reference one
+  or more Phase 1 workflows; the remaining 223 carry
+  `"infrastructure"`. Field is optional in W1 to keep the rollout
+  additive; W4 (post-merge of W1 + W2 resource scaffolding) flips it to
+  required so every future tool is forced to declare its workflow at
+  compile time. No runtime behaviour change in this release.
+
 ## [2.39.0] - 2026-04-30
 
 ### Added
@@ -85,7 +183,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   with track-list expand and inline streaming embeds is queued under
   the ADR-200 Phase 1.x backlog.
 - **`structuredContent`** envelope — `{ title, markdown, cover_base64,
-  cover_mime_type, resource_link_uri }`. Apps clients prefer this over
+cover_mime_type, resource_link_uri }`. Apps clients prefer this over
   re-decoding the image content block; non-Apps clients ignore it.
 
 ### Notes
@@ -162,15 +260,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   hints via the new `buildRecordingAttributionHints(recording)` helper
   (`mcp-server/src/tools/recording-attribution-hints.ts`). Mirror of
   `buildCustodyHints` for works:
-    - `recording_ownership_unset` — fires when `ownership_percentage IS NULL`.
-      Suggests `pica_recordings_update ownership_percentage:N`.
-    - `recording_no_credits` — always fires (we never know credits from a
-      single fresh row). Suggests the new `pica_recording_credits_update`.
-    - `recording_master_unclaimed` — fires when `ownership_percentage IS NULL`.
-      Alternative path for multi-party master claims via `pica_custody_claim`.
-  NULL-only triggers: `0` is "explicit zero", no hint. Negative-path
-  covered by jest at `recording-attribution-hints.test.ts` per
-  `feedback_meta_test_load_bearing.md`.
+  - `recording_ownership_unset` — fires when `ownership_percentage IS NULL`.
+    Suggests `pica_recordings_update ownership_percentage:N`.
+  - `recording_no_credits` — always fires (we never know credits from a
+    single fresh row). Suggests the new `pica_recording_credits_update`.
+  - `recording_master_unclaimed` — fires when `ownership_percentage IS NULL`.
+    Alternative path for multi-party master claims via `pica_custody_claim`.
+    NULL-only triggers: `0` is "explicit zero", no hint. Negative-path
+    covered by jest at `recording-attribution-hints.test.ts` per
+    `feedback_meta_test_load_bearing.md`.
 - **ADR-213 Primitive B — `pica_recording_credits_update`.** First-party
   recording-side write tool; closes the work/recording credit-write
   asymmetry. Writes to `recording_credits` (NOT the trade-secret
@@ -259,7 +357,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   missing (HTTP-discovery without bearer scope), or when the SDK response
   is missing `billing_slice` (older server pre-Phase-1), the fetcher
   emits a conservative `{ billing_state: "trial", trial_days_remaining:
-  null, current_tier: null, capacity_pct: 0 }` rather than fabricating
+null, current_tier: null, capacity_pct: 0 }` rather than fabricating
   "active" — the agent never sees misleading "active" billing for an
   uninitialized context.
 

package/dist/resources/agent-guide.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ADR-214 — workflow narrative for agents.
+ *
+ * Two markdown constants. ResourceRegistry serves AGENT_GUIDE_LOBBY when
+ * config.lobbyMode || !pica, AGENT_GUIDE_AUTHENTICATED otherwise.
+ *
+ * Tool sequences are verbatim from ADR-214 Decision section "Top
+ * workflows" — audit-verified 2026-04-30 against the live ToolRegistry.
+ *
+ * Edits to this file are linted by scripts/lint-agent-guide.ts: every
+ * `pica_*` token must resolve to a real tool in ToolRegistry.
+ */
+export declare const AGENT_GUIDE_AUTHENTICATED = "# pica \u2014 agent guide\n\npica manages a music catalog: works (compositions), recordings (masters),\npeople (writers, performers, publishers), credits, agreements, exports.\nmulti-tenant per organisation; every write is org-scoped automatically.\n\nyou are signed in. ~227 tools are available. five core workflows below\ncover most of the surface; for anything not listed, fall back to\n`pica_discover` (mode: list_categories \u2192 list_tools) \u2192 `pica_tool_details`.\n\n## top workflows\n\n### register a new work\n1. `pica_works_create` \u2014 title required; iswc settable inline.\n2. `pica_credits_update` \u2014 batch; attach writer/composer credits.\n   writer_split_percentage values must sum to 100 across all writer rows.\n   see `pica://schemas/work-required` and `pica://schemas/work-credits-required`.\n\n### add a recording to an existing work\n- `pica_recordings_create` \u2014 title + artist_name + version_type required\n  (version_type defaults to `master`). isrc and duration_ms are inline.\n- see `pica://schemas/recording-required`.\n\n### add audio to a recording\n1. `pica_audio_presigned_upload` \u2014 returns a signed url + token.\n2. uploader (browser, curl, sdk) PUTs the file to that url.\n3. `pica_audio_complete_upload` \u2014 registers the upload in the catalog.\n4. (optional) `pica_audio_analyze` \u2014 async; extracts bpm, key, mood, and\n   transcribes lyrics via whisper.\n5. `pica_audio_inspect` (sections: [\"analysis\", \"status\"]) \u2014 poll for\n   analysis results when you called step 4.\n\n### add recording credits\n- `pica_recording_credits_update` \u2014 batch. role enum is DISTINCT from\n  work credits (MainArtist / FeaturedArtist / Producer / Engineer / etc.).\n- person_id is OPTIONAL \u2014 credits can carry just credited_name when the\n  person isn't in the catalog yet.\n- see `pica://schemas/recording-credits-required`.\n\n### enrich existing metadata\n1. `pica_resolve_work` / `pica_resolve_person` / `pica_resolve_recording` \u2014\n   tier A identifier matches apply directly; tier B fuzzy matches queue\n   as proposals.\n2. `pica_enrichment_proposals_list` \u2014 view pending proposals.\n3. `pica_enrichment_proposal_apply` \u2014 commit a proposal you've reviewed.\n\n## common gotchas\n\n- **duration units differ.** `works.duration_seconds` (integer seconds);\n  `recordings.duration_ms` (integer milliseconds);\n  `audio_files.duration_seconds` (seconds again).\n- **no standalone identifier-assign tool.** iswc on works, isrc on\n  recordings, ipi/pro/ppl/mcps numbers on people \u2014 all inline at create\n  or update. there is no separate identifier tool family; don't search\n  for one.\n- **two write surfaces for work collaborators.** `pica_credits_update`\n  is canonical (writer/publisher splits + attestation). `work_collaborators`\n  is a simpler legacy surface still used by some flows.\n- **recording credits are a separate surface** with a different role\n  enum. use `pica_recording_credits_update`, not `pica_credits_update`.\n- **people identifier sprawl.** inline columns: `cae_ipi_number`,\n  `ipn_number`, `prs_number`, `ppl_number`, `pro_member_number`,\n  `mcps_member_number`. satellite (settable through the same create/update\n  call): `isni`, `musicbrainz_id`, `wikidata_id`, `discogs_artist_id`,\n  `imdb_id`, `viaf_id`, `deezer_artist_id`. treat as one inline surface.\n- **audio analysis is async + explicit.** `pica_audio_complete_upload`\n  does NOT auto-trigger analysis. call `pica_audio_analyze` and poll.\n- **lyrics from analysis don't auto-write back to `works.lyrics`.**\n  whisper transcripts land on the analysis row; copy is a separate step.\n- **org scoping + duplicate prevention.** every write is scoped to the\n  caller's organisation. iswc and isrc duplicates are blocked at write.\n\n## schema resources (pre-flight before each workflow)\n\n- `pica://schemas/work-required` \u2014 backs `pica_works_create`.\n- `pica://schemas/recording-required` \u2014 backs `pica_recordings_create`.\n- `pica://schemas/work-credits-required` \u2014 backs `pica_credits_update`.\n- `pica://schemas/recording-credits-required` \u2014 backs `pica_recording_credits_update`.\n- `pica://schemas/person-required` \u2014 backs `pica_people_create`.\n\neach schema returns a json contract: required fields, recommended fields,\nCHECK enum values, companion-call orchestration, and an example payload.\n";
+export declare const AGENT_GUIDE_LOBBY = "# pica \u2014 sign in to begin\n\nyou are in lobby mode. three tools are available; the rest unlock after\nsign-in.\n\n## lobby tools\n- `pica_signup_start` \u2014 create a new organisation and get a magic link\n  for first-time setup.\n- `pica_sign_in` \u2014 request a magic link for an existing user.\n- `pica_sign_out` \u2014 drop session.\n\n## to sign in\n1. ask the user for an email address.\n2. call `pica_signup_start` (new user) or `pica_sign_in` (returning).\n3. user clicks the magic link. on the next request, the catalog tool\n   surface unlocks automatically \u2014 no config to refresh.\n\n## what unlocks after sign-in\n~227 tools across catalog (works, recordings, people, credits),\nenrichment, exports, agreements, multimedia, analytics, and audio. five\nrequired-fields schema resources at `pica://schemas/<workflow>-required`.\nthe full agent-guide replaces this lobby content.\n";
+//# sourceMappingURL=agent-guide.d.ts.map

package/dist/resources/agent-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.d.ts","sourceRoot":"","sources":["../../src/resources/agent-guide.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,yBAAyB,2zIAkFrC,CAAC;AAEF,eAAO,MAAM,iBAAiB,24BAsB7B,CAAC"}

package/dist/resources/agent-guide.js

@@ -0,0 +1,120 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * ADR-214 — workflow narrative for agents.
+ *
+ * Two markdown constants. ResourceRegistry serves AGENT_GUIDE_LOBBY when
+ * config.lobbyMode || !pica, AGENT_GUIDE_AUTHENTICATED otherwise.
+ *
+ * Tool sequences are verbatim from ADR-214 Decision section "Top
+ * workflows" — audit-verified 2026-04-30 against the live ToolRegistry.
+ *
+ * Edits to this file are linted by scripts/lint-agent-guide.ts: every
+ * `pica_*` token must resolve to a real tool in ToolRegistry.
+ */
+export const AGENT_GUIDE_AUTHENTICATED = `# pica — agent guide
+
+pica manages a music catalog: works (compositions), recordings (masters),
+people (writers, performers, publishers), credits, agreements, exports.
+multi-tenant per organisation; every write is org-scoped automatically.
+
+you are signed in. ~227 tools are available. five core workflows below
+cover most of the surface; for anything not listed, fall back to
+\`pica_discover\` (mode: list_categories → list_tools) → \`pica_tool_details\`.
+
+## top workflows
+
+### register a new work
+1. \`pica_works_create\` — title required; iswc settable inline.
+2. \`pica_credits_update\` — batch; attach writer/composer credits.
+   writer_split_percentage values must sum to 100 across all writer rows.
+   see \`pica://schemas/work-required\` and \`pica://schemas/work-credits-required\`.
+
+### add a recording to an existing work
+- \`pica_recordings_create\` — title + artist_name + version_type required
+  (version_type defaults to \`master\`). isrc and duration_ms are inline.
+- see \`pica://schemas/recording-required\`.
+
+### add audio to a recording
+1. \`pica_audio_presigned_upload\` — returns a signed url + token.
+2. uploader (browser, curl, sdk) PUTs the file to that url.
+3. \`pica_audio_complete_upload\` — registers the upload in the catalog.
+4. (optional) \`pica_audio_analyze\` — async; extracts bpm, key, mood, and
+   transcribes lyrics via whisper.
+5. \`pica_audio_inspect\` (sections: ["analysis", "status"]) — poll for
+   analysis results when you called step 4.
+
+### add recording credits
+- \`pica_recording_credits_update\` — batch. role enum is DISTINCT from
+  work credits (MainArtist / FeaturedArtist / Producer / Engineer / etc.).
+- person_id is OPTIONAL — credits can carry just credited_name when the
+  person isn't in the catalog yet.
+- see \`pica://schemas/recording-credits-required\`.
+
+### enrich existing metadata
+1. \`pica_resolve_work\` / \`pica_resolve_person\` / \`pica_resolve_recording\` —
+   tier A identifier matches apply directly; tier B fuzzy matches queue
+   as proposals.
+2. \`pica_enrichment_proposals_list\` — view pending proposals.
+3. \`pica_enrichment_proposal_apply\` — commit a proposal you've reviewed.
+
+## common gotchas
+
+- **duration units differ.** \`works.duration_seconds\` (integer seconds);
+  \`recordings.duration_ms\` (integer milliseconds);
+  \`audio_files.duration_seconds\` (seconds again).
+- **no standalone identifier-assign tool.** iswc on works, isrc on
+  recordings, ipi/pro/ppl/mcps numbers on people — all inline at create
+  or update. there is no separate identifier tool family; don't search
+  for one.
+- **two write surfaces for work collaborators.** \`pica_credits_update\`
+  is canonical (writer/publisher splits + attestation). \`work_collaborators\`
+  is a simpler legacy surface still used by some flows.
+- **recording credits are a separate surface** with a different role
+  enum. use \`pica_recording_credits_update\`, not \`pica_credits_update\`.
+- **people identifier sprawl.** inline columns: \`cae_ipi_number\`,
+  \`ipn_number\`, \`prs_number\`, \`ppl_number\`, \`pro_member_number\`,
+  \`mcps_member_number\`. satellite (settable through the same create/update
+  call): \`isni\`, \`musicbrainz_id\`, \`wikidata_id\`, \`discogs_artist_id\`,
+  \`imdb_id\`, \`viaf_id\`, \`deezer_artist_id\`. treat as one inline surface.
+- **audio analysis is async + explicit.** \`pica_audio_complete_upload\`
+  does NOT auto-trigger analysis. call \`pica_audio_analyze\` and poll.
+- **lyrics from analysis don't auto-write back to \`works.lyrics\`.**
+  whisper transcripts land on the analysis row; copy is a separate step.
+- **org scoping + duplicate prevention.** every write is scoped to the
+  caller's organisation. iswc and isrc duplicates are blocked at write.
+
+## schema resources (pre-flight before each workflow)
+
+- \`pica://schemas/work-required\` — backs \`pica_works_create\`.
+- \`pica://schemas/recording-required\` — backs \`pica_recordings_create\`.
+- \`pica://schemas/work-credits-required\` — backs \`pica_credits_update\`.
+- \`pica://schemas/recording-credits-required\` — backs \`pica_recording_credits_update\`.
+- \`pica://schemas/person-required\` — backs \`pica_people_create\`.
+
+each schema returns a json contract: required fields, recommended fields,
+CHECK enum values, companion-call orchestration, and an example payload.
+`;
+export const AGENT_GUIDE_LOBBY = `# pica — sign in to begin
+
+you are in lobby mode. three tools are available; the rest unlock after
+sign-in.
+
+## lobby tools
+- \`pica_signup_start\` — create a new organisation and get a magic link
+  for first-time setup.
+- \`pica_sign_in\` — request a magic link for an existing user.
+- \`pica_sign_out\` — drop session.
+
+## to sign in
+1. ask the user for an email address.
+2. call \`pica_signup_start\` (new user) or \`pica_sign_in\` (returning).
+3. user clicks the magic link. on the next request, the catalog tool
+   surface unlocks automatically — no config to refresh.
+
+## what unlocks after sign-in
+~227 tools across catalog (works, recordings, people, credits),
+enrichment, exports, agreements, multimedia, analytics, and audio. five
+required-fields schema resources at \`pica://schemas/<workflow>-required\`.
+the full agent-guide replaces this lobby content.
+`;
+//# sourceMappingURL=agent-guide.js.map

package/dist/resources/agent-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guide.js","sourceRoot":"","sources":["../../src/resources/agent-guide.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFxC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBhC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,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,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAe;gBAElB,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,YAAY;IAK1D;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IAqGrC;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyH7C;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAY/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,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,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAe;gBAElB,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,YAAY;IAK1D;;OAEG;IACH,aAAa,IAAI,kBAAkB,EAAE;IA+IrC;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IA4J7C;;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"}

package/dist/resources/index.js

@@ -3,6 +3,8 @@ import { ResourceError } from "@withpica/mcp-utils";
 import { readFileSync } from "fs";
 import { join } from "path";
 import { WITHPICA_PRIMER } from "./llms-primer.js";
+import { AGENT_GUIDE_AUTHENTICATED, AGENT_GUIDE_LOBBY, } from "./agent-guide.js";
+import { REQUIRED_SCHEMAS } from "./required-schemas.generated.js";
 import { UPLOAD_HTML } from "../apps/upload.js";
 import { DOWNLOAD_HTML } from "../apps/download.js";
 import { RELEASE_HTML } from "../apps/release.js";
@@ -25,6 +27,12 @@ export class ResourceRegistry {
                 description: "Getting started guide — how to sign in and what you can do",
                 mimeType: "text/markdown",
             },
+            {
+                uri: "pica://docs/agent-guide",
+                name: "Agent Guide — How to Use PICA",
+                description: "Workflow-by-workflow guide for agents — what tools to call in what order, common gotchas, pointers to schema resources. Lobby mode returns a sign-in-focused variant; authenticated mode returns the full workflow map.",
+                mimeType: "text/markdown",
+            },
         ];
         if (this.config?.lobbyMode || !this.pica) {
             return resources;
@@ -89,6 +97,31 @@ export class ResourceRegistry {
             name: "Release Card",
             description: "Release rich-render card — cover art + markdown summary (ADR-208 Phase 3 Primitive D, Phase 3 stub)",
             mimeType: "text/html;profile=mcp-app",
+        }, {
+            uri: "pica://schemas/work-required",
+            name: "Required Fields — Register a Work",
+            description: "Required + recommended fields, CHECK enums, and companion-call orchestration for pica_works_create. Read before calling the work-create workflow.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/recording-required",
+            name: "Required Fields — Register a Recording",
+            description: "Required + recommended fields, CHECK enums, and companion-call orchestration for pica_recordings_create.",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/work-credits-required",
+            name: "Required Fields — Attach Work Credits",
+            description: "Per-row required fields and CHECK enums for pica_credits_update (writer/composer/publisher splits, sum to 100).",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/recording-credits-required",
+            name: "Required Fields — Attach Recording Credits",
+            description: "Per-row required fields and the role enum for pica_recording_credits_update (MainArtist / FeaturedArtist / Producer / Engineer / etc.).",
+            mimeType: "application/json",
+        }, {
+            uri: "pica://schemas/person-required",
+            name: "Required Fields — Register a Person",
+            description: "Required + recommended fields for pica_people_create (writers, performers, publishers; identifiers settable inline).",
+            mimeType: "application/json",
         });
         return resources;
     }
@@ -118,6 +151,18 @@ export class ResourceRegistry {
                         },
                     ],
                 };
+            case "pica://docs/agent-guide": {
+                const lobby = this.config?.lobbyMode || !this.pica;
+                return {
+                    contents: [
+                        {
+                            uri: "pica://docs/agent-guide",
+                            mimeType: "text/markdown",
+                            text: lobby ? AGENT_GUIDE_LOBBY : AGENT_GUIDE_AUTHENTICATED,
+                        },
+                    ],
+                };
+            }
             default:
                 break;
         }
@@ -195,6 +240,25 @@ export class ResourceRegistry {
                         },
                     ],
                 };
+            case "pica://schemas/work-required":
+            case "pica://schemas/recording-required":
+            case "pica://schemas/work-credits-required":
+            case "pica://schemas/recording-credits-required":
+            case "pica://schemas/person-required": {
+                const key = uri.replace("pica://schemas/", "");
+                const body = REQUIRED_SCHEMAS[key];
+                if (!body)
+                    throw new ResourceError(`Schema not found: ${uri}`);
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(body, null, 2),
+                        },
+                    ],
+                };
+            }
             default:
                 throw new ResourceError(`Resource not found: ${uri}`);
         }

package/dist/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAS7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAmBjE,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAoB;IACxB,MAAM,CAAgB;IAE9B,YAAY,IAAuB,EAAE,MAAqB;QACxD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,SAAS,GAAyB;YACtC;gBACE,GAAG,EAAE,gBAAgB;gBACrB,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,4DAA4D;gBAC9D,QAAQ,EAAE,eAAe;aAC1B;SACF,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,SAAS,CAAC,IAAI,CACZ;YACE,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,4HAA4H;YAC9H,QAAQ,EAAE,eAAe;SAC1B,EACD;YACE,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,oDAAoD;YACjE,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,mBAAmB;YACxB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,6BAA6B;YAC1C,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,iBAAiB;YACtB,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,0CAA0C;YACvD,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,6BAA6B;YACnC,WAAW,EACT,4GAA4G;YAC9G,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,qBAAqB;YAC1B,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACT,0GAA0G;YAC5G,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,iBAAiB;YACtB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,2EAA2E;YAC7E,QAAQ,EAAE,kBAAkB;SAC7B,EACD;YACE,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACT,qHAAqH;YACvH,QAAQ,EAAE,WAAW;SACtB,EACD;YACE,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,6EAA6E;YAC/E,QAAQ,EAAE,2BAA2B;SACtC,EACD;YACE,GAAG,EAAE,oBAAoB;YACzB,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,gEAAgE;YAClE,QAAQ,EAAE,2BAA2B;SACtC,EACD;YACE,GAAG,EAAE,mBAAmB;YACxB,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,qGAAqG;YACvG,QAAQ,EAAE,2BAA2B;SACtC,CACF,CAAC;QAEF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,gBAAgB;gBACnB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,gBAAgB;4BACrB,QAAQ,EAAE,eAAe;4BACzB,IAAI,EACF,uBAAuB;gCACvB,yFAAyF;gCACzF,oBAAoB;gCACpB,uDAAuD;gCACvD,iFAAiF;gCACjF,oDAAoD;gCACpD,yCAAyC;gCACzC,mDAAmD;gCACnD,8DAA8D;gCAC9D,8CAA8C;gCAC9C,iCAAiC;gCACjC,gDAAgD;yBACnD;qBACF;iBACF,CAAC;YAEJ;gBACE,MAAM;QACV,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,yCAAyC,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,eAAe;gBAClB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,eAAe;4BACpB,QAAQ,EAAE,eAAe;4BACzB,IAAI,EAAE,eAAe;yBACtB;qBACF;iBACF,CAAC;YAEJ,KAAK,cAAc;gBACjB,OAAO,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAEnC,KAAK,eAAe;gBAClB,OAAO,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAEpC,KAAK,mBAAmB;gBACtB,OAAO,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAExC,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAEtC,KAAK,kBAAkB;gBACrB,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAEvC,KAAK,qBAAqB;gBACxB,OAAO,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAE1C,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;YAEtC,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;YAE/B,KAAK,kBAAkB;gBACrB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,kBAAkB;4BACvB,QAAQ,EAAE,2BAA2B;4BACrC,IAAI,EAAE,WAAW;4BACjB,KAAK,EAAE;gCACL,EAAE,EAAE;oCACF,GAAG,EAAE;wCACH,cAAc,EAAE,4BAA4B;qCAC7C;iCACF;6BACF;yBACF;qBACF;iBACF,CAAC;YAEJ,KAAK,oBAAoB;gBACvB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,oBAAoB;4BACzB,QAAQ,EAAE,2BAA2B;4BACrC,IAAI,EAAE,aAAa;4BACnB,KAAK,EAAE;gCACL,EAAE,EAAE;oCACF,GAAG,EAAE;wCACH,cAAc,EAAE,4BAA4B;qCAC7C;iCACF;6BACF;yBACF;qBACF;iBACF,CAAC;YAEJ,KAAK,mBAAmB;gBACtB,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,mBAAmB;4BACxB,QAAQ,EAAE,2BAA2B;4BACrC,IAAI,EAAE,YAAY;yBACnB;qBACF;iBACF,CAAC;YAEJ;gBACE,MAAM,IAAI,aAAa,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,2CAA2C;QAC3C,MAAM,aAAa,GAAG;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,uBAAuB,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,0BAA0B,CAAC;SAChD,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpD,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,eAAe;4BACpB,QAAQ,EAAE,WAAW;4BACrB,IAAI,EAAE,WAAW;yBAClB;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,aAAa,CACrB,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,cAAc;oBACnB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,KAAK,CAAC,MAAM;wBACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;4BACX,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,SAAS,EAAE,IAAI,CAAC,SAAS;4BACzB,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;yBACxC,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,eAAe;oBACpB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,MAAM,CAAC,MAAM;wBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;4BAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;4BACb,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,cAAc,EAAE,MAAM,CAAC,cAAc;yBACtC,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,mBAAmB;oBACxB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,UAAU,CAAC,MAAM;wBACxB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;4BACzC,EAAE,EAAE,SAAS,CAAC,EAAE;4BAChB,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;4BAC5C,OAAO,EAAE,SAAS,CAAC,OAAO;yBAC3B,CAAC,CAAC;qBACJ,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,IAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,IAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACvC,IAAI,CAAC,IAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,QAAQ,EAAE;gBACR,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,YAAY,EAAE,MAAM,CAAC,MAAM;gBAC3B,gBAAgB,EAAE,UAAU,CAAC,MAAM;gBACnC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM;gBACnD,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM;gBACtD,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;gBAC7C,OAAO,EAAE;oBACP,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;oBACT,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;oBACT,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,MAAM;oBACpE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;yBAC5D,MAAM;iBACV;aACF;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;gBAChD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;gBAC9C,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM;aAChE;YACD,UAAU,EAAE;gBACV,KAAK,EAAE,UAAU,CAAC,MAAM;gBACxB,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM;aACnD;SACF,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,iBAAiB;oBACtB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB;QAC5B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAE/C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,kBAAkB;oBACvB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAExD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,qBAAqB;oBAC1B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAE9D,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,iBAAiB;oBACtB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/required-schemas.generated.d.ts

@@ -0,0 +1,128 @@
+export declare const REQUIRED_SCHEMAS: {
+    readonly "person-required": {
+        readonly workflow: "person-required";
+        readonly summary: "Required fields to register a person (writer, performer, producer, publisher). Identifiers (IPI / ISNI / PRO / MusicBrainz / etc.) are inline-settable at create time.";
+        readonly primary_tool: "pica_people_create";
+        readonly primary_required: readonly ["first_name", "last_name"];
+        readonly primary_recommended: readonly ["middle_name", "name", "stage_name", "stage_names", "person_type", "biography", "email", "emails", "phone", "website", "social_media", "roles", "tags", "cae_ipi_number", "ipn_number", "prs_number", "ppl_number", "mcps_member_number", "pro_name", "pro_member_number", "default_publisher", "default_publisher_ipi", "company", "position", "territory", "relationship_strength", "email_preferences", "profile_image_url", "notes", "isni", "musicbrainz_id", "wikidata_id", "discogs_artist_id", "deezer_artist_id", "date_of_birth", "gender", "nationality", "birth_place", "instruments", "career_start_year"];
+        readonly enums: {};
+        readonly companion_calls: readonly [{
+            readonly tool: "pica_people_update";
+            readonly when: "After creation — to amend name, identifiers (IPI / ISNI / PRO / MusicBrainz / etc.), or any other inline field. Same payload shape as create plus `id`.";
+            readonly required: readonly ["id"];
+        }];
+        readonly example: {
+            readonly first_name: "Jane";
+            readonly last_name: "Doe";
+            readonly cae_ipi_number: "00000000001";
+            readonly isni: "0000000123456789";
+            readonly pro_member_number: "PRS123456";
+        };
+    };
+    readonly "recording-credits-required": {
+        readonly workflow: "recording-credits-required";
+        readonly summary: "Required fields per credit row when attaching MainArtist / FeaturedArtist / Producer / Engineer credits to a recording. Distinct role enum from work credits. person_id is optional — credits can carry just credited_name.";
+        readonly primary_tool: "pica_recording_credits_update";
+        readonly primary_required: readonly ["recording_id", "credited_name", "role"];
+        readonly primary_recommended: readonly ["person_id", "split_percentage", "split_type", "display_order", "notes"];
+        readonly enums: {
+            readonly role: readonly ["Arranger", "Co-Producer", "Engineer", "Executive Producer", "FeaturedArtist", "Instrumentalist", "MainArtist", "Mastering Engineer", "Mixer", "Other", "Performer", "Producer", "Programmer", "Recording Engineer", "Remixer", "Vocalist"];
+        };
+        readonly companion_calls: readonly [];
+        readonly example: {
+            readonly recording_id: "<uuid>";
+            readonly credits: readonly [{
+                readonly credited_name: "The Riverbed Trio";
+                readonly role: "MainArtist";
+                readonly display_order: 0;
+            }, {
+                readonly credited_name: "Sam Producer";
+                readonly role: "Producer";
+                readonly display_order: 1;
+            }];
+        };
+    };
+    readonly "recording-required": {
+        readonly workflow: "recording-required";
+        readonly summary: "Required fields to register a recording (a specific master, version, or live capture of a work).";
+        readonly primary_tool: "pica_recordings_create";
+        readonly primary_required: readonly ["title", "artist_name", "version_type"];
+        readonly primary_recommended: readonly ["recording_title", "work_id", "ownership_percentage", "labels", "isrc", "isrc_source", "musicbrainz_recording_id", "mlc_recording_id", "mlc_song_code", "duration_ms", "preview_url", "album_art_url", "spotify_url", "spotify_track_uri", "spotify_track_id", "youtube_video_id", "youtube_url", "apple_music_url", "deezer_track_id", "ppl_registered", "ppl_recording_id", "ai_disclosure", "provenance_attestation", "training_rights"];
+        readonly enums: {
+            readonly version_type: readonly ["acoustic", "alternate", "alternate_master", "cover", "live_performance", "lyric_video", "master", "music_video", "remix"];
+        };
+        readonly companion_calls: readonly [{
+            readonly tool: "pica_recording_credits_update";
+            readonly when: "Batch — attach MainArtist / Producer / Engineer credits to the recording.";
+            readonly required: readonly ["recording_id", "credits"];
+            readonly per_row_required: readonly ["credited_name", "role", "display_order"];
+        }, {
+            readonly tool: "pica_recordings_update";
+            readonly when: "After creation — to amend recording_title, artist_name, version_type, isrc, duration_ms, or any other inline field. Same payload shape as create plus `id`.";
+            readonly required: readonly ["id"];
+        }];
+        readonly example: {
+            readonly title: "Midnight Rivers (Master)";
+            readonly artist_name: "The Riverbed Trio";
+            readonly version_type: "master";
+            readonly isrc: "USABC2300001";
+            readonly duration_ms: 213000;
+        };
+    };
+    readonly "work-credits-required": {
+        readonly workflow: "work-credits-required";
+        readonly summary: "Required fields per credit row when attaching writer/composer/publisher credits to a work. Splits sum to 100 across writers.";
+        readonly primary_tool: "pica_credits_update";
+        readonly primary_required: readonly ["work_id", "credits"];
+        readonly primary_recommended: readonly [];
+        readonly enums: {
+            readonly credit_type: readonly ["arranger", "composer", "conductor", "engineer", "instrumentalist", "lyricist", "mastering", "mixer", "owner", "performer", "producer", "programmer", "remixer", "vocalist", "writer"];
+            readonly rights_type: readonly ["all", "mechanical", "performance", "synchronization"];
+            readonly attestation_status: readonly ["attested", "declined", "disputed", "pending"];
+        };
+        readonly companion_calls: readonly [];
+        readonly example: {
+            readonly work_id: "<uuid>";
+            readonly credits: readonly [{
+                readonly person_id: "<uuid>";
+                readonly credit_type: "writer";
+                readonly writer_split_percentage: 50;
+            }, {
+                readonly person_id: "<uuid>";
+                readonly credit_type: "writer";
+                readonly writer_split_percentage: 50;
+            }];
+        };
+    };
+    readonly "work-required": {
+        readonly workflow: "work-required";
+        readonly summary: "Required fields to register a fully-credited musical work.";
+        readonly primary_tool: "pica_works_create";
+        readonly primary_required: readonly ["title", "work_type"];
+        readonly primary_recommended: readonly ["work_status", "iswc", "isrc", "tunecode", "prs_work_id", "spotify_track_uri", "duration_seconds", "tempo", "key", "genre", "mood", "primary_artist", "primary_artist_id", "display_artist", "publisher_name", "lyrics", "lyrics_language", "published", "notes", "ai_disclosure", "provenance_attestation", "training_rights"];
+        readonly enums: {
+            readonly work_type: readonly ["demo", "instrumental", "library", "sample", "song"];
+            readonly work_status: readonly ["archived", "demo", "pitched", "placed", "released", "unreleased"];
+        };
+        readonly companion_calls: readonly [{
+            readonly tool: "pica_credits_update";
+            readonly when: "Once per work, batch — attach all writer/publisher splits in a single call.";
+            readonly required: readonly ["work_id", "credits"];
+            readonly per_row_required: readonly ["person_id", "credit_type"];
+            readonly constraint: "writer_split_percentage values must sum to 100 across all writer credits for the work.";
+        }, {
+            readonly tool: "pica_works_update";
+            readonly when: "After creation — to amend title, work_type, work_status, iswc, lyrics, or any other inline field. Use the same payload shape as create with the addition of `id`.";
+            readonly required: readonly ["id"];
+        }];
+        readonly example: {
+            readonly title: "Midnight Rivers";
+            readonly work_type: "song";
+            readonly iswc: "T-123.456.789-0";
+            readonly duration_seconds: 213;
+            readonly lyrics_language: "en";
+        };
+    };
+};
+export type RequiredSchemaKey = keyof typeof REQUIRED_SCHEMAS;
+//# sourceMappingURL=required-schemas.generated.d.ts.map

package/dist/resources/required-schemas.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-schemas.generated.d.ts","sourceRoot":"","sources":["../../src/resources/required-schemas.generated.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgVnB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,gBAAgB,CAAC"}