assist-feedback.php
10 months ago
assistant.php
8 months ago
base.php
8 months ago
dropped-file.php
8 months ago
edit-image.php
8 months ago
embed.php
10 months ago
feedback.php
10 months ago
function.php
8 months ago
image.php
8 months ago
parameter.php
1 year ago
text.php
8 months ago
transcribe.php
8 months ago
dropped-file.php
204 lines
| 1 | <?php |
| 2 | |
| 3 | class Meow_MWAI_Query_DroppedFile { |
| 4 | private $data; |
| 5 | private $rawData; |
| 6 | private $type; // Defines what the data is about ('refId', 'url', or 'data') |
| 7 | private $purpose; // Can be 'assistant', 'vision' or 'files' => this needs to be checked |
| 8 | private $mimeType; // 'image/jpeg' or any other mime type |
| 9 | private $fileId; // The ID of the file in the database |
| 10 | public $originalPath; // The original file path (for files loaded from disk) |
| 11 | |
| 12 | public static function from_url( $url, $purpose, $mimeType = null, $fileId = null ) { |
| 13 | if ( empty( $mimeType ) ) { |
| 14 | $mimeType = Meow_MWAI_Core::get_mime_type( $url ); |
| 15 | } |
| 16 | return new Meow_MWAI_Query_DroppedFile( $url, 'url', $purpose, $mimeType, $fileId ); |
| 17 | } |
| 18 | |
| 19 | public static function from_data( $data, $purpose, $mimeType = null ) { |
| 20 | return new Meow_MWAI_Query_DroppedFile( $data, 'data', $purpose, $mimeType ); |
| 21 | } |
| 22 | |
| 23 | public static function from_path( $path, $purpose, $mimeType = null ) { |
| 24 | $data = file_get_contents( $path ); |
| 25 | if ( empty( $mimeType ) ) { |
| 26 | $mimeType = Meow_MWAI_Core::get_mime_type( $path ); |
| 27 | } |
| 28 | $droppedFile = new Meow_MWAI_Query_DroppedFile( $data, 'data', $purpose, $mimeType ); |
| 29 | // Store the original path for filename extraction |
| 30 | $droppedFile->originalPath = $path; |
| 31 | return $droppedFile; |
| 32 | } |
| 33 | |
| 34 | public static function from_refId( $refId, $purpose, $mimeType = null ) { |
| 35 | return new Meow_MWAI_Query_DroppedFile( $refId, 'refId', $purpose, $mimeType ); |
| 36 | } |
| 37 | |
| 38 | /** |
| 39 | * Create DroppedFile from provider file_id reference (OpenAI, Anthropic, etc.) |
| 40 | * |
| 41 | * For PDFs uploaded to provider Files APIs, we only store the file_id |
| 42 | * Examples: OpenAI 'file-xxx', Anthropic 'file_xxx' |
| 43 | * These are reference-only - the file data lives on the provider's servers |
| 44 | * Do NOT try to load file data from these - use get_refId() to get the file_id |
| 45 | */ |
| 46 | public static function from_provider_file_id( $fileId, $purpose, $mimeType = null ) { |
| 47 | return new Meow_MWAI_Query_DroppedFile( $fileId, 'provider_file_id', $purpose, $mimeType ); |
| 48 | } |
| 49 | |
| 50 | /** |
| 51 | * @deprecated Use from_provider_file_id() instead |
| 52 | * Kept for backward compatibility |
| 53 | */ |
| 54 | public static function from_openai_file_id( $fileId, $purpose, $mimeType = null ) { |
| 55 | return self::from_provider_file_id( $fileId, $purpose, $mimeType ); |
| 56 | } |
| 57 | |
| 58 | public function __construct( $data, $type, $purpose, $mimeType = null, $fileId = null ) { |
| 59 | // Support both old 'openai_file_id' and new 'provider_file_id' for backward compatibility |
| 60 | if ( $type === 'openai_file_id' ) { |
| 61 | $type = 'provider_file_id'; |
| 62 | } |
| 63 | if ( !empty( $type ) && $type !== 'refId' && $type !== 'url' && $type !== 'data' && $type !== 'provider_file_id' ) { |
| 64 | throw new Exception( 'AI Engine: The file type can only be refId, url, data, or provider_file_id.' ); |
| 65 | } |
| 66 | if ( !empty( $purpose ) && $purpose !== 'assistant-in' && $purpose !== 'vision' && $purpose !== 'files' ) { |
| 67 | throw new Exception( 'AI Engine: The file purpose can only be assistant, vision or files.' ); |
| 68 | } |
| 69 | $this->data = $data; |
| 70 | $this->type = $type; |
| 71 | $this->purpose = $purpose; |
| 72 | $this->mimeType = $mimeType; |
| 73 | $this->fileId = $fileId; |
| 74 | } |
| 75 | |
| 76 | public function get_url() { |
| 77 | if ( $this->type === 'url' ) { |
| 78 | return $this->data; |
| 79 | } |
| 80 | throw new Exception( 'AI Engine: The file is not an URL.' ); |
| 81 | } |
| 82 | |
| 83 | private function get_raw_data() { |
| 84 | if ( !empty( $this->rawData ) ) { |
| 85 | return $this->rawData; |
| 86 | } |
| 87 | if ( $this->type === 'provider_file_id' ) { |
| 88 | // Provider file IDs are reference-only (file data lives on provider's servers) |
| 89 | // Common mistake: trying to load file data for PDFs in conversation history |
| 90 | // Fix: Check file mime type before calling get_data()/get_base64()/get_inline_base64_url() |
| 91 | // For PDFs: use get_refId() to get the file_id string instead |
| 92 | throw new Exception( 'AI Engine: Cannot get raw data for provider file ID (file_id: ' . $this->data . '). Use get_refId() instead.' ); |
| 93 | } |
| 94 | if ( $this->type === 'refId' ) { |
| 95 | // For refId, fetch the URL from database and load the file |
| 96 | global $mwai_core; |
| 97 | $url = $mwai_core->files->get_url( $this->data ); |
| 98 | if ( empty( $url ) ) { |
| 99 | throw new Exception( 'AI Engine: Could not find file URL for refId: ' . $this->data ); |
| 100 | } |
| 101 | // Validate URL scheme to prevent SSRF attacks |
| 102 | $parts = wp_parse_url( $url ); |
| 103 | if ( ! isset( $parts['scheme'] ) || ! in_array( $parts['scheme'], [ 'http', 'https' ], true ) ) { |
| 104 | throw new Exception( 'Invalid URL scheme; only HTTP/HTTPS allowed.' ); |
| 105 | } |
| 106 | $this->rawData = file_get_contents( $url ); |
| 107 | return $this->rawData; |
| 108 | } |
| 109 | else if ( $this->type === 'url' ) { |
| 110 | // Validate URL scheme to prevent SSRF attacks |
| 111 | $parts = wp_parse_url( $this->data ); |
| 112 | if ( ! isset( $parts['scheme'] ) || ! in_array( $parts['scheme'], [ 'http', 'https' ], true ) ) { |
| 113 | throw new Exception( 'Invalid URL scheme; only HTTP/HTTPS allowed.' ); |
| 114 | } |
| 115 | |
| 116 | $this->rawData = file_get_contents( $this->data ); |
| 117 | return $this->rawData; |
| 118 | } |
| 119 | else if ( $this->type === 'data' ) { |
| 120 | return $this->data; |
| 121 | } |
| 122 | throw new Exception( 'AI Engine: The file is not data or an URL.' ); |
| 123 | } |
| 124 | |
| 125 | public function get_data() { |
| 126 | if ( $this->type === 'provider_file_id' ) { |
| 127 | // Provider file IDs are just references, no data loading needed |
| 128 | throw new Exception( 'AI Engine: Cannot get data for provider file ID. Use get_refId() instead.' ); |
| 129 | } |
| 130 | if ( $this->type === 'refId' || $this->type === 'url' ) { |
| 131 | return $this->get_raw_data(); |
| 132 | } |
| 133 | else if ( $this->type === 'data' ) { |
| 134 | return $this->data; |
| 135 | } |
| 136 | throw new Exception( 'AI Engine: The file is not data or an URL.' ); |
| 137 | } |
| 138 | |
| 139 | public function get_base64() { |
| 140 | $data = $this->get_raw_data(); |
| 141 | return base64_encode( $data ); |
| 142 | } |
| 143 | |
| 144 | // Will return something like "data:image/jpeg;base64,{data}" |
| 145 | public function get_inline_base64_url() { |
| 146 | $b64 = $this->get_base64(); |
| 147 | return "data:{$this->mimeType};base64,{$b64}"; |
| 148 | } |
| 149 | |
| 150 | public function get_type() { |
| 151 | return $this->type; |
| 152 | } |
| 153 | |
| 154 | public function get_purpose() { |
| 155 | return $this->purpose; |
| 156 | } |
| 157 | |
| 158 | public function get_mimeType() { |
| 159 | return $this->mimeType; |
| 160 | } |
| 161 | |
| 162 | public function is_image() { |
| 163 | return strpos( $this->mimeType, 'image' ) !== false; |
| 164 | } |
| 165 | |
| 166 | public function get_fileId() { |
| 167 | return $this->fileId; |
| 168 | } |
| 169 | |
| 170 | public function get_refId() { |
| 171 | if ( $this->type === 'refId' || $this->type === 'provider_file_id' ) { |
| 172 | return $this->data; |
| 173 | } |
| 174 | return null; |
| 175 | } |
| 176 | |
| 177 | // Return a filename for this file. If the file is an URL, use the basename of |
| 178 | // its path. If the file is raw data, generate a generic name based on the mime type. |
| 179 | public function get_filename() { |
| 180 | // If we have an original path (from from_path), use its basename |
| 181 | if ( !empty( $this->originalPath ) ) { |
| 182 | return basename( $this->originalPath ); |
| 183 | } |
| 184 | if ( $this->type === 'refId' ) { |
| 185 | global $mwai_core; |
| 186 | $path = $mwai_core->files->get_path( $this->data ); |
| 187 | return basename( $path ); |
| 188 | } |
| 189 | if ( $this->type === 'url' ) { |
| 190 | $path = parse_url( $this->data, PHP_URL_PATH ); |
| 191 | return basename( $path ); |
| 192 | } |
| 193 | if ( $this->type === 'data' ) { |
| 194 | if ( !empty( $this->mimeType ) ) { |
| 195 | $parts = explode( '/', $this->mimeType ); |
| 196 | $ext = end( $parts ); |
| 197 | return 'file.' . $ext; |
| 198 | } |
| 199 | return 'file.bin'; |
| 200 | } |
| 201 | return 'file'; |
| 202 | } |
| 203 | } |
| 204 |