@local-labs-jpollock/local-addon-nexus-ai 0.3.2 → 0.4.0

package/wp-plugins/ai-provider-for-ollama/plugin.php

@@ -1,218 +1,157 @@
 <?php
-
 /**
- * Plugin Name: AI Provider for Ollama
- * Plugin URI: https://github.com/getflywheel/local-addon-nexus-ai
- * Description: AI Provider for Ollama for the WordPress AI Client. Connects to a locally running Ollama instance — no API keys required.
- * Requires at least: 6.9
- * Requires PHP: 7.4
- * Version: 1.0.0
- * Author: WP Engine
- * License: GPL-2.0-or-later
- * License URI: https://spdx.org/licenses/GPL-2.0-or-later.html
- * Text Domain: ai-provider-for-ollama
+ * Plugin Name:       AI Provider for Ollama
+ * Plugin URI:        https://github.com/fueled/ai-provider-for-ollama
+ * Description:       Ollama provider for the WordPress AI Client.
+ * Requires at least: 7.0
+ * Requires PHP:      7.4
+ * Version:           1.1.1
+ * Author:            Fueled
+ * Author URI:        https://fueled.com
+ * License:           GPL-2.0-or-later
+ * License URI:       https://spdx.org/licenses/GPL-2.0-or-later.html
+ * Text Domain:       ai-provider-for-ollama
  *
- * @package WordPress\OllamaAiProvider
+ * @package Fueled\AiProviderForOllama
  */
 
-declare(strict_types=1);
-
-namespace WordPress\OllamaAiProvider;
+declare( strict_types=1 );
 
-use WordPress\AiClient\AiClient;
-use WordPress\OllamaAiProvider\Provider\OllamaProvider;
+namespace Fueled\AiProviderForOllama;
 
-if (!defined('ABSPATH')) {
-    return;
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
 }
 
