mindwebconcierge

<p>Mind Web Concierge brings intelligent AI assistance directly to your WordPress website. Powered by RAG (Retrieval-Augmented Generation) technology, it understands your content and delivers accurate, context-aware responses to your visitors in real time.</p>
<p>It allows you to:</p>
<ul>
<li>Provide instant automated responses to visitors</li>
<li>Improve customer engagement and retention</li>
<li>Reduce support workload</li>
<li>Deliver 24/7 AI-powered assistance</li>
<li>Index WordPress posts, pages, and WooCommerce products automatically</li>
<li>Connect any OpenAI-compatible language model via the LLM settings panel</li>
<li>Link a Mind Spaces workspace where you can upload documents and ask questions about them directly</li>
<li>Use Local Thinking mode to let visitors ask questions focused on the current page content and any linked Mind Spaces notebooks assigned to that page</li>
</ul>
<p>Perfect for:</p>
<ul>
<li>Business websites</li>
<li>E-commerce stores</li>
<li>Service providers</li>
<li>Corporate portals</li>
</ul>
<p>Easy to install, configure, and scale.</p>
<h3>Data Handling</h3>
<p>This plugin stores chatbot conversation logs and metadata in the WordPress database. The following visitor data is collected per conversation: session ID, IP address, screen resolution, user agent (browser info), accepted language, referrer URL, timezone, and platform. Data is accessible only to authorized administrators. Depending on configuration, conversation content may be sent to external services for AI processing.</p>
<h3>External Services</h3>
<p>This plugin connects to the following external services operated by Smart Processes. Data is transmitted to these services during normal plugin operation.</p>
<h4>RAG API</h4>
<ul>
<li>URL: https://rag.smartprocesses.cloud</li>
<li>Purpose: Content indexing, category management, and AI-generated streaming responses.</li>
<li>Data sent: WordPress post content, WooCommerce product data, visitor questions.</li>
</ul>
<h4>Mind Spaces API</h4>
<ul>
<li>URL: https://spaces.smartmind.services</li>
<li>Purpose: Authentication, space retrieval, document-based knowledge access, and knowledge base management.</li>
<li>Data sent: Authentication tokens derived from administrator login, space queries, and related knowledge base requests.</li>
</ul>
<p>Mind Spaces is the knowledge management platform behind Mind Web Concierge. It lets you manage spaces (knowledge bases), upload documents, and ask questions directly to test AI responses. For more information visit: https://spaces.smartmind.services</p>
<h4>Subscription API</h4>
<ul>
<li>URL: https://subscriptions.smartprocesses.cloud</li>
<li>Purpose: Retrieves pricing information and handles subscription billing and management via Stripe, including trial creation, subscription retrieval, cancellations, reactivations, and invoice downloads.</li>
<li>Data sent: App GUID, customer email, Stripe product ID.</li>
</ul>
<h4>Smart Mind Website</h4>
<ul>
<li>URL: https://smartmind.it</li>
<li>Purpose: Provides product information, legal pages, optional pricing display, and the optional “Powered by” link shown in the chatbot widget.</li>
<li>Data sent: No personal visitor data is intentionally transmitted by the plugin to this website during normal operation.</li>
</ul>
<p>The plugin may display links to Smart Mind legal or product pages for administrator reference and optional front-end branding. These links do not process visitor chat content.</p>
<p>The plugin communicates with Smart Processes services only for features explicitly enabled and used by the site administrator, such as AI responses, content indexing, notebook access, pricing retrieval, and subscription management. No personal user data is transmitted without the administrator’s configuration and the visitor’s direct interaction with the chatbot.</p>
<ul>
<li>Privacy Policy: https://smartmind.it/mind-web-privacy-policy/</li>
<li>Terms of Service: https://smartmind.it/mind-web-terms-of-service/</li>
</ul>
<h3>Plugin Constants</h3>
<p>The plugin defines the following internal constants. These are set automatically and do not require manual configuration.</p>
<h4>MINDWECO_RAG_URL</h4>
<p>The base URL for the RAG API service. Used for all indexing, category management, and streaming ask requests.<br />
Value: <code>https://rag.smartprocesses.cloud</code></p>
<h4>MINDWECO_NOTEBOOKS_URL</h4>
<p>The base URL for the Mind Spaces (Notebooks) service. Used for authentication, notebook retrieval, and knowledge base management.<br />
Value: <code>https://spaces.smartmind.services</code></p>
<h4>MINDWECO_STRIPE_URL</h4>
<p>The base URL for the Stripe subscription management API. Used for trial creation, subscription status, cancellation, reactivation, and invoice downloads.<br />
Value: <code>https://subscriptions.smartprocesses.cloud/api</code></p>
<h4>MINDWECO_PROD_ID</h4>
<p>The Stripe Product ID associated with this plugin’s subscription plan. Passed automatically when creating trial subscriptions.<br />
Value: <code>prod_U3VYkOBf6Ngqi3</code></p>
<h4>MINDWECO_POWER_BY</h4>
<p>The URL of the service provider’s product page. Used to display an optional “Powered by” link in the chatbot widget when enabled by the administrator.<br />
Value: <code>https://smartmind.it/</code></p>
<h3>API Reference</h3>
<p>The plugin communicates with external services through the following internal functions.</p>
<h4>Authentication & Token Management</h4>
<p><strong>mindweco_plugin_api_login( $base_url, $username, $password )</strong><br />
Authenticates with the RAG API and retrieves an access token.</p>
<p><strong>mindweco_plugin_refresh_token()</strong><br />
Refreshes the main RAG API access token using stored credentials.</p>
<p><strong>mindweco_plugin_knowledge_repository_get_token()</strong><br />
Returns a valid knowledge repository token, refreshing automatically if expired.</p>
<p><strong>mindweco_plugin_knowledge_repository_refresh_token()</strong><br />
Refreshes the knowledge repository token using stored credentials.</p>
<p><strong>mindweco_plugin_knowledge_repository_login_with_cookie( $base_url, $username, $password, $external_id, $external_name, $type )</strong><br />
Authenticates with the knowledge repository (Mind Spaces) and retrieves an auth token. Also registers the current indexing configuration as an external app connection.</p>
<p><strong>mindweco_plugin_knowledge_repository_logout( $base_url, $external_app_id, $user_id )</strong><br />
Removes the external app connection from the knowledge repository and clears stored credentials.</p>
<h4>Categories</h4>
<p><strong>mindweco_plugin_api_create_category( $base_url, $token, $name, $indexing_id, $sitemap_xml, $language, $parent_id )</strong><br />
Creates a new content category in the RAG service. Called automatically on plugin activation using the site’s nav menu sitemap.</p>
<p><strong>mindweco_plugin_api_get_categories( $base_url, $token )</strong><br />
Retrieves all categories for the authenticated account.</p>
<h4>Indexing</h4>
<p><strong>mindweco_plugin_api_index_items( $base_url, $token, $category_id, $chunk_size, $chunk_overlap, $url, $wp_json, $header_levels, $meta, $local_item_id )</strong><br />
Indexes a WordPress post or page into the knowledge base. Also called automatically when a post is published or updated via the <code>transition_post_status</code> hook.</p>
<p><strong>mindweco_plugin_api_index_products( $base_url, $token, $category_id, $chunk_size, $chunk_overlap, $product_json, $meta, $local_item_id )</strong><br />
Indexes a WooCommerce product into the knowledge base.</p>
<p><strong>mindweco_plugin_api_delete_indexed_items( $base_url, $token, $category_id, $item_id )</strong><br />
Deletes a previously indexed item. Also called automatically when a post is trashed or permanently deleted via the <code>before_delete_post</code> and <code>wp_trash_post</code> hooks.</p>
<h4>Streaming / Ask</h4>
<p><strong>mindweco_ask_page_based_ref( $base_url, $token, $question, $category_id, $category_ids, $top_k, $app_guid, $callback, $items_ids, $conversation_id )</strong><br />
Sends a question to the streaming endpoint and delivers the response via Server-Sent Events (SSE). Uses cURL exclusively because the WordPress HTTP API does not support streaming callbacks. Supports multi-category queries and item-level filtering for Local Thinking mode.</p>
<h4>Stripe / Subscriptions</h4>
<p><strong>mindweco_stripe_add_trial( $stripe_base_url, $app_guid, $product_id, $customer_email, $title, $site_base_url )</strong><br />
Creates a Stripe trial subscription and a new RAG user account simultaneously. Called on plugin activation.</p>
<p><strong>mindweco_stripe_add_trial_without_user( $stripe_base_url, $app_guid, $product_id, $customer_email )</strong><br />
Creates a Stripe trial subscription without creating a user account.</p>
<p><strong>mindweco_stripe_active_subscription( $stripe_base_url, $app_guid )</strong><br />
Retrieves the currently active Stripe subscription for a given app GUID. Called periodically via <code>mindweco_periodic_subscription_check</code> (every 30 minutes) to keep subscription status in sync.</p>
<p><strong>mindweco_get_all_subscriptions( $stripe_base_url, $app_guid )</strong><br />
Retrieves all Stripe subscriptions for a given app GUID.</p>
<p><strong>mindweco_get_history_subscription( $stripe_base_url, $app_guid )</strong><br />
Retrieves the full subscription history for a given app GUID.</p>
<p><strong>mindweco_plugin_cancel_subscription( $stripe_base_url, $app_guid, $subscription_id, $cancel )</strong><br />
Cancels an active Stripe subscription. Also called automatically on plugin deactivation.</p>
<p><strong>mindweco_plugin_reactivate_subscription( $stripe_base_url, $app_guid, $subscription_id, $cancel )</strong><br />
Reactivates a previously cancelled Stripe subscription.</p>
<p><strong>mindweco_download_subscription_invoice( $stripe_base_url, $invoice_number )</strong><br />
Retrieves the PDF download URL for a given invoice number.</p>
<h4>LLM Configuration</h4>
<p><strong>mindweco_plugin_create_attach_llm_to_config( $base_url, $token, $name, $llm_base_url, $model_name, $provider, $api_key, $indexing_id )</strong><br />
Creates a new LLM configuration and attaches it to an existing indexing configuration. The API key is encrypted before being stored using AES-256-CBC via <code>mindweco_encrypt_api_key()</code>.</p>
<p><strong>mindweco_plugin_update_llm_config( $base_url, $token, $llm_id, $name, $api_key, $llm_base_url, $model_name, $user_id )</strong><br />
Updates an existing LLM configuration.</p>
<p><strong>mindweco_plugin_delete_llm_config( $base_url, $token, $llm_id )</strong><br />
Deletes an LLM configuration by ID and clears all related options from the WordPress database.</p>
<h4>Mind Spaces / Notebooks</h4>
<p><strong>mindweco_plugin_get_notebooks( $base_url, $token )</strong><br />
Retrieves all notebooks (spaces) from the Mind Spaces knowledge repository.</p>
<h4>Page-Based Notebooks</h4>
<p>Notebooks can be assigned to specific WordPress pages via the admin UI. These mappings are stored in the <code>mindweco_page_based_notebooks</code> option as an array keyed by page ID, each containing a <code>title</code> and a <code>notebooks</code> array of notebook IDs.</p>
<p>At runtime, <code>mindweco_get_notebooks_for_page( $post_id )</code> looks up the current page’s title and returns its assigned notebook IDs. These are merged into the category_ids sent to the streaming endpoint.</p>
<h3>Videos</h3>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/Y8d5Sn0xg2I?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h3>Privacy Policy</h3>
<p>This plugin transmits the following data to external services operated by Smart Processes:</p>
<ul>
<li>WordPress post and page content (for indexing)</li>
<li>WooCommerce product data (for indexing, if WooCommerce is active)</li>
<li>Visitor questions typed into the chat widget</li>
<li>Authentication tokens derived from administrator login (for API authentication)</li>
<li>Customer email and subscription data (for Stripe billing)</li>
</ul>
<p>The following visitor metadata is stored in the WordPress database per conversation session:</p>
<ul>
<li>IP address</li>
<li>User agent (browser and OS information)</li>
<li>Screen resolution</li>
<li>Accepted language</li>
<li>Referrer URL</li>
<li>Timezone</li>
<li>Platform</li>
</ul>
<p>Data is transmitted to the following services:</p>
<ul>
<li>RAG API: https://rag.smartprocesses.cloud</li>
<li>Mind Spaces: https://spaces.smartmind.services</li>
<li>Subscription API: https://subscriptions.smartprocesses.cloud/api</li>
<li>Smart Mind Website: https://smartmind.it</li>
</ul>
<p>A session cookie named <code>mindweco_sid</code> is set in the visitor’s browser containing only a randomly generated session ID (UUID v4). It is automatically deleted when the browser tab or window is closed.</p>
<p>Access tokens and passwords are encrypted at rest in the WordPress database<br />
using AES-256-CBC encryption tied to the site’s unique AUTH_KEY.</p>
<h4>Browser Local Storage</h4>
<p>This plugin stores the following data in the visitor’s browser localStorage to preserve UI preferences across page loads:</p>
<ul>
<li>mindweco-theme-mode – stores the visitor’s preferred color theme (light or dark).</li>
<li>mindweco_ask_only_current_page_{post_id} – stores the state of the Local Thinking toggle per page.</li>
<li>pinned_{message_id} – stores which chat messages the visitor has pinned.</li>
<li>cit_{message_id} – stores citation/source references for bot responses.</li>
</ul>
<p>All data is stored locally in the visitor’s browser only. None of this data is transmitted to external servers. It is automatically cleared when the visitor starts a new chat session.</p>
<p>The subscription service may also be contacted server-side to retrieve pricing and billing-related information for the plugin’s subscription features.</p>
<p>The Smart Mind website may be referenced for legal pages, product information, optional pricing display, and optional front-end branding links.</p>
<p>For full details on how data is collected, processed, and protected, please refer to our Privacy Policy:<br />
https://smartmind.it/mind-web-privacy-policy/</p>


