@larkup/tool-doc-editor 0.2.30 → 0.3.0

package/dist/editor.d.ts

@@ -1,12 +1,6 @@
-/**
- * Document editor — orchestrates parsing, editing, and export.
- *
- * Uses:
- * - pdf-lib (MIT) for native PDF form filling
- * - Sandbox scripts for DOCX/PPTX editing via python-docx/python-pptx
- * - In-memory session management
- */
 import type { EditorSession, FieldEdit, ContentEdit, EditResult, SignatureData } from './types.js';
+/** Hydrate isolated sessions from the host's tenant-bound persistent repository. */
+export declare function runWithDocumentSessions<T>(operation: () => T): Promise<Awaited<T>>;
 export declare function getSession(sessionId: string): EditorSession | undefined;
 export declare function getAllSessions(): EditorSession[];
 export declare function deleteSession(sessionId: string): boolean;

package/dist/editor.js

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { workspaceHost } from '@larkup/core/workspace-host';
 /**
  * Document editor — orchestrates parsing, editing, and export.
  *
@@ -11,18 +13,50 @@ import { SandboxManager } from '@larkup/sandbox';
 import { readConfig } from '@larkup/core/config-store';
 import { parseDocument, enrichPDFWithText } from './parsers.js';
 import { generateFillDOCXScript, generateFillPPTXScript, generateEditDOCXScript, generateEditPPTXScript, generateExtractPDFTextScript, } from './sandbox-scripts.js';
-const sessions = new Map();
+const localSessions = new Map();
+const sessionScope = new AsyncLocalStorage();
+function sessions() {
+    return sessionScope.getStore()?.sessions ?? localSessions;
+}
+async function persistSessions() {
+    await sessionScope.getStore()?.flush();
+}
+/** Hydrate isolated sessions from the host's tenant-bound persistent repository. */
+export async function runWithDocumentSessions(operation) {
+    const host = workspaceHost();
+    if (!host || sessionScope.getStore())
+        return await operation();
+    const stored = ((await host.readState('document-sessions')) ?? []);
+    const scoped = new Map(stored.map((session) => [session.id, session]));
+    let previous = JSON.stringify(stored);
+    let pending = Promise.resolve();
+    const flush = () => {
+        pending = pending.then(async () => {
+            const next = JSON.stringify([...scoped.values()]);
+            if (next !== previous) {
+                await host.writeState('document-sessions', JSON.parse(next));
+                previous = next;
+            }
+        });
+        return pending;
+    };
+    return await sessionScope.run({ sessions: scoped, flush }, async () => {
+        const result = await operation();
+        await flush();
+        return result;
+    });
+}
 export function getSession(sessionId) {
-    return sessions.get(sessionId);
+    return sessions().get(sessionId);
 }
 export function getAllSessions() {
-    return Array.from(sessions.values()).sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    return Array.from(sessions().values()).sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
 }
 export function deleteSession(sessionId) {
-    return sessions.delete(sessionId);
+    return sessions().delete(sessionId);
 }
 export function restoreSession(session) {
-    sessions.set(session.id, session);
+    sessions().set(session.id, session);
 }
 export async function createSession(buffer, fileName, mimeType) {
     // Parse the document
@@ -75,13 +109,14 @@ export async function createSession(buffer, fileName, mimeType) {
         createdAt: new Date().toISOString(),
         updatedAt: new Date().toISOString(),
     };
-    sessions.set(session.id, session);
+    sessions().set(session.id, session);
+    await persistSessions();
     return session;
 }
 export async function applyFieldEdits(sessionId, edits) {
-    const session = sessions.get(sessionId);
+    const session = sessions().get(sessionId);
     if (!session) {
-        console.error(`[doc-editor] Session not found: ${sessionId}. Available sessions:`, Array.from(sessions.keys()));
+        console.error(`[doc-editor] Session not found: ${sessionId}. Available sessions:`, Array.from(sessions().keys()));
         return {
             success: false,
             parsed: null,
@@ -212,6 +247,7 @@ export async function applyFieldEdits(sessionId, edits) {
         session.parsed = newParsed;
         session.edits.push(...edits);
         session.updatedAt = new Date().toISOString();
+        await persistSessions();
         return {
             success: true,
             parsed: newParsed,
@@ -231,7 +267,7 @@ export async function applyFieldEdits(sessionId, edits) {
     }
 }
 export async function applyContentEdits(sessionId, edits) {
-    const session = sessions.get(sessionId);
+    const session = sessions().get(sessionId);
     if (!session) {
         return {
             success: false,
@@ -308,6 +344,7 @@ export async function applyContentEdits(sessionId, edits) {
         session.currentFileBase64 = newBase64;
         session.parsed = newParsed;
         session.updatedAt = new Date().toISOString();
+        await persistSessions();
         return {
             success: true,
             parsed: newParsed,
@@ -326,7 +363,7 @@ export async function applyContentEdits(sessionId, edits) {
     }
 }
 export function exportDocument(sessionId) {
-    const session = sessions.get(sessionId);
+    const session = sessions().get(sessionId);
     if (!session)
         return null;
     return {
@@ -421,7 +458,7 @@ async function fillPDFNatively(buffer, edits) {
     return { buffer: Buffer.from(modifiedBytes), matchedFields };
 }
 export async function applySignature(sessionId, data) {
-    const session = sessions.get(sessionId);
+    const session = sessions().get(sessionId);
     if (!session) {
         return { success: false, error: 'Session not found' };
     }
@@ -534,7 +571,8 @@ export async function applySignature(sessionId, data) {
             session.currentFileBase64 = newBase64;
             session.parsed = newParsed;
             session.updatedAt = new Date().toISOString();
-            sessions.set(sessionId, session);
+            await persistSessions();
+            sessions().set(sessionId, session);
             return {
                 success: true,
                 parsed: newParsed,

package/dist/index.d.ts

@@ -8,7 +8,7 @@
 export declare const TOOL_META: {
     readonly id: "doc-editor";
     readonly name: "Document Editor";
-    readonly version: "0.2.28";
+    readonly version: "0.3.0";
 };
 export declare const TOOL_EXTENSION: {
     id: string;
@@ -18,3 +18,4 @@ export declare const TOOL_EXTENSION: {
 export { createSession, getSession, getAllSessions, deleteSession, restoreSession, applyFieldEdits, applyContentEdits, applySignature, exportDocument, } from './editor.js';
 export { parseDocument, parsePDF, parseDOCX, parsePPTX, parseTXT, detectDocumentType, enrichPDFWithText, } from './parsers.js';
 export type { DocumentType, DocumentField, DocumentPage, ParsedDocument, FieldEdit, ContentEdit, EditorSession, EditResult, } from './types.js';
+export { runWithDocumentSessions } from './editor.js';

package/dist/index.js

@@ -8,7 +8,7 @@
 export const TOOL_META = {
     id: 'doc-editor',
     name: 'Document Editor',
-    version: '0.2.28',
+    version: '0.3.0',
 };
 export const TOOL_EXTENSION = {
     id: 'doc-editor',
@@ -18,3 +18,4 @@ export const TOOL_EXTENSION = {
 // Public API
 export { createSession, getSession, getAllSessions, deleteSession, restoreSession, applyFieldEdits, applyContentEdits, applySignature, exportDocument, } from './editor.js';
 export { parseDocument, parsePDF, parseDOCX, parsePPTX, parseTXT, detectDocumentType, enrichPDFWithText, } from './parsers.js';
+export { runWithDocumentSessions } from './editor.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/tool-doc-editor",
-  "version": "0.2.30",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -40,7 +40,7 @@
     "jszip": "^3.10.1",
     "mammoth": "^1.12.0",
     "pdf-lib": "^1.17.1",
-    "@larkup/core": "0.7.4",
+    "@larkup/core": "0.8.0",
     "@larkup/sandbox": "0.1.8"
   },
   "peerDependencies": {
@@ -53,7 +53,7 @@
   },
   "devDependencies": {
     "typescript": "^7.0.2",
-    "@larkup/marketplace": "0.3.8"
+    "@larkup/marketplace": "0.3.9"
   },
   "license": "Apache-2.0",
   "repository": {

package/src/editor.ts

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { workspaceHost } from '@larkup/core/workspace-host';
 /**
  * Document editor — orchestrates parsing, editing, and export.
  *
@@ -29,24 +31,58 @@ import {
   generateExtractPDFTextScript,
 } from './sandbox-scripts.js';
 
-const sessions = new Map<string, EditorSession>();
+const localSessions = new Map<string, EditorSession>();
+const sessionScope = new AsyncLocalStorage<{
+  sessions: Map<string, EditorSession>;
+  flush: () => Promise<void>;
+}>();
+function sessions() {
+  return sessionScope.getStore()?.sessions ?? localSessions;
+}
+async function persistSessions() {
+  await sessionScope.getStore()?.flush();
+}
+/** Hydrate isolated sessions from the host's tenant-bound persistent repository. */
+export async function runWithDocumentSessions<T>(operation: () => T): Promise<Awaited<T>> {
+  const host = workspaceHost();
+  if (!host || sessionScope.getStore()) return await operation();
+  const stored = ((await host.readState('document-sessions')) ?? []) as EditorSession[];
+  const scoped = new Map(stored.map((session) => [session.id, session]));
+  let previous = JSON.stringify(stored);
+  let pending = Promise.resolve();
+  const flush = () => {
+    pending = pending.then(async () => {
+      const next = JSON.stringify([...scoped.values()]);
+      if (next !== previous) {
+        await host.writeState('document-sessions', JSON.parse(next));
+        previous = next;
+      }
+    });
+    return pending;
+  };
+  return await sessionScope.run({ sessions: scoped, flush }, async () => {
+    const result = await operation();
+    await flush();
+    return result;
+  });
+}
 
 export function getSession(sessionId: string): EditorSession | undefined {
-  return sessions.get(sessionId);
+  return sessions().get(sessionId);
 }
 
 export function getAllSessions(): EditorSession[] {
-  return Array.from(sessions.values()).sort(
+  return Array.from(sessions().values()).sort(
     (a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime(),
   );
 }
 
 export function deleteSession(sessionId: string): boolean {
-  return sessions.delete(sessionId);
+  return sessions().delete(sessionId);
 }
 
 export function restoreSession(session: EditorSession): void {
-  sessions.set(session.id, session);
+  sessions().set(session.id, session);
 }
 
 export async function createSession(
@@ -112,16 +148,17 @@ export async function createSession(
     updatedAt: new Date().toISOString(),
   };
 
-  sessions.set(session.id, session);
+  sessions().set(session.id, session);
+  await persistSessions();
   return session;
 }
 
 export async function applyFieldEdits(sessionId: string, edits: FieldEdit[]): Promise<EditResult> {
-  const session = sessions.get(sessionId);
+  const session = sessions().get(sessionId);
   if (!session) {
     console.error(
       `[doc-editor] Session not found: ${sessionId}. Available sessions:`,
-      Array.from(sessions.keys()),
+      Array.from(sessions().keys()),
     );
     return {
       success: false,
@@ -279,6 +316,7 @@ export async function applyFieldEdits(sessionId: string, edits: FieldEdit[]): Pr
     session.parsed = newParsed;
     session.edits.push(...edits);
     session.updatedAt = new Date().toISOString();
+    await persistSessions();
 
     return {
       success: true,
@@ -302,7 +340,7 @@ export async function applyContentEdits(
   sessionId: string,
   edits: ContentEdit[],
 ): Promise<EditResult> {
-  const session = sessions.get(sessionId);
+  const session = sessions().get(sessionId);
   if (!session) {
     return {
       success: false,
@@ -390,6 +428,7 @@ export async function applyContentEdits(
     session.currentFileBase64 = newBase64;
     session.parsed = newParsed;
     session.updatedAt = new Date().toISOString();
+    await persistSessions();
 
     return {
       success: true,
@@ -411,7 +450,7 @@ export async function applyContentEdits(
 export function exportDocument(
   sessionId: string,
 ): { buffer: Buffer; fileName: string; mimeType: string } | null {
-  const session = sessions.get(sessionId);
+  const session = sessions().get(sessionId);
   if (!session) return null;
 
   return {
@@ -522,7 +561,7 @@ async function fillPDFNatively(
 }
 
 export async function applySignature(sessionId: string, data: SignatureData): Promise<EditResult> {
-  const session = sessions.get(sessionId);
+  const session = sessions().get(sessionId);
   if (!session) {
     return { success: false, error: 'Session not found' } as any;
   }
@@ -651,7 +690,8 @@ export async function applySignature(sessionId: string, data: SignatureData): Pr
       session.currentFileBase64 = newBase64;
       session.parsed = newParsed;
       session.updatedAt = new Date().toISOString();
-      sessions.set(sessionId, session);
+      await persistSessions();
+      sessions().set(sessionId, session);
 
       return {
         success: true,

package/src/index.ts

@@ -9,7 +9,7 @@
 export const TOOL_META = {
   id: 'doc-editor',
   name: 'Document Editor',
-  version: '0.2.28',
+  version: '0.3.0',
 } as const;
 
 export const TOOL_EXTENSION = {
@@ -51,3 +51,5 @@ export type {
   EditorSession,
   EditResult,
 } from './types.js';
+
+export { runWithDocumentSessions } from './editor.js';

package/tool.manifest.json

@@ -5,7 +5,7 @@
   "description": "AI-powered form filling and document editing with Canvas-style live preview.",
   "longDescription": "Open PDF, Word, PowerPoint, and text files in a split-view Canvas. AI fills forms using your knowledge base, edits content on request, and previews changes live. Supports PDF form fields (AcroForm), DOCX paragraphs/tables, PPTX slide text, and plain text editing. Uses pdf-lib (native) for PDF and the Docker sandbox for DOCX/PPTX via python-docx/python-pptx.",
   "category": "utility",
-  "version": "0.2.30",
+  "version": "0.3.0",
   "pricing": "free",
   "emoji": "📝",
   "icon": "FileEdit",