aline-ai 0.6.5__py3-none-any.whl → 0.6.7__py3-none-any.whl

realign/dashboard/widgets/events_table.py

@@ -3,9 +3,6 @@
 import contextlib
 import io
 import json
-import os
-import shutil
-import subprocess
 import traceback
 from datetime import datetime
 from typing import Optional, Set
@@ -20,6 +17,7 @@ from textual.worker import Worker, WorkerState
 from textual.widgets import Button, DataTable, Static
 
 from ...logging_config import setup_logger
+from ..clipboard import copy_text
 from .openable_table import OpenableDataTable
 
 logger = setup_logger("realign.dashboard.events", "dashboard.log")
@@ -613,33 +611,12 @@ class EventsTable(Container):
 
         # Build copy text
         if slack_message:
-            copy_text = str(slack_message) + "\n\n" + str(share_link)
+            text_to_copy = str(slack_message) + "\n\n" + str(share_link)
         else:
-            copy_text = str(share_link)
+            text_to_copy = str(share_link)
 
         # Copy to clipboard
-        copied = False
-        if os.environ.get("TMUX") and shutil.which("pbcopy"):
-            try:
-                copied = (
-                    subprocess.run(
-                        ["pbcopy"],
-                        input=copy_text,
-                        text=True,
-                        capture_output=False,
-                        check=False,
-                    ).returncode
-                    == 0
-                )
-            except Exception:
-                copied = False
-
-        if not copied:
-            try:
-                self.app.copy_to_clipboard(copy_text)
-                copied = True
-            except Exception:
-                copied = False
+        copied = copy_text(self.app, text_to_copy)
 
         suffix = " (copied to clipboard)" if copied else ""
         self.app.notify(f"Share link created{suffix}", title="Share", timeout=4)

realign/dashboard/widgets/sessions_table.py

@@ -3,9 +3,6 @@
 import contextlib
 import io
 import json
-import os
-import shutil
-import subprocess
 import traceback
 from datetime import datetime
 from pathlib import Path
@@ -20,6 +17,7 @@ from textual.worker import Worker, WorkerState
 from textual.widgets import Button, DataTable, Select, Static
 
 from ...logging_config import setup_logger
+from ..clipboard import copy_text
 from .openable_table import OpenableDataTable
 
 logger = setup_logger("realign.dashboard.sessions", "dashboard.log")
@@ -685,33 +683,12 @@ class SessionsTable(Container):
 
         # Build copy text
         if slack_message:
-            copy_text = str(slack_message) + "\n\n" + str(share_link)
+            text_to_copy = str(slack_message) + "\n\n" + str(share_link)
         else:
-            copy_text = str(share_link)
+            text_to_copy = str(share_link)
 
         # Copy to clipboard
-        copied = False
-        if os.environ.get("TMUX") and shutil.which("pbcopy"):
-            try:
-                copied = (
-                    subprocess.run(
-                        ["pbcopy"],
-                        input=copy_text,
-                        text=True,
-                        capture_output=False,
-                        check=False,
-                    ).returncode
-                    == 0
-                )
-            except Exception:
-                copied = False
-
-        if not copied:
-            try:
-                self.app.copy_to_clipboard(copy_text)
-                copied = True
-            except Exception:
-                copied = False
+        copied = copy_text(self.app, text_to_copy)
 
         suffix = " (copied to clipboard)" if copied else ""
         self.app.notify(f"Share link created{suffix}", title="Share", timeout=4)

realign/db/base.py

@@ -57,6 +57,8 @@ class SessionRecord:
     total_turns: Optional[int] = None
     # V12: file mtime when total_turns was cached (for validation)
     total_turns_mtime: Optional[float] = None
+    # V19: agent association
+    agent_id: Optional[str] = None
 
 
 @dataclass
@@ -125,6 +127,39 @@ class AgentRecord:
     created_by: Optional[str] = None  # Creator UID
 
 
+@dataclass
+class AgentInfoRecord:
+    """Agent profile/identity data (V20, V22: sync fields)."""
+
+    id: str
+    name: str
+    created_at: datetime
+    updated_at: datetime
+    description: Optional[str] = ""
+    visibility: str = "visible"
+    # V22: sync metadata
+    share_id: Optional[str] = None
+    share_url: Optional[str] = None
+    share_admin_token: Optional[str] = None
+    share_contributor_token: Optional[str] = None
+    share_expiry_at: Optional[str] = None
+    last_synced_at: Optional[str] = None
+    sync_version: int = 0
+
+
+@dataclass
+class WindowLinkRecord:
+    """Represents a terminal/session association (V23)."""
+
+    terminal_id: str
+    agent_id: Optional[str] = None
+    session_id: Optional[str] = None
+    provider: Optional[str] = None
+    source: Optional[str] = None
+    ts: Optional[float] = None
+    created_at: Optional[datetime] = None
+
+
 @dataclass
 class AgentContextRecord:
     """Represents a context entry (V15: replaces load.json)."""
