@aaronsb/google-workspace-mcp 2.6.1 → 2.7.0

package/build/server/scratchpad/__tests__/docs-sync.test.js

@@ -0,0 +1,213 @@
+/**
+ * Tests for docs-sync — translating a scratchpad JSON-mode mutation into
+ * a Docs batchUpdate request. Pure translator; no API calls (mocked or
+ * otherwise) in this file. See issue #79.
+ */
+import { translateMutation, isRejection } from '../docs-sync.js';
+/** Minimal Docs-API-shaped JSON with one body content element. */
+function docWith(element, revisionId = 'rev-1') {
+    return JSON.stringify({
+        documentId: 'doc-1',
+        revisionId,
+        body: { content: [element] },
+    });
+}
+/** Helper — a textRun element. content/startIndex/endIndex configurable. */
+function textRunElement(content, startIndex) {
+    return {
+        startIndex,
+        endIndex: startIndex + content.length,
+        paragraph: {
+            elements: [
+                { startIndex, endIndex: startIndex + content.length, textRun: { content } },
+            ],
+            paragraphStyle: { namedStyleType: 'NORMAL_TEXT' },
+        },
+    };
+}
+const TEXT_PATH = '$.body.content[0].paragraph.elements[0].textRun.content';
+const STYLE_PATH = '$.body.content[0].paragraph.paragraphStyle.namedStyleType';
+describe('translateMutation — textRun.content path', () => {
+    it('builds deleteContentRange(start, end-1) + insertText when old content ends with \\n', () => {
+        // Trailing newline is the paragraph break — must not delete through it,
+        // or the paragraph itself disappears.
+        const beforeJson = docWith(textRunElement('Hello world\n', 1)); // endIndex = 13
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'Goodbye', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error(`unexpected rejection: ${result.reason}`);
+        expect(result.body.requests).toEqual([
+            { deleteContentRange: { range: { startIndex: 1, endIndex: 12 } } }, // end - 1 = 13 - 1
+            { insertText: { text: 'Goodbye', location: { index: 1 } } },
+        ]);
+        expect(result.body.writeControl).toEqual({ requiredRevisionId: 'rev-1' });
+    });
+    it('builds deleteContentRange(start, end) when old content has no trailing newline', () => {
+        const beforeJson = docWith(textRunElement('inline', 5)); // endIndex = 11, no trailing \n
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'inlined', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error(`unexpected rejection: ${result.reason}`);
+        expect(result.body.requests).toEqual([
+            { deleteContentRange: { range: { startIndex: 5, endIndex: 11 } } },
+            { insertText: { text: 'inlined', location: { index: 5 } } },
+        ]);
+    });
+    it('omits deleteContentRange when the run is just a paragraph-break newline', () => {
+        // oldContent='\n' → deleteEnd = endIndex - 1 = startIndex; nothing to delete.
+        const beforeJson = docWith(textRunElement('\n', 7));
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'X', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error(`unexpected rejection: ${result.reason}`);
+        expect(result.body.requests).toEqual([
+            { insertText: { text: 'X', location: { index: 7 } } },
+        ]);
+    });
+    it('rejects a newline in the new value (structural edit disguised as text)', () => {
+        const beforeJson = docWith(textRunElement('Hello\n', 1));
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'line1\nline2', beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/newline/);
+    });
+    it('rejects a non-string value', () => {
+        const beforeJson = docWith(textRunElement('x', 1));
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 42, beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/string/);
+    });
+    it('rejects when the element has no textRun (e.g. an inline image)', () => {
+        const beforeJson = docWith({
+            startIndex: 1,
+            endIndex: 2,
+            paragraph: {
+                elements: [{ startIndex: 1, endIndex: 2, inlineObjectElement: { objectId: 'img-1' } }],
+            },
+        });
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'x', beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/textRun/);
+    });
+});
+describe('translateMutation — paragraphStyle path', () => {
+    it('builds updateParagraphStyle with the element range and the leaf field mask', () => {
+        const beforeJson = docWith(textRunElement('Heading text\n', 1));
+        const result = translateMutation({ op: 'set', path: STYLE_PATH, value: 'HEADING_1', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error(`unexpected rejection: ${result.reason}`);
+        expect(result.body.requests).toEqual([{
+                updateParagraphStyle: {
+                    range: { startIndex: 1, endIndex: 14 }, // 'Heading text\n'.length = 13
+                    paragraphStyle: { namedStyleType: 'HEADING_1' },
+                    fields: 'namedStyleType',
+                },
+            }]);
+        expect(result.body.writeControl).toEqual({ requiredRevisionId: 'rev-1' });
+    });
+    it('passes the leaf field name through unchanged (alignment, direction, etc.)', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'set', path: '$.body.content[0].paragraph.paragraphStyle.alignment', value: 'CENTER', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error(`unexpected rejection: ${result.reason}`);
+        const r = result.body.requests[0];
+        expect(r.updateParagraphStyle.fields).toBe('alignment');
+        expect(r.updateParagraphStyle.paragraphStyle).toEqual({ alignment: 'CENTER' });
+    });
+    it('rejects when the element is not a paragraph', () => {
+        const beforeJson = docWith({
+            startIndex: 1, endIndex: 5,
+            table: { rows: 1, columns: 1 },
+        });
+        const result = translateMutation({ op: 'set', path: STYLE_PATH, value: 'HEADING_1', beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/paragraph/);
+    });
+});
+describe('translateMutation — rejected paths and ops', () => {
+    it('rejects an unsupported path with a guidance message', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'set', path: '$.body.content[0].paragraph.elements[0].textStyle.bold', value: true, beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result)) {
+            expect(result.reason).toMatch(/not supported/);
+            expect(result.reason).toMatch(/markdown mode/);
+        }
+    });
+    it('rejects json_delete on a docs-bound scratchpad (structural)', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'delete', path: TEXT_PATH, beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/structural/);
+    });
+    it('rejects json_insert on a docs-bound scratchpad (structural)', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'insert', path: '$.body.content', value: { paragraph: {} }, beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/structural/);
+    });
+    it('rejects when the element index is out of range', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'set', path: '$.body.content[5].paragraph.elements[0].textRun.content', value: 'y', beforeJson }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/not found/);
+    });
+    it('rejects on a malformed buffer JSON (caller surfaces "fix syntax first")', () => {
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'x', beforeJson: '{ this is not valid JSON' }, 'rev-1');
+        expect(isRejection(result)).toBe(true);
+        if (isRejection(result))
+            expect(result.reason).toMatch(/JSON/);
+    });
+});
+describe('translateMutation — writeControl.requiredRevisionId', () => {
+    it('omits writeControl when no revisionId is provided', () => {
+        // E.g. an older import that didn't capture a revisionId. The API still
+        // accepts the request, just without optimistic-concurrency protection.
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'y', beforeJson }, undefined);
+        if (isRejection(result))
+            throw new Error('unexpected rejection');
+        expect(result.body.writeControl).toBeUndefined();
+    });
+    it('includes writeControl for paragraphStyle changes as well as text', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const text = translateMutation({ op: 'set', path: TEXT_PATH, value: 'y', beforeJson }, 'rev-42');
+        const style = translateMutation({ op: 'set', path: STYLE_PATH, value: 'HEADING_2', beforeJson }, 'rev-42');
+        if (isRejection(text) || isRejection(style))
+            throw new Error('unexpected rejection');
+        expect(text.body.writeControl).toEqual({ requiredRevisionId: 'rev-42' });
+        expect(style.body.writeControl).toEqual({ requiredRevisionId: 'rev-42' });
+    });
+});
+describe('translateMutation — summary', () => {
+    it('summary names the path and (for text) the length delta', () => {
+        const beforeJson = docWith(textRunElement('Hello\n', 1));
+        const result = translateMutation({ op: 'set', path: TEXT_PATH, value: 'Goodbye', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error('unexpected rejection');
+        expect(result.summary).toMatch(/content\[0\].elements\[0\]/);
+        // 'Hello\n'.length = 6, 'Goodbye'.length = 7
+        expect(result.summary).toMatch(/6 → 7/);
+    });
+    it('summary names the paragraphStyle field for style changes', () => {
+        const beforeJson = docWith(textRunElement('x\n', 1));
+        const result = translateMutation({ op: 'set', path: STYLE_PATH, value: 'HEADING_1', beforeJson }, 'rev-1');
+        if (isRejection(result))
+            throw new Error('unexpected rejection');
+        expect(result.summary).toMatch(/paragraphStyle\.namedStyleType/);
+    });
+});
+/**
+ * Suggested next pass — handler-level integration tests that mock `execute`
+ * to cover the API-error-preserves-buffer and success-reloads-buffer cases.
+ * Co-located with this file would be reasonable; a separate file under the
+ * same dir keeps the unit-vs-integration split clear.
+ *
+ *  - API rejects (stale revisionId, structural error) → buffer preserved.
+ *  - API succeeds → reloadDocsBuffer fires, sp.lines replaced, binding
+ *    revisionId updated from the fresh response.
+ */
+//# sourceMappingURL=docs-sync.test.js.map

package/build/server/scratchpad/__tests__/docs-sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-sync.test.js","sourceRoot":"","sources":["../../../../src/server/scratchpad/__tests__/docs-sync.test.ts"],"names":[],"mappings":"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"}

package/build/server/scratchpad/adapters/import-doc.js

@@ -52,7 +52,9 @@ async function importDocJson(scratchpads, scratchpadId, email, documentId) {
             'docs', 'documents', 'get',
             '--params', JSON.stringify({ documentId }),
         ], { account: email });
-        const json = JSON.stringify(result.data, null, 2);
+        const doc = result.data;
+        const revisionId = typeof doc.revisionId === 'string' ? doc.revisionId : undefined;
+        const json = JSON.stringify(doc, null, 2);
         const lines = json.split('\n');
         scratchpads.appendRawLines(scratchpadId, lines);
         scratchpads.setFormat(scratchpadId, 'json');
@@ -60,10 +62,11 @@ async function importDocJson(scratchpads, scratchpadId, email, documentId) {
             service: 'docs',
             resourceId: documentId,
             account: email,
+            revisionId, // optimistic-concurrency seed for batchUpdate (#79)
         });
         return {
-            text: `Imported doc as JSON (${lines.length} lines) into scratchpad ${scratchpadId}.\nLive-bound to docs/${documentId} — json_set mutations will apply directly.`,
-            refs: { scratchpadId, documentId, format: 'json', linesImported: lines.length, bound: true },
+            text: `Imported doc as JSON (${lines.length} lines) into scratchpad ${scratchpadId}.\nLive-bound to docs/${documentId} — json_set mutations push back via batchUpdate.`,
+            refs: { scratchpadId, documentId, format: 'json', linesImported: lines.length, bound: true, revisionId },
         };
     }
     catch (err) {

package/build/server/scratchpad/adapters/import-doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-doc.js","sourceRoot":"","sources":["../../../../src/server/scratchpad/adapters/import-doc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"import-doc.js","sourceRoot":"","sources":["../../../../src/server/scratchpad/adapters/import-doc.ts"],"names":[],"mappings":"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"}

