mcp-scraper 0.66.6 → 0.67.0

package/dist/bin/api-server.js

@@ -17,9 +17,9 @@ loadDotEnv();
 async function main() {
   const [{ serve }, { app }, { startWorker }, { migrate }] = await Promise.all([
     import("@hono/node-server"),
-    import("../server-5WPS3LZD.js"),
-    import("../worker-UTBUWEXQ.js"),
-    import("../db-4RVZ3NYZ.js")
+    import("../server-MFVYRB6I.js"),
+    import("../worker-JGWV2LID.js"),
+    import("../db-ZGZAKYBW.js")
   ]);
   const PORT = parseInt(process.env.PORT ?? "3001");
   try {

package/dist/bin/mcp-scraper-cli.cjs

@@ -30,7 +30,7 @@ var import_promises5 = require("fs/promises");
 var import_node_path3 = require("path");
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.6";
+var PACKAGE_VERSION = "0.67.0";
 
 // src/cli/agent-config.ts
 function apiKeyValue(options) {

package/dist/bin/mcp-scraper-cli.js

@@ -13,7 +13,7 @@ import "../chunk-VXLU74YZ.js";
 import "../chunk-GGZEC22A.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-NLEAYKOC.js";
+} from "../chunk-GT63KEUB.js";
 
 // src/cli/human-cli.ts
 import { Command } from "commander";

package/dist/bin/mcp-scraper-install.cjs

@@ -3,7 +3,7 @@
 
 // release-message.json
 var release_message_default = {
-  message: "Search Console bulk URL Inspection now returns one ordered partial-result receipt without the former one-minute cutoff."
+  message: "Transparent Commons can now turn pasted images, generated image bytes, stored image artifacts, direct image URLs, or ordinary webpage URLs into one permanent Commons-hosted image before validation and publishing."
 };
 
 // src/install-terminal.ts
@@ -112,7 +112,7 @@ function renderInstallTerminal(options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.6";
+var PACKAGE_VERSION = "0.67.0";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-scraper-install.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   renderInstallTerminal
-} from "../chunk-KPE52NPT.js";
+} from "../chunk-IHDTONZV.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-NLEAYKOC.js";
+} from "../chunk-GT63KEUB.js";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-stdio-server.cjs

