@framers/agentos 0.1.113 → 0.1.114

package/dist/core/tools/permissions/ToolPermissionManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolPermissionManager.js","sourceRoot":"","sources":["../../../../src/core/tools/permissions/ToolPermissionManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ToolPermissionManager.js","sourceRoot":"","sources":["../../../../src/core/tools/permissions/ToolPermissionManager.ts"],"names":[],"mappings":"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"}

package/dist/core/vision/VisionPipeline.d.ts

@@ -0,0 +1,437 @@
+/**
+ * @module core/vision/VisionPipeline
+ *
+ * Unified vision pipeline with progressive enhancement.
+ *
+ * Processes images through configurable tiers:
+ *
+ * ```
+ * ┌─────────────────────────────────────────────────────────────────────┐
+ * │ Image Buffer / URL                                                  │
+ * │   ↓                                                                 │
+ * │ Preprocessing (sharp: resize, grayscale, sharpen, normalize)        │
+ * │   ↓                                                                 │
+ * │ Tier 1 — Local OCR (PaddleOCR or Tesseract.js)                     │
+ * │   ↓ confidence < threshold?                                         │
+ * │ Tier 2 — Local Vision (TrOCR / Florence-2)                         │
+ * │   ↓ still below threshold?                                          │
+ * │ Tier 3 — Cloud Vision (GPT-4o / Claude / Gemini via generateText)  │
+ * │   ↓                                                                 │
+ * │ Merge: highest-confidence text wins, structured layout preserved    │
+ * │                                                                     │
+ * │ [parallel] CLIP embedding runs alongside all tiers                  │
+ * └─────────────────────────────────────────────────────────────────────┘
+ * ```
+ *
+ * ## Dependency loading
+ *
+ * All heavy ML dependencies (ppu-paddle-ocr, tesseract.js,
+ * \@huggingface/transformers) are loaded lazily via dynamic `import()`.
+ * If a dependency is missing, the pipeline throws a helpful error
+ * with installation instructions — it never crashes on missing
+ * optional peer deps at module load time.
+ *
+ * ## Strategy behaviours
+ *
+ * | Strategy | Tier 1 | Tier 2 | Tier 3 | Notes |
+ * |----------|--------|--------|--------|-------|
+ * | progressive | Always | If low confidence | If still low | Default |
+ * | local-only | Always | Always | Never | Air-gapped |
+ * | cloud-only | Never | Never | Always | Best quality |
+ * | parallel | Always | Always | Always | Merge best |
+ *
+ * @see {@link VisionPipelineConfig} for configuration options.
+ * @see {@link VisionResult} for the output shape.
+ * @see {@link createVisionPipeline} for the auto-detecting factory.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = new VisionPipeline({
+ *   strategy: 'progressive',
+ *   ocr: 'paddle',
+ *   handwriting: true,
+ *   documentAI: true,
+ *   embedding: true,
+ *   cloudProvider: 'openai',
+ *   confidenceThreshold: 0.8,
+ * });
+ *
+ * const result = await pipeline.process(imageBuffer);
+ * console.log(result.text);       // extracted text
+ * console.log(result.category);   // 'printed-text' | 'handwritten' | etc.
+ * console.log(result.embedding);  // CLIP vector for search
+ * console.log(result.layout);     // structured document layout
+ * ```
+ */
+import type { VisionPipelineConfig, VisionResult, VisionTier, ContentCategory, DocumentLayout } from './types.js';
+/**
+ * Unified vision pipeline with progressive enhancement.
+ *
+ * Processes images through up to three tiers of increasing capability:
+ * 1. Local OCR (PaddleOCR / Tesseract.js) — fast, free, offline
+ * 2. Local Vision Models (TrOCR / Florence-2 / CLIP) — offline but slower
+ * 3. Cloud Vision LLMs (GPT-4o, Claude, Gemini) — best quality, API cost
+ *
+ * All heavy dependencies are loaded lazily on first use. The pipeline
+ * never imports ML libraries at module load time, so it's safe to
+ * instantiate even when optional peer deps are missing — errors only
+ * surface when a tier that needs them actually runs.
+ *
+ * @see {@link createVisionPipeline} for automatic provider detection.
+ */
+export declare class VisionPipeline {
+    /** Resolved pipeline configuration. */
+    private readonly _config;
+    /** PaddleOCR service instance (Tier 1). */
+    private _paddleOcr?;
+    /** Tesseract.js worker instance (Tier 1). */
+    private _tesseract?;
+    /** TrOCR pipeline for handwriting recognition (Tier 2). */
+    private _trOcrPipeline?;
+    /** Florence-2 pipeline for document understanding (Tier 2). */
+    private _florencePipeline?;
+    /** CLIP pipeline for image embeddings (Tier 2). */
+    private _clipPipeline?;
+    /** Whether dispose() has been called. Guards against use-after-free. */
+    private _disposed;
+    /**
+     * Create a new vision pipeline.
+     *
+     * @param config - Pipeline configuration. All heavy dependencies are loaded
+     *   lazily, so construction is synchronous and never imports ML libraries.
+     *
+     * @example
+     * ```typescript
+     * const pipeline = new VisionPipeline({
+     *   strategy: 'progressive',
+     *   ocr: 'paddle',
+     *   handwriting: true,
+     *   cloudProvider: 'openai',
+     * });
+     * ```
+     */
+    constructor(config: VisionPipelineConfig);
+    /**
+     * Process an image through the configured tiers.
+     *
+     * Automatically detects content type (printed text, handwritten, diagram,
+     * etc.) and routes through the appropriate processing tiers based on the
+     * configured {@link VisionStrategy}.
+     *
+     * @param image - Image data as a Buffer or file-path / URL string.
+     *   Buffers are preprocessed with sharp (if configured). URL strings
+     *   are passed directly to providers that support them.
+     * @param options - Optional overrides for this specific invocation.
+     * @param options.forceCategory - Force a specific content category
+     *   instead of auto-detecting from OCR confidence heuristics.
+     * @param options.tiers - Run only these specific tiers, ignoring
+     *   the strategy's normal routing logic.
+     * @returns Aggregated vision result with text, confidence, embeddings, etc.
+     *
+     * @throws {Error} If all configured tiers fail to produce a result.
+     * @throws {Error} If a required dependency (e.g. ppu-paddle-ocr) is missing.
+     * @throws {Error} If `dispose()` was already called.
+     *
+     * @example
+     * ```typescript
+     * // Full progressive pipeline
+     * const result = await pipeline.process(imageBuffer);
+     *
+     * // Force handwriting mode
+     * const hw = await pipeline.process(scanBuffer, {
+     *   forceCategory: 'handwritten',
+     * });
+     *
+     * // Only run OCR and embedding, skip everything else
+     * const partial = await pipeline.process(imageBuffer, {
+     *   tiers: ['ocr', 'embedding'],
+     * });
+     * ```
+     */
+    process(image: Buffer | string, options?: {
+        forceCategory?: ContentCategory;
+        tiers?: VisionTier[];
+    }): Promise<VisionResult>;
+    /**
+     * Extract text only — fastest path using OCR tier exclusively.
+     *
+     * Ignores all other tiers (handwriting, document-ai, cloud, embedding).
+     * Useful when you just need the text content and don't need confidence
+     * scoring, layout analysis, or embeddings.
+     *
+     * @param image - Image data as a Buffer or file-path / URL string.
+     * @returns Extracted text, or empty string if OCR produces no output.
+     *
+     * @throws {Error} If the configured OCR engine is missing.
+     *
+     * @example
+     * ```typescript
+     * const text = await pipeline.extractText(receiptImage);
+     * console.log(text); // "ACME STORE\n...\nTotal: $42.99"
+     * ```
+     */
+    extractText(image: Buffer | string): Promise<string>;
+    /**
+     * Generate an image embedding using CLIP — embedding tier only.
+     *
+     * Useful for building image similarity search indexes without running
+     * the full OCR + vision pipeline.
+     *
+     * @param image - Image data as a Buffer or file-path / URL string.
+     * @returns CLIP embedding vector (typically 512 or 768 dimensions).
+     *
+     * @throws {Error} If `@huggingface/transformers` is not installed.
+     * @throws {Error} If CLIP model loading fails.
+     *
+     * @example
+     * ```typescript
+     * const embedding = await pipeline.embed(photoBuffer);
+     * await vectorStore.upsert('images', [{
+     *   id: 'photo-1',
+     *   embedding,
+     *   metadata: { source: 'upload' },
+     * }]);
+     * ```
+     */
+    embed(image: Buffer | string): Promise<number[]>;
+    /**
+     * Analyze document layout using Florence-2 — document-ai tier only.
+     *
+     * Returns structured {@link DocumentLayout} with semantic blocks
+     * (text, tables, figures, headings, lists, code) and their bounding
+     * boxes within each page.
+     *
+     * @param image - Image data as a Buffer or file-path / URL string.
+     * @returns Structured document layout with pages and blocks.
+     *
+     * @throws {Error} If `@huggingface/transformers` is not installed.
+     * @throws {Error} If Florence-2 model loading fails.
+     *
+     * @example
+     * ```typescript
+     * const layout = await pipeline.analyzeLayout(documentScan);
+     * for (const page of layout.pages) {
+     *   for (const block of page.blocks) {
+     *     console.log(`${block.type}: ${block.content.slice(0, 50)}...`);
+     *   }
+     * }
+     * ```
+     */
+    analyzeLayout(image: Buffer | string): Promise<DocumentLayout>;
+    /**
+     * Shut down the pipeline and release all loaded model resources.
+     *
+     * After calling dispose(), any further calls to `process()`,
+     * `extractText()`, `embed()`, or `analyzeLayout()` will throw.
+     *
+     * @example
+     * ```typescript
+     * const pipeline = new VisionPipeline({ strategy: 'progressive' });
+     * try {
+     *   const result = await pipeline.process(image);
+     * } finally {
+     *   await pipeline.dispose();
+     * }
+     * ```
+     */
+    dispose(): Promise<void>;
+    /**
+     * Apply configured preprocessing to an image buffer using sharp.
+     *
+     * @param image - Raw image buffer.
+     * @returns Preprocessed image buffer, or the original if no preprocessing
+     *   is configured or sharp is unavailable.
+     */
+    private _preprocess;
+    /**
+     * Run OCR on the image using the configured engine (PaddleOCR or Tesseract.js).
+     *
+     * @param image - Preprocessed image buffer or URL string.
+     * @returns Tier result with extracted text, confidence, and regions.
+     * @throws {Error} If OCR engine is 'none' or neither engine is available.
+     */
+    private _runOcr;
+    /**
+     * Run PaddleOCR for text extraction.
+     *
+     * Lazily loads and initializes the ppu-paddle-ocr library on first call.
+     * Subsequent calls reuse the cached service instance.
+     *
+     * @param image - Image buffer or URL string.
+     * @returns Tier result with PaddleOCR output.
+     * @throws {Error} If ppu-paddle-ocr is not installed.
+     */
+    private _runPaddleOcr;
+    /**
+     * Run Tesseract.js for text extraction.
+     *
+     * Lazily loads the tesseract.js library and creates a worker on first call.
+     * The worker is reused for subsequent calls and terminated on dispose().
+     *
+     * @param image - Image buffer or URL string.
+     * @returns Tier result with Tesseract output.
+     * @throws {Error} If tesseract.js is not installed.
+     */
+    private _runTesseract;
+    /**
+     * Run TrOCR handwriting recognition via @huggingface/transformers.
+     *
+     * TrOCR is a transformer model specifically trained for handwritten
+     * text recognition. It excels where standard OCR engines (PaddleOCR,
+     * Tesseract) produce low-confidence, garbled output on cursive text.
+     *
+     * @param image - Preprocessed image buffer or URL string.
+     * @returns Tier result with handwriting-recognized text.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _runTrOcr;
+    /**
+     * Run Florence-2 document understanding via @huggingface/transformers.
+     *
+     * Florence-2 detects semantic blocks (text, tables, figures, headings,
+     * lists, code) and their bounding boxes, producing a structured
+     * {@link DocumentLayout} alongside extracted text.
+     *
+     * @param image - Preprocessed image buffer or URL string.
+     * @returns Tier result plus structured document layout.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _runFlorence2;
+    /**
+     * Generate a CLIP image embedding via @huggingface/transformers.
+     *
+     * CLIP embeddings enable cross-modal similarity search — the embedding
+     * lives in the same vector space as text embeddings from the same model,
+     * so you can search images with text queries and vice versa.
+     *
+     * @param image - Preprocessed image buffer or URL string.
+     * @returns Embedding vector (typically 512 or 768 dimensions), or undefined
+     *   if CLIP is not available.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _runClipEmbedding;
+    /**
+     * Run cloud vision LLM for image understanding.
+     *
+     * Uses the existing `generateText()` API with a multimodal message
+     * containing the image as a base64 data URL. This works with any
+     * vision-capable provider (OpenAI GPT-4o, Anthropic Claude, Google
+     * Gemini, Ollama with LLaVA, etc.).
+     *
+     * @param image - Image buffer or URL string.
+     * @returns Tier result with cloud vision description.
+     * @throws {Error} If no cloud provider is configured.
+     * @throws {Error} If the cloud API call fails.
+     */
+    private _runCloudVision;
+    /**
+     * Lazily load and initialize PaddleOCR.
+     *
+     * @returns Initialized PaddleOCR service instance.
+     * @throws {Error} If ppu-paddle-ocr is not installed, with install instructions.
+     */
+    private _loadPaddleOcr;
+    /**
+     * Lazily load and initialize a Tesseract.js worker.
+     *
+     * @returns Initialized Tesseract worker ready for recognition.
+     * @throws {Error} If tesseract.js is not installed, with install instructions.
+     */
+    private _loadTesseract;
+    /**
+     * Lazily load the TrOCR image-to-text pipeline from @huggingface/transformers.
+     *
+     * @returns HuggingFace image-to-text pipeline configured with TrOCR weights.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _loadTrOcr;
+    /**
+     * Lazily load the Florence-2 document understanding pipeline.
+     *
+     * @returns HuggingFace pipeline configured for Florence-2 document analysis.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _loadFlorence2;
+    /**
+     * Lazily load the CLIP feature-extraction pipeline for image embeddings.
+     *
+     * @returns HuggingFace feature-extraction pipeline configured with CLIP.
+     * @throws {Error} If @huggingface/transformers is not installed.
+     */
+    private _loadClip;
+    /**
+     * Detect the content category from OCR results using heuristics.
+     *
+     * This avoids running expensive classification models just to decide
+     * which Tier 2 model to invoke. The heuristics are deliberately
+     * conservative — when in doubt, they return 'mixed' which triggers
+     * both handwriting and document-ai tiers.
+     *
+     * @param ocrResult - Result from Tier 1 OCR, or undefined if OCR was skipped.
+     * @returns Detected content category.
+     */
+    private _detectCategory;
+    /**
+     * Determine whether a specific tier should run based on the strategy
+     * and any explicit tier overrides.
+     *
+     * @param tier - The tier to check.
+     * @param strategy - The pipeline's configured strategy.
+     * @param requestedTiers - Explicit tier overrides from the caller, if any.
+     * @returns True if the tier should run.
+     */
+    private _shouldRunTier;
+    /**
+     * Determine whether cloud vision should run based on strategy, current
+     * confidence, and threshold.
+     *
+     * Cloud vision is the most expensive tier, so we're careful about when
+     * to invoke it — only when local results are insufficient.
+     *
+     * @param strategy - Pipeline strategy.
+     * @param bestLocalConfidence - Best confidence from local tiers so far.
+     * @param threshold - Confidence threshold for cloud escalation.
+     * @param requestedTiers - Explicit tier overrides, if any.
+     * @returns True if cloud vision should run.
+     */
+    private _shouldRunCloudVision;
+    /**
+     * Find the highest confidence among a set of tier results.
+     *
+     * @param tierResults - Results from tiers that have run so far.
+     * @returns Best confidence score, or 0 if no results.
+     */
+    private _bestConfidence;
+    /**
+     * Assemble the final {@link VisionResult} from individual tier outputs.
+     *
+     * The winning tier is the one with the highest confidence. Layout data
+     * from Florence-2 is always included when available, regardless of
+     * which tier's text wins.
+     *
+     * @param tierResults - All tier results collected during processing.
+     * @param activeTiers - Which tiers actually ran (for metadata).
+     * @param embedding - CLIP embedding, if generated.
+     * @param layout - Florence-2 document layout, if generated.
+     * @param forcedCategory - Caller-specified category override.
+     * @param startTime - Timestamp when processing started (for duration).
+     * @returns Assembled vision result.
+     */
+    private _assembleResult;
+    /**
+     * Convert a URL or file path to a Buffer by reading the file or
+     * fetching the URL.
+     *
+     * @param url - URL string (http://, https://, file://, or bare path).
+     * @returns Image data as a Buffer.
+     */
+    private _urlToBuffer;
+    /**
+     * Guard method that throws if the pipeline has been disposed.
+     * Called at the top of every public method to prevent use-after-free.
+     *
+     * @throws {Error} If dispose() has been called.
+     */
+    private _assertNotDisposed;
+}
+//# sourceMappingURL=VisionPipeline.d.ts.map