-require_once __DIR__ . '/src/autoload.php';
+define( 'AI_PROVIDER_FOR_OLLAMA_MIN_PHP_VERSION', '7.4' );
+define( 'AI_PROVIDER_FOR_OLLAMA_MIN_WP_VERSION', '7.0' );
+define( 'AI_PROVIDER_FOR_OLLAMA_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
+define( 'AI_PROVIDER_FOR_OLLAMA_PLUGIN_FILE', __FILE__ );
+
+/**
+ * Displays an admin notice for requirement failures.
+ *
+ * @since 1.0.0
+ *
+ * @param string $message The error message to display.
+ */
+function requirement_notice( string $message ): void {
+	if ( ! is_admin() ) {
+		return;
+	}
+	?>
+
+	<div class="notice notice-error">
+		<p><?php echo wp_kses_post( $message ); ?></p>
+	</div>
+
+	<?php
+}
 
 /**
- * Registers the AI Provider for Ollama with the AI Client.
+ * Checks if the PHP version meets the minimum requirement.
+ *
+ * @since 1.0.0
  *
- * IMPORTANT: This registers with whichever registry is active.
- * The 'ai' plugin bundles its own php-ai-client which creates a separate registry.
- * We register on 'init' priority 5 to run early, and again on priority 10
- * to catch both core and plugin registries.
+ * @return bool True if PHP version is sufficient, false otherwise.
+ */
+function check_php_version(): bool {
+	if ( version_compare( phpversion(), AI_PROVIDER_FOR_OLLAMA_MIN_PHP_VERSION, '<' ) ) {
+		add_action(
+			'admin_notices',
+			static function () {
+				requirement_notice(
+					sprintf(
+						/* translators: 1: Required PHP version, 2: Current PHP version */
+						__( 'The Ollama Provider plugin requires PHP version %1$s or higher. You are running PHP version %2$s.', 'ai-provider-for-ollama' ),
+						AI_PROVIDER_FOR_OLLAMA_MIN_PHP_VERSION,
+						PHP_VERSION
+					)
+				);
+			}
+		);
+
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Checks if the WordPress version meets the minimum requirement.
  *
  * @since 1.0.0
  *
- * @return void
+ * @global string $wp_version WordPress version.
+ *
+ * @return bool True if WordPress version is sufficient, false otherwise.
+ */
+function check_wp_version(): bool {
+	if ( ! is_wp_version_compatible( AI_PROVIDER_FOR_OLLAMA_MIN_WP_VERSION ) ) {
+		add_action(
+			'admin_notices',
+			static function () {
+				global $wp_version;
+				requirement_notice(
+					sprintf(
+						/* translators: 1: Required WordPress version, 2: Current WordPress version */
+						__( 'The Ollama Provider plugin requires WordPress version %1$s or higher. You are running WordPress version %2$s.', 'ai-provider-for-ollama' ),
+						AI_PROVIDER_FOR_OLLAMA_MIN_WP_VERSION,
+						$wp_version
+					)
+				);
+			}
+		);
+
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Loads the Ollama provider plugin.
+ *
+ * @since 1.0.0
  */
-function register_provider(): void
-{
-    if (!class_exists(AiClient::class)) {
-        return;
-    }
-
-    $registry = AiClient::defaultRegistry();
-
-    // Always try to register, even if already registered (might be different registry)
-    try {
-        if (!$registry->hasProvider('ollama')) {
-            $registry->registerProvider(OllamaProvider::class);
-
-            // Set up HTTP transporter using WordPress HTTP API
-            if (class_exists('WordPress\\AiClient\\Providers\\Http\\WordPressHttpTransporter')) {
-                $httpTransporter = new \WordPress\AiClient\Providers\Http\WordPressHttpTransporter();
-                $registry->setHttpTransporter('ollama', $httpTransporter);
-            }
-
-            // Set dummy API key credentials (Ollama doesn't need authentication, but framework requires it)
-            // WordPress 7.0 uses Connectors API, older versions use wp_ai_client_provider_credentials
-            $credentials = get_option('wp_ai_client_provider_credentials', []);
-            if (!isset($credentials['ollama'])) {
-                $credentials['ollama'] = 'ollama-local';
-                update_option('wp_ai_client_provider_credentials', $credentials);
-            }
-
-            // WordPress 7.0+ Connectors API location
-            if (!get_option('connectors_ai_ollama_api_key')) {
-                update_option('connectors_ai_ollama_api_key', 'ollama-local-no-auth-needed');
-            }
-
-            error_log('Ollama provider registered with registry ' . spl_object_hash($registry));
-        }
-    } catch (\Exception $e) {
-        error_log('Ollama provider registration failed: ' . $e->getMessage());
-    }
+function load(): void {
+	static $loaded = false;
+
+	// Prevent loading twice.
+	if ( $loaded ) {
+		return;
+	}
+
+	// Check version requirements.
+	if ( ! check_php_version() || ! check_wp_version() ) {
+		return;
+	}
+
+	// Throw an error if the composer autoloader is not found.
+	if ( ! file_exists( AI_PROVIDER_FOR_OLLAMA_PLUGIN_DIR . 'vendor/autoload.php' ) ) {
+		add_action(
+			'admin_notices',
+			static function () {
+				requirement_notice(
+					sprintf(
+						/* translators: %s: composer install command */
+						esc_html__( 'Your installation of the Ollama Provider plugin is incomplete. Please run %s.', 'ai-provider-for-ollama' ),
+						'<code>composer install</code>'
+					)
+				);
+			},
+			10
+		);
+
+		return;
+	}
+
+	// Load the composer autoloader.
+	require_once AI_PROVIDER_FOR_OLLAMA_PLUGIN_DIR . 'vendor/autoload.php';
+
+	// Initialize the plugin.
+	$plugin = new Plugin();
+	$plugin->init();
 }
 
-// Register very early (priority 1) to ensure it's available before any experiments initialize
-add_action('init', __NAMESPACE__ . '\\register_provider', 1);
-
-// Register again at priority 5 and 10 to catch any late-loading registries
-add_action('init', __NAMESPACE__ . '\\register_provider', 5);
-add_action('init', __NAMESPACE__ . '\\register_provider', 10);
-
-// Prepend Ollama models to the experiment preferred models list.
-add_filter('ai_experiments_preferred_models_for_text_generation', function ($models) {
-    if (!class_exists(AiClient::class)) {
-        error_log('Ollama filter: AiClient class not found');
-        return $models;
-    }
-
-    $registry = AiClient::defaultRegistry();
-    // Check by provider ID, not class name
-    if (!$registry->hasProvider('ollama')) {
-        error_log('Ollama filter: Provider not registered');
-        return $models;
-    }
-
-    // Also check if it's configured
-    if (!$registry->isProviderConfigured('ollama')) {
-        error_log('Ollama filter: Provider not configured');
-        return $models;
-    }
-
-    try {
-        $modelMetadataList = OllamaProvider::modelMetadataDirectory()->listModelMetadata();
-
-        $ollamaModels = [];
-        foreach ($modelMetadataList as $modelMetadata) {
-            // Only add text generation models to this filter
-            $hasTextGeneration = false;
-            foreach ($modelMetadata->getSupportedCapabilities() as $capability) {
-                if ($capability->isTextGeneration()) {
-                    $hasTextGeneration = true;
-                    break;
-                }
-            }
-
-            if ($hasTextGeneration) {
-                // Format: [providerId, modelId] - numeric indexed array
-                $ollamaModels[] = ['ollama', $modelMetadata->getId()];
-            }
-        }
-
-        return array_merge($ollamaModels, $models);
-    } catch (\Exception $e) {
-        error_log('Ollama filter error: ' . $e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
-        return $models;
-    }
-});
-
-// Disable image generation experiment
-// Ollama DOES support image generation models (x/z-image-turbo, flux, etc.) BUT they
-// timeout and aren't production-ready yet. The implementation exists in
-// OllamaImageGenerationModel.php and can be enabled when Ollama's image models become stable.
-add_filter('ai_experiments_available', function ($experiments) {
-    if (isset($experiments['image_generation'])) {
-        unset($experiments['image_generation']);
-        error_log('Ollama: Disabled image_generation experiment (models timeout - not production-ready)');
-    }
-    return $experiments;
-}, 20);
-
-// Allow localhost requests to Ollama
-add_filter('http_request_host_is_external', function ($is_external, $host, $url) {
-    // Allow localhost for Ollama API calls
-    if ($host === 'localhost' && strpos($url, 'localhost:11434') !== false) {
-        return true;
-    }
-    return $is_external;
-}, 10, 3);
-
-// Bypass WordPress localhost blocking for Ollama and increase timeout
-add_filter('http_request_args', function ($args, $url) {
-    if (strpos($url, 'localhost:11434') !== false) {
-        $args['reject_unsafe_urls'] = false;
-        $args['timeout'] = 60; // 60 seconds for model inference
-    }
-    return $args;
-}, 10, 2);
-
-// Bypass credential validation — Ollama needs no API keys.
-add_filter('ai_experiments_pre_has_valid_credentials_check', function ($valid) {
-    error_log('ai_experiments_pre_has_valid_credentials_check called with: ' . var_export($valid, true));
-
-    if ($valid !== null) {
-        error_log('  Returning early with: ' . var_export($valid, true));
-        return $valid;
-    }
-
-    if (!class_exists(AiClient::class)) {
-        error_log('  AiClient class not found');
-        return $valid;
-    }
-
-    $registry = AiClient::defaultRegistry();
-    $isConfigured = $registry->isProviderConfigured('ollama');
-    error_log('  Ollama isProviderConfigured: ' . ($isConfigured ? 'YES' : 'NO'));
-
-    if ($isConfigured) {
-        error_log('  Returning TRUE for Ollama');
-        return true;
-    }
-
-    error_log('  Returning NULL');
-    return $valid;
-});
-
-
-// Debug: Log when WordPress searches for models
-add_action('init', function() {
-    if (!class_exists(AiClient::class)) {
-        return;
-    }
-
-    $registry = AiClient::defaultRegistry();
-
-    // Try to find text generation models through the registry
-    try {
-        $requirements = new \WordPress\AiClient\Providers\Models\DTO\ModelRequirements(
-            [\WordPress\AiClient\Providers\Models\Enums\CapabilityEnum::textGeneration()],
-            []
-        );
-        $results = $registry->findModelsMetadataForSupport($requirements);
-        error_log('Registry findModelsMetadataForSupport returned ' . count($results) . ' provider groups');
-        foreach ($results as $providerModels) {
-            $providerId = $providerModels->getProvider()->getId();
-            $models = $providerModels->getModels();
-            error_log('  Provider ' . $providerId . ' has ' . count($models) . ' text generation models');
-        }
-    } catch (\Exception $e) {
-        error_log('Registry search ERROR: ' . $e->getMessage());
-    }
-}, 999);
+add_action( 'plugins_loaded', __NAMESPACE__ . '\\load' );

package/wp-plugins/ai-provider-for-ollama/readme.txt

@@ -0,0 +1,110 @@
+=== AI Provider for Ollama ===
+Contributors:      fueled, 10up
+Tags:              ai, ollama, llm, local-ai, connector
+Requires at least: 7.0
+Tested up to:      7.0
+Stable tag:        1.1.1
+Requires PHP:      7.4
+License:           GPL-2.0-or-later
+License URI:       https://www.gnu.org/licenses/gpl-2.0.html
+
+Ollama provider for the WordPress AI Client.
+
+== Description ==
+
+This plugin provides [Ollama](https://ollama.com/) integration for the WordPress AI Client. It lets WordPress sites use large language models running locally or on a remote Ollama instance for text and image generation and other AI capabilities.
+
+Ollama exposes an [OpenAI-compatible API](https://ollama.com/blog/openai-compatibility), and this provider uses that API to communicate with any model you have pulled into Ollama (Llama, Mistral, Gemma, Phi, and many more).
+
+**Features:**
+
+* Text generation with any Ollama model
+* Image generation with supported models
+* Automatic model discovery from your Ollama instance
+* Function calling support
+* Structured output (JSON mode) support
+* Settings page for host URL and seeing available models
+* Works without an API key for local instances
+
+**Requirements:**
+
+* PHP 7.4 or higher
+* WordPress 7.0 or higher
+* Ollama running locally or on a remote server (like Ollama Cloud)
+
+== Installation ==
+
+1. Upload the plugin files to `/wp-content/plugins/ai-provider-for-ollama/`.
+2. Activate the plugin through the 'Plugins' menu in WordPress.
+3. Go to **Settings > Ollama** to configure the host URL and see available models.
+
+== Frequently Asked Questions ==
+
+= How do I install Ollama? =
+
+Visit [ollama.com](https://ollama.com/) to download and install Ollama for your platform. Once installed, pull a model (example `ollama pull llama3.2`) and the provider will automatically discover it.
+
+= Do I need an API key? =
+
+No. For local Ollama instances, no API key is needed. The plugin automatically handles authentication for local setups.
+
+For remote Ollama instances that require authentication, enter the API key in the **Settings > Connectors** screen. If using Ollama Cloud, you also need to set your Ollama host URL in the **Settings > Ollama** screen to `https://ollama.com`.
+
+= How do I change the Ollama host URL? =
+
+By default, the provider connects to `http://localhost:11434`. You can change this in two ways:
+
+1. Set the `OLLAMA_HOST` environment variable (takes precedence).
+2. Go to **Settings > Ollama** in the WordPress admin and enter your host URL.
+
+== Screenshots ==
+
+1. Settings > Ollama screen showing available AI models and Host URL configuration.
+
+== Changelog ==
+
+= 1.1.1 - 2026-05-14 =
+
+**Added**
+- Ensure the AI plugin sees Ollama as a valid, connected provider within the status dashboard widget (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#55](https://github.com/Fueled/ai-provider-for-ollama/pull/55)).
+
+**Fixed**
+- More robust path inclusion for the logo (props [@dkotter](https://github.com/dkotter), [@abcdatos](https://profiles.wordpress.org/abcdatos/) via [#61](https://github.com/Fueled/ai-provider-for-ollama/pull/61)).
+
+= 1.1.0 - 2026-04-23 =
+
+* **Added:** Support for image generation when using compatible models (props [@milindmore22](https://github.com/milindmore22), [@dkotter](https://github.com/dkotter) via [#30](https://github.com/Fueled/ai-provider-for-ollama/pull/30)).
+* **Added:** Integrate with the `wpai_has_ai_credentials` filter to ensure the AI plugin sees Ollama as a valid, connected provider (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#43](https://github.com/Fueled/ai-provider-for-ollama/pull/43)).
+* **Added:** Show the capabilities of each model next to the model name on our settings page (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#51](https://github.com/Fueled/ai-provider-for-ollama/pull/51)).
+* **Changed:** Increase the standard timeout to be 60 seconds for text generation (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#49](https://github.com/Fueled/ai-provider-for-ollama/pull/49)).
+* **Fixed:** Properly parse structured outputs (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#49](https://github.com/Fueled/ai-provider-for-ollama/pull/49)).
+
+= 1.0.3 - 2026-03-25 =
+
+* **Changed:** Removed AI Client dependency FAQ entry (props [@raftaar1191](https://github.com/raftaar1191) via [#29](https://github.com/Fueled/ai-provider-for-ollama/pull/29)).
+* **Fixed:** Ensure the vendor directory ends up in our final release (props [@soderlind](https://github.com/soderlind), [@dkotter](https://github.com/dkotter) via [#31](https://github.com/Fueled/ai-provider-for-ollama/pull/31)).
+
+= 1.0.2 - 2026-03-23 =
+
+* **Changed:** Updated plugin display name and slug per WPORG feedback (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#25](https://github.com/Fueled/ai-provider-for-ollama/pull/25)).
+
+= 1.0.1 - 2026-03-20 =
+
+* **Added:** Support for the provider description and logo path (props [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#13](https://github.com/Fueled/ai-provider-for-ollama/pull/13)).
+* **Changed:** Display name and slug to meet WPORG Plugin team requirements (props [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#22](https://github.com/Fueled/ai-provider-for-ollama/pull/22)).
+* **Changed:** Update menu name from Ollama Settings to Ollama (props [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#19](https://github.com/Fueled/ai-provider-for-ollama/pull/19)).
+* **Fixed:** Ensure we properly check if the provider is connected rather than defaulting to always showing as connected (props [@raftaar1191](https://github.com/raftaar1191), [@dkotter](https://github.com/dkotter) via [#17](https://github.com/Fueled/ai-provider-for-ollama/pull/17)).
+
+= 1.0.0 - 2026-03-05 =
+
+* Initial release
+* Text generation with Ollama models via the OpenAI-compatible API
+* Automatic model discovery from the Ollama instance
+* Settings page for host URL and default model
+* Function calling and structured output support
+
+== Upgrade Notice ==
+
+= 1.0.0 =
+
+Initial release.

package/wp-plugins/ai-provider-for-ollama/vendor/autoload.php

@@ -0,0 +1,22 @@
+<?php
+
+// autoload.php @generated by Composer
+
+if (PHP_VERSION_ID < 50600) {
+    if (!headers_sent()) {
+        header('HTTP/1.1 500 Internal Server Error');
+    }
+    $err = 'Composer 2.3.0 dropped support for autoloading on PHP <5.6 and you are running '.PHP_VERSION.', please upgrade PHP or use Composer 2.2 LTS via "composer self-update --2.2". Aborting.'.PHP_EOL;
+    if (!ini_get('display_errors')) {
+        if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
+            fwrite(STDERR, $err);
+        } elseif (!headers_sent()) {
+            echo $err;
+        }
+    }
+    throw new RuntimeException($err);
+}
+
+require_once __DIR__ . '/composer/autoload_real.php';
+
+return ComposerAutoloaderInit493d072e40e7a82570eb5a313d494b45::getLoader();