Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

Use Sanity HTTP publish identity and preserve document revision guards

Emre Sokulluaba32b368310
diff --git a/src/chrome/skills/cms-sanity.md b/src/chrome/skills/cms-sanity.md
index 6b8a89c05..a5fecfac7 100644
--- a/src/chrome/skills/cms-sanity.md
+++ b/src/chrome/skills/cms-sanity.md
@@ -126,9 +126,13 @@ Publish only the same verified draft through
`POST /data/actions/<DATASET>` with this JSON body:
```json
-{"actions":[{"actionType":"sanity.action.document.publish","draftId":"drafts.<ID>","publishedId":"<ID>","ifDraftRevisionId":"<DRAFT_REV>","ifPublishedRevisionId":"<PUBLISHED_REV>"}]}
+{"actions":[{"actionType":"sanity.action.document.publish","versionId":"drafts.<ID>","publishedId":"<ID>","ifDraftRevisionId":"<DRAFT_REV>","ifPublishedRevisionId":"<PUBLISHED_REV>"}]}
```
+`versionId` replaces the deprecated HTTP `draftId` alias. This document action
+uses `ifDraftRevisionId`; do not substitute the variant-publish guard
+`ifVersionRevisionId`.
+
Include the published revision guard when a published document exists; omit it
for a genuinely new item after verifying absence. Re-read both immediately before
publishing. Actions publish promotes draft contents and removes that draft; verify
diff --git a/src/firefox/skills/cms-sanity.md b/src/firefox/skills/cms-sanity.md
index 6b8a89c05..a5fecfac7 100644
--- a/src/firefox/skills/cms-sanity.md
+++ b/src/firefox/skills/cms-sanity.md
@@ -126,9 +126,13 @@ Publish only the same verified draft through
`POST /data/actions/<DATASET>` with this JSON body:
```json
-{"actions":[{"actionType":"sanity.action.document.publish","draftId":"drafts.<ID>","publishedId":"<ID>","ifDraftRevisionId":"<DRAFT_REV>","ifPublishedRevisionId":"<PUBLISHED_REV>"}]}
+{"actions":[{"actionType":"sanity.action.document.publish","versionId":"drafts.<ID>","publishedId":"<ID>","ifDraftRevisionId":"<DRAFT_REV>","ifPublishedRevisionId":"<PUBLISHED_REV>"}]}
```
+`versionId` replaces the deprecated HTTP `draftId` alias. This document action
+uses `ifDraftRevisionId`; do not substitute the variant-publish guard
+`ifVersionRevisionId`.
+
Include the published revision guard when a published document exists; omit it
for a genuinely new item after verifying absence. Re-read both immediately before
publishing. Actions publish promotes draft contents and removes that draft; verify
diff --git a/test/cms-api-first.mjs b/test/cms-api-first.mjs
index 02a5aca6a..1f2fa88fb 100644
--- a/test/cms-api-first.mjs
+++ b/test/cms-api-first.mjs
@@ -118,6 +118,23 @@ for (let n = 201; n <= 208; n++) {
for (const v of variants) {
const { browser, skills } = v;
+ test(`${browser}: Sanity publish example keeps HTTP identity and document revision guards`, () => {
+ // Contract: https://www.sanity.io/docs/http-reference/actions#documentpublishaction
+ // Sanity's PublishAction retains ifDraftRevisionId; ifVersionRevisionId
+ // belongs to PublishVariantAction, a different operation.
+ const recipe = read(`src/${browser}/skills/cms-sanity.md`);
+ const examples = [...recipe.matchAll(/```json\s+([\s\S]*?)```/g)].map(match => JSON.parse(match[1]));
+ const publishes = examples.flatMap(example => example.actions || [])
+ .filter(action => action.actionType === 'sanity.action.document.publish');
+ assert.equal(publishes.length, 1, 'validate the actual packaged publish example');
+ const publish = publishes[0];
+ assert.equal(publish.versionId, `drafts.${publish.publishedId}`, 'publish the same draft/published pair');
+ assert.equal(publish.ifDraftRevisionId, '<DRAFT_REV>', 'keep the draft optimistic lock');
+ assert.equal(publish.ifPublishedRevisionId, '<PUBLISHED_REV>', 'keep the existing-publication optimistic lock');
+ assert.equal('draftId' in publish, false, 'use the current HTTP identity field');
+ assert.equal('ifVersionRevisionId' in publish, false, 'do not mix variant and document action guards');
+ });
+
test(`${browser}: default catalog exposes all nine; only selected recipe loads in Mid/Full`, () => {
const all = records(v);
assert.ok(all.length <= skills.MAX_CUSTOM_SKILLS);