@scalemule/news-publication 0.0.81 → 0.0.82

package/README.md

@@ -328,15 +328,54 @@ The publisher-supplied `PawMark` preserves the approved SVG paths. Hosts may set
 
 ### Standard article submission
 
-Server tools and authorized agents use `PublicationArticleClient` from
-`@scalemule/news-publication/article-workflow`. Discover `options()` first;
-require `workflow_version: 1`. Use `submitArticle()` for a private draft plus
-managed photo staging, or `get()` and `save()` for a generation-fenced edit.
-Keep the operation key when resuming. Editorial approval and release remain
-explicit commands; acceptance does not certify scan, image or audio completion.
-The platform contract and a complete example live in
-`docs/news-platform/ARTICLE-WORKFLOW-V1.md` in the ScaleMule meta-repo.
-Do not use direct SQL, S3 paths, base64 bodies or invented media readiness.
+Submit through the server-owned API using `PublicationArticleClient` from
+`@scalemule/news-publication/article-workflow`:
+
+```ts
+const receipt = await client.submitArticle({
+  operationKey: "story-intake-v1", authorProfileId: authorId,
+  document: { title, content_markdown: body, section: "Local Business" },
+  intent: "publish",
+  assets: [{ file: photo, filename: "venue.jpg", position: "hero",
+    metadata: { alt: "Exterior of the actual venue", credit: "Photographer",
+      rights_confirmed: true } }],
+});
+```
+
+This sends **one POST** to `/v1/blog/publications/{id}/submissions`, with a
+multipart manifest and its files. JSON without files is supported by
+`client.submit(manifest, key)`. The same API accepts `article.operation: "save"`
+with the existing article ID, expected generation, complete document and revision
+reason. The server owns private Photo/Storage intake, scan checks, immutable
+media attachment, required private narration and release. Optional narration
+and missing-visual commissioning use the existing post-publication workers.
+Existing subject/editorial/sensitivity approvals still apply. `draft` is the
+safe default; `publish` requests release after the configured gates.
+
+An accepted receipt is **not** a claim that media is ready or a page has been
+verified. Read `client.submission(receipt.submission_id)` for holds, processing
+and public readiness. After a timeout, replay the identical manifest, files and
+operation key. Do not re-upload through other endpoints or create a new article.
+A foreign revision, rejected media, expired replay or unconfirmed asset intake
+stops with a retained receipt rather than silently overwriting or duplicating.
+No client-side fallback performs a separate multi-service publishing sequence.
+Discover `managed_submission_version: 1` before adopting this endpoint on an
+older server. Supported files are still JPEG/PNG/WebP photographs, not video or
+animation. Never use SQL, S3 paths, embedded binary or invented ready flags.
+
+CLI equivalents:
+
+```sh
+scalemule-article submit --publication "$PUBLICATION_ID" \
+  --manifest article.json --asset hero=./venue.jpg --operation-key story-intake-v1
+scalemule-article status --publication "$PUBLICATION_ID" --submission "$SUBMISSION_ID"
+```
+
+The manifest uses the API's snake_case fields: `article`, `intent`, and optional
+`assets: [{slot: "hero", position: "hero", metadata: {...}}]`. Each `--asset`
+matches one declared slot. Credentials are normal project/member credentials.
+The operation key is retained for 30 days. A legacy article must first have an
+explicitly selected collaboration policy; this endpoint never downgrades review.
 
 ### Edit article prose, cards and citations
 

package/bin/scalemule-article.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFile, mkdir, writeFile, rename, open, unlink } from 'node:fs/promises';
+import { readFile, stat, mkdir, writeFile, rename, open, unlink } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { dirname, join, basename } from 'node:path';
 import { createHash } from 'node:crypto';
