mcp-scraper 0.55.0 → 0.57.0

package/dist/{chunk-WYLIDW4S.js → chunk-ULAJAZQF.js}

@@ -21,14 +21,14 @@ import {
 } from "./chunk-AK2NNIYA.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-V2QWNGEK.js";
+} from "./chunk-QQ6ZBYZZ.js";
 import {
   MC_PER_CREDIT,
   PAA_BASE_CREDITS,
   PAA_QUESTION_CREDITS,
   PAGE_SCRAPE_CREDITS,
   SERP_SEARCH_CREDITS
-} from "./chunk-N4LT53JX.js";
+} from "./chunk-R6CO77BN.js";
 import {
   buildPublicErrorEnvelope,
   normalizePublicErrorCode,
@@ -374,7 +374,7 @@ seam is noted so you can chain them.
   prepare-memory-write: it returns the live entity profile contract, duplicate candidates, tag reuse/review/create
   guidance, recommended sections, optional sections, and heading guidance before any write occurs.
 - Validate a composed entity without writing -> **commons_validate_entity**. Use it after composing and before submit
-  to catch missing featured images, missing source/body evidence, duplicate conflicts, revision problems, and
+  to catch missing featured images, missing source/body evidence, duplicate candidates, and
   unsupported placeholder sections.
 - Create or edit a public wiki entity -> **commons_submit_entity**. This is a governed proposal write,
   not direct rendered HTML editing. Normal workflow is prepare -> validate -> submit. Pick the closest entity type
@@ -382,6 +382,9 @@ seam is noted so you can chain them.
   Trail, or PublicArticle.
   Creating a new entity costs 10 Credits; editing an existing entity costs 2 Credits. Preparation, validation,
   search, and reads are free. Reusing the same idempotency key for a retry does not charge twice.
+  Commons is an open wiki. Any account may edit any entity, and every edit publishes immediately and is
+  tracked on the public contribution ledger with the actor, the changed fields, and a before/after snapshot.
+  Pass baseRevision on an edit so the ledger records whether it landed on top of a newer revision.
   The body must be a neutral encyclopedia projection, not a blog post or raw scrape dump. Use H2 for the
   entity's main sections and H3/H4/H5 for subtopics; every heading becomes a public page-menu item.
   Entity profiles are adaptive contracts, not empty templates. Use the prepare output as the guide, but omit
@@ -6376,6 +6379,16 @@ var CommonsValidateEntityInputSchema = {
 var CommonsGetEntityLedgerInputSchema = {
   idOrSlug: z5.string().trim().min(1).max(180).describe("Published entity id or /wiki/ slug whose contribution ledger should be read.")
 };
+var CommonsHostImageInputSchema = {
+  sourceUrl: z5.string().url().optional().describe("Public https image URL to download and host. The wiki never serves a third-party URL directly, so pass the original source here rather than putting it on the entity."),
+  imageBase64: z5.string().min(16).optional().describe("Base64 image bytes for an image you already hold. Use for images under about 3 MB; larger files should be published from a URL."),
+  alt: z5.string().trim().max(500).optional().describe("Alt text describing the image for readers who cannot see it."),
+  license: z5.string().trim().max(240).optional().describe("License or usage terms of the original image, preserved with the hosted copy."),
+  attribution: z5.string().trim().max(500).optional().describe("Credit line for the original photographer, publication, or archive.")
+};
+var CommonsGetProposalInputSchema = {
+  proposalId: z5.string().trim().min(1).max(120).describe("Proposal id returned by commons_submit_entity, in the form commons-proposal-<uuid>.")
+};
 var CommonsSaveFilterInputSchema = {
   name: z5.string().trim().min(2).max(80).describe("User-facing name for this MCP personalization filter. Reusing a name updates the saved filter."),
   description: z5.string().trim().max(500).optional().describe("Optional note explaining when this filter should be used."),
@@ -9833,7 +9846,7 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.commonsValidateEntity(input));
   server.registerTool("commons_submit_entity", {
     title: "Transparent Commons Governed Entity Write",
-    description: "Create or propose an edit to a Transparent Commons public wiki entity through the governed MCP Scraper write plane. A new entity costs 10 Credits; an edit to an existing entity costs 2 Credits. Preparation and validation are free, and idempotent retries are not charged twice. This never edits rendered HTML directly. Normal workflow is commons_prepare_entity, compose, commons_validate_entity, then submit. Choose a precise entityType and write a neutral encyclopedia projection with the matching entity structure, not a blog article or raw scrape dump. Use H2 sections and H3/H4/H5 subitems; every heading appears in the public page menu. Omit unsupported sections instead of publishing empty/filler headings. It writes a proposal, records a contribution ledger entry when accepted, and auto-publishes only safe non-conflicting changes with a featured image and source/body evidence. Existing entity edits require baseRevision to auto-publish. Requires idempotencyKey.",
+    description: "Create or propose an edit to a Transparent Commons public wiki entity through the governed MCP Scraper write plane. A new entity costs 10 Credits; an edit to an existing entity costs 2 Credits. Preparation and validation are free, and idempotent retries are not charged twice. This never edits rendered HTML directly. Normal workflow is commons_prepare_entity, compose, commons_validate_entity, then submit. Choose a precise entityType and write a neutral encyclopedia projection with the matching entity structure, not a blog article or raw scrape dump. Use H2 sections and H3/H4/H5 subitems; every heading appears in the public page menu. Omit unsupported sections instead of publishing empty/filler headings. Transparent Commons is an open wiki: any account may edit any entity, and every edit publishes and is recorded on the public contribution ledger. Publishing requires a featured image and body/source evidence. Pass baseRevision when editing so the ledger can show whether the edit was written on top of a newer revision. Requires idempotencyKey.",
     inputSchema: CommonsSubmitEntityInputSchema,
     outputSchema: recordOutputSchema("commons_submit_entity", CommonsGenericOutputSchema),
     annotations: {
@@ -9857,6 +9870,32 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
       openWorldHint: false
     }
   }, async (input) => executor.commonsGetEntityLedger(input));
+  server.registerTool("commons_host_image", {
+    title: "Host a Transparent Commons Image",
+    description: "Download an image from a public https URL, or accept base64 bytes, and store it as a permanent Commons-hosted image. Returns the hosted URL to use on an entity. Commons never serves a third-party image URL: submitting an entity with an external image hosts it automatically, and this tool exists for hosting an image before or independently of a write. JPEG, PNG, GIF, and WebP up to 10 MB; SVG is rejected because the wiki serves images to the public web. Identical bytes are stored once and reused.",
+    inputSchema: CommonsHostImageInputSchema,
+    outputSchema: recordOutputSchema("commons_host_image", CommonsGenericOutputSchema),
+    annotations: {
+      title: "Host a Transparent Commons Image",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
+  }, async (input) => executor.commonsHostImage(input));
+  server.registerTool("commons_get_proposal", {
+    title: "Transparent Commons Proposal Status",
+    description: "Read one commons_submit_entity proposal owned by the calling account. Use it when submit returned a proposal that was held for review instead of published, to see the review reason and whether it has since been applied.",
+    inputSchema: CommonsGetProposalInputSchema,
+    outputSchema: recordOutputSchema("commons_get_proposal", CommonsGenericOutputSchema),
+    annotations: {
+      title: "Transparent Commons Proposal Status",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  }, async (input) => executor.commonsGetProposal(input));
   server.registerTool("commons_save_filter", {
     title: "Transparent Commons Saved MCP Filter",
     description: "Save or update an account-scoped Commons search filter so one MCP can behave like many personalized reading rooms, trails, source scopes, categories, or tag bundles. Reusing a filter name updates it.",
@@ -10868,6 +10907,12 @@ var HttpMcpToolExecutor = class {
   commonsGetEntityLedger(input) {
     return this.getJson(`/commons/entities/${encodeURIComponent(input.idOrSlug)}/ledger`);
   }
+  commonsGetProposal(input) {
+    return this.getJson(`/commons/proposals/${encodeURIComponent(input.proposalId)}`);
+  }
+  commonsHostImage(input) {
+    return this.call("/commons/images", input);
+  }
   commonsSaveFilter(input) {
     return this.call("/commons/filters", input);
   }
@@ -15927,4 +15972,4 @@ export {
   ScheduledResultsMcpExecutor,
   registerScheduledResultsMcpTools
 };
-//# sourceMappingURL=chunk-WYLIDW4S.js.map
+//# sourceMappingURL=chunk-ULAJAZQF.js.map