flock-core 0.4.0b46__py3-none-any.whl → 0.4.0b49__py3-none-any.whl

flock/webapp/app/services/flock_service.py

@@ -1,5 +1,5 @@
 # src/flock/webapp/app/services/flock_service.py
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, Any, Optional
 
 import yaml
 
@@ -248,25 +248,50 @@ def remove_agent_from_current_flock_service(agent_name: str, app_state: object)
 
 
 async def run_current_flock_service(
-    start_agent_name: str, inputs: dict, app_state: object
-) -> dict | str:
-    """Runs the Flock instance from app_state."""
-    current_flock: Flock | None = getattr(app_state, 'flock_instance', None)
+    start_agent_name: str,
+    inputs: dict[str, Any],
+    app_state: Any,
+) -> dict[str, Any]:
+    """Runs the specified agent from the current flock instance in app_state."""
+    logger.info(f"Attempting to run agent: {start_agent_name} using flock from app_state.")
+
+    current_flock: Flock | None = getattr(app_state, "flock_instance", None)
+    run_store: RunStore | None = getattr(app_state, "run_store", None)
+
     if not current_flock:
-        logger.error("Service: Execution failed, no flock loaded.")
-        return "Error: No flock loaded."
-    if not start_agent_name or start_agent_name not in current_flock.agents:
-        logger.error(f"Service: Execution failed, start agent '{start_agent_name}' not found in flock '{current_flock.name}'.")
-        return f"Error: Start agent '{start_agent_name}' not found."
+        logger.error("Run service: No Flock instance available in app_state.")
+        return {"error": "No Flock loaded in the application."}
+    if not run_store:
+        logger.error("Run service: No RunStore instance available in app_state.")
+        # Attempt to initialize a default run_store if missing and this service is critical
+        # This might indicate an issue in the application lifecycle setup
+        logger.warning("Run service: Initializing a default RunStore as none was found in app_state.")
+        run_store = RunStore()
+        setattr(app_state, "run_store", run_store)
+        # Also update global DI if this is how it's managed elsewhere for consistency,
+        # though ideally DI setup handles this more centrally.
+        # from flock.webapp.app.dependencies import set_global_flock_services
+        # set_global_flock_services(current_flock, run_store)
+
+
+    if start_agent_name not in current_flock.agents:
+        logger.error(f"Run service: Agent '{start_agent_name}' not found in current flock '{current_flock.name}'.")
+        return {"error": f"Agent '{start_agent_name}' not found."}
+
     try:
-        logger.info(f"Service: Running flock '{current_flock.name}' starting with agent '{start_agent_name}'.")
+        logger.info(f"Executing agent '{start_agent_name}' from flock '{current_flock.name}' using app_state.")
+        # Direct execution using the flock from app_state
         result = await current_flock.run_async(
             start_agent=start_agent_name, input=inputs, box_result=False
         )
+        # Store run details using the run_store from app_state
+        if hasattr(run_store, "add_run_details"): # Check if RunStore has this method
+            run_id = result.get("run_id", "unknown_run_id") # Assuming run_async result might contain run_id
+            run_store.add_run_details(run_id=run_id, agent_name=start_agent_name, inputs=inputs, outputs=result)
         return result
     except Exception as e:
-        logger.error(f"Service: Error during flock execution for '{current_flock.name}': {e}", exc_info=True)
-        return f"Error: {e!s}"
+        logger.error(f"Run service: Error during agent execution: {e}", exc_info=True)
+        return {"error": f"An error occurred: {e}"}
 
 
 def get_registered_items_service(item_type: str) -> list[dict]:

flock/webapp/app/services/sharing_models.py

