@withpica/mcp-server/dist/tools/recording-attribution-hints.d.ts

MCP Server for withPICA — enables AI assistants to interact with your withPICA music catalog

/**
 * ADR-213 Primitive A — completion hints for pica_recordings_create.
 *
 * Mirror of buildCustodyHints (works-side) for recordings. When a fresh
 * recording is created, three Important-severity hints prompt the rights
 * conversation by default:
 *
 * 1. recording_ownership_unset — fires when ownership_percentage IS NULL.
 *    NULL = "not set"; 0 = explicit zero (no hint, user has declared no
 *    ownership); 1-100 = already declared.
 * 2. recording_no_credits — always fires (we never know credits from a
 *    single fresh row). Points at pica_recording_credits_update.
 * 3. recording_master_unclaimed — fires when ownership_percentage IS NULL.
 *    Alternative path to #1 for orgs that want a formal chain claim
 *    (label / co-producer scenarios) rather than a flat percentage.
 *
 * Defensive shape — the SDK's `Recording` TS interface does not declare
 * `ownership_percentage`, but the API returns it as JSON pass-through
 * from `recordingsService.create`. Callers pass the raw recording object;
 * we read fields with a typed wrapper.
 */
import type { CompletionHint } from "@withpica/mcp-utils";
export declare function buildRecordingAttributionHints(recording: unknown): CompletionHint[];
//# sourceMappingURL=recording-attribution-hints.d.ts.map