@se-studio/contentful-cms 3.2.1 → 3.4.0

package/dist/output/print.js.map

@@ -1 +1 @@
-{"version":3,"file":"print.js","sourceRoot":"","sources":["../../src/output/print.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW;YACd,OAAO,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,GAAW;IACxC,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../src/output/print.ts"],"names":[],"mappings":"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"}

package/dist/runtime/context.d.ts

@@ -1,6 +1,7 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 import type { CmsEditConfig } from '../config/types.js';
 import type { IndexCacheStore } from '../index/cache-store.js';
+import type { MediaPipelineJobStore } from '../media-pipeline/job-store.js';
 import type { SessionStore } from '../session/session-store.js';
 import type { StagedUploadStore } from '../staged-upload/store.js';
 export interface ContentfulUserIdentity {
@@ -18,6 +19,10 @@ export interface CmsEditRuntimeContext {
     user?: ContentfulUserIdentity;
     /** Staged file uploads for hosted asset upload (Redis). */
     stagedUploadStore?: StagedUploadStore;
+    /** Media pipeline job ownership + rate limits (Redis on hosted). */
+    mediaPipelineJobStore?: MediaPipelineJobStore;
+    /** Hosted project key (e.g. se2026) for media job bindings / logs. */
+    projectKey?: string;
 }
 export declare const cmsEditContext: AsyncLocalStorage<CmsEditRuntimeContext>;
 export declare function getRuntimeContext(): CmsEditRuntimeContext | undefined;

package/dist/runtime/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,eAAO,MAAM,cAAc,0CAAiD,CAAC;AAE7E,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,0CAAiD,CAAC;AAE7E,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,qBAAqB,EAC9B,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhB"}

package/dist/runtime/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAwBrD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAE7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA8B,EAC9B,EAAwB;IAExB,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA6BrD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAE7E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA8B,EAC9B,EAAwB;IAExB,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/session/dirty.d.ts

@@ -0,0 +1,20 @@
+import type { SessionState } from './state.js';
+/** True when the session has staged field edits or pending deletions. */
+export declare function isSessionDirty(session: SessionState): boolean;
+export interface DirtyOpenErrorPayload {
+    code: 'SESSION_DIRTY';
+    unsavedChanges: number;
+    pendingDeletions: number;
+    rootEntryId: string;
+    rootEntryType: string;
+    actions: string[];
+}
+export interface DirtyOpenError {
+    message: string;
+    payload: DirtyOpenErrorPayload;
+}
+/**
+ * Agent-facing hard-fail when `open` would replace a session that still has local work.
+ */
+export declare function formatDirtyOpenError(session: SessionState): DirtyOpenError;
+//# sourceMappingURL=dirty.d.ts.map

package/dist/session/dirty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty.d.ts","sourceRoot":"","sources":["../../src/session/dirty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE7D;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,CAsC1E"}

package/dist/session/dirty.js

@@ -0,0 +1,44 @@
+/** True when the session has staged field edits or pending deletions. */
+export function isSessionDirty(session) {
+    return session.modifiedEntryIds.length > 0 || session.pendingDeletions.length > 0;
+}
+/**
+ * Agent-facing hard-fail when `open` would replace a session that still has local work.
+ */
+export function formatDirtyOpenError(session) {
+    const unsavedChanges = session.modifiedEntryIds.length;
+    const pendingDeletions = session.pendingDeletions.length;
+    const rootEntryId = session.rootEntryId;
+    const rootEntryType = session.rootEntryType;
+    const actions = [
+        'cms-edit open --resume',
+        'cms-edit diff',
+        'cms-edit save',
+        'cms-edit discard',
+        'cms-edit open --overwrite --id <entryId>',
+    ];
+    const message = [
+        `Cannot open: session has ${unsavedChanges} unsaved entry change(s) and ${pendingDeletions} pending deletion(s).`,
+        `Root: ${rootEntryId} (${rootEntryType}) — continue this work, or explicitly abandon it.`,
+        '',
+        '  Continue current work:  cms-edit open --resume',
+        '  Review changes:         cms-edit diff',
+        '  Save drafts:            cms-edit save',
+        '  Abandon all staged:     cms-edit discard',
+        '  Abandon and open new:   cms-edit open --overwrite --id <entryId>',
+        '',
+        'Do not re-run open without --overwrite while changes are staged — that previously wiped session field edits.',
+    ].join('\n');
+    return {
+        message,
+        payload: {
+            code: 'SESSION_DIRTY',
+            unsavedChanges,
+            pendingDeletions,
+            rootEntryId,
+            rootEntryType,
+            actions,
+        },
+    };
+}
+//# sourceMappingURL=dirty.js.map

package/dist/session/dirty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirty.js","sourceRoot":"","sources":["../../src/session/dirty.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;AACpF,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACvD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACzD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE5C,MAAM,OAAO,GAAG;QACd,wBAAwB;QACxB,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,0CAA0C;KAC3C,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,4BAA4B,cAAc,gCAAgC,gBAAgB,uBAAuB;QACjH,SAAS,WAAW,KAAK,aAAa,mDAAmD;QACzF,EAAE;QACF,kDAAkD;QAClD,yCAAyC;QACzC,yCAAyC;QACzC,4CAA4C;QAC5C,oEAAoE;QACpE,EAAE;QACF,8GAA8G;KAC/G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,OAAO;QACP,OAAO,EAAE;YACP,IAAI,EAAE,eAAe;YACrB,cAAc;YACd,gBAAgB;YAChB,WAAW;YACX,aAAa;YACb,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/docs/editor-tasks/media-pipeline-prepare.md

@@ -1,8 +1,8 @@
 # Capability: Media pipeline — prepare pack
 
-Normalize a **folder of designer masters** (or inline files) into short-lived **public HTTPS URLs** under cms-edit upload limits, then import into Contentful with reuse-first.
+Normalize a **folder of designer masters** into short-lived **public HTTPS URLs** under cms-edit upload limits, then import into Contentful with reuse-first.
 
-**Never** expect this service to write Contentful. Pipeline → ready URLs only. **cms-edit** owns assets/entries.
+**Never** expect the media pipeline service to write Contentful. Pipeline → ready URLs only. **cms-edit** owns assets/entries.
 
 ## Intent phrases
 
@@ -19,13 +19,14 @@ Normalize a **folder of designer masters** (or inline files) into short-lived **
 
 ## Prerequisites
 
-- Media pipeline base URL (ops default for SE Studio: `https://se-media-pipeline.vercel.app`)
-- API bearer key (ops secret — e.g. env `MEDIA_PIPELINE_API_KEY` or site runbook; never invent)
-- Tenant id: `se` | `om1` | … (explicit; never infer only from Drive URL)
-- Drive folder **shared Viewer** with pipeline service account  
+- Hosted cms-edit with media pipeline **configured on the host** (ops env):
+  - `MEDIA_PIPELINE_BASE_URL`
+  - `MEDIA_PIPELINE_SERVICE_KEY` (server-only — **never ask the agent/user for this**)
+  - `MEDIA_PIPELINE_TENANT` (e.g. `se`, not the cms-edit projectKey)
+- Drive folder shared **Viewer** with pipeline service account  
   `media-pipeline-reader@se-media-pipeline.iam.gserviceaccount.com`  
-  (or “anyone with the link” if using API-key-only mode)
-- Profile default: `case-study-v1` (images ≤ ~3.5MB, videos H.264 mp4 ≤ ~8MB)
+  (or “anyone with the link” if using API-key Drive mode on the pipeline)
+- Profile default: `case-study-v1`
 
 ## When to use
 
@@ -35,94 +36,89 @@ Normalize a **folder of designer masters** (or inline files) into short-lived **
 | Single small image already in library | `task-media-reuse-and-upload` only |
 | Masters already under limits and catalogued | Reuse search only |
 
-## Steps
+## Steps (agent — single auth)
 
-### 1. Confirm job inputs
+### 1. Prepare
 
-1. Tenant (`se`, `om1`, …)
-2. Profile (`case-study-v1` unless overridden)
-3. Source:
-   - **Preferred:** `google_drive_folder` + folder URL  
-   - **Dev/test:** `inline_files` with base64 (small files only)
-4. Optional: `ttlHours` (1–24, default 24), `namingPrefix` (defaults from tenant)
-
-### 2. Start the pack job
-
-```http
-POST {MEDIA_PIPELINE_BASE}/api/v1/jobs
-Authorization: Bearer {MEDIA_PIPELINE_API_KEY}
-Content-Type: application/json
+Call MCP tool **`cms_edit_media`**:
 
+```json
 {
-  "tenant": "se",
-  "profile": "case-study-v1",
-  "source": {
-    "type": "google_drive_folder",
-    "url": "https://drive.google.com/drive/folders/…"
-  },
-  "options": { "ttlHours": 24 }
+  "action": "prepare",
+  "driveFolderUrl": "https://drive.google.com/drive/folders/…",
+  "profile": "case-study-v1"
 }
 ```
 
-Expect **202** with `jobId`, `runId`, `statusUrl` / poll path.
+CLI: `cms-edit media prepare --drive-folder "https://drive.google.com/drive/folders/…"`
+
+Expect `{ ok: true, jobId, status: "queued", pollHint }`.
+
+If `{ ok: false, code: "pipeline_unconfigured" }` → host ops must set env vars. **Do not** ask the user for a pipeline API key.
+
+### 2. Wait / status
+
+```json
+{ "action": "wait", "jobId": "<jobId>" }
+```
 
-### 3. Poll until terminal
+or
 
-```http
-GET {MEDIA_PIPELINE_BASE}/api/v1/jobs/{jobId}?tenant={tenant}
-Authorization: Bearer {MEDIA_PIPELINE_API_KEY}
+```json
+{ "action": "status", "jobId": "<jobId>" }
 ```
 
 Statuses: `queued` → `running` → `succeeded` | `partial` | `failed`.
 
 - **succeeded** — all files ready  
-- **partial** — some ready; `gaps[]` lists failures (e.g. quality floor)  
+- **partial** — some ready; `gaps[]` lists failures  
 - **failed** — nothing usable; stop and report gaps  
 
-**Do not** invent assets for gaps. Carry gaps into source-readiness / GO-WITH-GAPS.
+**Do not** invent assets for gaps.
 
-### 4. Map pack → Contentful (reuse-first)
-
-For **each** ready asset in `assets[]`:
-
-1. `cms_edit ["index", "sync"]` once per session if catalog may be stale  
-2. Search: `asset search` / `--filename-match` using `fileName` or source stem  
-3. If no match: **prefer URL upload** (ready URLs are already under limits):
+### 3. Catalog
 
+```json
+{ "action": "catalog", "jobId": "<jobId>" }
 ```
-cms_edit ["asset", "upload", "--url", "<assets[i].url>", "--mime", "<mime>", "--file-name", "<fileName>", "--title", "<titleDraft>", "--if-exists-by-filename"]
-```
 
-Hosted MCP: `--url` is preferred for pipeline packs. Staged upload only if URL fetch fails (then download is unnecessary — pipeline already normalized).
+Each asset includes:
+
+| Field | Use |
+|-------|-----|
+| `readyUrl` | `asset upload --url` into Contentful |
+| `previewUrl` / `posterUrl` | Agent vision for **title / fileName / alt** (when present) |
+| `altDraft` / `titleDraft` | Filename seeds only — improve before save |
 
-4. Set alt / description from `altDraft` when the site workflow requires it (`asset set` / asset fields per site)  
-5. Create **Media** wrappers only when needed; **reuse** existing Media entries by asset id  
-6. Record map: `sourceName` → `{ assetId, mediaId?, readyUrl }` for the article/page build  
+### 4. Import into Contentful (reuse-first)
 
-### 5. Hand off to structure build
+After drafting titles/alts from **previewUrl** / **posterUrl**:
 
-Return to:
+```json
+{
+  "action": "import",
+  "jobId": "<jobId>",
+  "withMedia": true,
+  "overrides": [
+    { "sourceName": "OM1_Hero.jpg", "title": "OM1 hero", "alt": "…" }
+  ]
+}
+```
 
-- `task-create-from-document` / `task-create-article` / customer case-study task  
-- Soft-proof component order with **real** asset/media ids in the plan  
+Optional: `"dryRun": true` to preview the map without writing.
 
-## Confirmation gates
+CLI: `cms-edit media import --job <id> [--dry-run] [--with-media] [--overrides-json '[…]']`
 
-1. Report pipeline `status` + asset count + `gaps` before CMS uploads  
-2. Report reuse hits vs new uploads  
-3. Do not start multi-block article create until the pack map is complete (or gaps accepted as GO-WITH-GAPS)
+Import:
 
-## Out of scope
+1. Searches existing assets by fileName  
+2. Else uploads from `readyUrl` as the authenticated Contentful user  
+3. Returns `map: { sourceName → { assetId, mediaId?, … } }` for page build  
 
-- Contentful publish  
-- Copy rewrite  
-- Pipeline writing CMA (forbidden permanently)  
-- Video/image creative edits beyond normalize  
+Manual `asset upload --url` remains available for one-offs.
 
-## Related resources
+### Hardening notes (for agents)
 
-- `task-media-reuse-and-upload`
-- `task-source-readiness-review`
-- `task-create-from-document`
-- `task-create-article`
-- `task-preview-verify`
+- Jobs are **owned by the OAuth user** who prepared them — you cannot poll another user’s `jobId`.  
+- Rate limits apply (prepares/hour, concurrent jobs).  
+- Never document or request `MEDIA_PIPELINE_API_KEY` in chat.

package/docs/help/batch.md

@@ -1,8 +1,22 @@
 # Batch edit by entry ID
 
-Edit multiple unrelated Contentful entries without opening a page tree. Useful for link variant sweeps, navigation item tweaks, and other standalone entry updates.
+Edit multiple Contentful entries by ID with scalar field updates. Useful for link variant sweeps, media flags (`autoplay`/`loop`), navigation tweaks, and other standalone updates.
 
-Batch commands use session name **`batch`** by default (override with `--session`). Page sessions from `cms-edit open` are not affected.
+## Sessions
+
+| Context | What happens |
+|---------|----------------|
+| Default CLI (`--session` omitted) | Uses session name **`batch`** (does not touch a separate page session) |
+| Page session already open (e.g. MCP `_mcp`) | `batch set` **stages into that page session** — same `diff` / `save` as article work. Do **not** re-`open`. Do **not** `batch discard` (use `cms-edit discard` only if abandoning everything). |
+| Explicit isolation | `cms-edit --session link-sweep batch set …` |
+
+You can also stay on the page session without `batch`:
+
+```bash
+cms-edit set <entryId>:autoplay=true <entryId>:loop=true
+# or
+cms-edit set <entryId> autoplay true
+```
 
 ## Workflow
 
@@ -16,17 +30,25 @@ cms-edit batch diff
 # Write all changes as drafts (single save)
 cms-edit batch save
 
-# Or discard without saving
+# Or discard without saving (pure batch sessions only)
 cms-edit batch discard
 ```
 
+Mid-page (MCP / open article session):
+
+```bash
+cms-edit batch set 5uMh54rIsJRFRQSXDuJiG:autoplay=true
+cms-edit diff
+cms-edit save
+```
+
 ## Token format
 
 ```
 <entryId>:<fieldId>=<value>
 ```
 
-- **entryId** — 22-character Contentful entry ID (no `@` prefix)
+- **entryId** — Contentful entry ID (alphanumeric, optional `_`/`-`, length 1–64; **not** fixed at 22 characters)
 - **fieldId** — field name on that entry's content type
 - **value** — literal token (no shell quotes needed for simple strings). Coercion follows the field type from Contentful:
   - **Symbol** / **Text** — always stored as strings (e.g. `order=42` stays `"42"`)
@@ -39,6 +61,7 @@ Examples:
 
 ```bash
 cms-edit batch set abcdefghijklmnopqrstuv:variant=link
+cms-edit batch set 5uMh54rIsJRFRQSXDuJiG:autoplay=true
 cms-edit batch set abcdefghijklmnopqrstuv:cmsLabel=Footer CTA
 ```
 
@@ -60,7 +83,7 @@ When a page is already open, prefer `cms-edit links set @cN <index> variant link
 
 Field types and enum validations are loaded from the Contentful Management API. Results are cached:
 
-- In the **batch session file** (`contentTypes` on the session) so `batch set` → `batch save` reuse schema without extra API calls
+- In the **session file** (`contentTypes` on the session) so `batch set` → save reuse schema without extra API calls
 - On disk at `~/.contentful-cms/content-types/<spaceId>/<environment>/` (24-hour TTL)
 
 ## v1 limits
@@ -68,11 +91,4 @@ Field types and enum validations are loaded from the Contentful Management API.
 - **Scalar fields only** — no rich text, entry links, asset links, or link arrays
 - **Draft-only** — same as `cms-edit save`; never publishes
 - **No cross-entry link arrays** — use page session + `cms-edit set --links` for parent arrays
-- **Partial save on failure** — if one entry fails during `batch save`, earlier entries may already be saved; the CLI lists failures and reminds you to run `cms-edit batch diff` for remaining changes
-
-## Named sessions
-
-```bash
-cms-edit --session link-sweep batch set idOne123456789012345678:variant=link
-cms-edit --session link-sweep batch save
-```
+- **Partial save on failure** — if one entry fails during `batch save`, earlier entries may already be saved; the CLI lists failures and reminds you to run diff for remaining changes

package/docs/help/index.md

@@ -84,6 +84,10 @@ cms-edit batch run --json '[...]'
 | Command | Description |
 |---|---|
 | `open --page-slug <slug>` | Load a page into the session (see `help lookup`) |
+| `open --resume` | Re-print active session; **keeps** staged edits (no refetch) |
+| `open --overwrite …` | Replace session even if dirty (discards staged field edits) |
+| `set <ref\|id> <field> <value>` | Set field; bare entry IDs allowed mid-session |
+| `set <id>:field=value …` | Scalar multi-set by entry ID (stays on current session) |
 | `open --id <id>` | Load by Contentful entry ID |
 | `peek --page-slug <slug>` | Print content tree + root field values without creating a session |
 | `peek --id <id>` | Same by Contentful entry ID |
@@ -137,7 +141,7 @@ cms-edit batch run --json '[...]'
 ### Batch Operations
 | Command | Description |
 |---|---|
-| `batch set <entryId>:field=value …` | Queue scalar updates on multiple entries by ID |
+| `batch set <entryId>:field=value …` | Queue scalar updates by ID (page session OK mid-edit; then `save`) |
 | `batch diff` / `batch save` / `batch discard` | Review and commit batch session |
 | `batch run --json <json> or --json-base64 <encoded>` | Execute a JSON batch of operations |
 

package/docs/help/workflow.md

@@ -26,6 +26,25 @@ cms-edit open --id 4xKpzQ2abc123
 
 `open` fetches the full entry tree and saves it to a local session file. All subsequent commands operate on this session without re-fetching from Contentful until you `save`.
 
+### Critical: do not re-open while edits are staged
+
+`set` / `rtf` / parent links from `add` stay in the session until `save`. Calling `open` again **replaces** the session.
+
+| Situation | Command |
+|-----------|---------|
+| Session has unsaved changes, need tree again | `cms-edit open --resume` (no refetch; keeps staged edits) |
+| Intentionally abandon staged work and load another entry | `cms-edit open --overwrite --id <id>` (or `discard` then `open`) |
+| Plain `open` while dirty | **Hard fail** with remediation steps |
+
+```bash
+cms-edit open --resume
+cms-edit diff
+cms-edit save
+# or abandon:
+cms-edit discard
+cms-edit open --id <other>
+```
+
 **Output:**
 ```
 ✓ Opened /solutions/hepatology (12 entries)
@@ -72,6 +91,34 @@ cms-edit set @c2 heading "New Heading"
 cms-edit set @c2 backgroundColour "Navy"
 ```
 
+### Mid-session by Contentful entry ID (e.g. media autoplay)
+
+You do **not** need to leave the page session:
+
+```bash
+# Bare entry ID (fetched into the session if not in the tree)
+cms-edit set 5uMh54rIsJRFRQSXDuJiG autoplay true
+
+# Same shape as batch set — stays on the current page session
+cms-edit set 5uMh54rIsJRFRQSXDuJiG:autoplay=true 5uMh54rIsJRFRQSXDuJiG:loop=true
+# or: cms-edit batch set … (also allowed mid-page; then cms-edit save)
+```
+
+### Entry links: `--link` vs `--links` (strict)
+
+| Field shape | Flag | Notes |
+|-------------|------|--------|
+| Single Entry link | `--link` | Exactly one id |
+| Array of Entry links | `--links` | Full replace of the array |
+| Append to array | `--links --append` | Add ids |
+| Wrong flag | hard error | Never silently coerces |
+
+```bash
+cms-edit set @c1 visual <mediaEntryId> --link
+cms-edit set @c2 contents <id1>,<id2> --links
+# To change one array item: read the array, edit the list, write all ids back with --links
+```
+
 ### Rich text fields
 ```bash
 # Inline markdown (short content)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-cms",
-  "version": "3.2.1",
+  "version": "3.4.0",
   "description": "CLI tool for AI agents to read and edit Contentful draft content without publish permissions",
   "repository": {
     "type": "git",