@@ -7,6 +7,8 @@ import { parseArgs } from 'node:util';
 import { PublicationArticleClient, articlePhotoHtmlMatches,articleEditHtmlMatches } from '../dist/article-workflow-client.js';
 
 const help = `Usage:
+  scalemule-article submit --publication ID --manifest article.json --operation-key KEY [--asset hero=/path/photo.jpg]
+  scalemule-article status --publication ID --submission ID
   scalemule-article inspect --publication ID --article ID
   scalemule-article replace-cover --publication ID --article ID --file-id ID --expected-version N --metadata photo.json
   scalemule-article replace-photo --url ARTICLE_URL --file PHOTO --metadata photo.json --operation-key KEY
@@ -54,7 +56,7 @@ that every website/CDN cache already displays the new image.
 try {
   const { values, positionals } = parseArgs({
     allowPositionals: true, strict: true,
-    options: Object.fromEntries(['publication', 'article', 'file-id', 'expected-version', 'metadata', 'application-id', 'api-url', 'url', 'file', 'operation-key', 'state', 'timeout-ms','patch','expected-generation','enable-review-policy'].map(k => [k, { type: 'string' }]).concat([['help', { type: 'boolean' }],['release',{type:'boolean'}]])),
+    options: Object.fromEntries(['publication', 'article', 'file-id', 'expected-version', 'metadata', 'application-id', 'api-url', 'url', 'file', 'operation-key', 'state', 'timeout-ms','patch','expected-generation','enable-review-policy','manifest','submission'].map(k => [k, { type: 'string' }]).concat([['asset',{type:'string',multiple:true}],['help', { type: 'boolean' }],['release',{type:'boolean'}]])),
   });
   if (values.help || !positionals.length) {
     console.log(help);
@@ -64,7 +66,7 @@ try {
     const budget = Number(values['timeout-ms'] ?? (command==='edit'?10000:30000));
     if (!Number.isFinite(budget) || budget < 100 || budget > 120000) throw Error('--timeout-ms must be between 100 and 120000');
     const remaining = () => { const ms = Math.floor(budget - (performance.now()-commandStarted)); if (ms < 1) throw Error('Operation deadline reached; resume the same operation'); return ms; };
-    if (extra.length || !['inspect', 'replace-cover', 'replace-photo','edit'].includes(command)) throw Error('Use inspect, edit, replace-cover or replace-photo; see --help');
+    if (extra.length || !['submit','status','inspect', 'replace-cover', 'replace-photo','edit'].includes(command)) throw Error('Use submit, status, inspect, edit, replace-cover or replace-photo; see --help');
     if (values.url) {
       if (!process.env.SCALEMULE_API_KEY || !process.env.SCALEMULE_ACCESS_TOKEN || values['application-id']) throw Error('URL resolution requires normal publication member/API-key credentials');
       const url = new URL(values.url);
@@ -83,7 +85,7 @@ try {
       if ((values.publication && values.publication !== pub.id) || (values.article && values.article !== resolved.article.id)) throw Error('Article URL and supplied IDs disagree');
       values.publication = pub.id; values.article = resolved.article.id;
     }
-    for (const key of ['publication', 'article']) if (!values[key]) throw Error(`Missing --${key}`);
+    for (const key of (['submit','status'].includes(command)?['publication']:['publication','article'])) if (!values[key]) throw Error(`Missing --${key}`);
     if (!process.env.SCALEMULE_ACCESS_TOKEN) throw Error('SCALEMULE_ACCESS_TOKEN is required; use normal member or platform admin authorization');
     if (!values['application-id'] && !process.env.SCALEMULE_API_KEY) throw Error('Member calls also require SCALEMULE_API_KEY');
     const client = new PublicationArticleClient({
@@ -94,7 +96,22 @@ try {
       accessToken: process.env.SCALEMULE_ACCESS_TOKEN,
     });
     const started = performance.now();
-    if (command === 'inspect') {
+    if(command==='submit'){
+      for(const key of ['manifest','operation-key'])if(!values[key])throw Error('Missing --'+key);
+      const manifest=JSON.parse(await readFile(values.manifest,'utf8'));
+      const assets=[];
+      for(const entry of values.asset??[]){
+        const split=entry.indexOf('=');if(split<1)throw Error('--asset must be slot=/path/to/photo');
+        const slot=entry.slice(0,split),path=entry.slice(split+1);
+        const info=await stat(path);if(!info.isFile()||info.size<1||info.size>25*1024*1024)throw Error('Photo must be a regular file between 1 byte and 25 MiB');
+        assets.push({slot,filename:basename(path),file:new Blob([await readFile(path)])});
+      }
+      const receipt=await client.submit(manifest,values['operation-key'],assets,AbortSignal.timeout(remaining()));
+      console.log(JSON.stringify({...receipt,elapsed_ms:Math.round(performance.now()-started)},null,2));
+    }else if(command==='status'){
+      if(!values.submission)throw Error('Missing --submission');
+      console.log(JSON.stringify(await client.submission(values.submission,AbortSignal.timeout(remaining())),null,2));
+    }else if (command === 'inspect') {
       const [options, processing, collaboration] = await Promise.all([
         client.options(values.article), client.processing(values.article),
         client.get(values.article).then(current => ({ enabled: true, generation: current.generation, status: current.status })).catch(error => {

package/dist/article-workflow-client.cjs

@@ -900,143 +900,35 @@ var PublicationArticleClient = class {
       "If-Match": String(generation)
     });
   }
-  /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-   * replay the same operation key to inspect/reuse staged contributions before another transfer.
-   * Editorial approval and release are always separate explicit operations. */
-  async submitArticle(input) {
-    if (input.document.media?.length)
-      throw new Error(
-        "Pass file assets separately when creating an article package"
-      );
-    const capabilities = await this.options();
-    if (capabilities.workflow_version !== 1)
-      throw new Error("Unsupported article workflow version");
-    if (input.assets?.length && !capabilities.capabilities.managed_private_asset_upload)
-      throw new Error("Managed article upload is not deployed");
-    const created = await this.create(
-      input.operationKey,
-      input.authorProfileId,
-      input.document,
-      input.reviewPolicy
-    );
-    try {
-      const selected = [];
-      for (const asset of input.assets ?? []) {
-        let current = await this.get(created.article_id);
-        const digest3 = Array.from(
-          new Uint8Array(
-            await crypto.subtle.digest(
-              "SHA-256",
-              await asset.file.arrayBuffer()
-            )
-          )
-        ).map((v) => v.toString(16).padStart(2, "0")).join("");
-        const existing = current.contributions.find(
-          (c) => c.kind === "MEDIA" && c.state !== "REJECTED" && c.state !== "WITHDRAWN" && c.payload.sha256 === digest3 && Object.entries(asset.metadata).every(
-            ([k, v]) => c.payload[k] === v
-          )
-        );
-        const staged = existing?.payload.file_id ? { contribution_id: existing.id, file_id: existing.payload.file_id } : await this.upload(
-          created.article_id,
-          current.generation,
-          asset.file,
-          asset.filename,
-          asset.metadata
-        );
-        await this.registerPhoto(staged.file_id);
-        if (input.approveMedia) {
-          if (!asset.metadata.rights_confirmed || asset.metadata.private_preview_only)
-            throw new Error("Publication requires confirmed image rights");
-          if (existing?.state !== "APPROVED") {
-            current = await this.get(created.article_id);
-            await this.command(created.article_id, current.generation, {
-              action: "RESOLVE",
-              contribution_id: staged.contribution_id,
-              state: "APPROVED"
-            });
-          }
-          selected.push({
-            kind: "image",
-            contribution_id: staged.contribution_id,
-            file_id: staged.file_id,
-            caption: asset.metadata.caption,
-            credit: asset.metadata.credit,
-            alt: asset.metadata.alt,
-            position: asset.position
-          });
-        }
-      }
-      if (selected.length) {
-        const current = await this.get(created.article_id);
-        const document = { ...input.document, media: selected };
-        const saved = current.revisions.find(
-          (r) => r.id === current.current_revision_id
-        )?.document;
-        if (!saved) throw new Error("Current immutable revision is missing");
-        if (sameDocument(saved, document))
-          return {
-            ...created,
-            revision_id: current.current_revision_id,
-            generation: current.generation,
-            editorial_status: current.status,
-            replayed: true
-          };
-        if (!sameDocument(
-          { ...saved, media: [] },
-          { ...input.document, media: [] }
-        ) || saved.media?.length)
-          throw new ArticleWorkflowError(
-            "The article was edited after this package began; load its current revision before changing it",
-            409,
-            created.article_id
-          );
-        return await this.save(
-          `${input.operationKey}:assets`,
-          created.article_id,
-          current.generation,
-          document,
-          "MEDIA_UPDATE"
-        );
-      }
-      return created;
-    } catch (error) {
-      if (error instanceof ArticleWorkflowError) {
-        error.articleId = created.article_id;
-        throw error;
-      }
-      throw new ArticleWorkflowError(
-        error instanceof Error ? error.message : "Article package interrupted",
-        0,
-        created.article_id
-      );
-    }
+  /** One server-owned submission. No client-side Photo/TTS orchestration and no
+   * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+   * Replay the identical manifest/files/key after an uncertain acknowledgement.
+   */
+  submit(manifest, operationKey, files = [], signal) {
+    if (!operationKey) throw new Error("A stable operation key is required");
+    if (files.length > 10 || files.some((f) => f.file.size < 1 || f.file.size > 25 * 1024 * 1024) || files.reduce((n, f) => n + f.file.size, 0) > 50 * 1024 * 1024) throw new Error("Supply up to ten photographs, at most 25 MiB each and 50 MiB total");
+    const slots = new Set(files.map((f) => f.slot));
+    if (slots.size !== files.length || files.length !== (manifest.assets?.length ?? 0) || manifest.assets?.some((a) => !slots.has(a.slot))) throw new Error("Supply one file for each declared asset slot");
+    if (!files.length) return this.request("/submissions", "POST", manifest, { "Idempotency-Key": operationKey }, signal);
+    const form = new FormData();
+    form.append("manifest", JSON.stringify(manifest));
+    for (const asset of files) form.append(asset.slot, asset.file, asset.filename);
+    return this.request("/submissions", "POST", form, { "Idempotency-Key": operationKey }, signal);
+  }
+  submission(submissionId, signal) {
+    return this.request("/submissions/" + encodeURIComponent(submissionId), "GET", void 0, void 0, signal);
+  }
+  submitArticle(input) {
+    if (input.document.media?.length) throw new Error("Pass file assets separately when creating an article package");
+    const assets = (input.assets ?? []).map((a, i) => ({ ...a, slot: "asset_" + String.fromCharCode(97 + i) }));
+    return this.submit({
+      article: { operation: "create", author_profile_id: input.authorProfileId, document: input.document, review_policy: input.reviewPolicy },
+      intent: input.intent ?? "draft",
+      approve_media: input.approveMedia,
+      assets: assets.map((a) => ({ slot: a.slot, position: a.position, metadata: a.metadata }))
+    }, input.operationKey, assets);
   }
 };
-function sameDocument(a, b) {
-  const sorted = (v) => Array.isArray(v) ? v.map(sorted) : v && typeof v === "object" ? Object.fromEntries(Object.keys(v).sort().map((k) => [k, sorted(v[k])])) : v;
-  const canonical3 = (d) => [
-    d.title,
-    d.subtitle || "",
-    d.content_markdown,
-    d.excerpt ?? null,
-    sorted(d.cards ?? null),
-    sorted(d.citations ?? null),
-    d.section,
-    d.community || "",
-    d.format || null,
-    d.layout ? [d.layout.id, d.layout.version] : null,
-    (d.media || []).map((m) => [
-      m.kind || "image",
-      m.contribution_id,
-      m.file_id,
-      m.caption,
-      m.credit,
-      m.alt,
-      m.position
-    ])
-  ];
-  return JSON.stringify(canonical3(a)) === JSON.stringify(canonical3(b));
-}
 
 exports.ArticleEditOperationError = ArticleEditOperationError;
 exports.ArticlePhotoOperationError = ArticlePhotoOperationError;

package/dist/article-workflow-client.d.cts

@@ -112,13 +112,13 @@ type ArticleMedia = {
     position: "hero" | "inline" | "gallery" | "attachment";
 };
 type AssetMetadata = {
-    caption: string;
-    credit: string;
-    alt: string;
-    creator: string;
-    who_is_pictured: string;
-    when_taken: string;
-    where_taken: string;
+    caption?: string;
+    credit?: string;
+    alt?: string;
+    creator?: string;
+    who_is_pictured?: string;
+    when_taken?: string;
+    where_taken?: string;
     rights_confirmed: boolean;
     private_preview_only?: boolean;
 };
@@ -195,6 +195,8 @@ type ArticleWorkflowOptions = {
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
         versioned_editorial_fields?: boolean;
+        managed_submission_version?: number | null;
+        multipart_submission?: boolean;
     };
 };
 type ArticleOperation = {
@@ -224,6 +226,56 @@ type Record = {
         };
     }[];
 };
+type ArticleSubmissionManifest = {
+    article: {
+        operation: "create";
+        author_profile_id: string;
+        document: ArticleDocument;
+        review_policy?: string;
+        celebration_type?: string;
+    } | {
+        operation: "save";
+        article_id: string;
+        expected_generation: number;
+        document: ArticleDocument;
+        reason: string;
+    };
+    intent?: "draft" | "review" | "publish";
+    approve_media?: boolean;
+    sensitivity_review?: {
+        policy_version: string;
+        rule_ids: string[];
+        reason: string;
+    };
+    assets?: {
+        slot: string;
+        position: "hero" | "gallery" | "attachment";
+        metadata: AssetMetadata;
+    }[];
+};
+type ArticleSubmissionReceipt = {
+    submission_id: string;
+    article_id: string | null;
+    revision_id: string | null;
+    status: "intake" | "queued" | "scanning" | "narrating" | "awaiting_review" | "held" | "complete" | "published";
+    error_code: string | null;
+    status_path: string;
+    permalink_path: string | null;
+    processing: ArticleProcessing | null;
+    progress: {
+        intent: string;
+        assets: {
+            [slot: string]: {
+                state: string;
+                contribution_id?: string;
+                file_id?: string;
+            };
+        };
+    };
+    accepted_is_not_published: true;
+    public_ready: boolean;
+    next_action: string;
+};
 declare class ArticleWorkflowError extends Error {
     status: number;
     articleId?: string | undefined;
@@ -303,22 +355,30 @@ declare class PublicationArticleClient {
         kind: "image";
         state: "OPEN";
     }>;
-    /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-     * replay the same operation key to inspect/reuse staged contributions before another transfer.
-     * Editorial approval and release are always separate explicit operations. */
+    /** One server-owned submission. No client-side Photo/TTS orchestration and no
+     * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+     * Replay the identical manifest/files/key after an uncertain acknowledgement.
+     */
+    submit(manifest: ArticleSubmissionManifest, operationKey: string, files?: {
+        slot: string;
+        file: Blob;
+        filename: string;
+    }[], signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
+    submission(submissionId: string, signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
     submitArticle(input: {
         operationKey: string;
         authorProfileId: string;
         document: ArticleDocument;
         reviewPolicy?: string;
+        intent?: "draft" | "review" | "publish";
         assets?: {
             file: Blob;
             filename: string;
             metadata: AssetMetadata;
-            position: ArticleMedia["position"];
+            position: "hero" | "gallery" | "attachment";
         }[];
         approveMedia?: boolean;
-    }): Promise<ArticleOperation>;
+    }): Promise<ArticleSubmissionReceipt>;
 }
 
-export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };
+export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, type ArticleSubmissionManifest, type ArticleSubmissionReceipt, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };

package/dist/article-workflow-client.d.ts

@@ -112,13 +112,13 @@ type ArticleMedia = {
     position: "hero" | "inline" | "gallery" | "attachment";
 };
 type AssetMetadata = {
-    caption: string;
-    credit: string;
-    alt: string;
-    creator: string;
-    who_is_pictured: string;
-    when_taken: string;
-    where_taken: string;
+    caption?: string;
+    credit?: string;
+    alt?: string;
+    creator?: string;
+    who_is_pictured?: string;
+    when_taken?: string;
+    where_taken?: string;
     rights_confirmed: boolean;
     private_preview_only?: boolean;
 };
@@ -195,6 +195,8 @@ type ArticleWorkflowOptions = {
         prioritized_narration_processing?: boolean;
         content_first_editor_document?: boolean;
         versioned_editorial_fields?: boolean;
+        managed_submission_version?: number | null;
+        multipart_submission?: boolean;
     };
 };
 type ArticleOperation = {
@@ -224,6 +226,56 @@ type Record = {
         };
     }[];
 };
+type ArticleSubmissionManifest = {
+    article: {
+        operation: "create";
+        author_profile_id: string;
+        document: ArticleDocument;
+        review_policy?: string;
+        celebration_type?: string;
+    } | {
+        operation: "save";
+        article_id: string;
+        expected_generation: number;
+        document: ArticleDocument;
+        reason: string;
+    };
+    intent?: "draft" | "review" | "publish";
+    approve_media?: boolean;
+    sensitivity_review?: {
+        policy_version: string;
+        rule_ids: string[];
+        reason: string;
+    };
+    assets?: {
+        slot: string;
+        position: "hero" | "gallery" | "attachment";
+        metadata: AssetMetadata;
+    }[];
+};
+type ArticleSubmissionReceipt = {
+    submission_id: string;
+    article_id: string | null;
+    revision_id: string | null;
+    status: "intake" | "queued" | "scanning" | "narrating" | "awaiting_review" | "held" | "complete" | "published";
+    error_code: string | null;
+    status_path: string;
+    permalink_path: string | null;
+    processing: ArticleProcessing | null;
+    progress: {
+        intent: string;
+        assets: {
+            [slot: string]: {
+                state: string;
+                contribution_id?: string;
+                file_id?: string;
+            };
+        };
+    };
+    accepted_is_not_published: true;
+    public_ready: boolean;
+    next_action: string;
+};
 declare class ArticleWorkflowError extends Error {
     status: number;
     articleId?: string | undefined;
@@ -303,22 +355,30 @@ declare class PublicationArticleClient {
         kind: "image";
         state: "OPEN";
     }>;
-    /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-     * replay the same operation key to inspect/reuse staged contributions before another transfer.
-     * Editorial approval and release are always separate explicit operations. */
+    /** One server-owned submission. No client-side Photo/TTS orchestration and no
+     * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+     * Replay the identical manifest/files/key after an uncertain acknowledgement.
+     */
+    submit(manifest: ArticleSubmissionManifest, operationKey: string, files?: {
+        slot: string;
+        file: Blob;
+        filename: string;
+    }[], signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
+    submission(submissionId: string, signal?: AbortSignal): Promise<ArticleSubmissionReceipt>;
     submitArticle(input: {
         operationKey: string;
         authorProfileId: string;
         document: ArticleDocument;
         reviewPolicy?: string;
+        intent?: "draft" | "review" | "publish";
         assets?: {
             file: Blob;
             filename: string;
             metadata: AssetMetadata;
-            position: ArticleMedia["position"];
+            position: "hero" | "gallery" | "attachment";
         }[];
         approveMedia?: boolean;
-    }): Promise<ArticleOperation>;
+    }): Promise<ArticleSubmissionReceipt>;
 }
 
-export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };
+export { type ArticleDocument, type ArticleEditCheckpoint, type ArticleEditInput, ArticleEditOperationError, type ArticleEditPatch, type ArticleMedia, type ArticleOperation, type ArticlePhotoInput, ArticlePhotoOperationError, type ArticleProcessing, type ArticleSubmissionManifest, type ArticleSubmissionReceipt, ArticleWorkflowError, type ArticleWorkflowOptions, type AssetMetadata, type PhotoOperationCheckpoint, PublicationArticleClient, type PublishedCoverReplacement, articleEditHtmlMatches, articlePhotoHtmlMatches };

package/dist/article-workflow-client.js

@@ -898,142 +898,34 @@ var PublicationArticleClient = class {
       "If-Match": String(generation)
     });
   }
-  /** One agent operation over existing owners. Stops at conflicts/unknown upload acknowledgement;
-   * replay the same operation key to inspect/reuse staged contributions before another transfer.
-   * Editorial approval and release are always separate explicit operations. */
-  async submitArticle(input) {
-    if (input.document.media?.length)
-      throw new Error(
-        "Pass file assets separately when creating an article package"
-      );
-    const capabilities = await this.options();
-    if (capabilities.workflow_version !== 1)
-      throw new Error("Unsupported article workflow version");
-    if (input.assets?.length && !capabilities.capabilities.managed_private_asset_upload)
-      throw new Error("Managed article upload is not deployed");
-    const created = await this.create(
-      input.operationKey,
-      input.authorProfileId,
-      input.document,
-      input.reviewPolicy
-    );
-    try {
-      const selected = [];
-      for (const asset of input.assets ?? []) {
-        let current = await this.get(created.article_id);
-        const digest3 = Array.from(
-          new Uint8Array(
-            await crypto.subtle.digest(
-              "SHA-256",
-              await asset.file.arrayBuffer()
-            )
-          )
-        ).map((v) => v.toString(16).padStart(2, "0")).join("");
-        const existing = current.contributions.find(
-          (c) => c.kind === "MEDIA" && c.state !== "REJECTED" && c.state !== "WITHDRAWN" && c.payload.sha256 === digest3 && Object.entries(asset.metadata).every(
-            ([k, v]) => c.payload[k] === v
-          )
-        );
-        const staged = existing?.payload.file_id ? { contribution_id: existing.id, file_id: existing.payload.file_id } : await this.upload(
-          created.article_id,
-          current.generation,
-          asset.file,
-          asset.filename,
-          asset.metadata
-        );
-        await this.registerPhoto(staged.file_id);
-        if (input.approveMedia) {
-          if (!asset.metadata.rights_confirmed || asset.metadata.private_preview_only)
-            throw new Error("Publication requires confirmed image rights");
-          if (existing?.state !== "APPROVED") {
-            current = await this.get(created.article_id);
-            await this.command(created.article_id, current.generation, {
-              action: "RESOLVE",
-              contribution_id: staged.contribution_id,
-              state: "APPROVED"
-            });
-          }
-          selected.push({
-            kind: "image",
-            contribution_id: staged.contribution_id,
-            file_id: staged.file_id,
-            caption: asset.metadata.caption,
-            credit: asset.metadata.credit,
-            alt: asset.metadata.alt,
-            position: asset.position
-          });
-        }
-      }
-      if (selected.length) {
-        const current = await this.get(created.article_id);
-        const document = { ...input.document, media: selected };
-        const saved = current.revisions.find(
-          (r) => r.id === current.current_revision_id
-        )?.document;
-        if (!saved) throw new Error("Current immutable revision is missing");
-        if (sameDocument(saved, document))
-          return {
-            ...created,
-            revision_id: current.current_revision_id,
-            generation: current.generation,
-            editorial_status: current.status,
-            replayed: true
-          };
-        if (!sameDocument(
-          { ...saved, media: [] },
-          { ...input.document, media: [] }
-        ) || saved.media?.length)
-          throw new ArticleWorkflowError(
-            "The article was edited after this package began; load its current revision before changing it",
-            409,
-            created.article_id
-          );
-        return await this.save(
-          `${input.operationKey}:assets`,
-          created.article_id,
-          current.generation,
-          document,
-          "MEDIA_UPDATE"
-        );
-      }
-      return created;
-    } catch (error) {
-      if (error instanceof ArticleWorkflowError) {
-        error.articleId = created.article_id;
-        throw error;
-      }
-      throw new ArticleWorkflowError(
-        error instanceof Error ? error.message : "Article package interrupted",
-        0,
-        created.article_id
-      );
-    }
+  /** One server-owned submission. No client-side Photo/TTS orchestration and no
+   * fallback to a different workflow. A 202 receipt is acceptance, not readiness.
+   * Replay the identical manifest/files/key after an uncertain acknowledgement.
+   */
+  submit(manifest, operationKey, files = [], signal) {
+    if (!operationKey) throw new Error("A stable operation key is required");
+    if (files.length > 10 || files.some((f) => f.file.size < 1 || f.file.size > 25 * 1024 * 1024) || files.reduce((n, f) => n + f.file.size, 0) > 50 * 1024 * 1024) throw new Error("Supply up to ten photographs, at most 25 MiB each and 50 MiB total");
+    const slots = new Set(files.map((f) => f.slot));
+    if (slots.size !== files.length || files.length !== (manifest.assets?.length ?? 0) || manifest.assets?.some((a) => !slots.has(a.slot))) throw new Error("Supply one file for each declared asset slot");
+    if (!files.length) return this.request("/submissions", "POST", manifest, { "Idempotency-Key": operationKey }, signal);
+    const form = new FormData();
+    form.append("manifest", JSON.stringify(manifest));
+    for (const asset of files) form.append(asset.slot, asset.file, asset.filename);
+    return this.request("/submissions", "POST", form, { "Idempotency-Key": operationKey }, signal);
+  }
+  submission(submissionId, signal) {
+    return this.request("/submissions/" + encodeURIComponent(submissionId), "GET", void 0, void 0, signal);
+  }
+  submitArticle(input) {
+    if (input.document.media?.length) throw new Error("Pass file assets separately when creating an article package");
+    const assets = (input.assets ?? []).map((a, i) => ({ ...a, slot: "asset_" + String.fromCharCode(97 + i) }));
+    return this.submit({
+      article: { operation: "create", author_profile_id: input.authorProfileId, document: input.document, review_policy: input.reviewPolicy },
+      intent: input.intent ?? "draft",
+      approve_media: input.approveMedia,
+      assets: assets.map((a) => ({ slot: a.slot, position: a.position, metadata: a.metadata }))
+    }, input.operationKey, assets);
   }
 };
-function sameDocument(a, b) {
-  const sorted = (v) => Array.isArray(v) ? v.map(sorted) : v && typeof v === "object" ? Object.fromEntries(Object.keys(v).sort().map((k) => [k, sorted(v[k])])) : v;
-  const canonical3 = (d) => [
-    d.title,
-    d.subtitle || "",
-    d.content_markdown,
-    d.excerpt ?? null,
-    sorted(d.cards ?? null),
-    sorted(d.citations ?? null),
-    d.section,
-    d.community || "",
-    d.format || null,
-    d.layout ? [d.layout.id, d.layout.version] : null,
-    (d.media || []).map((m) => [
-      m.kind || "image",
-      m.contribution_id,
-      m.file_id,
-      m.caption,
-      m.credit,
-      m.alt,
-      m.position
-    ])
-  ];
-  return JSON.stringify(canonical3(a)) === JSON.stringify(canonical3(b));
-}
 
 export { ArticleEditOperationError, ArticlePhotoOperationError, ArticleWorkflowError, PublicationArticleClient, articleEditHtmlMatches, articlePhotoHtmlMatches };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.81",
+  "version": "0.0.82",
   "description": "Shared server framework for ScaleMule local news publications. Walnut Creek Times is the broadsheet default; each paper supplies its own identity and feature flags.",
   "type": "module",
   "bin": {