@withpica/mcp-server 2.95.2 → 2.95.4

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.
Files changed (206) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.intro.md +115 -0
  3. package/README.md +188 -204
  4. package/dist/lib/changelog.generated.d.ts +2 -2
  5. package/dist/lib/changelog.generated.d.ts.map +1 -1
  6. package/dist/lib/changelog.generated.js +2 -2
  7. package/dist/lib/changelog.generated.js.map +1 -1
  8. package/dist/prompts/index.js +4 -4
  9. package/dist/prompts/index.js.map +1 -1
  10. package/dist/resources/agent-guide.d.ts +50 -4
  11. package/dist/resources/agent-guide.d.ts.map +1 -1
  12. package/dist/resources/agent-guide.js +109 -18
  13. package/dist/resources/agent-guide.js.map +1 -1
  14. package/dist/resources/index.d.ts.map +1 -1
  15. package/dist/resources/index.js +81 -2
  16. package/dist/resources/index.js.map +1 -1
  17. package/dist/resources/llms-primer.d.ts +1 -1
  18. package/dist/resources/llms-primer.d.ts.map +1 -1
  19. package/dist/resources/llms-primer.js +1 -1
  20. package/dist/resources/required-schemas.generated.d.ts +24 -12
  21. package/dist/resources/required-schemas.generated.d.ts.map +1 -1
  22. package/dist/resources/required-schemas.generated.js +31 -18
  23. package/dist/resources/required-schemas.generated.js.map +1 -1
  24. package/dist/resources/required-schemas.source.d.ts.map +1 -1
  25. package/dist/resources/required-schemas.source.js +39 -15
  26. package/dist/resources/required-schemas.source.js.map +1 -1
  27. package/dist/server-instructions.d.ts +2 -2
  28. package/dist/server-instructions.d.ts.map +1 -1
  29. package/dist/server-instructions.js +5 -5
  30. package/dist/server-instructions.js.map +1 -1
  31. package/dist/skills/skills.generated.d.ts.map +1 -1
  32. package/dist/skills/skills.generated.js +23 -14
  33. package/dist/skills/skills.generated.js.map +1 -1
  34. package/dist/tools/agent-identity.d.ts.map +1 -1
  35. package/dist/tools/agent-identity.js +2 -1
  36. package/dist/tools/agent-identity.js.map +1 -1
  37. package/dist/tools/agreement-types.d.ts.map +1 -1
  38. package/dist/tools/agreement-types.js +23 -11
  39. package/dist/tools/agreement-types.js.map +1 -1
  40. package/dist/tools/agreements.d.ts.map +1 -1
  41. package/dist/tools/agreements.js +17 -9
  42. package/dist/tools/agreements.js.map +1 -1
  43. package/dist/tools/analytics.d.ts.map +1 -1
  44. package/dist/tools/analytics.js +6 -3
  45. package/dist/tools/analytics.js.map +1 -1
  46. package/dist/tools/assets.d.ts.map +1 -1
  47. package/dist/tools/assets.js +20 -13
  48. package/dist/tools/assets.js.map +1 -1
  49. package/dist/tools/audio-files.d.ts.map +1 -1
  50. package/dist/tools/audio-files.js +5 -3
  51. package/dist/tools/audio-files.js.map +1 -1
  52. package/dist/tools/bulk.d.ts.map +1 -1
  53. package/dist/tools/bulk.js +15 -9
  54. package/dist/tools/bulk.js.map +1 -1
  55. package/dist/tools/collaborators.d.ts.map +1 -1
  56. package/dist/tools/collaborators.js +41 -16
  57. package/dist/tools/collaborators.js.map +1 -1
  58. package/dist/tools/comparisons.d.ts.map +1 -1
  59. package/dist/tools/comparisons.js +2 -1
  60. package/dist/tools/comparisons.js.map +1 -1
  61. package/dist/tools/credits.d.ts +4 -3
  62. package/dist/tools/credits.d.ts.map +1 -1
  63. package/dist/tools/credits.js +16 -88
  64. package/dist/tools/credits.js.map +1 -1
  65. package/dist/tools/custody.d.ts.map +1 -1
  66. package/dist/tools/custody.js +43 -10
  67. package/dist/tools/custody.js.map +1 -1
  68. package/dist/tools/dashboard.d.ts.map +1 -1
  69. package/dist/tools/dashboard.js +38 -19
  70. package/dist/tools/dashboard.js.map +1 -1
  71. package/dist/tools/deprecations.d.ts +12 -2
  72. package/dist/tools/deprecations.d.ts.map +1 -1
  73. package/dist/tools/deprecations.js +22 -12
  74. package/dist/tools/deprecations.js.map +1 -1
  75. package/dist/tools/directory.d.ts.map +1 -1
  76. package/dist/tools/directory.js +7 -4
  77. package/dist/tools/directory.js.map +1 -1
  78. package/dist/tools/discovery.d.ts +66 -10
  79. package/dist/tools/discovery.d.ts.map +1 -1
  80. package/dist/tools/discovery.js +221 -25
  81. package/dist/tools/discovery.js.map +1 -1
  82. package/dist/tools/disputes.d.ts.map +1 -1
  83. package/dist/tools/disputes.js +3 -0
  84. package/dist/tools/disputes.js.map +1 -1
  85. package/dist/tools/documents.d.ts.map +1 -1
  86. package/dist/tools/documents.js +9 -6
  87. package/dist/tools/documents.js.map +1 -1
  88. package/dist/tools/enrichment.d.ts +14 -0
  89. package/dist/tools/enrichment.d.ts.map +1 -1
  90. package/dist/tools/enrichment.js +217 -16
  91. package/dist/tools/enrichment.js.map +1 -1
  92. package/dist/tools/error-envelope.d.ts +44 -0
  93. package/dist/tools/error-envelope.d.ts.map +1 -0
  94. package/dist/tools/error-envelope.js +17 -0
  95. package/dist/tools/error-envelope.js.map +1 -0
  96. package/dist/tools/exports.d.ts +4 -0
  97. package/dist/tools/exports.d.ts.map +1 -1
  98. package/dist/tools/exports.js +158 -6
  99. package/dist/tools/exports.js.map +1 -1
  100. package/dist/tools/groups.d.ts.map +1 -1
  101. package/dist/tools/groups.js +1 -0
  102. package/dist/tools/groups.js.map +1 -1
  103. package/dist/tools/import-documents.d.ts.map +1 -1
  104. package/dist/tools/import-documents.js +3 -2
  105. package/dist/tools/import-documents.js.map +1 -1
  106. package/dist/tools/import.d.ts.map +1 -1
  107. package/dist/tools/import.js +71 -38
  108. package/dist/tools/import.js.map +1 -1
  109. package/dist/tools/index.d.ts +53 -4
  110. package/dist/tools/index.d.ts.map +1 -1
  111. package/dist/tools/index.js +166 -38
  112. package/dist/tools/index.js.map +1 -1
  113. package/dist/tools/licensing.d.ts.map +1 -1
  114. package/dist/tools/licensing.js +6 -2
  115. package/dist/tools/licensing.js.map +1 -1
  116. package/dist/tools/memory.d.ts.map +1 -1
  117. package/dist/tools/memory.js +8 -4
  118. package/dist/tools/memory.js.map +1 -1
  119. package/dist/tools/metadata.d.ts +7 -1
  120. package/dist/tools/metadata.d.ts.map +1 -1
  121. package/dist/tools/metadata.js +65 -2
  122. package/dist/tools/metadata.js.map +1 -1
  123. package/dist/tools/multimedia.d.ts.map +1 -1
  124. package/dist/tools/multimedia.js +7 -3
  125. package/dist/tools/multimedia.js.map +1 -1
  126. package/dist/tools/notes.d.ts.map +1 -1
  127. package/dist/tools/notes.js +9 -6
  128. package/dist/tools/notes.js.map +1 -1
  129. package/dist/tools/notifications.d.ts.map +1 -1
  130. package/dist/tools/notifications.js +16 -27
  131. package/dist/tools/notifications.js.map +1 -1
  132. package/dist/tools/people.d.ts.map +1 -1
  133. package/dist/tools/people.js +8 -5
  134. package/dist/tools/people.js.map +1 -1
  135. package/dist/tools/projects.d.ts.map +1 -1
  136. package/dist/tools/projects.js +16 -12
  137. package/dist/tools/projects.js.map +1 -1
  138. package/dist/tools/recording-custody.d.ts.map +1 -1
  139. package/dist/tools/recording-custody.js +9 -5
  140. package/dist/tools/recording-custody.js.map +1 -1
  141. package/dist/tools/recording-samples.d.ts.map +1 -1
  142. package/dist/tools/recording-samples.js +25 -6
  143. package/dist/tools/recording-samples.js.map +1 -1
  144. package/dist/tools/recordings.d.ts +10 -0
  145. package/dist/tools/recordings.d.ts.map +1 -1
  146. package/dist/tools/recordings.js +32 -19
  147. package/dist/tools/recordings.js.map +1 -1
  148. package/dist/tools/recovery-hints.d.ts.map +1 -1
  149. package/dist/tools/recovery-hints.js +58 -17
  150. package/dist/tools/recovery-hints.js.map +1 -1
  151. package/dist/tools/release-rich.js +5 -5
  152. package/dist/tools/release-rich.js.map +1 -1
  153. package/dist/tools/releases.d.ts.map +1 -1
  154. package/dist/tools/releases.js +21 -12
  155. package/dist/tools/releases.js.map +1 -1
  156. package/dist/tools/royalties.d.ts.map +1 -1
  157. package/dist/tools/royalties.js +12 -6
  158. package/dist/tools/royalties.js.map +1 -1
  159. package/dist/tools/send.d.ts.map +1 -1
  160. package/dist/tools/send.js +7 -4
  161. package/dist/tools/send.js.map +1 -1
  162. package/dist/tools/sessions.d.ts.map +1 -1
  163. package/dist/tools/sessions.js +8 -4
  164. package/dist/tools/sessions.js.map +1 -1
  165. package/dist/tools/settings.d.ts.map +1 -1
  166. package/dist/tools/settings.js +10 -4
  167. package/dist/tools/settings.js.map +1 -1
  168. package/dist/tools/share-links.d.ts.map +1 -1
  169. package/dist/tools/share-links.js +7 -3
  170. package/dist/tools/share-links.js.map +1 -1
  171. package/dist/tools/share-send.d.ts.map +1 -1
  172. package/dist/tools/share-send.js +15 -5
  173. package/dist/tools/share-send.js.map +1 -1
  174. package/dist/tools/shows.d.ts +31 -0
  175. package/dist/tools/shows.d.ts.map +1 -0
  176. package/dist/tools/shows.js +307 -0
  177. package/dist/tools/shows.js.map +1 -0
  178. package/dist/tools/skills.d.ts.map +1 -1
  179. package/dist/tools/skills.js +7 -0
  180. package/dist/tools/skills.js.map +1 -1
  181. package/dist/tools/split-sheets.d.ts.map +1 -1
  182. package/dist/tools/split-sheets.js +19 -12
  183. package/dist/tools/split-sheets.js.map +1 -1
  184. package/dist/tools/statements.js +2 -2
  185. package/dist/tools/statements.js.map +1 -1
  186. package/dist/tools/storage-config.d.ts.map +1 -1
  187. package/dist/tools/storage-config.js +5 -3
  188. package/dist/tools/storage-config.js.map +1 -1
  189. package/dist/tools/subscription.d.ts +69 -19
  190. package/dist/tools/subscription.d.ts.map +1 -1
  191. package/dist/tools/subscription.js +98 -255
  192. package/dist/tools/subscription.js.map +1 -1
  193. package/dist/tools/sync-placements.d.ts.map +1 -1
  194. package/dist/tools/sync-placements.js +10 -5
  195. package/dist/tools/sync-placements.js.map +1 -1
  196. package/dist/tools/telegram.d.ts.map +1 -1
  197. package/dist/tools/telegram.js +16 -24
  198. package/dist/tools/telegram.js.map +1 -1
  199. package/dist/tools/users.d.ts.map +1 -1
  200. package/dist/tools/users.js +12 -6
  201. package/dist/tools/users.js.map +1 -1
  202. package/dist/tools/works.d.ts.map +1 -1
  203. package/dist/tools/works.js +13 -10
  204. package/dist/tools/works.js.map +1 -1
  205. package/package.json +7 -3
  206. package/server.json +2 -2