Mind Web Concierge

Mind Web Concierge is an intelligent WordPress assistant powered by RAG technology. It acts as a digital concierge for your website - guiding users th …

Selvakumar Duraipandian

<p>Markdown for AI Agents is a lightweight WordPress plugin that enables HTTP content negotiation for your site’s content. When a client (like an AI agent or a custom script) requests a page with the <code>Accept: text/markdown</code> header, the plugin intercepts the request and returns a clean, structured Markdown representation of the post or page content.</p>
<p>This is ideal for AI crawlers, RAG (Retrieval-Augmented Generation) systems, and non-browser clients that prefer machine-friendly text over complex HTML.</p>
<p><strong>Important note:</strong> This plugin is primarily a developer/integration tool. Human visitors browsing your site will never see any difference — the Markdown output is only served when explicitly requested via the <code>Accept: text/markdown</code> HTTP header. Normal browser requests always receive the standard HTML page.</p>
<p><strong>Key Features:</strong></p>
<ul>
<li>Automatically detects <code>Accept: text/markdown</code> headers.</li>
<li>Converts HTML content to clean Markdown using the League HTMLToMarkdown library.</li>
<li>Strips away theme layout, navigation, headers, footers, and sidebars — serving only the main content.</li>
<li>Adds useful HTTP response headers: <code>Content-Type: text/markdown</code>, <code>Vary: Accept</code>, and <code>X-Markdown-Word-Count</code>.</li>
<li>Respects WordPress visibility rules and filters.</li>
<li>No configuration required — works out of the box for posts, pages, and custom post types.</li>
</ul>
<h3>How It Works</h3>
<p>This plugin uses a standard web technique called <strong>HTTP content negotiation</strong>. The same URL on your site can serve different representations of the same content depending on what the client asks for:</p>
<ul>
<li>A regular browser sends <code>Accept: text/html</code> <span aria-hidden="true" class="wp-exclude-emoji">→</span> receives your normal HTML page.</li>
<li>An AI agent sends <code>Accept: text/markdown</code> <span aria-hidden="true" class="wp-exclude-emoji">→</span> receives a clean Markdown version of the same page.</li>
</ul>
<p>No extra URLs, no duplicate content, no configuration needed. The plugin hooks into WordPress’s <code>template_redirect</code> action, detects the <code>Accept</code> header, captures the rendered HTML, converts it to Markdown, and returns it with appropriate headers.</p>
<h3>Why Markdown for AI Agents?</h3>
<p>When building RAG (Retrieval-Augmented Generation) applications or AI pipelines that ingest web content, HTML is extremely noisy. A typical WordPress page contains thousands of tokens worth of HTML tags, inline styles, navigation menus, scripts, and layout markup — none of which carries meaning for an AI model.</p>
<p>Serving clean Markdown instead can reduce token consumption by up to 60%, which means:</p>
<ul>
<li><strong>Lower API costs</strong> — fewer tokens ingested when loading pages into vector stores or LLM pipelines.</li>
<li><strong>Faster processing</strong> — less text for the model to parse, filter, and discard.</li>
<li><strong>Better retrieval accuracy</strong> — higher signal-to-noise ratio improves the quality of RAG results.</li>
<li><strong>Simpler pipelines</strong> — no need for custom HTML stripping logic on the client side; the plugin handles it server-side.</li>
</ul>
<p>Any AI agent, crawler, or ingestion script that sends <code>Accept: text/markdown</code> in its request header will automatically receive the clean Markdown version — no extra URLs, no separate endpoints, no changes to your content workflow.</p>


Markdown for AI Agents

Serve clean Markdown versions of WordPress content to AI agents using HTTP content negotiation.

Mind Web Concierge vs Markdown for AI Agents