@@ -0,0 +1,43 @@
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class SharedLinkConfig(BaseModel):
+    """Configuration for a shared Flock agent execution link or chat session."""
+
+    share_id: str = Field(..., description="Unique identifier for the shared link.")
+    agent_name: str = Field(..., description="The name of the agent being shared (for run) or the chat agent (for chat).")
+    flock_definition: str = Field(..., description="The YAML/JSON string definition of the Flock the agent belongs to.")
+    created_at: datetime = Field(
+        default_factory=datetime.utcnow, description="Timestamp of when the link was created."
+    )
+    share_type: str = Field(default="agent_run", description="Type of share: 'agent_run' or 'chat'")
+
+    # Chat-specific settings (only relevant if share_type is 'chat')
+    chat_message_key: str | None = Field(None, description="Message key for chat input mapping.")
+    chat_history_key: str | None = Field(None, description="History key for chat input mapping.")
+    chat_response_key: str | None = Field(None, description="Response key for chat output mapping.")
+
+    # Placeholder for future enhancement: pre-filled input values
+    # input_values: Optional[Dict[str, Any]] = Field(
+    #     None, description="Optional pre-filled input values for the agent."
+    # )
+
+    model_config = {
+        "from_attributes": True,
+        "json_schema_extra": {
+            "examples": [
+                {
+                    "share_id": "abcdef123456",
+                    "agent_name": "MyChatAgent",
+                    "flock_definition": "name: MySharedFlock\nagents:\n  MyChatAgent:\n    input: 'message: str'\n    output: 'response: str'\n    # ... rest of flock YAML ...",
+                    "created_at": "2023-10-26T10:00:00Z",
+                    "share_type": "chat",
+                    "chat_message_key": "user_input",
+                    "chat_history_key": "conversation_history",
+                    "chat_response_key": "agent_output"
+                }
+            ]
+        }
+    }

flock/webapp/app/services/sharing_store.py