@@ -15,5 +15,9 @@ export declare class ExportTools {
15
15
  private exportIndustryReady;
16
16
  private exportCatalogAssetReport;
17
17
  private exportAiConsent;
18
+ private exportOwnershipRecord;
19
+ private exportRightsProof;
20
+ private exportDiligencePack;
21
+ private exportSnapshot;
18
22
  }
19
23
  //# sourceMappingURL=exports.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAQtE,qBAAa,WAAW;IACtB,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;YAqO3D,gBAAgB;YA4BhB,sBAAsB;YAqCtB,mBAAmB;YAqBnB,wBAAwB;YAkDxB,eAAe;CAY9B"}
1
+ {"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAQtE,qBAAa,WAAW;IACtB,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;YA4X3D,gBAAgB;YA4BhB,sBAAsB;YAqCtB,mBAAmB;YAqBnB,wBAAwB;YAkDxB,eAAe;YAYf,qBAAqB;YASrB,iBAAiB;YASjB,mBAAmB;YASnB,cAAc;CA6B7B"}
@@ -23,7 +23,13 @@ export class ExportTools {
23
23
  "Pass exactly one of `work_id` (single export — required for `sync-pdf`) or `work_ids` (bulk export, comma-separated UUIDs — not supported for `sync-pdf`). " +
24
24
  "For `pro`/`distributor`/`nro`, returns the generated CSV as inline text ({format, csv}) — there is no download URL, so present it directly " +
25
25
  "(e.g. as a code block) or write it to a file; `pica_download` needs a presigned URL and does not apply here. " +
26
- "`sync-pdf` returns structured one-sheet data instead. Direct the user to https://withpica.com/inspect for the full export UI.",
26
+ "`sync-pdf` returns structured one-sheet DATA the rendered one-page PDF exists but is a browser download at " +
27
+ "`/api/admin/works/export?format=sync-pdf&as=pdf&workId=<id>`, which streams raw PDF bytes this transport cannot carry; " +
28
+ "hand the user that URL, or direct them to https://withpica.com/inspect. Do NOT pass `as` to this tool — it is not an input here. " +
29
+ "Direct the user to https://withpica.com/inspect for the full export UI. " +
30
+ "For a registration submission the user hands to a PRO/CMO — a ZIP with writer " +
31
+ "and writer-summary CSVs plus a CWR field mapping guide — use " +
32
+ "pica_export_song_registration instead; this tool returns one flat CSV.",
27
33
  workflows: ["export-required"],
28
34
  vernacular_kind: "creator-entry",
29
35
  inputSchema: {
@@ -61,12 +67,17 @@ export class ExportTools {
61
67
  scope: "write:catalog",
62
68
  audiences: ["stdio", "http", "public"],
63
69
  tier: "write",
64
- description: "Export works in song registration format (CWR-compatible) for PRO/CMO registration. " +
70
+ description: "Export works in song registration format for PRO/CMO registration. " +
71
+ "This is NOT a CWR file — the ZIP holds CSVs (works, writers, writer summary), JSON, a PDF summary " +
72
+ "and `mapping-guide.md`, which maps the CSV columns onto CWR fields for whoever does the submission. " +
73
+ "PICA has no CWR emitter; never tell the user you produced a CWR file. " +
65
74
  "Returns a signed-URL JSON envelope ({ download_url, expires_at, file_size_bytes }) pointing to the generated ZIP. " +
66
75
  "Filter by ISWC status: pass iswc_status='missing' to export only works that still need an ISWC " +
67
76
  "(the registration-priority bucket), 'present' for works that already have one, or 'all' (default) " +
68
77
  "for the entire catalog. " +
69
- "Pass work_ids to scope to a specific set of works (UUIDs); omit for the full catalog.",
78
+ "Pass work_ids to scope to a specific set of works (UUIDs); omit for the full catalog. " +
79
+ "For a single flat CSV in a named destination format (pro / distributor / nro) " +
80
+ "rather than this multi-file bundle, use pica_export_catalog_csv instead.",
70
81
  workflows: ["export-required"],
71
82
  vernacular_kind: "specialist",
72
83
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -98,7 +109,10 @@ export class ExportTools {
98
109
  "Export industry-ready metadata package — formatted for distribution to publishers, labels, and sync agents. " +
99
110
  "Returns a signed-URL JSON envelope ({ download_url, expires_at, file_size_bytes }) pointing to the generated ZIP. " +
100
111
  "Set inline:true to instead receive the structured export DATA inline (no S3 URL) — use this when running in a sandbox whose allowlist can't reach the S3 download host. " +
101
- "Pass work_ids to scope to a specific set of works (UUIDs); omit for the full catalog.",
112
+ "Pass work_ids to scope to a specific set of works (UUIDs); omit for the full catalog. " +
113
+ "This is the general-purpose hand-off bundle; when the destination is specifically " +
114
+ "a PRO/CMO registration, prefer pica_export_song_registration, which adds the " +
115
+ "writer-summary CSV and CWR field mapping a registrar needs.",
102
116
  workflows: ["export-required"],
103
117
  vernacular_kind: "creator-entry",
104
118
  inputSchema: {
@@ -125,7 +139,10 @@ export class ExportTools {
125
139
  audiences: ["stdio", "http", "public"],
126
140
  tier: "write",
127
141
  description: "Generate a Catalog Asset Report (CAR) — a unified ZIP bundle with cover PDF, evidence folders, and integrity manifest. Maps creative portfolio data to property-lending equivalents for financial institutions, insurers, PROs, and distributors. Sections include: ownership (title deed equivalent), valuation (surveyor's report), physical assets (contents schedule), agreements (mortgage deed), catalog intelligence (condition report), and summary with equivalence map. " +
128
- "work_ids note: ownership/valuation/agreements sections honour work_ids; assets/intelligence/placements sections remain organisation-wide (their underlying service methods are not yet scope-aware — tracked as a follow-up).",
142
+ "work_ids note: ownership/valuation/agreements sections honour work_ids; assets/intelligence/placements sections remain organisation-wide (their underlying service methods are not yet scope-aware — tracked as a follow-up). " +
143
+ "This is the document for an external reader (lender, insurer, buyer). When the " +
144
+ "reader is the catalogue owner deciding what to fix next, use pica_export_snapshot " +
145
+ "instead — same underlying data, ranked as a to-do list.",
129
146
  workflows: ["export-required"],
130
147
  vernacular_kind: "specialist",
131
148
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -168,6 +185,111 @@ export class ExportTools {
168
185
  },
169
186
  executor: withBillingGate(this.pica, "catalog asset report", this.exportCatalogAssetReport.bind(this)),
170
187
  },
188
+ {
189
+ definition: {
190
+ name: "pica_export_snapshot",
191
+ scope: "write:catalog",
192
+ audiences: ["stdio", "http", "public"],
193
+ tier: "write",
194
+ description: "Use when the user asks: 'give me a snapshot of my catalogue', 'what shape is my catalogue in', 'what should I fix next', 'export everything about this work'. " +
195
+ "Export the catalogue snapshot: PICA score with per-pillar detail, financial summary, ownership coverage, gaps ranked by severity each with a suggested action, physical assets, production-asset provenance (the equipment a recording was made on), and a prioritised what-to-do-next list. " +
196
+ "Scope it with scope='work' plus a single work_id for a deep dive on one work, 'selected' with several work_ids, or 'everything' (default) for the whole catalogue. " +
197
+ "For a diligence document aimed at a lender or buyer, use pica_export_catalog_asset_report instead — this one is aimed at the catalogue owner deciding what to fix.",
198
+ workflows: ["export-required"],
199
+ vernacular_kind: "creator-entry",
200
+ inputSchema: {
201
+ type: "object",
202
+ properties: {
203
+ scope: {
204
+ type: "string",
205
+ enum: ["everything", "selected", "work"],
206
+ description: "everything = whole catalogue (default); selected = the given work_ids; work = exactly one work_id, a deep dive.",
207
+ },
208
+ work_ids: {
209
+ type: "array",
210
+ items: { type: "string" },
211
+ description: "Work UUIDs. Required for 'work' (exactly one) and 'selected' (one or more); ignored for 'everything'.",
212
+ },
213
+ },
214
+ },
215
+ },
216
+ executor: withBillingGate(this.pica, "catalogue snapshot export", this.exportSnapshot.bind(this)),
217
+ },
218
+ {
219
+ definition: {
220
+ name: "pica_export_ownership_record",
221
+ scope: "write:catalog",
222
+ audiences: ["stdio", "http", "public"],
223
+ tier: "write",
224
+ description: "Use when the user asks: 'who owns this catalogue?', 'send my lawyer the ownership record', 'prove who owns what'. " +
225
+ "Export the ownership record — a per-contributor and per-asset register of who owns what, with claim status, share percentages and the definitions a lawyer needs to read it (claim workflow, dispute resolution, what each status means). This is the REGISTER; pica_export_rights_proof is the EVIDENCE behind it. Both exist because they answer different questions for different readers. " +
226
+ "Returns a signed-URL JSON envelope ({ download_url, expires_at, file_size_bytes }) pointing to the generated ZIP. " +
227
+ "Pass inline=true to receive the structured data instead, for a sandboxed agent that cannot fetch a signed S3 URL.",
228
+ workflows: ["export-required"],
229
+ vernacular_kind: "specialist",
230
+ vernacular_reason: "Diligence documents are specialist context; added 2026-07-30 (ADR-303) to close a UI/MCP parity gap, not from telemetry.",
231
+ inputSchema: {
232
+ type: "object",
233
+ properties: {
234
+ inline: {
235
+ type: "boolean",
236
+ description: "Return the structured export data inline instead of a signed download URL. Use when you cannot fetch an S3 URL.",
237
+ },
238
+ },
239
+ },
240
+ },
241
+ executor: withBillingGate(this.pica, "ownership record export", this.exportOwnershipRecord.bind(this)),
242
+ },
243
+ {
244
+ definition: {
245
+ name: "pica_export_rights_proof",
246
+ scope: "write:catalog",
247
+ audiences: ["stdio", "http", "public"],
248
+ tier: "write",
249
+ description: "Use when the user asks: 'prove the chain of title', 'what evidence do we have', 'send the proof bundle to the buyer'. " +
250
+ "Export the rights proof bundle — timestamped ownership claims, contributor attestations, identity verification and evidence-integrity hashes. This is the EVIDENCE; pica_export_ownership_record is the register it supports. Use this when someone has asked you to prove ownership rather than state it. " +
251
+ "Returns a signed-URL JSON envelope ({ download_url, expires_at, file_size_bytes }) pointing to the generated ZIP. " +
252
+ "Pass inline=true to receive the structured data instead, for a sandboxed agent that cannot fetch a signed S3 URL.",
253
+ workflows: ["export-required"],
254
+ vernacular_kind: "specialist",
255
+ vernacular_reason: "Diligence documents are specialist context; added 2026-07-30 (ADR-303) to close a UI/MCP parity gap, not from telemetry.",
256
+ inputSchema: {
257
+ type: "object",
258
+ properties: {
259
+ inline: {
260
+ type: "boolean",
261
+ description: "Return the structured export data inline instead of a signed download URL. Use when you cannot fetch an S3 URL.",
262
+ },
263
+ },
264
+ },
265
+ },
266
+ executor: withBillingGate(this.pica, "rights proof export", this.exportRightsProof.bind(this)),
267
+ },
268
+ {
269
+ definition: {
270
+ name: "pica_export_diligence_pack",
271
+ scope: "write:catalog",
272
+ audiences: ["stdio", "http", "public"],
273
+ tier: "write",
274
+ description: "Use when the user asks: 'send me the diligence pack', 'what is missing before I register', 'prepare for a catalogue sale'. " +
275
+ "Export the catalogue diligence pack as a document — readiness scoring, ownership clarity, identifier completeness, uninsured insurable assets, and gaps ranked by severity with a suggested action for each. For the ANSWER rather than the document, call pica_catalog_diligence, which returns the same analysis as JSON and is cheaper; for a lender's asset report, use pica_export_catalog_asset_report. " +
276
+ "Returns a signed-URL JSON envelope for the generated ZIP. " +
277
+ "Pass inline=true for the structured data instead, when a sandboxed agent cannot fetch a signed S3 URL.",
278
+ workflows: ["export-required"],
279
+ vernacular_kind: "specialist",
280
+ vernacular_reason: "Diligence documents are specialist context; added 2026-07-30 (ADR-303) to close a UI/MCP parity gap, not from telemetry.",
281
+ inputSchema: {
282
+ type: "object",
283
+ properties: {
284
+ inline: {
285
+ type: "boolean",
286
+ description: "Return the structured export data inline instead of a signed download URL. Use when you cannot fetch an S3 URL.",
287
+ },
288
+ },
289
+ },
290
+ },
291
+ executor: withBillingGate(this.pica, "diligence pack export", this.exportDiligencePack.bind(this)),
292
+ },
171
293
  {
172
294
  definition: {
173
295
  name: "pica_export_ai_consent",
@@ -183,7 +305,8 @@ export class ExportTools {
183
305
  "cleared level and permitted uses, and the full grant/revoke history, bundled as a " +
184
306
  "downloadable ZIP with CSVs and a PDF summary. " +
185
307
  "Pass work_ids to scope the works listing to a specific set of works (UUIDs); omit for the full catalog. " +
186
- "work_ids note: scopes the works listing but contributor and consent-history rollups remain organisation-wide (downstream recordings + performers queries are not yet scope-aware — tracked as a follow-up).",
308
+ "work_ids note: scopes the works listing but contributor and consent-history rollups remain organisation-wide. " +
309
+ "For the account holder's own personal data export, use pica_export_my_data.",
187
310
  workflows: ["export-required"],
188
311
  vernacular_kind: "creator-entry",
189
312
  inputSchema: {
@@ -310,5 +433,34 @@ export class ExportTools {
310
433
  const result = await this.pica.exports.aiConsent(workIds && workIds.length > 0 ? { work_ids: workIds } : undefined);
311
434
  return formatSuccess("AI consent declarations exported — shows disclosure level and training rights per work", result);
312
435
  }
436
+ async exportOwnershipRecord(args) {
437
+ const result = await this.pica.exports.ownershipRecord(args?.inline === true ? { inline: true } : undefined);
438
+ return formatSuccess("ownership record generated", result?.data ?? result);
439
+ }
440
+ async exportRightsProof(args) {
441
+ const result = await this.pica.exports.rightsProof(args?.inline === true ? { inline: true } : undefined);
442
+ return formatSuccess("rights proof generated", result?.data ?? result);
443
+ }
444
+ async exportDiligencePack(args) {
445
+ const result = await this.pica.exports.diligencePack(args?.inline === true ? { inline: true } : undefined);
446
+ return formatSuccess("diligence pack generated", result?.data ?? result);
447
+ }
448
+ async exportSnapshot(args) {
449
+ const scope = (args?.scope ?? "everything");
450
+ const workIds = args?.work_ids;
451
+ // The route validates this too, but a 400 reaches the agent as an opaque
452
+ // failure; saying it here makes the retry obvious.
453
+ if (scope === "work" && workIds?.length !== 1) {
454
+ return formatSuccess("scope='work' needs exactly one work_id. Pass one, or use scope='selected' for several.", { error: "INVALID_SCOPE" });
455
+ }
456
+ if (scope === "selected" && !workIds?.length) {
457
+ return formatSuccess("scope='selected' needs at least one work_id. Pass some, or use scope='everything'.", { error: "INVALID_SCOPE" });
458
+ }
459
+ const result = await this.pica.exports.picaSnapshot({
460
+ scope,
461
+ ...(workIds?.length ? { work_ids: workIds } : {}),
462
+ });
463
+ return formatSuccess("catalogue snapshot generated", result?.data ?? result);
464
+ }
313
465
  }
314
466
  //# sourceMappingURL=exports.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/tools/exports.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/tools/groups.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAiBtE,qBAAa,WAAW;IACtB,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;YAyK3D,SAAS;YAmBT,YAAY;YAcZ,WAAW;YAWX,UAAU;CASzB"}
1
+ {"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/tools/groups.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAiBtE,qBAAa,WAAW;IACtB,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;YA0K3D,SAAS;YAmBT,YAAY;YAcZ,WAAW;YAWX,UAAU;CASzB"}
@@ -106,6 +106,7 @@ export class GroupsTools {
106
106
  audiences: ["stdio", "http"],
107
107
  tier: "read",
108
108
  description: "List members of a group person. Active members only by default; pass include_inactive=true for history. " +
109
+ "To change the roster use pica_group_add_member or pica_group_remove_member; this only reads it. " +
109
110
  "→ then: pica_people_inspect (get details for a specific member)",
110
111
  workflows: "infrastructure",
111
112
  vernacular_kind: "specialist",
@@ -1 +1 @@
1
- {"version":3,"file":"groups.js","sourceRoot":"","sources":["../../src/tools/groups.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"groups.js","sourceRoot":"","sources":["../../src/tools/groups.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"import-documents.d.ts","sourceRoot":"","sources":["../../src/tools/import-documents.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,mBAAmB;IAC9B,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;YAmH3D,oBAAoB;YAOpB,qBAAqB;YA+DrB,eAAe;IAgB7B,OAAO,CAAC,WAAW;CAyDpB"}
1
+ {"version":3,"file":"import-documents.d.ts","sourceRoot":"","sources":["../../src/tools/import-documents.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,mBAAmB;IAC9B,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;YAoH3D,oBAAoB;YAOpB,qBAAqB;YA+DrB,eAAe;IAgB7B,OAAO,CAAC,WAAW;CAyDpB"}
@@ -52,7 +52,8 @@ export class ImportDocumentTools {
52
52
  tier: "read",
53
53
  description: "Inspect a specific import document. By default returns the full canonical document " +
54
54
  "(summary, identity extractions, line items, field mapping, warnings). " +
55
- "Include 'diff' in sections to compare with a second document.",
55
+ "Include 'diff' in sections to compare with a second document. " +
56
+ "To find or filter documents, use pica_import_documents_query; this one returns one in full.",
56
57
  workflows: "infrastructure",
57
58
  vernacular_kind: "specialist",
58
59
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -91,7 +92,7 @@ export class ImportDocumentTools {
91
92
  "Ingest a royalty or distribution statement that is ALREADY a CSV, or raw text/table data the " +
92
93
  "agent has converted to canonical Markdown with YAML frontmatter containing: source, period, " +
93
94
  "currency, type (line items as a Markdown table). " +
94
- "For an uploaded PDF/image/xlsx statement file, use pica_statements_pending → pica_documents_read → " +
95
+ "For an uploaded PDF/image/xlsx statement file, use pica_statements_pending → pica_documents_inspect → " +
95
96
  "pica_statement_ingest_document instead — that path extracts the lines and requires owner approval " +
96
97
  "before writing (a wrong royalty number is worse than no number).",
97
98
  workflows: "infrastructure",
@@ -1 +1 @@
1
- {"version":3,"file":"import-documents.js","sourceRoot":"","sources":["../../src/tools/import-documents.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"import-documents.js","sourceRoot":"","sources":["../../src/tools/import-documents.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/tools/import.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAkBtE,qBAAa,WAAW;IACtB,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;YAwY3D,aAAa;YAwCb,cAAc;YAwCd,aAAa;YA6Cb,eAAe;YAUf,iBAAiB;YAUjB,mBAAmB;YA0KnB,iBAAiB;CA8GhC"}
1
+ {"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/tools/import.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAmBtE,qBAAa,WAAW;IACtB,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;YA2Z3D,aAAa;YAqCb,cAAc;YAwCd,aAAa;YAoFb,eAAe;YAUf,iBAAiB;YAUjB,mBAAmB;YAqKnB,iBAAiB;CAyGhC"}
@@ -1,4 +1,5 @@
1
1
  // Copyright (c) 2025-2026 Withpica Ltd. All rights reserved.
2
+ import { typedError } from "./error-envelope.js";
2
3
  import { formatSuccess, formatAsText, mapGapsToHints, } from "@withpica/mcp-utils";
3
4
  import { buildIntegrityPressure } from "./integrity-hints.js";
4
5
  const VALID_DOMAINS = [
@@ -127,7 +128,10 @@ export class ImportTools {
127
128
  "Pass EITHER `file_content` (raw CSV string) OR `file_id` (from pica_upload_complete). " +
128
129
  "Always run pica_import_validate first to check for errors. " +
129
130
  "Use dry_run: true to preview what would be imported without actually creating records. " +
130
- "Max 10,000 rows per import.",
131
+ "A call runs synchronously under a ~2 minute budget, so the server imports at most row_limit rows per call " +
132
+ "(default 2,000) and returns rowRange.nextOffset when the file has more rows: call again with " +
133
+ "row_offset = nextOffset, and stop when it is null. For a file over ~2,000 rows, upload it once with " +
134
+ "pica_upload_file → pica_upload_complete and pass file_id, so the CSV is not re-sent on every call.",
131
135
  workflows: "infrastructure",
132
136
  vernacular_kind: "specialist",
133
137
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -181,14 +185,27 @@ export class ImportTools {
181
185
  conflict_strategy: {
182
186
  type: "string",
183
187
  enum: ["error", "skip"],
184
- description: "How to handle DB unique-constraint collisions (e.g. duplicate tunecode/iswc). " +
185
- "'error' (default): a single duplicate fails the whole batch. " +
186
- "'skip': fall back to per-row insert; duplicates become warnings, the rest still land.",
188
+ description: "How to handle DB unique-constraint collisions (e.g. duplicate tunecode/iswc, or two rows with the same title and artist). " +
189
+ "'skip' (default): fall back to per-row insert; the duplicate row becomes a warning, every other row in the batch still lands. " +
190
+ "'error': a single duplicate fails the whole batch opt in only if you need all-or-nothing per batch.",
187
191
  },
188
192
  batch_size: {
189
193
  type: "number",
190
194
  description: "Number of rows to process per batch (default: 50, max: 1000)",
191
195
  },
196
+ row_offset: {
197
+ type: "integer",
198
+ minimum: 0,
199
+ description: "Continuation cursor: index of the first data row to import (0-based, default 0). " +
200
+ "Pass the rowRange.nextOffset from the previous reply to continue a large file.",
201
+ },
202
+ row_limit: {
203
+ type: "integer",
204
+ minimum: 1,
205
+ maximum: 10000,
206
+ description: "Rows to import in this call (default 2,000). Keep it at the default unless the rows are trivially cheap; " +
207
+ "a call the budget ends commits what it wrote and reports nothing.",
208
+ },
192
209
  },
193
210
  required: ["domain", "mapping"],
194
211
  },
@@ -202,7 +219,8 @@ export class ImportTools {
202
219
  audiences: ["stdio", "http", "public"],
203
220
  tier: "read",
204
221
  description: "Get the available target fields for an import domain. Returns field names, labels, types, " +
205
- "and whether they are required. Useful for understanding what columns a CSV should have.",
222
+ "and whether they are required. Useful for understanding what columns a CSV should have. " +
223
+ "For a ready-made example CSV instead, use pica_import_template.",
206
224
  workflows: "infrastructure",
207
225
  vernacular_kind: "specialist",
208
226
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -227,7 +245,8 @@ export class ImportTools {
227
245
  audiences: ["stdio", "http", "public"],
228
246
  tier: "read",
229
247
  description: "Get an example CSV template for an import domain. Returns a CSV string with headers " +
230
- "and example rows that can be used as a starting point.",
248
+ "and example rows that can be used as a starting point. " +
249
+ "For the field list — names, types, and which are required — use pica_import_fields.",
231
250
  workflows: "infrastructure",
232
251
  vernacular_kind: "specialist",
233
252
  vernacular_reason: "Specialist context; not yet covered by the Creator Question Atlas — pending telemetry-driven addition per ADR-226 Phase 4 substrate writes.",
@@ -253,11 +272,10 @@ export class ImportTools {
253
272
  tier: "write",
254
273
  description: "Import works from a Spotify or Deezer URL — extracts each track's metadata (including its ISRC) and saves it to your catalog. " +
255
274
  "Use when the user asks: 'extract the isrc from this spotify link', 'save the isrc', 'get the isrc for this track', 'import this spotify link/album/playlist'. " +
256
- "Paste a track, album, or playlist link " +
257
- "and PICA will fetch all tracks and create works, recordings, people, and performer credits automatically. " +
258
275
  "Two-step flow: first call without confirm to preview tracks, then call with confirm: true to execute.\n\n" +
259
276
  "Supported platforms: Spotify (track/album/playlist), Deezer (track/album/playlist).\n" +
260
- "Apple Music and artist profile URLs are not yet supported.\n\n" +
277
+ "Apple Music and artist profile URLs are not yet supported. " +
278
+ "For a YouTube video, use pica_import_youtube_link; this one takes Spotify and Deezer links.\n\n" +
261
279
  "Each imported track creates: a work (with title, ISRC, UPC, label, artwork), " +
262
280
  "a recording (with ISRC, linked to work), people records for artists, " +
263
281
  "performer credits, and multimedia links. Enrichment cascades fire automatically. " +
@@ -304,12 +322,12 @@ export class ImportTools {
304
322
  "Two-step flow: first call without confirm to preview the video + classification + " +
305
323
  "work match, then call with confirm: true to execute.\n\n" +
306
324
  "Each imported video creates: a recording (with version_type, youtube_video_id, duration, " +
307
- "artist name, thumbnail as album art), a multimedia_items row linked to the work via " +
308
- "multimedia_work_links. The post-import enrichment cascade hydrates view/like counts " +
325
+ "artist name, thumbnail as album art) and a multimedia entry linked to the work. " +
326
+ "The post-import enrichment cascade hydrates view/like counts " +
309
327
  "onto the recording.\n\n" +
310
328
  "Set refresh: true to re-fetch view/like/comment counts for a video that's already " +
311
- "linked to a recording in this org instead of importing a duplicate — use this to " +
312
- "update stale stats on a video you've imported before.\n\n" +
329
+ "linked to a recording in this org instead of importing a duplicate.\n\n" +
330
+ "For a Spotify or Deezer link, use pica_import_streaming_link; this one takes YouTube URLs.\n\n" +
313
331
  "→ then: pica_credits_update (add songwriting credits), pica_recordings_inspect (check gaps)",
314
332
  workflows: "infrastructure",
315
333
  vernacular_kind: "specialist",
@@ -395,10 +413,7 @@ export class ImportTools {
395
413
  // agents. Surface the message instead — matches the sibling pattern
396
414
  // in importStreamingLink/importYouTubeLink.
397
415
  const message = error instanceof Error ? error.message : String(error);
398
- return {
399
- content: [{ type: "text", text: `CSV analyze failed: ${message}` }],
400
- isError: true,
401
- };
416
+ return typedError("CSV_ANALYZE_FAILED", `CSV analyze failed: ${message}`);
402
417
  }
403
418
  }
404
419
  async validateImport(args) {
@@ -434,8 +449,13 @@ export class ImportTools {
434
449
  const options = {
435
450
  dryRun: args.dry_run ?? false,
436
451
  skipInvalidRows: args.skip_invalid_rows ?? false,
437
- conflictStrategy: args.conflict_strategy,
452
+ // Explicit, not inherited: the executor defaults to "skip" too, but an
453
+ // agent reading this call's echoed options must see the strategy it
454
+ // actually ran under (the 2026-08-17 import ran "error" four times).
455
+ conflictStrategy: args.conflict_strategy ?? "skip",
438
456
  batchSize: args.batch_size,
457
+ rowOffset: args.row_offset,
458
+ rowLimit: args.row_limit,
439
459
  };
440
460
  const result = await this.pica.imports.execute(args.file_id
441
461
  ? {
@@ -451,13 +471,42 @@ export class ImportTools {
451
471
  options,
452
472
  });
453
473
  const prefix = result.dryRun ? "[DRY RUN] " : "";
454
- return formatSuccess(`${prefix}Import complete: ${result.importedCount} created, ` +
474
+ // A live run that wrote rows AND has rows that FAILED is a partial
475
+ // commit, not a failure: the created rows are already in the catalogue.
476
+ // Say so, and say what NOT to do — the 2026-08-17 agent re-sent a
477
+ // 2,239-row file three times because the reply read as "failed"
478
+ // (FIX_LOG 2026-08-24). The route computes `partial` from
479
+ // severity:"error" rows only; trust it, and only fall back to the same
480
+ // rule when talking to a server that predates the field. A skipped
481
+ // duplicate is a WARNING and must not trip this — under the default
482
+ // conflict strategy that is the ordinary clean-import case.
483
+ const hardErrors = result.errors.filter((e) => e.severity === "error").length;
484
+ const partial = typeof result.partial === "boolean"
485
+ ? result.partial
486
+ : !result.dryRun &&
487
+ hardErrors > 0 &&
488
+ (result.importedCount > 0 || result.updatedCount > 0);
489
+ // ADR-314 continuation: the server imports one slice per call and says
490
+ // where the next one starts. Repeat the instruction in prose — an agent
491
+ // acts on the sentence, not on a field it did not ask about.
492
+ const range = result.rowRange;
493
+ const continuation = range && range.nextOffset !== null && range.nextOffset !== undefined
494
+ ? ` Rows ${range.offset + 1}-${range.offset + range.count} of ${range.totalRowsInFile} processed; ` +
495
+ `call pica_import_execute again with row_offset: ${range.nextOffset} (same file_id or file_content, same mapping) to continue.`
496
+ : "";
497
+ return formatSuccess(`${prefix}Import ${partial ? "PARTIALLY complete" : "complete"}: ${result.importedCount} created, ` +
455
498
  `${result.updatedCount} updated, ${result.skippedCount} skipped. ` +
456
- `${result.errors.length} errors.`, {
499
+ `${result.errors.length} errors/warnings.` +
500
+ (partial
501
+ ? " The created rows are saved. Do NOT re-send the whole file: read the errors below and re-send only the rows that failed."
502
+ : "") +
503
+ continuation, {
457
504
  importedCount: result.importedCount,
458
505
  updatedCount: result.updatedCount,
459
506
  skippedCount: result.skippedCount,
460
507
  dryRun: result.dryRun,
508
+ partial,
509
+ rowRange: range,
461
510
  errors: result.errors.length > 0 ? result.errors.slice(0, 10) : undefined,
462
511
  createdRecords: result.createdRecords.length <= 20
463
512
  ? result.createdRecords
@@ -591,15 +640,7 @@ export class ImportTools {
591
640
  }
592
641
  catch (error) {
593
642
  const message = error instanceof Error ? error.message : String(error);
594
- return {
595
- content: [
596
- {
597
- type: "text",
598
- text: `Streaming import failed: ${message}`,
599
- },
600
- ],
601
- isError: true,
602
- };
643
+ return typedError("STREAMING_IMPORT_FAILED", `Streaming import failed: ${message}`);
603
644
  }
604
645
  }
605
646
  async importYouTubeLink(args) {
@@ -684,15 +725,7 @@ export class ImportTools {
684
725
  }
685
726
  catch (error) {
686
727
  const message = error instanceof Error ? error.message : String(error);
687
- return {
688
- content: [
689
- {
690
- type: "text",
691
- text: `YouTube import failed: ${message}`,
692
- },
693
- ],
694
- isError: true,
695
- };
728
+ return typedError("YOUTUBE_IMPORT_FAILED", `YouTube import failed: ${message}`);
696
729
  }
697
730
  }
698
731
  }