solace-agent-mesh 1.6.2__py3-none-any.whl → 1.7.0__py3-none-any.whl

solace_agent_mesh/gateway/http_sse/alembic/versions/20251024_add_projects_table.py

@@ -0,0 +1,135 @@
+"""Add projects table and project_id to sessions
+
+Revision ID: add_projects_table_001
+Revises: 20251015_session_idx
+Create Date: 2025-10-24 10:00:00.000000
+
+"""
+from typing import Sequence, Union
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy import inspect
+
+# revision identifiers, used by Alembic.
+revision: str = 'add_projects_table_001'
+down_revision: Union[str, Sequence[str], None] = '20251015_session_idx'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Create projects table and add project_id to sessions."""
+    bind = op.get_bind()
+    inspector = inspect(bind)
+    existing_tables = inspector.get_table_names()
+    dialect_name = bind.dialect.name
+
+    # Create projects table if it doesn't exist
+    # Note: This table is created without is_global and created_by_user_id columns
+    # as those were removed in the squashed migration
+    if 'projects' not in existing_tables:
+        op.create_table('projects',
+            sa.Column('id', sa.String(), nullable=False),
+            sa.Column('name', sa.String(), nullable=False),
+            sa.Column('user_id', sa.String(), nullable=False),
+            sa.Column('description', sa.Text(), nullable=True),
+            sa.Column('system_prompt', sa.Text(), nullable=True),
+            sa.Column('created_at', sa.BigInteger(), nullable=False),
+            sa.Column('updated_at', sa.BigInteger(), nullable=True),
+            sa.PrimaryKeyConstraint('id')
+        )
+
+    # Add project_id column to sessions if it doesn't exist
+    sessions_columns = [col['name'] for col in inspector.get_columns('sessions')]
+    if 'project_id' not in sessions_columns:
+        if dialect_name == 'sqlite':
+            # SQLite doesn't support ALTER TABLE ADD CONSTRAINT, recreate table
+            op.create_table(
+                'sessions_new',
+                sa.Column('id', sa.String(), nullable=False),
+                sa.Column('name', sa.String(), nullable=True),
+                sa.Column('user_id', sa.String(), nullable=False),
+                sa.Column('agent_id', sa.String(), nullable=True),
+                sa.Column('created_time', sa.BigInteger(), nullable=False),
+                sa.Column('updated_time', sa.BigInteger(), nullable=False),
+                sa.Column('project_id', sa.String(), nullable=True),
+                sa.ForeignKeyConstraint(['project_id'], ['projects.id']),
+                sa.PrimaryKeyConstraint('id')
+            )
+
+            # Copy data from old table
+            op.execute("""
+                INSERT INTO sessions_new (id, name, user_id, agent_id, created_time, updated_time)
+                SELECT id, name, user_id, agent_id, created_time, updated_time
+                FROM sessions
+            """)
+
+            # Drop old table
+            op.drop_table('sessions')
+
+            # Rename new table
+            op.rename_table('sessions_new', 'sessions')
+
+            # Recreate indexes
+            op.create_index('ix_sessions_user_id', 'sessions', ['user_id'])
+            op.create_index('ix_sessions_project_id', 'sessions', ['project_id'])
+        else:
+            # PostgreSQL, MySQL - standard ALTER TABLE
+            op.add_column('sessions', sa.Column('project_id', sa.String(), nullable=True))
+            op.create_index('ix_sessions_project_id', 'sessions', ['project_id'])
+            op.create_foreign_key(
+                'fk_sessions_project_id',
+                'sessions',
+                'projects',
+                ['project_id'],
+                ['id']
+            )
+
+
+def downgrade() -> None:
+    """Downgrade schema - removes project-related changes."""
+    bind = op.get_bind()
+    inspector = inspect(bind)
+    dialect_name = bind.dialect.name
+
+    # Drop project_id column from sessions if it exists
+    sessions_columns = [col['name'] for col in inspector.get_columns('sessions')]
+    if 'project_id' in sessions_columns:
+        if dialect_name == 'sqlite':
+            # SQLite doesn't support ALTER TABLE DROP CONSTRAINT, recreate table
+            op.create_table(
+                'sessions_old',
+                sa.Column('id', sa.String(), nullable=False),
+                sa.Column('name', sa.String(), nullable=True),
+                sa.Column('user_id', sa.String(), nullable=False),
+                sa.Column('agent_id', sa.String(), nullable=True),
+                sa.Column('created_time', sa.BigInteger(), nullable=False),
+                sa.Column('updated_time', sa.BigInteger(), nullable=False),
+                sa.PrimaryKeyConstraint('id')
+            )
+
+            # Copy data from current table (excluding project_id)
+            op.execute("""
+                INSERT INTO sessions_old (id, name, user_id, agent_id, created_time, updated_time)
+                SELECT id, name, user_id, agent_id, created_time, updated_time
+                FROM sessions
+            """)
+
+            # Drop current table
+            op.drop_table('sessions')
+
+            # Rename old table back
+            op.rename_table('sessions_old', 'sessions')
+
+            # Recreate index on user_id
+            op.create_index('ix_sessions_user_id', 'sessions', ['user_id'])
+        else:
+            # PostgreSQL, MySQL - standard ALTER TABLE
+            op.drop_constraint('fk_sessions_project_id', 'sessions', type_='foreignkey')
+            op.drop_index('ix_sessions_project_id', 'sessions')
+            op.drop_column('sessions', 'project_id')
+
+    # Drop projects table if it exists
+    existing_tables = inspector.get_table_names()
+    if 'projects' in existing_tables:
+        op.drop_table('projects')

solace_agent_mesh/gateway/http_sse/alembic/versions/versions_llm.txt

@@ -1,14 +1,14 @@
 # DEVELOPER GUIDE: versions
 
 ## Quick Summary
-This directory contains Alembic database migration files for the HTTP SSE gateway. These migrations handle the evolution of the database schema, including initial table creation, performance optimization through indexing, timestamp format standardization, and task management features with token usage tracking.
+This directory contains Alembic database migration files for the HTTP SSE gateway. These migrations handle the evolution of the database schema, including initial table creation, performance optimization through indexing, timestamp format standardization, and task management features.
 
 ## Files Overview
 - `20250910_d5b3f8f2e9a0_create_initial_database.py` - Creates the initial database schema with sessions and chat_messages tables
 - `20250911_b1c2d3e4f5g6_add_database_indexes.py` - Adds performance indexes for common query patterns
 - `20250916_f6e7d8c9b0a1_convert_timestamps_to_epoch_and_align_columns.py` - Converts datetime columns to epoch milliseconds and standardizes column names
-- `20250928_079e06e9b448_add_tasks_task_events_and_feedback_.py` - Adds task management tables (tasks, task_events, feedback)
-- `20250930_add_token_usage_to_tasks.py` - Adds token usage tracking columns to tasks table
+- `20251006_98882922fa59_add_tasks_events_feedback_chat_tasks.py` - Adds task management tables and replaces chat_messages with chat_tasks
+- `20251015_add_session_performance_indexes.py` - Adds optimized composite indexes for better query performance
 - `versions_llm.txt` - LLM-generated documentation for the versions directory
 
 ## Developer API Reference
@@ -85,46 +85,46 @@ alembic upgrade f6e7d8c9b0a1
 alembic downgrade b1c2d3e4f5g6
 ```
 
-### 20250928_079e06e9b448_add_tasks_task_events_and_feedback_.py
-**Purpose:** Adds task management functionality with tables for tracking tasks, events, and user feedback
+### 20251006_98882922fa59_add_tasks_events_feedback_chat_tasks.py
+**Purpose:** Major schema update that adds task management functionality and replaces chat_messages with chat_tasks
 **Import:** This is an Alembic migration file - not directly imported
 
 **Functions:**
-- `upgrade() -> None` - Creates tasks, task_events, and feedback tables with appropriate indexes and foreign key relationships
-- `downgrade() -> None` - Drops all task-related tables and recreates original session/message indexes
+- `upgrade() -> None` - Creates tasks, task_events, feedback, and chat_tasks tables; drops old chat_messages table and indexes
+- `downgrade() -> None` - Recreates chat_messages table and drops all task-related tables
 
 **Constants/Variables:**
-- `revision: str` - Migration identifier "079e06e9b448"
+- `revision: str` - Migration identifier "98882922fa59"
 - `down_revision: Union[str, Sequence[str], None]` - Previous migration "f6e7d8c9b0a1"
 
 **Usage Examples:**
 ```bash
 # Run this migration
-alembic upgrade 079e06e9b448
+alembic upgrade 98882922fa59
 
 # Rollback this migration
 alembic downgrade f6e7d8c9b0a1
 ```
 
-### 20250930_add_token_usage_to_tasks.py
-**Purpose:** Adds token usage tracking columns to the tasks table for monitoring AI model consumption
+### 20251015_add_session_performance_indexes.py
+**Purpose:** Performance optimization migration that adds composite indexes for optimal query patterns
 **Import:** This is an Alembic migration file - not directly imported
 
 **Functions:**
-- `upgrade() -> None` - Adds token usage columns (total_input_tokens, total_output_tokens, total_cached_input_tokens, token_usage_details) to tasks table
-- `downgrade() -> None` - Removes all token usage columns from tasks table
+- `upgrade() -> None` - Creates optimized composite indexes for user sessions, chat tasks, and task events; removes unused text index
+- `downgrade() -> None` - Removes performance indexes and recreates the original text index
 
 **Constants/Variables:**
-- `revision: str` - Migration identifier "20250930_token_usage"
-- `down_revision: Union[str, None]` - Previous migration "079e06e9b448"
+- `revision: str` - Migration identifier "20251015_session_idx"
+- `down_revision: str | Sequence[str] | None` - Previous migration "98882922fa59"
 
 **Usage Examples:**
 ```bash
 # Run this migration
-alembic upgrade 20250930_token_usage
+alembic upgrade 20251015_session_idx
 
 # Rollback this migration
-alembic downgrade 079e06e9b448
+alembic downgrade 98882922fa59
 
 # Run all migrations to latest
 alembic upgrade head
@@ -139,17 +139,23 @@ alembic history
 alembic revision --autogenerate -m "description"
 ```
 
-**Database Schema After All Migrations:**
+**Final Database Schema After All Migrations:**
 ```sql
 -- Core tables with epoch millisecond timestamps:
 -- sessions: id, name, user_id, agent_id, created_time, updated_time
--- chat_messages: id, session_id, message, sender_type, sender_name, created_time
+-- chat_tasks: id, session_id, user_id, user_message, message_bubbles, task_metadata, created_time, updated_time
 
 -- Task management tables:
 -- tasks: id, user_id, start_time, end_time, status, initial_request_text,
 --        total_input_tokens, total_output_tokens, total_cached_input_tokens, token_usage_details
 -- task_events: id, task_id, user_id, created_time, topic, direction, payload
 -- feedback: id, session_id, task_id, user_id, rating, comment, created_time
+
+-- Performance indexes:
+-- ix_sessions_user_id, ix_sessions_user_updated
+-- ix_chat_tasks_session_user_created
+-- ix_tasks_user_start_time, ix_task_events_task_created
+-- ix_feedback_task_id, ix_feedback_user_id, ix_feedback_created_time
 ```
 
-# content_hash: 93bf894b6e5451feedc0b65a723765d7e6798c6912fb3fc34eaf9548d27e4195
+# content_hash: c1d3d7f6855eba76bdabdb5cc0c7253756faf1583ef349dc503418c611a23bd2

solace_agent_mesh/gateway/http_sse/app.py

@@ -75,20 +75,6 @@ class WebUIBackendApp(BaseGatewayApp):
             "default": True,
             "description": "If true, the gateway will resolve artifact:// URIs found in A2A messages and embed the content as bytes before sending to the UI. If false, URIs are passed through.",
         },
-        {
-            "name": "system_purpose",
-            "required": False,
-            "type": "string",
-            "default": "",
-            "description": "Detailed description of the system's overall purpose, to be optionally used by agents.",
-        },
-        {
-            "name": "response_format",
-            "required": False,
-            "type": "string",
-            "default": "",
-            "description": "General guidelines on how agent responses should be structured, to be optionally used by agents.",
-        },
         {
             "name": "model",
             "required": False,
@@ -202,6 +188,25 @@ class WebUIBackendApp(BaseGatewayApp):
                 },
             },
         },
+        {
+            "name": "platform_service",
+            "required": False,
+            "type": "dict",
+            "default": {},
+            "description": "Configuration for the Platform Service (enterprise features: agents, connectors, deployments).",
+            "dict_schema": {
+                "database_url": {
+                    "type": "string",
+                    "required": False,
+                    "default": None,
+                    "description": (
+                        "Database URL for platform data (agents, connectors, deployments). "
+                        "REQUIRED for platform features to be available. "
+                        "Example: postgresql://user:pass@host:5432/platform_db"
+                    ),
+                },
+            },
+        },
         {
             "name": "task_logging",
             "required": False,