package/build/server/scratchpad/adapters/send-calendar.js

@@ -25,7 +25,7 @@ export async function sendCalendarEvent(scratchpads, scratchpadId, targetParams)
     if (location)
         args.push('--location', location);
     if (attendees)
-        args.push('--attendees', attendees);
+        args.push('--attendee', attendees);
     try {
         const result = await execute(args, { account: email });
         const data = result.data;

package/build/server/scratchpad/adapters/send-calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"send-calendar.js","sourceRoot":"","sources":["../../../../src/server/scratchpad/adapters/send-calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAW3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAA8B,EAC9B,YAAoB,EACpB,YAAiC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,cAAc,YAAY,aAAa,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC;IACzE,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,4FAA4F,YAAY,mBAAmB;YACjI,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,GAAG;QACZ,eAAe,EAAE,OAAO;KACzB,CAAC;IACF,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA+B,CAAC;QAEpD,OAAO;YACL,IAAI,EAAE,oBAAoB,OAAO,QAAQ;gBACvC,aAAa,KAAK,MAAM,GAAG,IAAI;gBAC/B,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,wCAAwC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW;gBAC7E,iBAAiB,IAAI,CAAC,EAAE,IAAI,SAAS,EAAE;gBACvC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC;YAC5C,IAAI,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,IAAI,EAAE,gBAAgB,OAAO,gBAAgB,YAAY,mBAAmB;YAC5E,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;SACpC,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"send-calendar.js","sourceRoot":"","sources":["../../../../src/server/scratchpad/adapters/send-calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAW3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAA8B,EAC9B,YAAoB,EACpB,YAAiC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,cAAc,YAAY,aAAa,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC;IACzE,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,4FAA4F,YAAY,mBAAmB;YACjI,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,SAAS;QACrB,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,GAAG;QACZ,eAAe,EAAE,OAAO;KACzB,CAAC;IACF,IAAI,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,MAAM,CAAC,IAA+B,CAAC;QAEpD,OAAO;YACL,IAAI,EAAE,oBAAoB,OAAO,QAAQ;gBACvC,aAAa,KAAK,MAAM,GAAG,IAAI;gBAC/B,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,wCAAwC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW;gBAC7E,iBAAiB,IAAI,CAAC,EAAE,IAAI,SAAS,EAAE;gBACvC,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC;YAC5C,IAAI,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,IAAI,EAAE,gBAAgB,OAAO,gBAAgB,YAAY,mBAAmB;YAC5E,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE;SACpC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/server/scratchpad/docs-sync.d.ts

@@ -0,0 +1,65 @@
+/**
+ * docs-sync — translate a single JSON-mode mutation into a Google Docs
+ * `batchUpdate` request, or reject it.
+ *
+ * Issue #79 / deferred portion of ADR-301. The scratchpad JSON-mode buffer
+ * for a Doc lets agents do `json_set` on a typed path; this module turns
+ * those intents into the discrete operations the Docs API requires
+ * (`insertText`, `deleteContentRange`, `updateParagraphStyle`) — no full
+ * JSON replace endpoint exists.
+ *
+ * Two supported path shapes:
+ *
+ *  1. `$.body.content[N].paragraph.elements[M].textRun.content`
+ *     Text content change → `deleteContentRange(startIndex, endIndex)` +
+ *     `insertText(text=newValue, location.index=startIndex)`. Watch the
+ *     trailing-newline trap: a textRun whose content ends with `\n` includes
+ *     the paragraph break in its range; deleting through it removes the
+ *     paragraph. We delete `endIndex - 1` in that case to preserve the break.
+ *     A `\n` in the new value is rejected — that's a structural edit dressed
+ *     as a text change.
+ *
+ *  2. `$.body.content[N].paragraph.paragraphStyle.<field>`
+ *     Paragraph style change → `updateParagraphStyle` over the element's
+ *     range with `fields: <field>`. We don't pre-validate the field name —
+ *     the API rejects unknown fields cleanly and we surface its message.
+ *
+ * Anything else (structural edits, table cells, list items, image
+ * properties, root-level changes) is rejected with guidance to use markdown
+ * mode + doc_create / doc_write for structural authoring.
+ *
+ * Optimistic concurrency: every translation includes
+ * `writeControl.requiredRevisionId` = the revisionId captured at import time
+ * (or after the previous successful sync). The Docs API rejects stale
+ * writes — the agent gets a clean error rather than silently corrupting a
+ * doc that's been edited by a collaborator since import.
+ */
+export type DocsSyncOp = 'set' | 'delete' | 'insert';
+export interface DocsSyncIntent {
+    op: DocsSyncOp;
+    path: string;
+    /** New value for `set` / `insert`; undefined for `delete`. */
+    value?: unknown;
+    /** Pre-mutation buffer JSON text (for looking up startIndex/endIndex/oldContent). */
+    beforeJson: string;
+}
+/** Successful translation — body to POST to documents.batchUpdate. */
+export interface DocsSyncRequest {
+    body: {
+        requests: Array<Record<string, unknown>>;
+        writeControl?: {
+            requiredRevisionId: string;
+        };
+    };
+    /** A human-readable summary of what was translated, for the response text. */
+    summary: string;
+}
+/** Rejection — caller surfaces `reason` to the agent. */
+export interface DocsSyncRejection {
+    reason: string;
+}
+export type DocsSyncResult = DocsSyncRequest | DocsSyncRejection;
+/** Translate a mutation intent into a batchUpdate request, or reject it. */
+export declare function translateMutation(intent: DocsSyncIntent, revisionId: string | undefined): DocsSyncResult;
+/** Type guard — narrows DocsSyncResult to the rejection arm. */
+export declare function isRejection(result: DocsSyncResult): result is DocsSyncRejection;

package/build/server/scratchpad/docs-sync.js

@@ -0,0 +1,191 @@
+/**
+ * docs-sync — translate a single JSON-mode mutation into a Google Docs
+ * `batchUpdate` request, or reject it.
+ *
+ * Issue #79 / deferred portion of ADR-301. The scratchpad JSON-mode buffer
+ * for a Doc lets agents do `json_set` on a typed path; this module turns
+ * those intents into the discrete operations the Docs API requires
+ * (`insertText`, `deleteContentRange`, `updateParagraphStyle`) — no full
+ * JSON replace endpoint exists.
+ *
+ * Two supported path shapes:
+ *
+ *  1. `$.body.content[N].paragraph.elements[M].textRun.content`
+ *     Text content change → `deleteContentRange(startIndex, endIndex)` +
+ *     `insertText(text=newValue, location.index=startIndex)`. Watch the
+ *     trailing-newline trap: a textRun whose content ends with `\n` includes
+ *     the paragraph break in its range; deleting through it removes the
+ *     paragraph. We delete `endIndex - 1` in that case to preserve the break.
+ *     A `\n` in the new value is rejected — that's a structural edit dressed
+ *     as a text change.
+ *
+ *  2. `$.body.content[N].paragraph.paragraphStyle.<field>`
+ *     Paragraph style change → `updateParagraphStyle` over the element's
+ *     range with `fields: <field>`. We don't pre-validate the field name —
+ *     the API rejects unknown fields cleanly and we surface its message.
+ *
+ * Anything else (structural edits, table cells, list items, image
+ * properties, root-level changes) is rejected with guidance to use markdown
+ * mode + doc_create / doc_write for structural authoring.
+ *
+ * Optimistic concurrency: every translation includes
+ * `writeControl.requiredRevisionId` = the revisionId captured at import time
+ * (or after the previous successful sync). The Docs API rejects stale
+ * writes — the agent gets a clean error rather than silently corrupting a
+ * doc that's been edited by a collaborator since import.
+ */
+import { parsePath } from './json-path.js';
+/** Translate a mutation intent into a batchUpdate request, or reject it. */
+export function translateMutation(intent, revisionId) {
+    // `json_delete` and `json_insert` only ever shape up as structural edits in
+    // a Docs document (removing a paragraph, inserting into the content array).
+    // The Docs API has no JSON-replace primitive; structural changes need
+    // distinct operations per element type. Out of scope for #79 — reject so
+    // the agent uses markdown mode (re-author + doc_create / doc_write).
+    if (intent.op === 'delete' || intent.op === 'insert') {
+        return {
+            reason: `json_${intent.op} on a docs-bound scratchpad is structural — use markdown mode (export the doc, edit, doc_create or doc_write).`,
+        };
+    }
+    const segments = parsePath(intent.path);
+    if (isTextRunContentPath(segments)) {
+        return translateTextContent(intent, segments, revisionId);
+    }
+    if (isParagraphStylePath(segments)) {
+        return translateParagraphStyle(intent, segments, revisionId);
+    }
+    return {
+        reason: `path ${intent.path} is not supported for live Docs sync. Supported: '$.body.content[N].paragraph.elements[M].textRun.content' (text) and '$.body.content[N].paragraph.paragraphStyle.<field>' (paragraph style). For structural edits use markdown mode.`,
+    };
+}
+// ── Path-shape matchers ──────────────────────────────────────
+function isTextRunContentPath(segments) {
+    return segments.length === 8
+        && segments[0] === 'body'
+        && segments[1] === 'content'
+        && typeof segments[2] === 'number'
+        && segments[3] === 'paragraph'
+        && segments[4] === 'elements'
+        && typeof segments[5] === 'number'
+        && segments[6] === 'textRun'
+        && segments[7] === 'content';
+}
+function isParagraphStylePath(segments) {
+    return segments.length === 6
+        && segments[0] === 'body'
+        && segments[1] === 'content'
+        && typeof segments[2] === 'number'
+        && segments[3] === 'paragraph'
+        && segments[4] === 'paragraphStyle'
+        && typeof segments[5] === 'string';
+}
+// ── Translators ──────────────────────────────────────────────
+function translateTextContent(intent, segments, revisionId) {
+    if (typeof intent.value !== 'string') {
+        return { reason: `textRun.content value must be a string, got ${typeof intent.value}` };
+    }
+    // A newline in the new value adds a paragraph break — that's a structural
+    // edit, not a text-content edit. Rejecting keeps the supported surface
+    // narrow and predictable; structural authoring belongs in markdown mode.
+    if (intent.value.includes('\n')) {
+        return { reason: 'newline in new value is a structural edit (adds a paragraph break) — use markdown mode for multi-paragraph content.' };
+    }
+    const contentIdx = segments[2];
+    const elementIdx = segments[5];
+    let doc;
+    try {
+        doc = JSON.parse(intent.beforeJson);
+    }
+    catch {
+        return { reason: 'buffer JSON parse failed — fix syntax errors before sync.' };
+    }
+    const element = navigate(doc, ['body', 'content', contentIdx, 'paragraph', 'elements', elementIdx]);
+    if (!element || typeof element !== 'object') {
+        return { reason: `element at body.content[${contentIdx}].paragraph.elements[${elementIdx}] not found in buffer.` };
+    }
+    const e = element;
+    const startIndex = e.startIndex;
+    const endIndex = e.endIndex;
+    const textRun = e.textRun;
+    const oldContent = textRun?.content;
+    if (typeof startIndex !== 'number' || typeof endIndex !== 'number') {
+        return { reason: `element at content[${contentIdx}].elements[${elementIdx}] is missing startIndex/endIndex.` };
+    }
+    if (typeof oldContent !== 'string') {
+        return { reason: `element at content[${contentIdx}].elements[${elementIdx}] is not a textRun (or has no content).` };
+    }
+    // Trailing-newline trap: if the run's content ends with `\n`, that newline
+    // IS the paragraph break. Deleting through endIndex removes the paragraph;
+    // delete through endIndex-1 instead and the paragraph survives.
+    const deleteEnd = oldContent.endsWith('\n') ? endIndex - 1 : endIndex;
+    // Defensive: if the element is a bare-newline run (oldContent === '\n'),
+    // there's nothing to delete; just insert.
+    const requests = [];
+    if (deleteEnd > startIndex) {
+        requests.push({
+            deleteContentRange: { range: { startIndex, endIndex: deleteEnd } },
+        });
+    }
+    requests.push({
+        insertText: { text: intent.value, location: { index: startIndex } },
+    });
+    return {
+        body: {
+            requests,
+            ...(revisionId ? { writeControl: { requiredRevisionId: revisionId } } : {}),
+        },
+        summary: `text content @ content[${contentIdx}].elements[${elementIdx}] (${oldContent.length} → ${intent.value.length} chars)`,
+    };
+}
+function translateParagraphStyle(intent, segments, revisionId) {
+    const contentIdx = segments[2];
+    const field = segments[5];
+    let doc;
+    try {
+        doc = JSON.parse(intent.beforeJson);
+    }
+    catch {
+        return { reason: 'buffer JSON parse failed — fix syntax errors before sync.' };
+    }
+    const structural = navigate(doc, ['body', 'content', contentIdx]);
+    if (!structural || typeof structural !== 'object') {
+        return { reason: `content[${contentIdx}] not found in buffer.` };
+    }
+    const s = structural;
+    const startIndex = s.startIndex;
+    const endIndex = s.endIndex;
+    if (typeof startIndex !== 'number' || typeof endIndex !== 'number') {
+        return { reason: `content[${contentIdx}] is missing startIndex/endIndex.` };
+    }
+    if (!s.paragraph) {
+        return { reason: `content[${contentIdx}] is not a paragraph (paragraphStyle only applies to paragraphs).` };
+    }
+    return {
+        body: {
+            requests: [{
+                    updateParagraphStyle: {
+                        range: { startIndex, endIndex },
+                        paragraphStyle: { [field]: intent.value },
+                        fields: field,
+                    },
+                }],
+            ...(revisionId ? { writeControl: { requiredRevisionId: revisionId } } : {}),
+        },
+        summary: `paragraphStyle.${field} @ content[${contentIdx}]`,
+    };
+}
+// ── Helpers ──────────────────────────────────────────────────
+function navigate(obj, segments) {
+    let current = obj;
+    for (const seg of segments) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[String(seg)];
+    }
+    return current;
+}
+/** Type guard — narrows DocsSyncResult to the rejection arm. */
+export function isRejection(result) {
+    return 'reason' in result;
+}
+//# sourceMappingURL=docs-sync.js.map

package/build/server/scratchpad/docs-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-sync.js","sourceRoot":"","sources":["../../../src/server/scratchpad/docs-sync.ts"],"names":[],"mappings":"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"}