@@ -214,6 +249,27 @@ class DatabaseInterface(ABC):
         """Backfill total_turns for all sessions from turns table (V10 migration)."""
         pass
 
+    @abstractmethod
+    def insert_window_link(
+        self,
+        *,
+        terminal_id: str,
+        agent_id: Optional[str],
+        session_id: Optional[str],
+        provider: Optional[str],
+        source: Optional[str],
+        ts: Optional[float] = None,
+    ) -> None:
+        """Insert a window link record (V23)."""
+        pass
+
+    @abstractmethod
+    def list_latest_window_links(
+        self, *, agent_id: Optional[str] = None, limit: int = 1000
+    ) -> List[WindowLinkRecord]:
+        """List latest window link per terminal (V23)."""
+        pass
+
     @abstractmethod
     def list_sessions(
         self, limit: int = 100, workspace_path: Optional[str] = None
@@ -250,6 +306,19 @@ class DatabaseInterface(ABC):
         """
         pass
 
+    @abstractmethod
+    def get_sessions_by_agent_id(self, agent_id: str, limit: int = 1000) -> List[SessionRecord]:
+        """Get all sessions linked to an agent.
+
+        Args:
+            agent_id: The agent_info ID
+            limit: Maximum number of sessions to return
+
+        Returns:
+            List of SessionRecord objects for this agent
+        """
+        pass
+
     @abstractmethod
     def get_turn_by_hash(self, session_id: str, content_hash: str) -> Optional[TurnRecord]:
         """Check if a turn with this content hash already exists in the session."""

realign/db/locks.py

@@ -31,6 +31,10 @@ def lock_key_for_event_summary(event_id: str) -> str:
     return f"event_summary:{event_id}"
 
 
+def lock_key_for_agent_description(agent_id: str) -> str:
+    return f"agent_description:{agent_id}"
+
+
 @contextmanager
 def lease_lock(
     db: DatabaseInterface,

realign/db/schema.py

@@ -76,9 +76,18 @@ Schema V18: UID refactor - created_by/shared_by with users table.
 - turns: drop uid and user_name (inherit from session)
 - agents: uid -> created_by, drop user_name
 - Update indexes accordingly
+
+Schema V19: Agent association for sessions.
+- sessions.agent_id: Logical agent entity association
+
+Schema V20: Agent identity/profile table.
+- agent_info table: name, description for agent profiles
+
+Schema V23: WindowLink mapping for terminal/session association.
+- windowlink table: terminal_id/agent_id/session_id with timestamp
 """
 
-SCHEMA_VERSION = 18
+SCHEMA_VERSION = 23
 
 FTS_EVENTS_SCRIPTS = [
     # Full Text Search for Events
@@ -150,7 +159,8 @@ INIT_SCRIPTS = [
         created_by TEXT,                          -- V18: Creator UID (FK to users.uid)
         shared_by TEXT,                           -- V18: Sharer UID (who imported this)
         total_turns INTEGER DEFAULT 0,            -- V10: Cached total turn count (avoids reading files)
-        total_turns_mtime REAL                    -- V12: File mtime when total_turns was cached (for validation)
+        total_turns_mtime REAL,                   -- V12: File mtime when total_turns was cached (for validation)
+        agent_id TEXT                             -- V19: Logical agent association
     );
     """,
     # Turns table (corresponds to git commits, V18: uid/user_name removed)
@@ -222,6 +232,7 @@ INIT_SCRIPTS = [
     "CREATE INDEX IF NOT EXISTS idx_sessions_activity ON sessions(last_activity_at DESC);",
     "CREATE INDEX IF NOT EXISTS idx_sessions_type ON sessions(session_type);",
     "CREATE INDEX IF NOT EXISTS idx_sessions_created_by ON sessions(created_by);",  # V18
+    "CREATE INDEX IF NOT EXISTS idx_sessions_agent_id ON sessions(agent_id);",  # V19
     "CREATE INDEX IF NOT EXISTS idx_turns_session ON turns(session_id);",
     "CREATE INDEX IF NOT EXISTS idx_turns_timestamp ON turns(timestamp DESC);",
     "CREATE INDEX IF NOT EXISTS idx_turns_hash ON turns(content_hash);",
@@ -335,6 +346,24 @@ INIT_SCRIPTS = [
         updated_at TEXT DEFAULT (datetime('now'))
     );
     """,
+    # Agent identity/profile table (V20, V22: sync columns)
+    """
+    CREATE TABLE IF NOT EXISTS agent_info (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        description TEXT DEFAULT '',
+        visibility TEXT NOT NULL DEFAULT 'visible',
+        share_id TEXT,
+        share_url TEXT,
+        share_admin_token TEXT,
+        share_contributor_token TEXT,
+        share_expiry_at TEXT,
+        last_synced_at TEXT,
+        sync_version INTEGER DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
     *FTS_EVENTS_SCRIPTS,
 ]
 
@@ -386,6 +415,21 @@ MIGRATION_V1_TO_V2 = [
     """
     CREATE INDEX IF NOT EXISTS idx_sessions_type ON sessions(session_type);
     """,
+    # WindowLink table (V23)
+    """
+    CREATE TABLE IF NOT EXISTS windowlink (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        terminal_id TEXT NOT NULL,
+        agent_id TEXT,
+        session_id TEXT,
+        provider TEXT,
+        source TEXT,
+        ts REAL,
+        created_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
+    "CREATE INDEX IF NOT EXISTS idx_windowlink_terminal_ts ON windowlink(terminal_id, ts DESC);",
+    "CREATE INDEX IF NOT EXISTS idx_windowlink_agent_ts ON windowlink(agent_id, ts DESC);",
 ]
 
 # Migration scripts from V2 to V3
@@ -652,6 +696,56 @@ MIGRATION_V17_TO_V18 = [
 ]
 
 
+MIGRATION_V18_TO_V19 = [
+    "ALTER TABLE sessions ADD COLUMN agent_id TEXT;",
+    "CREATE INDEX IF NOT EXISTS idx_sessions_agent_id ON sessions(agent_id);",
+]
+
+MIGRATION_V19_TO_V20 = [
+    """
+    CREATE TABLE IF NOT EXISTS agent_info (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        description TEXT DEFAULT '',
+        visibility TEXT NOT NULL DEFAULT 'visible',
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
+]
+
+MIGRATION_V20_TO_V21 = [
+    "ALTER TABLE agent_info ADD COLUMN visibility TEXT NOT NULL DEFAULT 'visible';",
+]
+
+MIGRATION_V21_TO_V22 = [
+    "ALTER TABLE agent_info ADD COLUMN share_id TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN share_url TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN share_admin_token TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN share_contributor_token TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN share_expiry_at TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN last_synced_at TEXT;",
+    "ALTER TABLE agent_info ADD COLUMN sync_version INTEGER DEFAULT 0;",
+]
+
+MIGRATION_V22_TO_V23 = [
+    """
+    CREATE TABLE IF NOT EXISTS windowlink (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        terminal_id TEXT NOT NULL,
+        agent_id TEXT,
+        session_id TEXT,
+        provider TEXT,
+        source TEXT,
+        ts REAL,
+        created_at TEXT DEFAULT (datetime('now'))
+    );
+    """,
+    "CREATE INDEX IF NOT EXISTS idx_windowlink_terminal_ts ON windowlink(terminal_id, ts DESC);",
+    "CREATE INDEX IF NOT EXISTS idx_windowlink_agent_ts ON windowlink(agent_id, ts DESC);",
+]
+
+
 def get_migration_scripts(from_version: int, to_version: int) -> list:
     """Get migration scripts for upgrading between versions."""
     scripts = []
@@ -716,4 +810,19 @@ def get_migration_scripts(from_version: int, to_version: int) -> list:
     if from_version < 18 and to_version >= 18:
         scripts.extend(MIGRATION_V17_TO_V18)
 
+    if from_version < 19 and to_version >= 19:
+        scripts.extend(MIGRATION_V18_TO_V19)
+
+    if from_version < 20 and to_version >= 20:
+        scripts.extend(MIGRATION_V19_TO_V20)
+
+    if from_version < 21 and to_version >= 21:
+        scripts.extend(MIGRATION_V20_TO_V21)
+
+    if from_version < 22 and to_version >= 22:
+        scripts.extend(MIGRATION_V21_TO_V22)
+
+    if from_version < 23 and to_version >= 23:
+        scripts.extend(MIGRATION_V22_TO_V23)
+
     return scripts