@@ -96,7 +96,26 @@ var PUBLIC_ERROR_CODES = [
   "site_export_not_found",
   "site_export_format_unavailable",
   "site_export_read_failed",
-  "site_export_image_not_found"
+  "site_export_image_not_found",
+  "image_url_invalid",
+  "image_url_not_https",
+  "image_host_unresolvable",
+  "image_host_blocked",
+  "image_redirect_invalid",
+  "image_source_unavailable",
+  "image_too_large",
+  "image_redirect_limit",
+  "image_base64_invalid",
+  "image_source_missing",
+  "image_source_ambiguous",
+  "image_source_type_invalid",
+  "image_artifact_not_found",
+  "image_page_too_large",
+  "page_image_not_found",
+  "page_image_candidates_unusable",
+  "image_format_unsupported",
+  "image_storage_unconfigured",
+  "featured_image_unhostable"
 ];
 var PUBLIC_ERROR_TYPES = [
   "request_aborted",
@@ -191,6 +210,26 @@ function publicErrorType(code) {
     case "site_export_read_failed":
     case "site_export_image_not_found":
       return "extraction";
+    case "image_url_invalid":
+    case "image_url_not_https":
+    case "image_host_unresolvable":
+    case "image_host_blocked":
+    case "image_redirect_invalid":
+    case "image_source_unavailable":
+    case "image_too_large":
+    case "image_redirect_limit":
+    case "image_base64_invalid":
+    case "image_source_missing":
+    case "image_source_ambiguous":
+    case "image_source_type_invalid":
+    case "image_artifact_not_found":
+    case "image_page_too_large":
+    case "page_image_not_found":
+    case "page_image_candidates_unusable":
+    case "image_format_unsupported":
+    case "image_storage_unconfigured":
+    case "featured_image_unhostable":
+      return "invalid_request";
     case "insufficient_balance":
       return "billing";
     case "vendor_unavailable":
@@ -264,6 +303,44 @@ function publicErrorMessage(code) {
       return "The stored site export could not be read or did not pass its integrity check.";
     case "site_export_image_not_found":
       return "The requested site-export image was not found, expired, or does not belong to this account.";
+    case "image_url_invalid":
+      return "The image source is not a valid URL. Use a stable public HTTPS URL or inline image bytes.";
+    case "image_url_not_https":
+      return "Commons image sources must use a public HTTPS URL or inline image bytes.";
+    case "image_host_unresolvable":
+      return "The image host could not be resolved. Use a different stable public URL or inline image bytes.";
+    case "image_host_blocked":
+      return "The image source resolves to a network address Commons cannot fetch safely.";
+    case "image_redirect_invalid":
+      return "The image source redirected to an invalid or unsafe destination.";
+    case "image_source_unavailable":
+      return "The image source could not be fetched. Host a different stable public URL or provide inline image bytes.";
+    case "image_too_large":
+      return "The image exceeds the Commons image size limit.";
+    case "image_redirect_limit":
+      return "The image source exceeded the Commons redirect limit.";
+    case "image_base64_invalid":
+      return "The supplied inline image bytes are invalid.";
+    case "image_source_missing":
+      return "Provide exactly one of a public image or webpage URL, inline image bytes, or an owner-scoped image artifact.";
+    case "image_source_ambiguous":
+      return "Provide only one image source: sourceUrl, imageBase64, or artifactId.";
+    case "image_source_type_invalid":
+      return "Use sourceType only with inline image bytes or an owner-scoped image artifact.";
+    case "image_artifact_not_found":
+      return "The image artifact was not found, expired, or does not belong to this account.";
+    case "image_page_too_large":
+      return "The webpage is too large for bounded Commons image discovery.";
+    case "page_image_not_found":
+      return "The webpage did not expose a usable featured or content image.";
+    case "page_image_candidates_unusable":
+      return "The webpage exposed image candidates, but none returned supported public image bytes.";
+    case "image_format_unsupported":
+      return "Commons accepts JPEG, PNG, GIF, or WebP image bytes.";
+    case "image_storage_unconfigured":
+      return "Commons image storage is temporarily unavailable.";
+    case "featured_image_unhostable":
+      return "The required featured image could not be hosted for Commons publication.";
     default:
       return PUBLIC_SERVICE_UNAVAILABLE_MESSAGE;
   }
@@ -1233,7 +1310,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.6";
+var PACKAGE_VERSION = "0.67.0";
 
 // src/mcp/input-field-descriptions.ts
 var import_zod = require("zod");
@@ -8217,11 +8294,21 @@ seam is noted so you can chain them.
 - Plan a new or edited entity -> **commons_prepare_entity**. This is the Commons equivalent of
   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 candidates, and
-  unsupported placeholder sections.
+- Host a featured image -> **commons_host_image**. The normal write sequence is **commons_prepare_entity ->
+  compose the payload -> commons_host_image -> commons_validate_entity -> commons_submit_entity**. Put the
+  permanent returned URL in featuredImage.url. Use imageBase64 for pasted or AI-generated bytes, artifactId for an
+  owner-scoped MCP Scraper image artifact, or sourceUrl for either a public HTTPS image or a webpage containing one.
+  Webpage discovery tries Open Graph, Twitter, JSON-LD, then meaningful content images. Never pass a caller-local
+  path, opaque chat attachment reference, or private/authenticated URL.
+- Validate a composed entity without writing -> **commons_validate_entity**. Use it after image hosting and before
+  submit. Validation does not fetch or store image bytes; an external/unregistered featured image is reported in
+  imageDiagnostics as not publishable until commons_host_image returns its permanent Commons URL. Validation also
+  catches 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
+  not direct rendered HTML editing. Submit retains defensive auto-hosting for a stable direct public HTTPS image,
+  but image ingress failure returns an actionable tool error: host different bytes or a different stable source,
+  replace featuredImage.url, validate again, and retry the same intended write with the same idempotency key.
+  Pick the closest entity type
   first: SoftwareApplication, Organization, Person, Event, Place, Taxon, ScienceConcept, MathConcept, TechArticle,
   Trail, or PublicArticle.
   Creating a new entity costs 10 Credits; editing an existing entity costs 2 Credits. Preparation, validation,
@@ -10119,7 +10206,7 @@ var CommonsGetEntityLinksetInputSchema = {
   idOrSlug: import_zod8.z.string().trim().min(1).max(180).describe("Transparent Commons TPW-Q entity id or /wiki/ slug whose governed RFC 9264 linkset should be read.")
 };
 var CommonsFeaturedImageInputSchema = import_zod8.z.object({
-  url: import_zod8.z.string().url().describe("Required public image URL for a publishable entity. Use extract_url includeFeaturedImage or preserved media when available."),
+  url: import_zod8.z.string().url().describe("For a publish-ready entity, use the permanent URL returned by commons_host_image. Validation reports any unregistered external URL as not ready. Do not use a chat attachment reference, caller-local path, private URL, or HTML page URL here; pass the original image or webpage source to commons_host_image first."),
   alt: import_zod8.z.string().trim().max(500).optional(),
   caption: import_zod8.z.string().trim().max(1e3).optional(),
   sourceUrl: import_zod8.z.string().url().optional(),
@@ -10211,14 +10298,14 @@ var CommonsPrepareEntityInputSchema = {
   maxCandidates: import_zod8.z.number().int().min(1).max(20).default(8).describe("Maximum duplicate candidates to return.")
 };
 var CommonsSubmitEntityInputSchema = {
-  idempotencyKey: import_zod8.z.string().trim().min(8).max(200).describe("Required unique opaque ID for this intended Commons write. Reuse only when retrying the same write after a timeout; use a new value for each intentional create or edit."),
+  idempotencyKey: import_zod8.z.string().trim().min(8).max(200).describe("Required unique opaque ID for this intended Commons write. Reuse it when retrying the same intended write after a timeout or after correcting a pre-persistence image-ingress failure; use a new value for each intentional create or edit."),
   title: import_zod8.z.string().trim().min(3).max(180).describe("Public page title. This is also used for duplicate slug/entity checks when slug is omitted."),
   description: import_zod8.z.string().trim().min(8).max(600).describe("Short article summary and schema.org description."),
   slug: import_zod8.z.string().trim().max(180).optional().describe("Optional URL slug. Omit to derive one from title."),
   entityId: import_zod8.z.string().trim().max(80).optional().describe("Existing Transparent Public Wiki entity id when proposing an edit. New entities normally omit this and receive a TPW-Q id."),
   entityType: import_zod8.z.string().trim().max(120).default("PublicArticle").describe("Backend Wikidata-style type. Prefer precise entity classes such as SoftwareApplication, Organization, Person, Event, Place, Taxon, ScienceConcept, MathConcept, TechArticle, or PublicArticle; the public article structure should match the selected type."),
   disambiguationName: import_zod8.z.string().trim().max(240).optional().describe("Clarifying name used when the concept could be confused with another entity."),
-  featuredImage: CommonsFeaturedImageInputSchema.optional().describe("Required for auto-published public entities. The image is also added to the media manifest if absent."),
+  featuredImage: CommonsFeaturedImageInputSchema.optional().describe("Required for auto-published public entities. First call commons_host_image with attachment bytes, an image artifact, a direct image URL, or a webpage URL, then place its returned permanent URL here. Validation does not fetch external images and reports unregistered URLs as not publishable. Submit retains a compatibility fallback for public URLs. The image is also added to the media manifest if absent."),
   source: CommonsSourceInputSchema.optional().describe("Source provenance. Store original URL, source byline, and origin canonical here; canonical does not replace rights review."),
   tags: import_zod8.z.array(import_zod8.z.string().trim().min(1).max(80)).max(24).optional().describe("Standardized topic tags. Use existing/searchable concepts when possible."),
   keywords: import_zod8.z.array(import_zod8.z.string().trim().min(1).max(120)).max(50).optional().describe("SEO and retrieval keywords."),
@@ -10280,12 +10367,31 @@ var CommonsGetEntityLedgerInputSchema = {
   idOrSlug: import_zod8.z.string().trim().min(1).max(180).describe("Published entity id or /wiki/ slug whose contribution ledger should be read.")
 };
 var CommonsHostImageInputSchema = {
-  sourceUrl: import_zod8.z.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: import_zod8.z.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."),
+  sourceUrl: import_zod8.z.string().url().optional().describe("Public HTTPS direct image URL or webpage URL. A direct image is hosted as-is; an HTML page is inspected for Open Graph, Twitter, JSON-LD, and meaningful content images, then the first usable candidate is hosted. Temporary signed URLs are consumed immediately and query credentials are not retained as provenance."),
+  imageBase64: import_zod8.z.string().min(16).optional().describe("Base64 image bytes for an image already available to the caller, including a pasted attachment or AI-generated image. Use sourceType to preserve whether it was uploaded or generated. Keep the complete serialized request within the client transport limit."),
+  artifactId: import_zod8.z.string().trim().min(1).max(500).optional().describe("Owner-scoped image artifact returned by an MCP Scraper media or screenshot workflow. The server reauthorizes ownership and reads the bytes directly; do not construct an artifact ID."),
+  sourceType: import_zod8.z.enum(["uploaded", "ai_generated"]).optional().describe("Provenance for imageBase64 or artifactId. Use ai_generated only when an image model created the supplied bytes; otherwise use uploaded or omit it."),
   alt: import_zod8.z.string().trim().max(500).optional().describe("Alt text describing the image for readers who cannot see it."),
   license: import_zod8.z.string().trim().max(240).optional().describe("License or usage terms of the original image, preserved with the hosted copy."),
   attribution: import_zod8.z.string().trim().max(500).optional().describe("Credit line for the original photographer, publication, or archive.")
 };
+var CommonsHostImageOutputSchema = {
+  ok: import_zod8.z.boolean(),
+  data: import_zod8.z.object({
+    id: import_zod8.z.string().describe("Stable Commons image ID."),
+    url: import_zod8.z.string().url().describe("Permanent Commons URL to use as featuredImage.url."),
+    contentType: import_zod8.z.enum(["image/jpeg", "image/png", "image/gif", "image/webp"]),
+    bytes: import_zod8.z.number().int().positive(),
+    digest: import_zod8.z.string(),
+    sourceUrl: import_zod8.z.string().url().nullable().describe("Sanitized direct asset URL that supplied the hosted bytes, when applicable."),
+    sourcePageUrl: import_zod8.z.string().url().nullable().describe("Sanitized webpage URL from which the image was discovered, when applicable."),
+    sourceKind: import_zod8.z.enum(["uploaded", "ai_generated", "artifact", "direct_url", "webpage", "registered"]),
+    selectionSource: import_zod8.z.enum(["provided_bytes", "artifact", "direct_url", "og:image", "twitter:image", "json-ld", "content-image", "registered"]),
+    reused: import_zod8.z.boolean().describe("True when identical image bytes were already stored.")
+  }).optional(),
+  error: import_zod8.z.string().optional(),
+  message: import_zod8.z.string().optional()
+};
 var CommonsGetProposalInputSchema = {
   proposalId: import_zod8.z.string().trim().min(1).max(120).describe("Proposal id returned by commons_submit_entity, in the form commons-proposal-<uuid>.")
 };
@@ -10313,6 +10419,30 @@ var CommonsGenericOutputSchema = {
   error: import_zod8.z.string().optional(),
   message: import_zod8.z.string().optional()
 };
+var CommonsFeaturedImageDiagnosticsOutputSchema = import_zod8.z.object({
+  state: import_zod8.z.enum(["missing", "external_unhosted", "commons_hosted"]).describe("Storage-readiness state for the candidate featured image."),
+  url: import_zod8.z.string().url().nullable().describe("Normalized candidate featured-image URL, or null when none was supplied."),
+  commonsImageId: import_zod8.z.string().nullable().describe("Registered Commons image ID when metadata proves the image is hosted, otherwise null."),
+  readyForPublish: import_zod8.z.boolean().describe("Whether Commons storage metadata proves this featured image is ready to publish."),
+  submitWillAttemptAutoHost: import_zod8.z.boolean().describe("Whether submit will use its compatibility fallback to try hosting this external image."),
+  requiredAction: import_zod8.z.string().nullable().describe("Action the caller must take before submit, or null when the image is ready.")
+}).describe("Featured-image storage readiness determined without fetching or storing external bytes.");
+var CommonsValidateEntityOutputSchema = {
+  ok: import_zod8.z.boolean(),
+  data: import_zod8.z.object({
+    ok: import_zod8.z.literal(true),
+    valid: import_zod8.z.boolean(),
+    publishable: import_zod8.z.boolean(),
+    autoPublishEligible: import_zod8.z.boolean(),
+    errors: import_zod8.z.array(import_zod8.z.string()),
+    warnings: import_zod8.z.array(import_zod8.z.string()),
+    imageDiagnostics: import_zod8.z.object({
+      featuredImage: CommonsFeaturedImageDiagnosticsOutputSchema
+    }).describe("Read-only image readiness and recovery guidance for this payload.")
+  }).passthrough().optional(),
+  error: import_zod8.z.string().optional(),
+  message: import_zod8.z.string().optional()
+};
 var DirectoryWorkflowStatusInputSchema = {
   jobId: import_zod8.z.string().trim().min(1).describe("The jobId returned by directory_workflow. Poll until status is complete, partial, empty, or failed.")
 };
@@ -14019,9 +14149,9 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.commonsPrepareEntity(input));
   server.registerTool("commons_validate_entity", {
     title: "Transparent Commons Validate Entity",
-    description: "Validate a proposed Transparent Commons entity payload without writing. Checks publishable basics, featured image, source/body evidence, existing-entity conflict state, heading profile alignment, and unsupported placeholder sections. Call this after composing the page and before commons_submit_entity.",
+    description: "Read-only validation for a proposed Transparent Commons entity payload. Call it after commons_prepare_entity, composing the page, and commons_host_image. It does not fetch or store image bytes: an external or otherwise unregistered featured image remains not publishable until commons_host_image returns the permanent Commons URL. Inspect imageDiagnostics for readiness and the required action before commons_submit_entity. Also checks source/body evidence, existing-entity conflict state, heading profile alignment, and unsupported placeholder sections.",
     inputSchema: CommonsValidateEntityInputSchema,
-    outputSchema: recordOutputSchema("commons_validate_entity", CommonsGenericOutputSchema),
+    outputSchema: recordOutputSchema("commons_validate_entity", CommonsValidateEntityOutputSchema),
     annotations: {
       title: "Transparent Commons Validate Entity",
       readOnlyHint: true,
@@ -14032,7 +14162,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. commons_prepare_entity returns the entity profile contract and section guidance to compose against. 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.",
+    description: "Charged governed write that creates or proposes an edit to a Transparent Commons public wiki entity. A new entity costs 10 Credits; an edit costs 2 Credits. Preparation, image hosting, and validation are free, and idempotent retries are not charged twice. Normal workflow is commons_prepare_entity, compose the page, commons_host_image, commons_validate_entity, then submit with the returned permanent featuredImage.url. Submit retains a compatibility fallback that auto-hosts a stable direct public HTTPS image URL; if image ingress fails, it returns an actionable image tool error so you can host different bytes or a different stable source, replace the URL, validate again, and retry the same intended write with the same idempotencyKey. This never edits rendered HTML directly. Transparent Commons is an open wiki: any account may edit any entity, and every applied edit is recorded on the public contribution ledger. Publishing requires a ready 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: {
@@ -14058,9 +14188,9 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.commonsGetEntityLedger(input));
   server.registerTool("commons_host_image", {
     title: "Host a Transparent Commons Image",
-    description: "Host an image from a public https URL or base64 bytes, returning a permanent Commons URL. Commons never serves a third-party image URL \u2014 commons_submit_entity hosts external images automatically, so use this only to host one before or independently of a write. JPEG, PNG, GIF, WebP up to 10 MB; SVG rejected. Identical bytes are stored once.",
+    description: "Turn one supplied image source into a permanent Transparent Commons image before validation and submission. Provide exactly one of imageBase64 for a pasted or AI-generated image, artifactId for an owner-scoped MCP Scraper image artifact, or sourceUrl for either a direct public HTTPS image or a webpage containing the desired image. Webpages are inspected in deterministic order for Open Graph, Twitter, JSON-LD, and meaningful content images; unusable candidates fall through to the next candidate. Returns the permanent URL for featuredImage.url plus source and selection provenance. JPEG, PNG, GIF, and WebP are accepted up to 10 MB; SVG is rejected. Identical bytes are stored once. Never pass a caller-local path or private/authenticated URL.",
     inputSchema: CommonsHostImageInputSchema,
-    outputSchema: recordOutputSchema("commons_host_image", CommonsGenericOutputSchema),
+    outputSchema: recordOutputSchema("commons_host_image", CommonsHostImageOutputSchema),
     annotations: {
       title: "Host a Transparent Commons Image",
       readOnlyHint: false,
@@ -18666,7 +18796,7 @@ var HostedMemoryMcpToolExecutor = class {
 
 // release-message.json
 var release_message_default = {
-  message: "Search Console bulk URL Inspection now returns one ordered partial-result receipt without the former one-minute cutoff."
+  message: "Transparent Commons can now turn pasted images, generated image bytes, stored image artifacts, direct image URLs, or ordinary webpage URLs into one permanent Commons-hosted image before validation and publishing."
 };
 
 // src/install-terminal.ts

package/dist/bin/mcp-stdio-server.js

@@ -13,21 +13,21 @@ import {
   registerScheduledResultsMcpTools,
   registerSerpIntelligenceCaptureTools,
   resolveDeploymentProfile
-} from "../chunk-VMWVEKZT.js";
+} from "../chunk-XOOKZYZG.js";
 import "../chunk-PGJQDMC2.js";
-import "../chunk-3EYALCYK.js";
-import "../chunk-3TKKJQB4.js";
+import "../chunk-2L4C4DAZ.js";
+import "../chunk-ES25GP6C.js";
 import {
   renderInstallTerminal
-} from "../chunk-KPE52NPT.js";
+} from "../chunk-IHDTONZV.js";
 import "../chunk-VXLU74YZ.js";
 import "../chunk-GGZEC22A.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-NLEAYKOC.js";
+} from "../chunk-GT63KEUB.js";
 import "../chunk-DNM65UCK.js";
 import "../chunk-AYJHI2FK.js";
-import "../chunk-55B3T5L2.js";
+import "../chunk-65FTMB7G.js";
 
 // bin/mcp-stdio-server.ts
 import { readFileSync } from "fs";

package/dist/bin/paa-harvest.cjs

@@ -300,7 +300,26 @@ var PUBLIC_ERROR_CODES = [
   "site_export_not_found",
   "site_export_format_unavailable",
   "site_export_read_failed",
-  "site_export_image_not_found"
+  "site_export_image_not_found",
+  "image_url_invalid",
+  "image_url_not_https",
+  "image_host_unresolvable",
+  "image_host_blocked",
+  "image_redirect_invalid",
+  "image_source_unavailable",
+  "image_too_large",
+  "image_redirect_limit",
+  "image_base64_invalid",
+  "image_source_missing",
+  "image_source_ambiguous",
+  "image_source_type_invalid",
+  "image_artifact_not_found",
+  "image_page_too_large",
+  "page_image_not_found",
+  "page_image_candidates_unusable",
+  "image_format_unsupported",
+  "image_storage_unconfigured",
+  "featured_image_unhostable"
 ];
 var PUBLIC_ERROR_TYPES = [
   "request_aborted",

package/dist/bin/paa-harvest.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   harvest
-} from "../chunk-K7Y27ND3.js";
+} from "../chunk-62LEXS5O.js";
 import {
   browserServiceApiKey
-} from "../chunk-3TKKJQB4.js";
+} from "../chunk-ES25GP6C.js";
 import "../chunk-77LQV73B.js";
-import "../chunk-55B3T5L2.js";
+import "../chunk-65FTMB7G.js";
 
 // src/cli.ts
 import { Command } from "commander";

package/dist/{chunk-3EYALCYK.js → chunk-2L4C4DAZ.js}

@@ -1,7 +1,7 @@
 import {
   publicErrorMessage,
   sanitizeVendorName
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/api/outbound-sanitize.ts
 var KEY_RENAMES = {

package/dist/{chunk-CETDPNMZ.js → chunk-2LXTOAKS.js}

@@ -10,7 +10,7 @@ import {
   finishHarvestAttempt,
   publicErrorMessage,
   startHarvestAttempt
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/api/harvest-problems.ts
 function errorMessage(err) {

package/dist/{chunk-K7Y27ND3.js → chunk-62LEXS5O.js}

@@ -6,7 +6,7 @@ import {
   currentCostContext,
   recordKernelSession,
   runWithCostContext
-} from "./chunk-3TKKJQB4.js";
+} from "./chunk-ES25GP6C.js";
 import {
   DEFAULT_PROXY_MODE,
   HarvestOptionsSchema,
@@ -21,7 +21,7 @@ import {
   RECAPTCHA_INSTRUCTIONS,
   RequestAbortedError,
   sanitizeVendorName
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/driver/BrowserDriver.ts
 import { chromium } from "playwright-extra";

package/dist/{chunk-55B3T5L2.js → chunk-65FTMB7G.js}

@@ -42,7 +42,26 @@ var PUBLIC_ERROR_CODES = [
   "site_export_not_found",
   "site_export_format_unavailable",
   "site_export_read_failed",
-  "site_export_image_not_found"
+  "site_export_image_not_found",
+  "image_url_invalid",
+  "image_url_not_https",
+  "image_host_unresolvable",
+  "image_host_blocked",
+  "image_redirect_invalid",
+  "image_source_unavailable",
+  "image_too_large",
+  "image_redirect_limit",
+  "image_base64_invalid",
+  "image_source_missing",
+  "image_source_ambiguous",
+  "image_source_type_invalid",
+  "image_artifact_not_found",
+  "image_page_too_large",
+  "page_image_not_found",
+  "page_image_candidates_unusable",
+  "image_format_unsupported",
+  "image_storage_unconfigured",
+  "featured_image_unhostable"
 ];
 var PUBLIC_ERROR_TYPES = [
   "request_aborted",
@@ -164,6 +183,26 @@ function publicErrorType(code) {
     case "site_export_read_failed":
     case "site_export_image_not_found":
       return "extraction";
+    case "image_url_invalid":
+    case "image_url_not_https":
+    case "image_host_unresolvable":
+    case "image_host_blocked":
+    case "image_redirect_invalid":
+    case "image_source_unavailable":
+    case "image_too_large":
+    case "image_redirect_limit":
+    case "image_base64_invalid":
+    case "image_source_missing":
+    case "image_source_ambiguous":
+    case "image_source_type_invalid":
+    case "image_artifact_not_found":
+    case "image_page_too_large":
+    case "page_image_not_found":
+    case "page_image_candidates_unusable":
+    case "image_format_unsupported":
+    case "image_storage_unconfigured":
+    case "featured_image_unhostable":
+      return "invalid_request";
     case "insufficient_balance":
       return "billing";
     case "vendor_unavailable":
@@ -237,6 +276,44 @@ function publicErrorMessage(code) {
       return "The stored site export could not be read or did not pass its integrity check.";
     case "site_export_image_not_found":
       return "The requested site-export image was not found, expired, or does not belong to this account.";
+    case "image_url_invalid":
+      return "The image source is not a valid URL. Use a stable public HTTPS URL or inline image bytes.";
+    case "image_url_not_https":
+      return "Commons image sources must use a public HTTPS URL or inline image bytes.";
+    case "image_host_unresolvable":
+      return "The image host could not be resolved. Use a different stable public URL or inline image bytes.";
+    case "image_host_blocked":
+      return "The image source resolves to a network address Commons cannot fetch safely.";
+    case "image_redirect_invalid":
+      return "The image source redirected to an invalid or unsafe destination.";
+    case "image_source_unavailable":
+      return "The image source could not be fetched. Host a different stable public URL or provide inline image bytes.";
+    case "image_too_large":
+      return "The image exceeds the Commons image size limit.";
+    case "image_redirect_limit":
+      return "The image source exceeded the Commons redirect limit.";
+    case "image_base64_invalid":
+      return "The supplied inline image bytes are invalid.";
+    case "image_source_missing":
+      return "Provide exactly one of a public image or webpage URL, inline image bytes, or an owner-scoped image artifact.";
+    case "image_source_ambiguous":
+      return "Provide only one image source: sourceUrl, imageBase64, or artifactId.";
+    case "image_source_type_invalid":
+      return "Use sourceType only with inline image bytes or an owner-scoped image artifact.";
+    case "image_artifact_not_found":
+      return "The image artifact was not found, expired, or does not belong to this account.";
+    case "image_page_too_large":
+      return "The webpage is too large for bounded Commons image discovery.";
+    case "page_image_not_found":
+      return "The webpage did not expose a usable featured or content image.";
+    case "page_image_candidates_unusable":
+      return "The webpage exposed image candidates, but none returned supported public image bytes.";
+    case "image_format_unsupported":
+      return "Commons accepts JPEG, PNG, GIF, or WebP image bytes.";
+    case "image_storage_unconfigured":
+      return "Commons image storage is temporarily unavailable.";
+    case "featured_image_unhostable":
+      return "The required featured image could not be hosted for Commons publication.";
     default:
       return PUBLIC_SERVICE_UNAVAILABLE_MESSAGE;
   }
@@ -921,6 +998,20 @@ async function migrate(options = {}) {
       PRIMARY KEY (user_id, connection_id, period_start)
     )
   `);
+  await db.execute(`
+    CREATE TABLE IF NOT EXISTS connected_account_charge_transfers (
+      id                 INTEGER PRIMARY KEY AUTOINCREMENT,
+      user_id            INTEGER NOT NULL,
+      period_start       TEXT NOT NULL,
+      from_connection_id TEXT NOT NULL,
+      to_connection_id   TEXT NOT NULL,
+      provider_config_key TEXT NOT NULL,
+      transferred_at     TEXT NOT NULL DEFAULT (datetime('now')),
+      UNIQUE (user_id, period_start, from_connection_id),
+      CHECK (from_connection_id <> to_connection_id)
+    )
+  `);
+  await db.execute(`CREATE INDEX IF NOT EXISTS connected_account_charge_transfers_destination ON connected_account_charge_transfers(user_id, period_start, to_connection_id, transferred_at DESC)`);
   await db.execute(`
     CREATE TABLE IF NOT EXISTS billing_credits (
       idempotency_key TEXT PRIMARY KEY,

package/dist/{chunk-3TKKJQB4.js → chunk-ES25GP6C.js}

@@ -1,6 +1,6 @@
 import {
   getDb
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/lib/browser-service-env.ts
 function browserServiceApiKey() {

package/dist/{chunk-NLEAYKOC.js → chunk-GT63KEUB.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var PACKAGE_VERSION = "0.66.6";
+var PACKAGE_VERSION = "0.67.0";
 
 export {
   PACKAGE_VERSION

package/dist/{chunk-KPE52NPT.js → chunk-IHDTONZV.js}

@@ -1,6 +1,6 @@
 // release-message.json
 var release_message_default = {
-  message: "Search Console bulk URL Inspection now returns one ordered partial-result receipt without the former one-minute cutoff."
+  message: "Transparent Commons can now turn pasted images, generated image bytes, stored image artifacts, direct image URLs, or ordinary webpage URLs into one permanent Commons-hosted image before validation and publishing."
 };
 
 // src/install-terminal.ts

package/dist/{chunk-KXRWY7DZ.js → chunk-LCGTNWOT.js}

@@ -15,7 +15,7 @@ import {
   sanitizeVendorName,
   serializePublicErrorEnvelope,
   settleDebitMcIdempotent
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/api/site-extract-content-store.ts
 import { createHash } from "crypto";

package/dist/{chunk-DBWWIK7O.js → chunk-LN6N3YLK.js}

@@ -8,7 +8,7 @@ import {
 import {
   buildPublicErrorEnvelope,
   getDb
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/lib/media-extractor.ts
 import { createWriteStream, mkdirSync, rmSync } from "fs";

package/dist/{chunk-ABYBPODM.js → chunk-UL4ZKAWZ.js}

@@ -1,6 +1,6 @@
 import {
   getDb
-} from "./chunk-55B3T5L2.js";
+} from "./chunk-65FTMB7G.js";
 
 // src/api/lead-list-enrichment-repository.ts
 import { createHash, randomUUID } from "crypto";