package/dist/core/vision/VisionPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisionPipeline.d.ts","sourceRoot":"","sources":["../../../src/core/vision/VisionPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAEZ,UAAU,EACV,eAAe,EAGf,cAAc,EAGf,MAAM,YAAY,CAAC;AAkCpB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IAKzB,uCAAuC;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAM/C,2CAA2C;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAM;IAEzB,6CAA6C;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAM;IAEzB,2DAA2D;IAC3D,OAAO,CAAC,cAAc,CAAC,CAAM;IAE7B,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAM;IAEhC,mDAAmD;IACnD,OAAO,CAAC,aAAa,CAAC,CAAM;IAE5B,wEAAwE;IACxE,OAAO,CAAC,SAAS,CAAS;IAM1B;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,oBAAoB;IAQxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;KACtB,GACA,OAAO,CAAC,YAAY,CAAC;IAmKxB;;;;;;;;;;;;;;;;;OAiBG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IActD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWpE;;;;;;;;;;;;;;;OAeG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B;;;;;;OAMG;YACW,WAAW;IAqDzB;;;;;;OAMG;YACW,OAAO;IAgBrB;;;;;;;;;OASG;YACW,aAAa;IAyC3B;;;;;;;;;OASG;YACW,aAAa;IAyC3B;;;;;;;;;;OAUG;YACW,SAAS;IAgCvB;;;;;;;;;;OAUG;YACW,aAAa;IAqD3B;;;;;;;;;;;OAWG;YACW,iBAAiB;IAiC/B;;;;;;;;;;;;OAYG;YACW,eAAe;IAqD7B;;;;;OAKG;YACW,cAAc;IA6B5B;;;;;OAKG;YACW,cAAc;IAuB5B;;;;;OAKG;YACW,UAAU;IAwBxB;;;;;OAKG;YACW,cAAc;IAwB5B;;;;;OAKG;YACW,SAAS;IA6BvB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;IAuCvB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAuCtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,eAAe;IAmCvB;;;;;;OAMG;YACW,YAAY;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAO3B"}