@@ -0,0 +1,156 @@
+import logging
+import sqlite3
+from abc import ABC, abstractmethod
+from pathlib import Path
+
+import aiosqlite
+
+from flock.webapp.app.services.sharing_models import SharedLinkConfig
+
+# Get a logger instance
+logger = logging.getLogger(__name__)
+
+class SharedLinkStoreInterface(ABC):
+    """Interface for storing and retrieving shared link configurations."""
+
+    @abstractmethod
+    async def initialize(self) -> None:
+        """Initialize the store (e.g., create tables)."""
+        pass
+
+    @abstractmethod
+    async def save_config(self, config: SharedLinkConfig) -> SharedLinkConfig:
+        """Saves a shared link configuration."""
+        pass
+
+    @abstractmethod
+    async def get_config(self, share_id: str) -> SharedLinkConfig | None:
+        """Retrieves a shared link configuration by its ID."""
+        pass
+
+    @abstractmethod
+    async def delete_config(self, share_id: str) -> bool:
+        """Deletes a shared link configuration by its ID. Returns True if deleted, False otherwise."""
+        pass
+
+class SQLiteSharedLinkStore(SharedLinkStoreInterface):
+    """SQLite implementation for storing and retrieving shared link configurations."""
+
+    def __init__(self, db_path: str):
+        self.db_path = Path(db_path)
+        self.db_path.parent.mkdir(parents=True, exist_ok=True) # Ensure directory exists
+        logger.info(f"SQLiteSharedLinkStore initialized with db_path: {self.db_path}")
+
+    async def initialize(self) -> None:
+        """Initializes the database and creates/updates the table if it doesn't exist."""
+        try:
+            async with aiosqlite.connect(self.db_path) as db:
+                # Ensure the table exists with the base schema first
+                await db.execute(
+                    """
+                    CREATE TABLE IF NOT EXISTS shared_links (
+                        share_id TEXT PRIMARY KEY,
+                        agent_name TEXT NOT NULL,
+                        flock_definition TEXT NOT NULL,
+                        created_at TEXT NOT NULL
+                        /* New columns will be added below if they don't exist */
+                    )
+                    """
+                )
+
+                # Add new columns individually, ignoring errors if they already exist
+                new_columns = [
+                    ("share_type", "TEXT DEFAULT 'agent_run' NOT NULL"),
+                    ("chat_message_key", "TEXT"),
+                    ("chat_history_key", "TEXT"),
+                    ("chat_response_key", "TEXT")
+                ]
+
+                for column_name, column_type in new_columns:
+                    try:
+                        await db.execute(f"ALTER TABLE shared_links ADD COLUMN {column_name} {column_type}")
+                        logger.info(f"Added column '{column_name}' to shared_links table.")
+                    except sqlite3.OperationalError as e:
+                        if "duplicate column name" in str(e).lower():
+                            logger.debug(f"Column '{column_name}' already exists in shared_links table.")
+                        else:
+                            raise # Re-raise if it's a different operational error
+
+                await db.commit()
+            logger.info(f"Database initialized and shared_links table schema ensured at {self.db_path}")
+        except sqlite3.Error as e:
+            logger.error(f"SQLite error during initialization: {e}", exc_info=True)
+            raise
+
+    async def save_config(self, config: SharedLinkConfig) -> SharedLinkConfig:
+        """Saves a shared link configuration to the SQLite database."""
+        try:
+            async with aiosqlite.connect(self.db_path) as db:
+                await db.execute(
+                    """INSERT INTO shared_links (
+                        share_id, agent_name, created_at, flock_definition, 
+                        share_type, chat_message_key, chat_history_key, chat_response_key
+                    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)""",
+                    (
+                        config.share_id,
+                        config.agent_name,
+                        config.created_at.isoformat(),
+                        config.flock_definition,
+                        config.share_type,
+                        config.chat_message_key,
+                        config.chat_history_key,
+                        config.chat_response_key,
+                    ),
+                )
+                await db.commit()
+            logger.info(f"Saved shared link config for ID: {config.share_id} with type: {config.share_type}")
+            return config
+        except sqlite3.Error as e:
+            logger.error(f"SQLite error saving config for ID {config.share_id}: {e}", exc_info=True)
+            raise
+
+    async def get_config(self, share_id: str) -> SharedLinkConfig | None:
+        """Retrieves a shared link configuration from SQLite by its ID."""
+        try:
+            async with aiosqlite.connect(self.db_path) as db:
+                async with db.execute(
+                    """SELECT 
+                        share_id, agent_name, created_at, flock_definition, 
+                        share_type, chat_message_key, chat_history_key, chat_response_key 
+                    FROM shared_links WHERE share_id = ?""",
+                    (share_id,)
+                ) as cursor:
+                    row = await cursor.fetchone()
+            if row:
+                logger.debug(f"Retrieved shared link config for ID: {share_id}")
+                return SharedLinkConfig(
+                    share_id=row[0],
+                    agent_name=row[1],
+                    created_at=row[2], # SQLite stores as TEXT, Pydantic will parse from ISO format
+                    flock_definition=row[3],
+                    share_type=row[4],
+                    chat_message_key=row[5],
+                    chat_history_key=row[6],
+                    chat_response_key=row[7],
+                )
+            logger.debug(f"No shared link config found for ID: {share_id}")
+            return None
+        except sqlite3.Error as e:
+            logger.error(f"SQLite error retrieving config for ID {share_id}: {e}", exc_info=True)
+            return None # Or raise, depending on desired error handling
+
+    async def delete_config(self, share_id: str) -> bool:
+        """Deletes a shared link configuration from SQLite by its ID."""
+        try:
+            async with aiosqlite.connect(self.db_path) as db:
+                result = await db.execute("DELETE FROM shared_links WHERE share_id = ?", (share_id,))
+                await db.commit()
+                deleted_count = result.rowcount
+            if deleted_count > 0:
+                logger.info(f"Deleted shared link config for ID: {share_id}")
+                return True
+            logger.info(f"Attempted to delete non-existent shared link config for ID: {share_id}")
+            return False
+        except sqlite3.Error as e:
+            logger.error(f"SQLite error deleting config for ID {share_id}: {e}", exc_info=True)
+            return False # Or raise

flock/webapp/static/css/chat.css

