WP_REST_Server::READABLE, 'callback' => array( $this, 'list_entries' ), 'permission_callback' => array( 'MYBOT_REST_Controller', 'admin_permission' ), 'args' => array( 'limit' => array( 'required' => false, 'type' => 'integer', 'default' => 100, 'sanitize_callback' => 'absint', ), ), ) ); register_rest_route( MYBOT_REST_NAMESPACE, '/knowledge/import', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'import' ), 'permission_callback' => array( 'MYBOT_REST_Controller', 'admin_permission' ), 'args' => array( 'filename' => array( 'required' => false, 'type' => 'string', 'default' => '', 'sanitize_callback' => 'sanitize_file_name', ), 'format' => array( 'required' => false, 'type' => 'string', 'default' => 'auto', 'sanitize_callback' => 'sanitize_key', ), 'content' => array( 'required' => true, 'type' => 'string', ), 'mode' => array( 'required' => false, 'type' => 'string', 'default' => 'merge', 'sanitize_callback' => 'sanitize_key', 'validate_callback' => function ( $value ) { return in_array( $value, array( 'merge', 'replace' ), true ); }, ), 'dry_run' => array( 'required' => false, 'type' => 'boolean', 'default' => false, 'sanitize_callback' => 'rest_sanitize_boolean', ), ), ) ); register_rest_route( MYBOT_REST_NAMESPACE, '/knowledge/delete', array( 'methods' => WP_REST_Server::CREATABLE, 'callback' => array( $this, 'delete' ), 'permission_callback' => array( 'MYBOT_REST_Controller', 'admin_permission' ), 'args' => array( 'id' => array( 'required' => false, 'type' => 'integer', 'default' => 0, 'sanitize_callback' => 'absint', ), ), ) ); } /** * Lists the knowledge items. * * @param WP_REST_Request $request The request. * @return WP_REST_Response */ public function list_entries( $request ) { $importer = new MYBOT_Knowledge_Importer(); $result = $importer->list_entries( (int) $request->get_param( 'limit' ) ); return new WP_REST_Response( array( 'success' => true, 'entries' => $result['entries'], 'total' => $result['total'], 'shown' => $result['shown'], ), 200 ); } /** * Reads a file and imports it into the knowledge base. * * @param WP_REST_Request $request The request. * @return WP_REST_Response|WP_Error */ public function import( $request ) { $importer = new MYBOT_Knowledge_Importer(); $filename = (string) $request->get_param( 'filename' ); $format = (string) $request->get_param( 'format' ); $content = (string) $request->get_param( 'content' ); $parsed = $importer->parse( $format, $content, $filename ); if ( is_wp_error( $parsed ) ) { return $parsed; } $entries = $parsed['entries']; // Preview mode: read-only, nothing is written to the database. if ( (bool) $request->get_param( 'dry_run' ) ) { $preview = array(); foreach ( array_slice( $entries, 0, 8 ) as $entry ) { $preview[] = array( 'title' => $entry['title'], 'chars' => MYBOT_Chunker::length( $entry['content'] ), 'excerpt' => MYBOT_Chunker::slice( $entry['content'], 0, 180 ), ); } return new WP_REST_Response( array( 'success' => true, 'dryRun' => true, 'format' => $parsed['format'], 'total' => $parsed['total'], 'preview' => $preview, 'ragReady' => mybot()->settings->rag_available(), 'maxEntries' => MYBOT_Knowledge_Importer::MAX_ENTRIES, ), 200 ); } $stats = $importer->import( $entries, $filename, (string) $request->get_param( 'mode' ) ); if ( is_wp_error( $stats ) ) { return $stats; } $message = sprintf( /* translators: 1: items created, 2: items updated, 3: items skipped */ __( 'Created %1$d, updated %2$d, skipped %3$d items.', 'aihouse' ), (int) $stats['created'], (int) $stats['updated'], (int) $stats['skipped'] ); if ( $stats['deleted'] > 0 ) { $message .= ' ' . sprintf( /* translators: %d: number of items deleted */ __( 'Deleted %d old items before importing.', 'aihouse' ), (int) $stats['deleted'] ); } if ( $stats['queued'] > 0 ) { $message .= ' ' . sprintf( /* translators: %d: number of items queued */ __( '%d items were queued for indexing into the vector DB.', 'aihouse' ), (int) $stats['queued'] ); } elseif ( ! mybot()->settings->rag_available() ) { $message .= ' ' . __( 'RAG is off, so nothing was indexed — configure a vector store, then click Index knowledge.', 'aihouse' ); } if ( ! empty( $stats['errors'] ) ) { $message .= ' ' . sprintf( /* translators: %d: number of failed items */ __( '%d items could not be saved.', 'aihouse' ), count( $stats['errors'] ) ); } return new WP_REST_Response( array( 'success' => true, 'message' => $message, 'stats' => $stats, 'format' => $parsed['format'], ), 200 ); } /** * Deletes one item, or everything when id = 0. * * @param WP_REST_Request $request The request. * @return WP_REST_Response|WP_Error */ public function delete( $request ) { $importer = new MYBOT_Knowledge_Importer(); $post_id = (int) $request->get_param( 'id' ); if ( $post_id > 0 ) { if ( ! $importer->delete_entry( $post_id ) ) { return new WP_Error( 'mybot_delete_failed', __( 'Could not delete this item.', 'aihouse' ), array( 'status' => 400 ) ); } return new WP_REST_Response( array( 'success' => true, 'message' => __( 'Deleted one knowledge item.', 'aihouse' ), 'deleted' => 1, ), 200 ); } $deleted = $importer->delete_all(); return new WP_REST_Response( array( 'success' => true, 'message' => sprintf( /* translators: %d: number of items deleted */ __( 'Deleted all %d knowledge items.', 'aihouse' ), (int) $deleted ), 'deleted' => (int) $deleted, ), 200 ); } }