cueward-adapter-macos 0.5.0

macOS adapter for Cueward with Safari, Notes, Messages, Reminders, Calendar, Screenshot, Clipboard, and OCR integrations.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use cueward_core::files::{FileInfo, ResourceValue};
use serde::{Deserialize, Serialize};
use std::path::PathBuf;

/// Scoped PDF/image extraction or Quick Look thumbnail selection.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PreviewRequest {
    pub root: PathBuf,
    pub path: PathBuf,
    pub follow_links: bool,
    pub expected_version: Option<String>,
    pub options: PreviewOptions,
}

/// Independent source, text, image and page bounds.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PreviewOptions {
    pub kind: PreviewKind,
    pub start_page: usize,
    pub page_count: usize,
    pub ocr: bool,
    pub render: bool,
    pub max_input_bytes: u64,
    pub max_text_bytes: usize,
    pub max_dimension: usize,
    pub max_preview_bytes: u64,
}

/// A thumbnail is a visual representation, never a document parser.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum PreviewKind {
    Pdf,
    Image,
    Thumbnail,
}

/// Text provenance is independent of preview-image generation.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum TextSource {
    NativePdf,
    VisionOcr,
    NotRequested,
}

/// Validated persistent PNG associated with the observed source and selected page.
#[derive(Debug, Serialize, Deserialize)]
pub struct PreviewArtifact {
    pub path: String,
    pub format: String,
    pub width: usize,
    pub height: usize,
    pub bytes: u64,
    pub sha256: String,
}

/// Selected page/frame with independent text and image availability.
#[derive(Debug, Serialize, Deserialize)]
pub struct PagePreview {
    pub page: usize,
    pub text: ResourceValue<String>,
    pub text_source: TextSource,
    pub confidence: Option<f32>,
    pub text_truncated: bool,
    pub preview: ResourceValue<PreviewArtifact>,
}

/// ImageIO metadata for the first frame; preview/OCR cover only that frame.
#[derive(Debug, Serialize, Deserialize)]
pub struct ImageInfo {
    pub content_type: String,
    pub width: usize,
    pub height: usize,
    pub frame_count: usize,
    pub orientation: Option<u32>,
}

/// Content from a bounded private snapshot, with current source checks.
#[derive(Debug, Serialize, Deserialize)]
pub struct FilePreview {
    pub file: FileInfo,
    pub source_sha256: String,
    pub kind: PreviewKind,
    pub total_pages: Option<usize>,
    pub pdf_encrypted: Option<bool>,
    pub image: Option<ImageInfo>,
    pub pages: Vec<PagePreview>,
    pub selection_truncated: bool,
    pub text_truncated: bool,
    pub cache_directory: Option<String>,
}

/// Separate native preview result in the existing external files envelope.
#[derive(Debug, Serialize, Deserialize)]
#[serde(tag = "operation", content = "result", rename_all = "snake_case")]
pub enum PreviewResponse {
    Preview(Box<FilePreview>),
}

/// Internal transport; parent owns the private operation directory lifetime.
#[derive(Debug, Serialize, Deserialize)]
pub struct PreviewWorkerRequest {
    pub request: PreviewRequest,
    pub directory: PathBuf,
}