@@ -240,3 +240,60 @@ body:not(.chat-page) .chat-settings-form .grid button:first-child {
 main.main-content:has(#chat-container) {
     overflow: hidden;
 }
+
+/* Ensure all direct text and common markdown elements within bot bubbles use the bot's text color */
+.bubble.bot,
+.bubble.bot p,
+.bubble.bot li,
+.bubble.bot h1,
+.bubble.bot h2,
+.bubble.bot h3,
+.bubble.bot h4,
+.bubble.bot h5,
+.bubble.bot h6,
+.bubble.bot strong,
+.bubble.bot em,
+.bubble.bot table,
+.bubble.bot th,
+.bubble.bot td {
+    color: var(--pico-code-color);
+}
+
+/* For links specifically within bot messages, you might want them to also use the bot text color */
+.bubble.bot a {
+    color: var(--pico-code-color);
+    text-decoration: underline; /* Or your preferred link style */
+}
+.bubble.bot a:hover {
+    color: var(--pico-primary-hover, var(--pico-primary));
+    text-decoration: underline;
+}
+
+/* Styling for code blocks generated by Markdown and highlighted by Prism.js */
+/* The prism-okaidia theme will handle the internal colors of the code. */
+/* This is more about the container of the code block. */
+.bubble.bot pre[class*="language-"] {
+    background-color: var(--pico-card-background-color); /* Or a slightly different dark shade */
+    border: 1px solid var(--pico-muted-border-color);
+    border-radius: var(--pico-border-radius);
+    padding: 0.75em;
+    margin: 0.5em 0;
+    font-size: 0.875em; /* Adjust as needed */
+    overflow-x: auto; /* Allow horizontal scrolling for long code lines */
+    /* The text color *inside* the code block will be handled by the Prism theme (e.g., Okaidia) */
+}
+
+/* Ensure the code itself inside the pre block also resets its base color if needed,
+   though Prism themes usually take care of this. This is a fallback. */
+.bubble.bot pre[class*="language-"] code {
+    /* color: inherit; */ /* This might not be necessary if Prism theme is comprehensive - try without first */
+    background: none;
+    padding: 0;
+}
+
+/* Styles for preformatted text wrapping */
+.bubble pre {
+    white-space: pre-wrap;  /* Allows wrapping and preserves sequences of white space and newlines */
+    word-wrap: break-word; /* Breaks long words/strings if they would overflow */
+    overflow-x: auto;     /* Adds a scrollbar if content is still too wide */
+}

flock/webapp/templates/chat.html

@@ -6,6 +6,8 @@
     <title>Flock Chat</title>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css" />
     <link rel="stylesheet" href="/static/css/chat.css">
+    {# Prism.js CSS for syntax highlighting (okaidia theme) #}
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-okaidia.min.css" referrerpolicy="no-referrer" />
     {# Inject active theme variables #}
     {% if theme_css %}
     <style>
@@ -17,6 +19,9 @@
     </style>
     {% endif %}
     <script src="https://unpkg.com/htmx.org@1.9.10" integrity="sha384-D1Kt99CQMDuVetoL1lrYwg5t+9QdHe7NLX/SoJYkXDFfX37iInKRy5xLSi8nO7UC" crossorigin="anonymous"></script>
+    {# Prism.js JS (core and components for common languages) #}
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-core.min.js" referrerpolicy="no-referrer"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/autoloader/prism-autoloader.min.js" referrerpolicy="no-referrer"></script>
 </head>
 <body class="chat-page">
     <div id="chat-container">
@@ -25,21 +30,33 @@
                 <h2>Flock Chat</h2>
                 <h3>{{ chat_subtitle }}</h3>
             </hgroup>
-            <button class="secondary outline" hx-get="/chat/htmx/settings-form" hx-target="#chat-content-area" hx-swap="innerHTML" style="min-width:auto;">Settings</button>
+            {% if not is_shared_chat %}
+            <button class="secondary outline" hx-get="/chat/settings-standalone" hx-target="#chat-content-area" hx-swap="innerHTML" style="min-width:auto;">Settings</button>
+            {% else %}
+            {# Optionally, could show a disabled settings button or some other indicator #}
+            <span style="font-size: 0.8rem; color: var(--pico-muted-color);">Settings frozen for shared session.</span>
+            {% endif %}
         </div>
 
         <div id="chat-content-area">
-            <div id="chat-log" hx-get="/chat/messages" hx-trigger="load" hx-swap="innerHTML">
+            <div id="chat-log" 
+                 hx-get="{% if is_shared_chat %}/chat/messages-shared/{{ share_id }}{% else %}/chat/messages{% endif %}" 
+                 hx-trigger="load" {# Polling removed #}
+                 hx-swap="innerHTML">
                 <p><em>Loading chat…</em></p>
             </div>
             
             <form id="chat-form-standalone"
-                  hx-post="/chat/send"
+                  hx-post="{% if is_shared_chat %}/chat/send-shared{% else %}/chat/send{% endif %}"
                   hx-target="#chat-log"
                   hx-swap="innerHTML"
                   hx-disabled-elt="input[name='message'], button[type='submit']"
                   hx-on::before-request="htmx.find('#chat-form-standalone button[type=\'submit\']').textContent = 'Sending...'"
                   hx-on::after-request="htmx.find('#chat-form-standalone button[type=\'submit\']').textContent = 'Send'; this.reset();">
+                
+                {% if is_shared_chat %}
+                <input type="hidden" name="share_id" value="{{ share_id }}">
+                {% endif %}
                 <input type="text" name="message" placeholder="Type a message…" required autofocus>
                 <button type="submit">Send</button>
             </form>
@@ -57,9 +74,17 @@
             log.scrollTop = log.scrollHeight;
         }
         document.addEventListener('htmx:afterSwap', e => {
-            if (e.detail.target.id === 'chat-log') scrollBottom();
+            if (e.detail.target.id === 'chat-log') {
+                scrollBottom();
+                // Re-run Prism highlighting after new content is swapped in
+                Prism.highlightAllUnder(log);
+            }
         });
         window.addEventListener('load', scrollBottom);
+        // Initial highlight on page load for any pre-existing content
+        document.addEventListener('DOMContentLoaded', () => {
+            Prism.highlightAll();
+        });
     })();
 </script>
 </body>

flock/webapp/templates/partials/_chat_messages.html

@@ -6,7 +6,7 @@
         </div>
     {% else %}
         <div class="bubble bot">
-            {{ entry.text }}
+            {{ entry.text | safe }}
             <span class="chat-timestamp">{{ entry.timestamp|default(now().strftime('%H:%M')) }}{% if entry.agent %} - {{ entry.agent }}{% endif %}{% if entry.duration_ms is defined %} - {{ entry.duration_ms }}ms{% endif %}</span>
         </div>
     {% endif %}

flock/webapp/templates/partials/_chat_settings_form.html

@@ -62,4 +62,26 @@
         <button type="button" class="secondary outline" hx-get="/chat/htmx/chat-view" hx-target="#chat-content-area" hx-swap="innerHTML">Cancel</button>
     </div>
     <div id="chat-settings-saving" class="htmx-indicator" style="text-align:center; margin-top:0.5rem;"><progress indeterminate></progress></div>
+
+    {# Share Chat Link Section #}
+    <div style="margin-top: 1.5rem; padding-top: 1rem; border-top: 1px solid var(--pico-muted-border-color);">
+        <h5 style="margin-bottom: 0.5rem;">Share Chat Configuration</h5>
+        <p><small>Create a shareable link for this chat configuration. The current Flock and these chat settings will be frozen for the shared session.</small></p>
+        <a href="#" 
+           id="shareChatHtmxLink"
+           hx-post="/ui/htmx/share/chat/generate-link" 
+           hx-target="#shareChatLinkDisplayArea" 
+           hx-swap="innerHTML"
+           hx-indicator="#share-chat-loading-indicator"
+           hx-include="closest form"  {# Includes all fields from the parent form #}
+           style="text-decoration: underline; cursor: pointer; color: var(--pico-primary);">
+            Create shareable chat link...
+        </a>
+        <span id="share-chat-loading-indicator" class="htmx-indicator" style="margin-left: 0.5rem;">
+            <progress indeterminate style="width: 100px;"></progress>
+        </span>
+        <div id="shareChatLinkDisplayArea" style="margin-top: 1rem;">
+            <!-- Shareable chat link will be loaded here by HTMX -->
+        </div>
+    </div>
 </form> 

flock/webapp/templates/partials/_execution_form.html

@@ -36,6 +36,20 @@
         </div>
 
         <button type="submit" {% if not flock.agents %}disabled{% endif %}>Run Flock</button>
+
+        <div id="share-agent-link-container" style="margin-top: 0.5rem;">
+            <a href="#" 
+               id="shareAgentHtmxLink"
+               hx-post="/ui/htmx/share/generate-link" 
+               hx-target="#shareLinkDisplayArea" 
+               hx-swap="innerHTML"
+               hx-indicator="#share-loading-indicator"
+               hx-include="#start_agent_name_select"
+               style="text-decoration: underline; cursor: pointer; color: var(--pico-primary);">
+                Create shareable link...
+            </a>
+        </div>
+
         <span id="run-loading-indicator" class="htmx-indicator">
             <progress indeterminate></progress> Running...
         </span>
@@ -45,4 +59,17 @@
     {% else %}
     <p>Load or create a Flock to enable execution.</p>
     {% endif %}
-</article>
+
+    <div id="shareLinkDisplayArea" style="margin-top: 1rem;">
+        <!-- Content will be loaded here by HTMX -->
+    </div>
+
+</article>
+
+<script>
+    document.addEventListener('DOMContentLoaded', function() {
+        // All previous JavaScript for toggling share link visibility is removed.
+        // If there are other unrelated JavaScript functions in this script block,
+        // they would remain.
+    });
+</script>

flock/webapp/templates/partials/_share_chat_link_snippet.html

@@ -0,0 +1,11 @@
+{# This snippet is returned by the /ui/htmx/share/chat/generate-link endpoint #}
+{% if share_url %}
+    <p style="margin-bottom: 0.5rem;"><strong>Shareable Chat Link generated:</strong></p>
+    <input type="text" id="generatedShareChatLinkInput" value="{{ share_url }}" readonly style="width: 100%; margin-bottom: 0.5rem;">
+    <p><small>You can select the link above and copy it (Ctrl+C or Cmd+C).</small></p>
+    <p><small>This link will start a chat session with the agent '{{ agent_name }}' from Flock '{{ flock_name }}' using the currently saved settings.</small></p>
+{% elif error_message %}
+    <p style="color: var(--pico-form-invalid-color);">Error generating chat link: {{ error_message }}</p>
+{% else %}
+    <p><em>Something went wrong, no chat link generated.</em></p>
+{% endif %} 

flock/webapp/templates/partials/_share_link_snippet.html

@@ -0,0 +1,35 @@
+{# This snippet is returned by the /ui/htmx/share/generate-link endpoint #}
+{% if share_url %}
+    <p style="margin-bottom: 0.5rem;"><strong>Shareable Link generated:</strong></p>
+    <input type="text" id="generatedShareLinkInput" value="{{ share_url }}" readonly style="width: 100%; margin-bottom: 0.5rem;">
+    {# <button type="button" onclick="copyGeneratedLinkToClipboard()">Copy Link</button> #}
+    {# <small id="copyGeneratedStatusMsg" style="margin-left: 0.5rem;"></small> #}
+    <p><small>You can select the link above and copy it (Ctrl+C or Cmd+C).</small></p>
+{% elif error_message %}
+    <p style="color: var(--pico-form-invalid-color);">Error: {{ error_message }}</p>
+{% else %}
+    <p><em>Something went wrong, no link generated.</em></p>
+{% endif %}
+
+{# 
+<script>
+    // Minimal JS for copy if desired - but user asked for JS-free.
+    // If you re-add the button, uncomment this.
+    function copyGeneratedLinkToClipboard() {
+        const input = document.getElementById('generatedShareLinkInput');
+        const msg = document.getElementById('copyGeneratedStatusMsg');
+        if (!input || !msg) return;
+
+        input.select();
+        input.setSelectionRange(0, 99999); // For mobile devices
+        try {
+            document.execCommand('copy');
+            msg.textContent = 'Copied!';
+            setTimeout(() => { msg.textContent = ''; }, 2000);
+        } catch (err) {
+            console.error('Failed to copy text: ', err);
+            msg.textContent = 'Failed to copy.';
+        }
+    }
+</script>
+#} 

flock/webapp/templates/shared_run_page.html

@@ -0,0 +1,116 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Flock Shared Agent: {{ selected_agent_name }}</title>
+    
+    {# Link to Pico.css #}
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css" />
+    <link rel="stylesheet" href="/static/css/layout.css">
+    <link rel="stylesheet" href="/static/css/header.css">
+    <link rel="stylesheet" href="/static/css/sidebar.css">
+    <link rel="stylesheet" href="/static/css/components.css">
+    <link rel="stylesheet" href="/static/css/chat.css">
+    <!-- Font Awesome for icons -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+    {# Inline generated theme CSS variables #}
+    {% if theme_css %}
+    <style>
+        /* Start Theme CSS */
+        /* stylelint-disable */
+        {{ theme_css | safe }}
+        /* stylelint-enable */
+        /* End Theme CSS */
+    </style>
+    {% endif %}
+
+    
+    {# HTMX script - ensure this is loaded for the page to work #}
+    <script src="https://unpkg.com/htmx.org@1.9.10" integrity="sha384-D1Kt99CQMDuVetoL1lrYwg5t+9QdHe7NLX/SoJYkXDFfX37iInKRy5xLSi8nO7UC" crossorigin="anonymous"></script>
+    <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.x.x/dist/cdn.min.js"></script>
+</head>
+<body>
+    <main class="main-content">
+        <header>
+            <hgroup>
+                <h2>Run {{ flock.name }} - {{ selected_agent_name }} </h2>
+            </hgroup>
+        </header>
+
+        {% if error_message %}
+            <article class="error-message" role="alert">
+                <strong>Error:</strong> {{ error_message }}
+            </article>
+        {% endif %}
+
+        {% if selected_agent_name and not error_message %} {# Only show form if no fatal error and agent is selected #}
+            <div style="display: flex; gap: var(--pico-spacing, 1rem);">
+                <div style="flex: 1;">
+                    <article id="execution-form-content">
+                        <form id="agent-run-form-shared" 
+                              hx-post="/ui/api/flock/htmx/run-shared" 
+                              hx-target="#results-display" 
+                              hx-swap="innerHTML" 
+                              hx-indicator="#run-loading-indicator">
+                            
+                            {# Hidden input for the fixed agent name #}
+                            <input type="hidden" name="start_agent_name" value="{{ selected_agent_name }}">
+                            
+                            {# Add share_id as a hidden input to be sent with the form #}
+                            <input type="hidden" name="share_id" value="{{ share_id }}">
+
+                            {# flock_definition_str hidden input is no longer needed #}
+                            {# {% if flock_definition_str %} #}
+                            {# <input type="hidden" name="flock_definition_str" value="{{ flock_definition_str }}"> #}
+                            {# {% endif %} #}
+                            
+                            {# Dynamically generated input fields #}
+                            {% if input_fields %}
+                                <h4>Inputs for <code>{{ selected_agent_name }}</code>:</h4>
+                                {% for field in input_fields %}
+                                    <label for="agent_input_{{ field.name }}">
+                                        {{ field.name }} ({{ field.type }})<br>
+                                        {% if field.description %}<small>{{ field.description }}</small>{% endif %}
+                                    </label>
+                                    {% if field.html_type == "checkbox" %}
+                                        <input type="checkbox" id="agent_input_{{ field.name }}" name="agent_input_{{ field.name }}" role="switch">
+                                    {% elif field.html_type == "textarea" %}
+                                        <textarea id="agent_input_{{ field.name }}" name="agent_input_{{ field.name }}" placeholder="{{ field.placeholder | default('Enter value') }}"></textarea>
+                                    {% else %}
+                                        <input type="{{ field.html_type }}" id="agent_input_{{ field.name }}" name="agent_input_{{ field.name }}" placeholder="Enter {{ field.type }} value">
+                                    {% endif %}
+                                {% endfor %}
+                            {% elif flock and selected_agent_name in flock.agents and not flock.agents[selected_agent_name].input %}
+                                <p>Agent <code>{{ selected_agent_name }}</code> requires no inputs.</p>
+                            {% elif not error_message %}
+                                 <p>Could not determine inputs for agent <code>{{ selected_agent_name }}</code>. The input signature might be missing or invalid.</p>
+                            {% endif %}
+
+                            <button type="submit" class="hide-on-request">Run Agent</button>
+                            <span id="run-loading-indicator" class="htmx-indicator">
+                                <progress indeterminate></progress> Running...
+                            </span>
+                        </form>
+                    </article>
+                </div>
+                <section class="right-pane-framed" style="flex: 2; border-left: 1px solid var(--pico-muted-border-color); padding-left: 1.5rem;">
+                    <header style=" border-bottom: 1px solid var(--pico-muted-border-color); margin-bottom: 1rem;">
+                        <h5>Execution Results</h5>
+                    </header>
+                    <div id="results-display">
+                        <p><code>Results will appear here after running the Flock.</code></p>
+                    </div>
+                </section>
+            </div>
+        
+        {% elif not error_message %}
+            <p>This shared link is not configured correctly. No agent specified or an issue occurred loading the configuration.</p>
+        {% endif %}
+
+        <footer class="main-footer">
+            <small>Built with FastAPI, HTMX, Pico.CSS by 🤍 white duck 🦆 - Theme: {{ active_theme_name | default('default') }}</small>
+        </footer>
+    </main>
+</body>
+</html>