@larkup/tool-doc-editor 0.2.15 → 0.2.16

package/dist/editor.js

@@ -8,6 +8,7 @@
  */
 import { PDFDocument, PDFTextField, PDFCheckBox, PDFDropdown, PDFRadioGroup, rgb, StandardFonts, } from 'pdf-lib';
 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();
@@ -23,9 +24,6 @@ export function deleteSession(sessionId) {
 export function restoreSession(session) {
     sessions.set(session.id, session);
 }
-/* ------------------------------------------------------------------ */
-/* Create session — parse and store document                           */
-/* ------------------------------------------------------------------ */
 export async function createSession(buffer, fileName, mimeType) {
     // Parse the document
     let parsed = await parseDocument(buffer, fileName, mimeType);
@@ -80,9 +78,6 @@ export async function createSession(buffer, fileName, mimeType) {
     sessions.set(session.id, session);
     return session;
 }
-/* ------------------------------------------------------------------ */
-/* Apply field edits                                                   */
-/* ------------------------------------------------------------------ */
 export async function applyFieldEdits(sessionId, edits) {
     const session = sessions.get(sessionId);
     if (!session) {
@@ -235,9 +230,6 @@ export async function applyFieldEdits(sessionId, edits) {
         };
     }
 }
-/* ------------------------------------------------------------------ */
-/* Apply content edits (text-level)                                    */
-/* ------------------------------------------------------------------ */
 export async function applyContentEdits(sessionId, edits) {
     const session = sessions.get(sessionId);
     if (!session) {
@@ -333,9 +325,6 @@ export async function applyContentEdits(sessionId, edits) {
         };
     }
 }
-/* ------------------------------------------------------------------ */
-/* Export the current document                                          */
-/* ------------------------------------------------------------------ */
 export function exportDocument(sessionId) {
     const session = sessions.get(sessionId);
     if (!session)
@@ -346,9 +335,6 @@ export function exportDocument(sessionId) {
         mimeType: session.mimeType,
     };
 }
-/* ------------------------------------------------------------------ */
-/* Native PDF form filling using pdf-lib (no sandbox needed)           */
-/* ------------------------------------------------------------------ */
 async function fillPDFNatively(buffer, edits) {
     const pdfDoc = await PDFDocument.load(buffer, { ignoreEncryption: true });
     const form = pdfDoc.getForm();
@@ -434,9 +420,6 @@ async function fillPDFNatively(buffer, edits) {
     const modifiedBytes = await pdfDoc.save();
     return { buffer: Buffer.from(modifiedBytes), matchedFields };
 }
-/* ------------------------------------------------------------------ */
-/* Apply signature using pdf-lib (no sandbox needed)                   */
-/* ------------------------------------------------------------------ */
 export async function applySignature(sessionId, data) {
     const session = sessions.get(sessionId);
     if (!session) {
@@ -567,9 +550,6 @@ export async function applySignature(sessionId, data) {
         return { success: false, error: err.message || 'Failed to apply signature' };
     }
 }
-/* ------------------------------------------------------------------ */
-/* Find text position on a PDF page using sandbox PyPDF               */
-/* ------------------------------------------------------------------ */
 async function findTextPositionOnPage(pdfBuffer, pageIndex, searchText) {
     try {
         const code = `
@@ -618,7 +598,12 @@ except Exception as e:
     print("__RESULT__:null")
     print(f"Error: {e}", file=sys.stderr)
 `;
-        const sandboxManager = new SandboxManager({ backend: 'docker' });
+        const config = await readConfig();
+        const backend = config.defaultSandboxProvider || 'local';
+        const sandboxManager = new SandboxManager({
+            backend,
+            credentials: config.sandboxProviderConfigs?.[backend],
+        });
         const result = await sandboxManager.execute({
             code,
             language: 'python',
@@ -646,11 +631,13 @@ except Exception as e:
     }
     return null;
 }
-/* ------------------------------------------------------------------ */
-/* Sandbox execution helper                                            */
-/* ------------------------------------------------------------------ */
 async function runSandboxScript(code, fileBuffer, inputFileName) {
-    const sandboxManager = new SandboxManager({ backend: 'docker' });
+    const config = await readConfig();
+    const backend = config.defaultSandboxProvider || 'local';
+    const sandboxManager = new SandboxManager({
+        backend,
+        credentials: config.sandboxProviderConfigs?.[backend],
+    });
     const result = await sandboxManager.execute({
         code,
         language: 'python',
@@ -674,9 +661,6 @@ async function runSandboxScript(code, fileBuffer, inputFileName) {
         })),
     };
 }
-/* ------------------------------------------------------------------ */
-/* Helpers                                                             */
-/* ------------------------------------------------------------------ */
 function escapeRegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/dist/parsers.js

@@ -4,9 +4,6 @@
 import { PDFDocument, PDFTextField, PDFCheckBox, PDFDropdown, PDFRadioGroup } from 'pdf-lib';
 import mammoth from 'mammoth';
 import { randomUUID } from 'node:crypto';
-/* ------------------------------------------------------------------ */
-/* Detect document type from MIME / extension                          */
-/* ------------------------------------------------------------------ */
 const MIME_MAP = {
     'application/pdf': 'pdf',
     'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
@@ -27,9 +24,6 @@ export function detectDocumentType(fileName, mimeType) {
     const ext = fileName.substring(fileName.lastIndexOf('.')).toLowerCase();
     return EXT_MAP[ext] ?? null;
 }
-/* ------------------------------------------------------------------ */
-/* PDF Parser — using pdf-lib (MIT)                                    */
-/* ------------------------------------------------------------------ */
 export async function parsePDF(buffer, fileName) {
     const sessionId = randomUUID();
     const pdfDoc = await PDFDocument.load(buffer, { ignoreEncryption: true });
@@ -157,9 +151,6 @@ export function enrichPDFWithText(parsed, extractedText) {
         rawText: extractedText,
     };
 }
-/* ------------------------------------------------------------------ */
-/* DOCX Parser — using mammoth (MIT)                                   */
-/* ------------------------------------------------------------------ */
 export async function parseDOCX(buffer, fileName) {
     const sessionId = randomUUID();
     // Extract HTML (for preview rendering)
@@ -192,10 +183,6 @@ export async function parseDOCX(buffer, fileName) {
         totalPages: 1,
     };
 }
-/* ------------------------------------------------------------------ */
-/* PPTX Parser — uses sandbox python-pptx for real parsing             */
-/* Fallback: JSZip to extract basic slide text                         */
-/* ------------------------------------------------------------------ */
 export async function parsePPTX(buffer, fileName) {
     const sessionId = randomUUID();
     // Basic extraction using JSZip (already in web app deps)
@@ -249,9 +236,6 @@ export async function parsePPTX(buffer, fileName) {
         };
     }
 }
-/* ------------------------------------------------------------------ */
-/* TXT Parser — native passthrough                                     */
-/* ------------------------------------------------------------------ */
 export async function parseTXT(buffer, fileName) {
     const sessionId = randomUUID();
     const rawText = buffer.toString('utf-8');
@@ -275,9 +259,6 @@ export async function parseTXT(buffer, fileName) {
         totalPages: 1,
     };
 }
-/* ------------------------------------------------------------------ */
-/* Unified parser                                                      */
-/* ------------------------------------------------------------------ */
 export async function parseDocument(buffer, fileName, mimeType) {
     const type = detectDocumentType(fileName, mimeType);
     if (!type) {
@@ -308,9 +289,6 @@ export async function parseDocument(buffer, fileName, mimeType) {
             };
     }
 }
-/* ------------------------------------------------------------------ */
-/* Heuristic form field detection from unstructured text               */
-/* ------------------------------------------------------------------ */
 /**
  * Detects form-like patterns in text:
  * - "Name: ___________"

package/dist/sandbox-scripts.js

@@ -9,9 +9,6 @@
  *
  * All scripts expect input files in /sandbox/input/ and output to /sandbox/output/
  */
-/* ------------------------------------------------------------------ */
-/* PDF — Fill form fields using pypdf                                  */
-/* ------------------------------------------------------------------ */
 export function generateFillPDFScript(edits) {
     const editsJson = JSON.stringify(edits);
     return `
@@ -60,9 +57,6 @@ with open("/sandbox/output/document.pdf", "wb") as f:
 print(f"SUCCESS: Updated {len(field_map)} fields")
 `;
 }
-/* ------------------------------------------------------------------ */
-/* PDF — Extract full text using pypdf                                 */
-/* ------------------------------------------------------------------ */
 export function generateExtractPDFTextScript() {
     return `
 import json
@@ -116,9 +110,6 @@ result = {
 print("__RESULT__:" + json.dumps(result, default=str))
 `;
 }
-/* ------------------------------------------------------------------ */
-/* DOCX — Edit content using python-docx                               */
-/* ------------------------------------------------------------------ */
 export function generateEditDOCXScript(edits) {
     const editsJson = JSON.stringify(edits);
     return `
@@ -181,9 +172,6 @@ doc.save("/sandbox/output/document.docx")
 print(f"SUCCESS: Applied {updated} edits")
 `;
 }
-/* ------------------------------------------------------------------ */
-/* DOCX — Fill form fields (content controls / placeholder text)       */
-/* ------------------------------------------------------------------ */
 export function generateFillDOCXScript(edits) {
     const editsJson = JSON.stringify(edits);
     return `
@@ -233,9 +221,6 @@ doc.save("/sandbox/output/document.docx")
 print(f"SUCCESS: Filled {updated} fields")
 `;
 }
-/* ------------------------------------------------------------------ */
-/* PPTX — Extract text from slides                                     */
-/* ------------------------------------------------------------------ */
 export function generateExtractPPTXScript() {
     return `
 import json
@@ -288,9 +273,6 @@ result = {
 print("__RESULT__:" + json.dumps(result, default=str))
 `;
 }
-/* ------------------------------------------------------------------ */
-/* PPTX — Edit slide text                                              */
-/* ------------------------------------------------------------------ */
 export function generateEditPPTXScript(edits) {
     const editsJson = JSON.stringify(edits);
     return `
@@ -325,9 +307,6 @@ prs.save("/sandbox/output/document.pptx")
 print(f"SUCCESS: Applied {updated} edits")
 `;
 }
-/* ------------------------------------------------------------------ */
-/* PPTX — Fill form fields in slides                                   */
-/* ------------------------------------------------------------------ */
 export function generateFillPPTXScript(edits) {
     const editsJson = JSON.stringify(edits);
     return `

package/dist/types.js

@@ -1,4 +1 @@
-/* ------------------------------------------------------------------ */
-/* Types for the Document Editor / Form Filling tool                   */
-/* ------------------------------------------------------------------ */
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larkup/tool-doc-editor",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "publishConfig": {
     "access": "public"
   },
@@ -40,8 +40,8 @@
     "jszip": "^3.10.1",
     "mammoth": "^1.12.0",
     "pdf-lib": "^1.17.1",
-    "@larkup/core": "0.4.2",
-    "@larkup/sandbox": "0.1.2"
+    "@larkup/core": "0.5.0",
+    "@larkup/sandbox": "0.1.3"
   },
   "peerDependencies": {
     "@larkup/marketplace": ">=0.1.0"
@@ -52,14 +52,14 @@
     }
   },
   "devDependencies": {
-    "typescript": "^6.0.3",
-    "@larkup/marketplace": "0.1.25"
+    "typescript": "^7.0.2",
+    "@larkup/marketplace": "0.2.0"
   },
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/Larkup-AI/larkup",
-    "directory": "packages/tools/doc-editor"
+    "directory": "packages/marketplace-tools/doc-editor"
   },
   "scripts": {
     "build": "tsc --outDir dist",

package/src/editor.ts

@@ -17,6 +17,8 @@ import {
   StandardFonts,
 } from 'pdf-lib';
 import { SandboxManager } from '@larkup/sandbox';
+import { readConfig } from '@larkup/core/config-store';
+import type { SandboxBackend } from '@larkup/sandbox';
 import type { EditorSession, FieldEdit, ContentEdit, EditResult, SignatureData } from './types.js';
 import { parseDocument, enrichPDFWithText } from './parsers.js';
 import {
@@ -47,10 +49,6 @@ export function restoreSession(session: EditorSession): void {
   sessions.set(session.id, session);
 }
 
-/* ------------------------------------------------------------------ */
-/* Create session — parse and store document                           */
-/* ------------------------------------------------------------------ */
-
 export async function createSession(
   buffer: Buffer,
   fileName: string,
@@ -118,10 +116,6 @@ export async function createSession(
   return session;
 }
 
-/* ------------------------------------------------------------------ */
-/* Apply field edits                                                   */
-/* ------------------------------------------------------------------ */
-
 export async function applyFieldEdits(sessionId: string, edits: FieldEdit[]): Promise<EditResult> {
   const session = sessions.get(sessionId);
   if (!session) {
@@ -304,10 +298,6 @@ export async function applyFieldEdits(sessionId: string, edits: FieldEdit[]): Pr
   }
 }
 
-/* ------------------------------------------------------------------ */
-/* Apply content edits (text-level)                                    */
-/* ------------------------------------------------------------------ */
-
 export async function applyContentEdits(
   sessionId: string,
   edits: ContentEdit[],
@@ -418,10 +408,6 @@ export async function applyContentEdits(
   }
 }
 
-/* ------------------------------------------------------------------ */
-/* Export the current document                                          */
-/* ------------------------------------------------------------------ */
-
 export function exportDocument(
   sessionId: string,
 ): { buffer: Buffer; fileName: string; mimeType: string } | null {
@@ -435,10 +421,6 @@ export function exportDocument(
   };
 }
 
-/* ------------------------------------------------------------------ */
-/* Native PDF form filling using pdf-lib (no sandbox needed)           */
-/* ------------------------------------------------------------------ */
-
 async function fillPDFNatively(
   buffer: Buffer,
   edits: FieldEdit[],
@@ -539,10 +521,6 @@ async function fillPDFNatively(
   return { buffer: Buffer.from(modifiedBytes), matchedFields };
 }
 
-/* ------------------------------------------------------------------ */
-/* Apply signature using pdf-lib (no sandbox needed)                   */
-/* ------------------------------------------------------------------ */
-
 export async function applySignature(sessionId: string, data: SignatureData): Promise<EditResult> {
   const session = sessions.get(sessionId);
   if (!session) {
@@ -689,10 +667,6 @@ export async function applySignature(sessionId: string, data: SignatureData): Pr
   }
 }
 
-/* ------------------------------------------------------------------ */
-/* Find text position on a PDF page using sandbox PyPDF               */
-/* ------------------------------------------------------------------ */
-
 async function findTextPositionOnPage(
   pdfBuffer: Buffer,
   pageIndex: number,
@@ -746,7 +720,12 @@ except Exception as e:
     print(f"Error: {e}", file=sys.stderr)
 `;
 
-    const sandboxManager = new SandboxManager({ backend: 'docker' });
+    const config = await readConfig();
+    const backend = (config.defaultSandboxProvider as SandboxBackend) || 'local';
+    const sandboxManager = new SandboxManager({
+      backend,
+      credentials: config.sandboxProviderConfigs?.[backend],
+    });
     const result = await sandboxManager.execute({
       code,
       language: 'python',
@@ -776,10 +755,6 @@ except Exception as e:
   return null;
 }
 
-/* ------------------------------------------------------------------ */
-/* Sandbox execution helper                                            */
-/* ------------------------------------------------------------------ */
-
 async function runSandboxScript(
   code: string,
   fileBuffer: Buffer,
@@ -790,7 +765,12 @@ async function runSandboxScript(
   exitCode: number;
   artifacts: { name: string; mimeType: string; data: string }[];
 }> {
-  const sandboxManager = new SandboxManager({ backend: 'docker' });
+  const config = await readConfig();
+  const backend = (config.defaultSandboxProvider as SandboxBackend) || 'local';
+  const sandboxManager = new SandboxManager({
+    backend,
+    credentials: config.sandboxProviderConfigs?.[backend],
+  });
 
   const result = await sandboxManager.execute({
     code,
@@ -817,10 +797,6 @@ async function runSandboxScript(
   };
 }
 
-/* ------------------------------------------------------------------ */
-/* Helpers                                                             */
-/* ------------------------------------------------------------------ */
-
 function escapeRegExp(string: string): string {
   return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/src/parsers.ts

@@ -7,10 +7,6 @@ import mammoth from 'mammoth';
 import { randomUUID } from 'node:crypto';
 import type { DocumentType, DocumentField, DocumentPage, ParsedDocument } from './types.js';
 
-/* ------------------------------------------------------------------ */
-/* Detect document type from MIME / extension                          */
-/* ------------------------------------------------------------------ */
-
 const MIME_MAP: Record<string, DocumentType> = {
   'application/pdf': 'pdf',
   'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
@@ -33,10 +29,6 @@ export function detectDocumentType(fileName: string, mimeType?: string): Documen
   return EXT_MAP[ext] ?? null;
 }
 
-/* ------------------------------------------------------------------ */
-/* PDF Parser — using pdf-lib (MIT)                                    */
-/* ------------------------------------------------------------------ */
-
 export async function parsePDF(buffer: Buffer, fileName: string): Promise<ParsedDocument> {
   const sessionId = randomUUID();
   const pdfDoc = await PDFDocument.load(buffer, { ignoreEncryption: true });
@@ -176,10 +168,6 @@ export function enrichPDFWithText(parsed: ParsedDocument, extractedText: string)
   };
 }
 
-/* ------------------------------------------------------------------ */
-/* DOCX Parser — using mammoth (MIT)                                   */
-/* ------------------------------------------------------------------ */
-
 export async function parseDOCX(buffer: Buffer, fileName: string): Promise<ParsedDocument> {
   const sessionId = randomUUID();
 
@@ -218,11 +206,6 @@ export async function parseDOCX(buffer: Buffer, fileName: string): Promise<Parse
   };
 }
 
-/* ------------------------------------------------------------------ */
-/* PPTX Parser — uses sandbox python-pptx for real parsing             */
-/* Fallback: JSZip to extract basic slide text                         */
-/* ------------------------------------------------------------------ */
-
 export async function parsePPTX(buffer: Buffer, fileName: string): Promise<ParsedDocument> {
   const sessionId = randomUUID();
 
@@ -282,10 +265,6 @@ export async function parsePPTX(buffer: Buffer, fileName: string): Promise<Parse
   }
 }
 
-/* ------------------------------------------------------------------ */
-/* TXT Parser — native passthrough                                     */
-/* ------------------------------------------------------------------ */
-
 export async function parseTXT(buffer: Buffer, fileName: string): Promise<ParsedDocument> {
   const sessionId = randomUUID();
   const rawText = buffer.toString('utf-8');
@@ -312,10 +291,6 @@ export async function parseTXT(buffer: Buffer, fileName: string): Promise<Parsed
   };
 }
 
-/* ------------------------------------------------------------------ */
-/* Unified parser                                                      */
-/* ------------------------------------------------------------------ */
-
 export async function parseDocument(
   buffer: Buffer,
   fileName: string,
@@ -354,10 +329,6 @@ export async function parseDocument(
   }
 }
 
-/* ------------------------------------------------------------------ */
-/* Heuristic form field detection from unstructured text               */
-/* ------------------------------------------------------------------ */
-
 /**
  * Detects form-like patterns in text:
  * - "Name: ___________"

package/src/sandbox-scripts.ts

@@ -12,10 +12,6 @@
 
 import type { FieldEdit, ContentEdit } from './types.js';
 
-/* ------------------------------------------------------------------ */
-/* PDF — Fill form fields using pypdf                                  */
-/* ------------------------------------------------------------------ */
-
 export function generateFillPDFScript(edits: FieldEdit[]): string {
   const editsJson = JSON.stringify(edits);
 
@@ -66,10 +62,6 @@ print(f"SUCCESS: Updated {len(field_map)} fields")
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* PDF — Extract full text using pypdf                                 */
-/* ------------------------------------------------------------------ */
-
 export function generateExtractPDFTextScript(): string {
   return `
 import json
@@ -124,10 +116,6 @@ print("__RESULT__:" + json.dumps(result, default=str))
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* DOCX — Edit content using python-docx                               */
-/* ------------------------------------------------------------------ */
-
 export function generateEditDOCXScript(edits: ContentEdit[]): string {
   const editsJson = JSON.stringify(edits);
 
@@ -192,10 +180,6 @@ print(f"SUCCESS: Applied {updated} edits")
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* DOCX — Fill form fields (content controls / placeholder text)       */
-/* ------------------------------------------------------------------ */
-
 export function generateFillDOCXScript(edits: FieldEdit[]): string {
   const editsJson = JSON.stringify(edits);
 
@@ -247,10 +231,6 @@ print(f"SUCCESS: Filled {updated} fields")
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* PPTX — Extract text from slides                                     */
-/* ------------------------------------------------------------------ */
-
 export function generateExtractPPTXScript(): string {
   return `
 import json
@@ -304,10 +284,6 @@ print("__RESULT__:" + json.dumps(result, default=str))
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* PPTX — Edit slide text                                              */
-/* ------------------------------------------------------------------ */
-
 export function generateEditPPTXScript(edits: ContentEdit[]): string {
   const editsJson = JSON.stringify(edits);
 
@@ -344,10 +320,6 @@ print(f"SUCCESS: Applied {updated} edits")
 `;
 }
 
-/* ------------------------------------------------------------------ */
-/* PPTX — Fill form fields in slides                                   */
-/* ------------------------------------------------------------------ */
-
 export function generateFillPPTXScript(edits: FieldEdit[]): string {
   const editsJson = JSON.stringify(edits);
 

package/src/types.ts

@@ -1,7 +1,3 @@
-/* ------------------------------------------------------------------ */
-/* Types for the Document Editor / Form Filling tool                   */
-/* ------------------------------------------------------------------ */
-
 /** Supported document types */
 export type DocumentType = 'pdf' | 'docx' | 'pptx' | 'txt' | 'xlsx';
 

package/tool.manifest.json

@@ -5,16 +5,31 @@
   "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.1",
+  "version": "0.2.16",
   "pricing": "free",
   "emoji": "📝",
   "icon": "FileEdit",
   "packageName": "@larkup/tool-doc-editor",
   "installSize": "~5 MB",
-  "systemDeps": ["docker"],
+  "systemDeps": [
+    "docker"
+  ],
+  "requiresSandbox": true,
   "author": "Larkup",
-  "capabilities": ["document-editing", "form-filling", "document-preview"],
-  "tags": ["pdf", "docx", "pptx", "form", "canvas", "editor", "fill"],
+  "capabilities": [
+    "document-editing",
+    "form-filling",
+    "document-preview"
+  ],
+  "tags": [
+    "pdf",
+    "docx",
+    "pptx",
+    "form",
+    "canvas",
+    "editor",
+    "fill"
+  ],
   "downloads": 0,
   "repositoryUrl": "https://github.com/Larkup-AI/larkup",
   "license": "Apache-2.0",