@withpica/mcp-server 2.110.0 → 2.112.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +129 -0
- package/README.intro.md +1 -1
- package/README.md +4 -4
- package/dist/apps/shared.d.ts.map +1 -1
- package/dist/apps/shared.js +8 -4
- package/dist/apps/shared.js.map +1 -1
- package/dist/lib/changelog.generated.d.ts +2 -2
- package/dist/lib/changelog.generated.d.ts.map +1 -1
- package/dist/lib/changelog.generated.js +2 -2
- package/dist/lib/changelog.generated.js.map +1 -1
- package/dist/prompts/creator-question-atlas.d.ts.map +1 -1
- package/dist/prompts/creator-question-atlas.js +11 -0
- package/dist/prompts/creator-question-atlas.js.map +1 -1
- package/dist/resources/agent-guide.d.ts.map +1 -1
- package/dist/resources/agent-guide.js +6 -4
- package/dist/resources/agent-guide.js.map +1 -1
- package/dist/resources/required-schemas.generated.d.ts +3 -3
- package/dist/resources/required-schemas.generated.d.ts.map +1 -1
- package/dist/resources/required-schemas.generated.js +3 -2
- package/dist/resources/required-schemas.generated.js.map +1 -1
- package/dist/resources/required-schemas.source.js +2 -2
- package/dist/resources/required-schemas.source.js.map +1 -1
- package/dist/tools/agreements.d.ts.map +1 -1
- package/dist/tools/agreements.js +3 -0
- package/dist/tools/agreements.js.map +1 -1
- package/dist/tools/audio-files.d.ts.map +1 -1
- package/dist/tools/audio-files.js +67 -7
- package/dist/tools/audio-files.js.map +1 -1
- package/dist/tools/credits.d.ts.map +1 -1
- package/dist/tools/credits.js +4 -0
- package/dist/tools/credits.js.map +1 -1
- package/dist/tools/dashboard.d.ts.map +1 -1
- package/dist/tools/dashboard.js +5 -1
- package/dist/tools/dashboard.js.map +1 -1
- package/dist/tools/deprecations.d.ts.map +1 -1
- package/dist/tools/deprecations.js +7 -0
- package/dist/tools/deprecations.js.map +1 -1
- package/dist/tools/discovery.d.ts.map +1 -1
- package/dist/tools/discovery.js +3 -1
- package/dist/tools/discovery.js.map +1 -1
- package/dist/tools/documents.d.ts.map +1 -1
- package/dist/tools/documents.js +3 -1
- package/dist/tools/documents.js.map +1 -1
- package/dist/tools/enrichment.js +1 -1
- package/dist/tools/enrichment.js.map +1 -1
- package/dist/tools/gap-hints.d.ts.map +1 -1
- package/dist/tools/gap-hints.js +21 -21
- package/dist/tools/gap-hints.js.map +1 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +7 -0
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/metadata.d.ts.map +1 -1
- package/dist/tools/metadata.js +13 -6
- package/dist/tools/metadata.js.map +1 -1
- package/dist/tools/people.d.ts.map +1 -1
- package/dist/tools/people.js +18 -1
- package/dist/tools/people.js.map +1 -1
- package/dist/tools/recording-custody.d.ts.map +1 -1
- package/dist/tools/recording-custody.js +3 -0
- package/dist/tools/recording-custody.js.map +1 -1
- package/dist/tools/recordings.d.ts.map +1 -1
- package/dist/tools/recordings.js +27 -4
- package/dist/tools/recordings.js.map +1 -1
- package/dist/tools/recovery-hints.d.ts.map +1 -1
- package/dist/tools/recovery-hints.js +29 -14
- package/dist/tools/recovery-hints.js.map +1 -1
- package/dist/tools/share-links.js +1 -1
- package/dist/tools/share-links.js.map +1 -1
- package/dist/tools/share-send.d.ts.map +1 -1
- package/dist/tools/share-send.js +25 -5
- package/dist/tools/share-send.js.map +1 -1
- package/dist/tools/song-access.d.ts +45 -0
- package/dist/tools/song-access.d.ts.map +1 -0
- package/dist/tools/song-access.js +184 -0
- package/dist/tools/song-access.js.map +1 -0
- package/dist/tools/users.d.ts +6 -4
- package/dist/tools/users.d.ts.map +1 -1
- package/dist/tools/users.js +28 -37
- package/dist/tools/users.js.map +1 -1
- package/dist/tools/works.d.ts.map +1 -1
- package/dist/tools/works.js +5 -1
- package/dist/tools/works.js.map +1 -1
- package/package.json +3 -3
- package/server.json +2 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"share-links.js","sourceRoot":"","sources":["../../src/tools/share-links.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAoB7D,OAAO,EACL,aAAa,EAEb,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,OAAO,eAAe;IAClB,IAAI,CAAa;IAEzB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO;YACL,gEAAgE;YAChE,+DAA+D;YAC/D,oEAAoE;YACpE,uEAAuE;YACvE,oEAAoE;YACpE,0BAA0B;YAC1B;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,wBAAwB;oBAC9B,KAAK,EAAE,cAAc;oBACrB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC;oBACtC,IAAI,EAAE,MAAM;oBACZ,WAAW,EACT,0DAA0D;wBAC1D,kEAAkE;wBAClE,qDAAqD;oBACvD,SAAS,EAAE,gBAAgB;oBAC3B,eAAe,EAAE,YAAY;oBAC7B,iBAAiB,EACf,6IAA6I;oBAC/I,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE;gCACP,IAAI,EAAE,QAAQ;gCACd,WAAW,EAAE,+CAA+C;6BAC7D;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;aACzC;YACD;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,yBAAyB;oBAC/B,KAAK,EAAE,aAAa;oBACpB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC;oBACtC,IAAI,EAAE,OAAO;oBACb,WAAW,EACT,yFAAyF;wBACzF,6EAA6E;wBAC7E,wFAAwF;wBACxF,4IAA4I;wBAC5I,4DAA4D;wBAC5D,iGAAiG;wBACjG,6FAA6F;wBAC7F,8FAA8F;wBAC9F,iHAAiH;wBACjH,
|
|
1
|
+
{"version":3,"file":"share-links.js","sourceRoot":"","sources":["../../src/tools/share-links.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"share-send.d.ts","sourceRoot":"","sources":["../../src/tools/share-send.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"share-send.d.ts","sourceRoot":"","sources":["../../src/tools/share-send.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,cAAc;IACb,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAiI3D,SAAS;CA2CxB"}
|
package/dist/tools/share-send.js
CHANGED
|
@@ -18,7 +18,7 @@ export class ShareSendTools {
|
|
|
18
18
|
description: "Use when the user asks: 'send this song to my publisher', " +
|
|
19
19
|
"'share this work with sarah', 'email the report to my manager', " +
|
|
20
20
|
"'shoot this over to <name>', 'forward to <email>'. " +
|
|
21
|
-
"Sends a withPICA-branded email containing a scoped
|
|
21
|
+
"Sends a withPICA-branded email containing a scoped share link " +
|
|
22
22
|
"share-link to a named recipient. To send SEVERAL works — an " +
|
|
23
23
|
"album, a pitch of three songs — pass entity_ids: the recipient " +
|
|
24
24
|
"gets ONE email and ONE link with a track list, never one per " +
|
|
@@ -31,15 +31,19 @@ export class ShareSendTools {
|
|
|
31
31
|
"FIRST_EXTERNAL_SEND_CONFIRMATION_REQUIRED — re-call with " +
|
|
32
32
|
"confirm_first_external_send: true to proceed (deliberate friction " +
|
|
33
33
|
"against typo-driven phishing). Sender capped at 20 external " +
|
|
34
|
-
"sends / 24h. Recipient capped at 20
|
|
35
|
-
"
|
|
34
|
+
"sends / 24h. Recipient capped at 20 shares / 30 days from all senders. " +
|
|
35
|
+
"Email From is always noreply@withpica.com; " +
|
|
36
36
|
"Reply-to is the sender's email; recipient can report unwanted " +
|
|
37
37
|
"contact via a footer link in the email. " +
|
|
38
|
-
"This sends the WORK itself, as a scoped
|
|
38
|
+
"This sends the WORK itself, as a scoped share link the " +
|
|
39
39
|
"recipient can open. Use pica_send_message instead to invite " +
|
|
40
40
|
"someone or to ask them for a file — that is the Send Hub outbox, " +
|
|
41
41
|
"and it carries no link to an asset. Use pica_share_links_create " +
|
|
42
|
-
"when the user wants a link to copy and no email sent."
|
|
42
|
+
"when the user wants a link to copy and no email sent. " +
|
|
43
|
+
"To email a link that already exists (made with pica_share_links_create, " +
|
|
44
|
+
"or in the browser), pass share_link_id instead of entity_id(s): the link's " +
|
|
45
|
+
"own settings are sent as they are, and on a specific-people link the " +
|
|
46
|
+
"address must be one of its recipients, who gets their own URL.",
|
|
43
47
|
inputSchema: {
|
|
44
48
|
type: "object",
|
|
45
49
|
properties: {
|
|
@@ -96,6 +100,11 @@ export class ShareSendTools {
|
|
|
96
100
|
items: { type: "string", format: "uuid" },
|
|
97
101
|
description: "optional: audio_files ids to include in the share (across every work being sent); omit to share all of the works' files",
|
|
98
102
|
},
|
|
103
|
+
share_link_id: {
|
|
104
|
+
type: "string",
|
|
105
|
+
format: "uuid",
|
|
106
|
+
description: "Email this existing share link (from pica_share_links_create or pica_share_links_query) instead of making one. Not with entity_id(s), expires_in_days, scope, included_file_ids or include_splits: the link's own settings stand.",
|
|
107
|
+
},
|
|
99
108
|
},
|
|
100
109
|
required: ["entity_type", "recipient"],
|
|
101
110
|
},
|
|
@@ -129,6 +138,9 @@ export class ShareSendTools {
|
|
|
129
138
|
included_file_ids: Array.isArray(args.included_file_ids)
|
|
130
139
|
? args.included_file_ids
|
|
131
140
|
: undefined,
|
|
141
|
+
share_link_id: typeof args.share_link_id === "string"
|
|
142
|
+
? args.share_link_id
|
|
143
|
+
: undefined,
|
|
132
144
|
});
|
|
133
145
|
return formatSuccess(`shared via withPICA — ${result.recipient_resolution.classification}`, result);
|
|
134
146
|
}
|
|
@@ -167,6 +179,14 @@ function suggestionFor(code) {
|
|
|
167
179
|
return "v1 supports entity_type='work' only. Recording/audio_file/document share-send is on the roadmap.";
|
|
168
180
|
case "FORBIDDEN":
|
|
169
181
|
return "You're not a member of the asset's organisation. Switch context with pica_organisations_switch or share an asset you own.";
|
|
182
|
+
case "LINK_SETTINGS_FIXED":
|
|
183
|
+
return "With share_link_id the link's own settings are sent; drop entity_id(s), expires_in_days, scope, included_file_ids and include_splits, or make a new link instead.";
|
|
184
|
+
case "SHARE_LINK_NOT_FOUND":
|
|
185
|
+
return "That share link isn't in your catalogue. List them with pica_share_links_query.";
|
|
186
|
+
case "SHARE_LINK_NOT_LIVE":
|
|
187
|
+
return "The link is turned off or expired. Turn it back on with pica_share_links_update, or make a new one.";
|
|
188
|
+
case "RECIPIENT_NOT_ON_LINK":
|
|
189
|
+
return "On a specific-people link only its recipients can be sent their own URL. Make a link that names this person, or send them a different link.";
|
|
170
190
|
case "RECIPIENT_NOT_FOUND":
|
|
171
191
|
return "The recipient lookup failed. For collaborator_id, verify it's in your current org. For user_id, confirm the user exists.";
|
|
172
192
|
default:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"share-send.js","sourceRoot":"","sources":["../../src/tools/share-send.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAqB7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE;oBACV,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,eAAe;oBACtB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;oBAC5B,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,gBAAgB;oBAC3B,eAAe,EAAE,eAAe;oBAChC,WAAW,EACT,4DAA4D;wBAC5D,kEAAkE;wBAClE,qDAAqD;wBACrD,gEAAgE;wBAChE,8DAA8D;wBAC9D,iEAAiE;wBACjE,+DAA+D;wBAC/D,8DAA8D;wBAC9D,8DAA8D;wBAC9D,2DAA2D;wBAC3D,wDAAwD;wBACxD,6DAA6D;wBAC7D,6CAA6C;wBAC7C,2DAA2D;wBAC3D,oEAAoE;wBACpE,8DAA8D;wBAC9D,
|
|
1
|
+
{"version":3,"file":"share-send.js","sourceRoot":"","sources":["../../src/tools/share-send.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* "who has access" to a song, for an agent (ADR-346 part 5b): the same lines
|
|
3
|
+
* the song page's panel shows, through the same route
|
|
4
|
+
* (/api/admin/works/[id]/access), and the same remove.
|
|
5
|
+
*
|
|
6
|
+
* - pica_works_access_query: one line per organisation or invited address,
|
|
7
|
+
* side (writing, master and which recording, or both for an old share),
|
|
8
|
+
* and what they can do (view, or look after the master details).
|
|
9
|
+
* - pica_works_access_remove: ends one line — the master owner's edit
|
|
10
|
+
* relationship first, then every share behind it. Destructive: the
|
|
11
|
+
* confirmation token is required upstream (tier "destructive").
|
|
12
|
+
*/
|
|
13
|
+
import { PicaClient } from "@withpica/mcp-sdk";
|
|
14
|
+
import type { ToolDefinition, ToolExecutor } from "./index.js";
|
|
15
|
+
type Reason = "invite" | "claim" | "agreement" | "master_owner" | "shared";
|
|
16
|
+
interface Line {
|
|
17
|
+
key: string;
|
|
18
|
+
granteeOrgName: string | null;
|
|
19
|
+
/** This catalogue's person behind the line (V1.1); absent on older apps. */
|
|
20
|
+
personName?: string | null;
|
|
21
|
+
/** Why they have access (V1.1); absent on older apps. */
|
|
22
|
+
reasons?: Reason[];
|
|
23
|
+
pendingEmail: string | null;
|
|
24
|
+
side: "composition" | "master" | "both";
|
|
25
|
+
recordingTitle: string | null;
|
|
26
|
+
status: "active" | "pending";
|
|
27
|
+
canDo: "view" | "look_after_master";
|
|
28
|
+
widerArrangement: boolean;
|
|
29
|
+
}
|
|
30
|
+
/** Why they have access, in the panel's words (WhoHasAccess.tsx reasonLine). */
|
|
31
|
+
export declare function reasonWords(l: Line): string;
|
|
32
|
+
/** The panel's words for a line (WhoHasAccess.tsx who + sideLine), so both read alike. */
|
|
33
|
+
export declare function lineWords(l: Line): string;
|
|
34
|
+
export declare class SongAccessTools {
|
|
35
|
+
private pica;
|
|
36
|
+
constructor(pica: PicaClient);
|
|
37
|
+
getTools(): Array<{
|
|
38
|
+
definition: ToolDefinition;
|
|
39
|
+
executor: ToolExecutor;
|
|
40
|
+
}>;
|
|
41
|
+
private query;
|
|
42
|
+
private remove;
|
|
43
|
+
}
|
|
44
|
+
export {};
|
|
45
|
+
//# sourceMappingURL=song-access.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"song-access.d.ts","sourceRoot":"","sources":["../../src/tools/song-access.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAG3E,KAAK,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CAAC;AAE3E,UAAU,IAAI;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAmB3C;AAED,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAoBzC;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAiF3D,KAAK;YAkCL,MAAM;CA2BrB"}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
|
|
2
|
+
import { formatSuccess } from "@withpica/mcp-utils";
|
|
3
|
+
/** Why they have access, in the panel's words (WhoHasAccess.tsx reasonLine). */
|
|
4
|
+
export function reasonWords(l) {
|
|
5
|
+
return (l.reasons ?? [])
|
|
6
|
+
.map((r) => {
|
|
7
|
+
switch (r) {
|
|
8
|
+
case "master_owner":
|
|
9
|
+
return "you invited them as the master owner";
|
|
10
|
+
case "invite":
|
|
11
|
+
return l.status === "pending"
|
|
12
|
+
? "you invited them; they haven't accepted yet"
|
|
13
|
+
: "accepted your co-writer invite";
|
|
14
|
+
case "claim":
|
|
15
|
+
return "claimed their writer profile";
|
|
16
|
+
case "agreement":
|
|
17
|
+
return "signed a split sheet or agreement with you";
|
|
18
|
+
default:
|
|
19
|
+
return "you shared it with them";
|
|
20
|
+
}
|
|
21
|
+
})
|
|
22
|
+
.join(" · ");
|
|
23
|
+
}
|
|
24
|
+
/** The panel's words for a line (WhoHasAccess.tsx who + sideLine), so both read alike. */
|
|
25
|
+
export function lineWords(l) {
|
|
26
|
+
const account = l.granteeOrgName ?? l.pendingEmail ?? "someone who hasn't joined yet";
|
|
27
|
+
const who = l.personName ? `${l.personName} (${account})` : account;
|
|
28
|
+
const side = l.side === "both"
|
|
29
|
+
? "writing and master"
|
|
30
|
+
: l.side === "composition"
|
|
31
|
+
? "writing"
|
|
32
|
+
: l.recordingTitle
|
|
33
|
+
? `master · ${l.recordingTitle}`
|
|
34
|
+
: "master";
|
|
35
|
+
const can = l.canDo === "look_after_master"
|
|
36
|
+
? "can look after the master details"
|
|
37
|
+
: l.status === "pending"
|
|
38
|
+
? "can view once they accept"
|
|
39
|
+
: "can view";
|
|
40
|
+
const why = reasonWords(l);
|
|
41
|
+
return `${who} — ${side} · ${can}${why ? ` (${why})` : ""}`;
|
|
42
|
+
}
|
|
43
|
+
function failure(text) {
|
|
44
|
+
return { content: [{ type: "text", text }], isError: true };
|
|
45
|
+
}
|
|
46
|
+
export class SongAccessTools {
|
|
47
|
+
pica;
|
|
48
|
+
constructor(pica) {
|
|
49
|
+
this.pica = pica;
|
|
50
|
+
}
|
|
51
|
+
getTools() {
|
|
52
|
+
return [
|
|
53
|
+
{
|
|
54
|
+
definition: {
|
|
55
|
+
name: "pica_works_access_query",
|
|
56
|
+
scope: "read:catalog",
|
|
57
|
+
audiences: ["stdio", "http"],
|
|
58
|
+
tier: "read",
|
|
59
|
+
description: "Use when the user asks: 'who has access to this song?', 'who can see my song?', 'who did I share this with?'. " +
|
|
60
|
+
"Lists everyone outside your catalogue who can see one of your songs: one line per organisation or invited address (with the person in your catalogue behind it when known, and why they have access: co-writer invite, claimed profile, signed agreement, master owner, or shared), the side they see (writing; master and which recording; or both for an old share), and what they can do — view, or look after the master details. " +
|
|
61
|
+
"Pending lines are invitations not yet accepted. A line with wider_arrangement is part of a relationship covering other recordings too: change it from people & access, not with pica_works_access_remove. " +
|
|
62
|
+
"Only your own songs; another catalogue's song is not found. " +
|
|
63
|
+
"→ then: pica_works_access_remove (end a line, after the user confirms)",
|
|
64
|
+
workflows: "infrastructure",
|
|
65
|
+
vernacular_kind: "creator-entry",
|
|
66
|
+
inputSchema: {
|
|
67
|
+
type: "object",
|
|
68
|
+
properties: {
|
|
69
|
+
work_id: {
|
|
70
|
+
type: "string",
|
|
71
|
+
description: "UUID of one of your songs (works).",
|
|
72
|
+
},
|
|
73
|
+
},
|
|
74
|
+
required: ["work_id"],
|
|
75
|
+
},
|
|
76
|
+
nextSteps: [
|
|
77
|
+
{
|
|
78
|
+
tool: "pica_works_access_remove",
|
|
79
|
+
reason: "End one line's access, using its key, once the user confirms.",
|
|
80
|
+
when: "on_success",
|
|
81
|
+
},
|
|
82
|
+
],
|
|
83
|
+
},
|
|
84
|
+
executor: this.query.bind(this),
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
definition: {
|
|
88
|
+
name: "pica_works_access_remove",
|
|
89
|
+
scope: "write:catalog",
|
|
90
|
+
audiences: ["stdio", "http"],
|
|
91
|
+
tier: "destructive",
|
|
92
|
+
description: "End one line of access to one of your songs, by the key pica_works_access_query returned. " +
|
|
93
|
+
"Ends every share behind the line, and a master owner's edit too (edit first, so a failure never leaves edit without view). " +
|
|
94
|
+
"If still_shared comes back true, they can still see the song: tell the user and offer to try again (a retry touches only what is still live). " +
|
|
95
|
+
"If kept_reason is set, they still look after this master through a wider arrangement: point the user to people & access. " +
|
|
96
|
+
"Owners and admins only. Sends no email.",
|
|
97
|
+
workflows: "infrastructure",
|
|
98
|
+
vernacular_kind: "specialist",
|
|
99
|
+
vernacular_reason: "Destructive; invoked by exact name after the user confirms which line to end.",
|
|
100
|
+
inputSchema: {
|
|
101
|
+
type: "object",
|
|
102
|
+
properties: {
|
|
103
|
+
work_id: {
|
|
104
|
+
type: "string",
|
|
105
|
+
description: "UUID of the song.",
|
|
106
|
+
},
|
|
107
|
+
key: {
|
|
108
|
+
type: "string",
|
|
109
|
+
description: "The line's key, exactly as pica_works_access_query returned it.",
|
|
110
|
+
},
|
|
111
|
+
},
|
|
112
|
+
required: ["work_id", "key"],
|
|
113
|
+
},
|
|
114
|
+
nextSteps: [
|
|
115
|
+
{
|
|
116
|
+
tool: "pica_works_access_query",
|
|
117
|
+
reason: "Read the lines again to confirm what is left.",
|
|
118
|
+
when: "on_success",
|
|
119
|
+
},
|
|
120
|
+
],
|
|
121
|
+
},
|
|
122
|
+
executor: this.remove.bind(this),
|
|
123
|
+
},
|
|
124
|
+
];
|
|
125
|
+
}
|
|
126
|
+
async query(args) {
|
|
127
|
+
const workId = typeof args.work_id === "string" ? args.work_id : "";
|
|
128
|
+
if (!workId)
|
|
129
|
+
return failure("work_id is required.");
|
|
130
|
+
try {
|
|
131
|
+
const lines = (await this.pica.songAccess.list(workId));
|
|
132
|
+
const summary = lines.length === 0
|
|
133
|
+
? "Only your catalogue can see this song."
|
|
134
|
+
: `${lines.length} ${lines.length === 1 ? "line" : "lines"} of access:\n` +
|
|
135
|
+
lines.map((l) => `- ${lineWords(l)}`).join("\n");
|
|
136
|
+
return formatSuccess(summary, {
|
|
137
|
+
lines: lines.map((l) => ({
|
|
138
|
+
key: l.key,
|
|
139
|
+
who: l.granteeOrgName ?? l.pendingEmail,
|
|
140
|
+
person: l.personName ?? null,
|
|
141
|
+
reasons: l.reasons ?? [],
|
|
142
|
+
side: l.side,
|
|
143
|
+
recording_title: l.recordingTitle,
|
|
144
|
+
status: l.status,
|
|
145
|
+
can_do: l.canDo,
|
|
146
|
+
wider_arrangement: l.widerArrangement,
|
|
147
|
+
words: lineWords(l),
|
|
148
|
+
})),
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
catch (err) {
|
|
152
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
153
|
+
if (/404|not found/i.test(msg))
|
|
154
|
+
return failure("That song isn't in your catalogue, so its access can't be listed.");
|
|
155
|
+
return failure(`Couldn't read who has access: ${msg}`);
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
async remove(args) {
|
|
159
|
+
const workId = typeof args.work_id === "string" ? args.work_id : "";
|
|
160
|
+
const key = typeof args.key === "string" ? args.key : "";
|
|
161
|
+
if (!workId || !key)
|
|
162
|
+
return failure("work_id and key are required.");
|
|
163
|
+
try {
|
|
164
|
+
const r = await this.pica.songAccess.remove(workId, key);
|
|
165
|
+
const text = r.still_shared
|
|
166
|
+
? "Removal didn't finish: they can still see this song. Offer to try again."
|
|
167
|
+
: r.kept_reason
|
|
168
|
+
? "Removed their share of this song, but they still look after this master through a wider arrangement — change that on people & access."
|
|
169
|
+
: "Removed. They can no longer see this song.";
|
|
170
|
+
return formatSuccess(text, r);
|
|
171
|
+
}
|
|
172
|
+
catch (err) {
|
|
173
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
174
|
+
if (/ACCESS_NOT_REMOVED/.test(msg))
|
|
175
|
+
return failure("Access was not removed: they can still see this song. Try again.");
|
|
176
|
+
if (/403|restricted to owners and admins/i.test(msg))
|
|
177
|
+
return failure("Only the catalogue's owners and admins can remove access.");
|
|
178
|
+
if (/404|not found/i.test(msg))
|
|
179
|
+
return failure("That song isn't in your catalogue.");
|
|
180
|
+
return failure(`Couldn't remove access: ${msg}`);
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
//# sourceMappingURL=song-access.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"song-access.js","sourceRoot":"","sources":["../../src/tools/song-access.ts"],"names":[],"mappings":"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"}
|
package/dist/tools/users.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* ADR-237 — Opt-in public handles + user-authored bio + avatar.
|
|
3
3
|
*
|
|
4
|
-
* Surfaces
|
|
4
|
+
* Surfaces 6 tools backing the cross-org discovery model:
|
|
5
5
|
*
|
|
6
6
|
* Reads (scope: read:people):
|
|
7
7
|
* - pica_users_find_by_handle — exact-match lookup (privacy-preserving)
|
|
@@ -10,9 +10,12 @@
|
|
|
10
10
|
* Writes (scope: write:people):
|
|
11
11
|
* - pica_users_set_handle — claim handle (rate-limited)
|
|
12
12
|
* - pica_users_clear_handle — release handle
|
|
13
|
-
* - pica_users_set_bio — write
|
|
13
|
+
* - pica_users_set_bio — write your bio (your own person's
|
|
14
|
+
* biography), or settle a waiting choice
|
|
14
15
|
* - pica_users_set_avatar_url — write avatar URL
|
|
15
|
-
*
|
|
16
|
+
*
|
|
17
|
+
* pica_users_import_bio_from_person was retired with one bio per person
|
|
18
|
+
* (RETIRED_TOOLS in ./deprecations.ts).
|
|
16
19
|
*
|
|
17
20
|
* `pica_collaborators_invite` (ADR-236) is separately extended to
|
|
18
21
|
* accept `recipient: {kind: "handle"}` and resolves to email
|
|
@@ -33,6 +36,5 @@ export declare class UsersTools {
|
|
|
33
36
|
private getMyProfile;
|
|
34
37
|
private setBio;
|
|
35
38
|
private setAvatarUrl;
|
|
36
|
-
private importBioFromPerson;
|
|
37
39
|
}
|
|
38
40
|
//# sourceMappingURL=users.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AASA
|
|
1
|
+
{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAmK3D,YAAY;YAWZ,SAAS;YAiBT,WAAW;YAKX,YAAY;YAUZ,MAAM;YA6BN,YAAY;CAS3B"}
|
package/dist/tools/users.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
|
|
2
|
-
import { formatSuccess } from "@withpica/mcp-utils";
|
|
2
|
+
import { formatSuccess, formatValidationError } from "@withpica/mcp-utils";
|
|
3
3
|
export class UsersTools {
|
|
4
4
|
pica;
|
|
5
5
|
constructor(pica) {
|
|
@@ -86,7 +86,7 @@ export class UsersTools {
|
|
|
86
86
|
audiences: ["stdio", "http"],
|
|
87
87
|
tier: "read",
|
|
88
88
|
description: "Use when the user asks: 'show my profile', 'what's my PICA handle', 'what bio do I have'. " +
|
|
89
|
-
"Return the caller's full profile: workspace_email, full_name, public_handle, handle_accepts_invites, avatar_url, bio,
|
|
89
|
+
"Return the caller's full profile: workspace_email, full_name, public_handle, handle_accepts_invites, avatar_url, linked_person_id, and the bio. The bio is the biography on the caller's own person record (one bio per person): `bio` in full, `bio_short` (its opening, used where a short version is wanted), `bio_confirmed` (whether you wrote or confirmed it; only then is it shown outside your catalogue), `bio_choice` when an earlier bio is waiting for the caller to choose, and `set_aside_bios` (earlier bios kept after a choice). Caller's own profile only — to look up someone else use pica_users_find_by_handle.",
|
|
90
90
|
workflows: "infrastructure",
|
|
91
91
|
vernacular_kind: "specialist",
|
|
92
92
|
vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas.",
|
|
@@ -100,9 +100,10 @@ export class UsersTools {
|
|
|
100
100
|
scope: "write:people",
|
|
101
101
|
audiences: ["stdio", "http"],
|
|
102
102
|
tier: "write",
|
|
103
|
-
description: "Use when the user asks: 'set my bio to X', 'change my profile description', 'update my bio'. " +
|
|
104
|
-
"Write your bio
|
|
105
|
-
"
|
|
103
|
+
description: "Use when the user asks: 'set my bio to X', 'change my profile description', 'update my bio', 'keep my earlier bio'. " +
|
|
104
|
+
"Write your bio: the biography on your own person record. Saving it confirms it as yours, and only a bio you wrote or confirmed is shown outside your catalogue: read-only on records of you that you've claimed in other catalogues, and its opening on your public handle. Re-saving the same text confirms a bio someone else wrote on your record. Plain text; HTML is removed and paragraphs are kept. Empty string clears it. " +
|
|
105
|
+
'If pica_users_get_my_profile shows a `bio_choice`, settle it with `choose` instead of `bio`: "current" keeps the bio you have, "earlier" uses the earlier one. The text you don\'t keep is kept in set_aside_bios, never deleted. ' +
|
|
106
|
+
"Refused with NO_LINKED_PERSON when your account isn't linked to a person yet, and NOT_YOUR_PERSON_ANY_MORE when you've left the catalogue your person is in.",
|
|
106
107
|
workflows: "infrastructure",
|
|
107
108
|
vernacular_kind: "specialist",
|
|
108
109
|
vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas.",
|
|
@@ -111,10 +112,14 @@ export class UsersTools {
|
|
|
111
112
|
properties: {
|
|
112
113
|
bio: {
|
|
113
114
|
type: "string",
|
|
114
|
-
description: "Bio text. Pass empty string to clear.
|
|
115
|
+
description: "Bio text. Pass empty string to clear. Leave out when passing `choose`.",
|
|
116
|
+
},
|
|
117
|
+
choose: {
|
|
118
|
+
type: "string",
|
|
119
|
+
enum: ["current", "earlier"],
|
|
120
|
+
description: 'Settle a waiting bio_choice: "current" keeps your bio, "earlier" uses the earlier one. Leave out when passing `bio`.',
|
|
115
121
|
},
|
|
116
122
|
},
|
|
117
|
-
required: ["bio"],
|
|
118
123
|
},
|
|
119
124
|
},
|
|
120
125
|
executor: this.setBio.bind(this),
|
|
@@ -144,30 +149,6 @@ export class UsersTools {
|
|
|
144
149
|
},
|
|
145
150
|
executor: this.setAvatarUrl.bind(this),
|
|
146
151
|
},
|
|
147
|
-
{
|
|
148
|
-
definition: {
|
|
149
|
-
name: "pica_users_import_bio_from_person",
|
|
150
|
-
scope: "write:people",
|
|
151
|
-
audiences: ["stdio", "http"],
|
|
152
|
-
tier: "write",
|
|
153
|
-
description: "Use when the user asks: 'pull my bio from my Spotify artist page', 'import bio from my catalog person', 'use the biography I already have on file'. " +
|
|
154
|
-
"Copy the biography held on your linked catalog person into your own profile bio. Guarded by `overwrite` (default false): refuses if you already have a bio and surfaces both bios so you can confirm before re-calling with overwrite=true. Returns no_source_available if you have no linked person or an empty biography. " +
|
|
155
|
-
"To write bio text directly rather than copy it, use pica_users_set_bio.",
|
|
156
|
-
workflows: "infrastructure",
|
|
157
|
-
vernacular_kind: "specialist",
|
|
158
|
-
vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas.",
|
|
159
|
-
inputSchema: {
|
|
160
|
-
type: "object",
|
|
161
|
-
properties: {
|
|
162
|
-
overwrite: {
|
|
163
|
-
type: "boolean",
|
|
164
|
-
description: "Default false. Set true to overwrite an existing bio.",
|
|
165
|
-
},
|
|
166
|
-
},
|
|
167
|
-
},
|
|
168
|
-
},
|
|
169
|
-
executor: this.importBioFromPerson.bind(this),
|
|
170
|
-
},
|
|
171
152
|
];
|
|
172
153
|
}
|
|
173
154
|
async findByHandle(args) {
|
|
@@ -202,6 +183,22 @@ export class UsersTools {
|
|
|
202
183
|
: "You have not claimed a handle yet.", profile);
|
|
203
184
|
}
|
|
204
185
|
async setBio(args) {
|
|
186
|
+
if (args.choose !== undefined) {
|
|
187
|
+
if (args.bio !== undefined) {
|
|
188
|
+
return formatValidationError({
|
|
189
|
+
choose: "pass either bio or choose, not both",
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
const chosen = await this.pica.users.chooseBio(args.choose);
|
|
193
|
+
return formatSuccess(args.choose === "earlier"
|
|
194
|
+
? "Using your earlier bio. The one it replaced is kept in set_aside_bios."
|
|
195
|
+
: "Kept your bio. The earlier one is kept in set_aside_bios.", chosen);
|
|
196
|
+
}
|
|
197
|
+
if (typeof args.bio !== "string") {
|
|
198
|
+
return formatValidationError({
|
|
199
|
+
bio: "pass bio (a string; empty clears it) or choose",
|
|
200
|
+
});
|
|
201
|
+
}
|
|
205
202
|
const result = await this.pica.users.setBio(args.bio);
|
|
206
203
|
return formatSuccess(result.bio === null
|
|
207
204
|
? "Bio cleared."
|
|
@@ -213,11 +210,5 @@ export class UsersTools {
|
|
|
213
210
|
? "Avatar cleared."
|
|
214
211
|
: `Avatar updated to ${result.avatar_url}`, result);
|
|
215
212
|
}
|
|
216
|
-
async importBioFromPerson(args) {
|
|
217
|
-
const result = await this.pica.users.importBioFromPerson({
|
|
218
|
-
overwrite: args.overwrite === true,
|
|
219
|
-
});
|
|
220
|
-
return formatSuccess("Bio import completed.", result);
|
|
221
|
-
}
|
|
222
213
|
}
|
|
223
214
|
//# sourceMappingURL=users.js.map
|
package/dist/tools/users.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA,6DAA6D;
|
|
1
|
+
{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../src/tools/works.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAoCtE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkKzE,CAAC;AAyDF,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA0yBzE;;OAEG;YACW,UAAU;IA+LxB;;OAEG;IACH;;;;;OAKG;YACW,mBAAmB;IAmBjC;;;;;;;;;OASG;YACW,4BAA4B;YAmC5B,WAAW;
|
|
1
|
+
{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../src/tools/works.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAoCtE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkKzE,CAAC;AAyDF,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAa;gBAEb,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;IA0yBzE;;OAEG;YACW,UAAU;IA+LxB;;OAEG;IACH;;;;;OAKG;YACW,mBAAmB;IAmBjC;;;;;;;;;OASG;YACW,4BAA4B;YAmC5B,WAAW;IAgczB;;OAEG;YACW,UAAU;IAgHxB;;OAEG;YACW,UAAU;YA6DV,WAAW;YAqBX,WAAW;IAUzB;;OAEG;YACW,UAAU;IAKxB;;;;;;;;;;OAUG;YACW,UAAU;IAiBxB;;OAEG;YACW,eAAe;IAe7B;;OAEG;YACW,sBAAsB;IAqBpC;;;;OAIG;YACW,UAAU;YAsCV,mBAAmB;CA6DlC"}
|
package/dist/tools/works.js
CHANGED
|
@@ -503,7 +503,7 @@ export class WorksTools {
|
|
|
503
503
|
"dossier",
|
|
504
504
|
],
|
|
505
505
|
},
|
|
506
|
-
description: 'Which data sections to include. Omit for all sections. Use ["basic"] for lightweight lookup. "health" is a short summary of THIS work: whether it is complete — the four tests identified, owned, registered and findable, how many pass, each one\'s reason,
|
|
506
|
+
description: 'Which data sections to include. Omit for all sections. Use ["basic"] for lightweight lookup. "health" is a short summary of THIS work: whether it is complete — the four tests identified, owned, registered and findable, how many pass, each one\'s reason (or a passing test\'s note, e.g. findable "not released yet"), the next step, and song_suggestions (what applies to this song: its writers\' own society, "which society is <name> with?", "this looks released: update it?") — plus the weighted detail score, missing critical fields and suggestions; opt-in, since "completeness" carries the full breakdown (with the same four tests as song_complete); for works across the catalogue needing attention use pica_works_query health_filter. "licensing" surfaces the AI-disclosure / training-rights / provenance-attestation compliance fields (work_licensing satellite) in one scoped view. "dossier" assembles the full song dossier (recordings, releases, credits, people, provenance, AI disclosure, consent) — heavy, so it is opt-in only (never part of the default all-sections response); for the PDF, or several works in one ZIP, use pica_export_song_dossiers.',
|
|
507
507
|
},
|
|
508
508
|
},
|
|
509
509
|
required: [],
|
|
@@ -1387,6 +1387,10 @@ export class WorksTools {
|
|
|
1387
1387
|
tests_passed: song?.checked ? song.passed : null,
|
|
1388
1388
|
tests: song?.checked ? song.tests : null,
|
|
1389
1389
|
next_step: song?.checked ? song.nextStep : null,
|
|
1390
|
+
// ADR-344: what applies' own steps that are not the next step
|
|
1391
|
+
// ("which society is <name> with?", "register it with PRS",
|
|
1392
|
+
// "this looks released: update it?"); none blocks complete.
|
|
1393
|
+
song_suggestions: song?.checked ? (song.suggestions ?? []) : null,
|
|
1390
1394
|
detail_score: c?.score ?? null,
|
|
1391
1395
|
score: c?.score ?? null,
|
|
1392
1396
|
missing_field_count: c?.missing_field_count ?? null,
|