aline-ai 0.6.5__py3-none-any.whl → 0.6.6__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/dashboard/widgets/terminal_panel.py

@@ -456,7 +456,7 @@ class TerminalPanel(Container, can_focus=True):
         try:
             from ...codex_terminal_linker import read_codex_session_meta
             from ...db import get_database
-            from ...codex_home import codex_sessions_dir_for_terminal
+            from ...codex_home import codex_sessions_dir_for_terminal_or_agent
         except Exception:
             return
 
@@ -474,9 +474,12 @@ class TerminalPanel(Container, can_focus=True):
             return
 
         candidates: list[Path] = []
-        sessions_root = codex_sessions_dir_for_terminal(terminal_id)
+        agent_info_id: str | None = None
+        if (agent.source or "").startswith("agent:"):
+            agent_info_id = agent.source[6:]
+        sessions_root = codex_sessions_dir_for_terminal_or_agent(terminal_id, agent_info_id)
         if sessions_root.exists():
-            # Deterministic: isolated per-terminal CODEX_HOME.
+            # Deterministic: isolated per-terminal/per-agent CODEX_HOME.
             try:
                 candidates = list(sessions_root.rglob("rollout-*.jsonl"))
             except Exception:
@@ -544,6 +547,9 @@ class TerminalPanel(Container, can_focus=True):
             return
 
         try:
+            source = "dashboard:auto-link"
+            if (agent.source or "").startswith("agent:"):
+                source = agent.source or source
             db.update_agent(
                 terminal_id,
                 provider="codex",
@@ -552,8 +558,13 @@ class TerminalPanel(Container, can_focus=True):
                 transcript_path=str(best),
                 cwd=cwd,
                 project_dir=cwd,
-                source="dashboard:auto-link",
+                source=source,
             )
+            if agent_info_id:
+                try:
+                    db.update_session_agent_id(best.stem, agent_info_id)
+                except Exception:
+                    pass
         except Exception:
             return
 
@@ -592,10 +603,16 @@ class TerminalPanel(Container, can_focus=True):
         try:
             controls_enabled = self.supported()
             with Horizontal(classes="summary"):
+                yield Button(
+                    "＋ New Agent",
+                    id="quick-new-agent",
+                    variant="primary",
+                    disabled=not controls_enabled,
+                )
                 yield Button(
                     "＋ Create",
                     id="new-agent",
-                    variant="primary",
+                    variant="default",
                     disabled=not controls_enabled,
                 )
             with Vertical(id="terminals", classes="list"):
@@ -1244,6 +1261,20 @@ class TerminalPanel(Container, can_focus=True):
         """Wrap a command to run in a specific directory."""
         return f"cd {shlex.quote(directory)} && {command}"
 
+    async def _quick_create_claude_agent(self) -> None:
+        """Quickly create a new Claude Code terminal with default settings.
+
+        Uses the last workspace (or cwd) with normal permissions and tracking enabled.
+        """
+        from ..screens.create_agent import _load_last_workspace
+
+        workspace = _load_last_workspace()
+        self.run_worker(
+            self._create_agent("claude", workspace, skip_permissions=False, no_track=False),
+            group="terminal-panel-create",
+            exclusive=True,
+        )
+
     def _on_create_agent_result(self, result: tuple[str, str, bool, bool] | None) -> None:
         """Handle the result from CreateAgentScreen modal."""
         if result is None:
@@ -1571,6 +1602,10 @@ class TerminalPanel(Container, can_focus=True):
             )
             return
 
+        if button_id == "quick-new-agent":
+            await self._quick_create_claude_agent()
+            return
+
         if button_id == "new-agent":
             from ..screens import CreateAgentScreen
 

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,18 @@ class AgentRecord:
     created_by: Optional[str] = None  # Creator UID
 
 
+@dataclass
+class AgentInfoRecord:
+    """Agent profile/identity data (V20)."""
+
+    id: str
+    name: str
+    created_at: datetime
+    updated_at: datetime
+    description: Optional[str] = ""
+    visibility: str = "visible"
+
+
 @dataclass
 class AgentContextRecord:
     """Represents a context entry (V15: replaces load.json)."""
@@ -250,6 +264,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,15 @@ 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_VERSION = 18
+SCHEMA_VERSION = 21
 
 FTS_EVENTS_SCRIPTS = [
     # Full Text Search for Events
@@ -150,7 +156,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 +229,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 +343,17 @@ INIT_SCRIPTS = [
         updated_at TEXT DEFAULT (datetime('now'))
     );
     """,
+    # Agent identity/profile table (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'))
+    );
+    """,
     *FTS_EVENTS_SCRIPTS,
 ]
 
@@ -652,6 +671,29 @@ 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';",
+]
+
+
 def get_migration_scripts(from_version: int, to_version: int) -> list:
     """Get migration scripts for upgrading between versions."""
     scripts = []
@@ -716,4 +758,13 @@ 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)
+
     return scripts

realign/db/sqlite_db.py

@@ -21,6 +21,7 @@ from .base import (
     EventRecord,
     LockRecord,
     AgentRecord,
+    AgentInfoRecord,
     AgentContextRecord,
     UserRecord,
 )
@@ -293,6 +294,7 @@ class SQLiteDatabase(DatabaseInterface):
         started_at: datetime,
         workspace_path: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
+        agent_id: Optional[str] = None,
     ) -> SessionRecord:
         """Get existing session or create new one."""
         conn = self._get_connection()
@@ -317,8 +319,8 @@ class SQLiteDatabase(DatabaseInterface):
             INSERT INTO sessions (
                 id, session_file_path, session_type, workspace_path,
                 started_at, last_activity_at, created_at, updated_at, metadata,
-                created_by
-            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+                created_by, agent_id
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
             """,
             (
                 session_id,
@@ -331,6 +333,7 @@ class SQLiteDatabase(DatabaseInterface):
                 now,
                 metadata_json,
                 config.uid,
+                agent_id,
             ),
         )
         conn.commit()
@@ -353,8 +356,18 @@ class SQLiteDatabase(DatabaseInterface):
             metadata=metadata or {},
             workspace_path=workspace_path,
             created_by=config.uid,
+            agent_id=agent_id,
         )
 
+    def update_session_agent_id(self, session_id: str, agent_id: Optional[str]) -> None:
+        """Set or update the agent_id on an existing session (V19)."""
+        conn = self._get_connection()
+        conn.execute(
+            "UPDATE sessions SET agent_id = ?, updated_at = ? WHERE id = ?",
+            (agent_id, datetime.now(), session_id),
+        )
+        conn.commit()
+
     def update_session_activity(self, session_id: str, last_activity_at: datetime) -> None:
         """Update last activity timestamp."""
         conn = self._get_connection()
@@ -557,6 +570,30 @@ class SQLiteDatabase(DatabaseInterface):
         )
         return [self._row_to_session(row) for row in cursor.fetchall()]
 
+    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
+        """
+        conn = self._get_connection()
+        cursor = conn.cursor()
+        try:
+            cursor.execute(
+                """SELECT * FROM sessions
+                   WHERE agent_id = ?
+                   ORDER BY last_activity_at DESC
+                   LIMIT ?""",
+                (agent_id, limit),
+            )
+            return [self._row_to_session(row) for row in cursor.fetchall()]
+        except sqlite3.OperationalError:
+            return []
+
     def get_turn_content(self, turn_id: str) -> Optional[str]:
         """Get the JSONL content for a turn."""
         conn = self._get_connection()
@@ -973,6 +1010,7 @@ class SQLiteDatabase(DatabaseInterface):
         expected_turns: Optional[int] = None,
         skip_dedup: bool = False,
         no_track: bool = False,
+        agent_id: Optional[str] = None,
     ) -> str:
         session_id = session_file_path.stem
         dedupe_key = f"turn:{session_id}:{int(turn_number)}"
@@ -991,6 +1029,8 @@ class SQLiteDatabase(DatabaseInterface):
             payload["skip_dedup"] = True
         if no_track:
             payload["no_track"] = True
+        if agent_id:
+            payload["agent_id"] = agent_id
 
         # For append-only session formats (Claude/Codex/Gemini), a turn is immutable once completed.
         # Avoid re-running already-done turn jobs on repeated enqueue attempts.
@@ -1033,6 +1073,17 @@ class SQLiteDatabase(DatabaseInterface):
             requeue_done=True,
         )
 
+    def enqueue_agent_description_job(self, *, agent_id: str) -> str:
+        dedupe_key = f"agent_desc:{agent_id}"
+        payload: Dict[str, Any] = {"agent_id": agent_id}
+        return self.enqueue_job(
+            kind="agent_description",
+            dedupe_key=dedupe_key,
+            payload=payload,
+            priority=12,
+            requeue_done=True,
+        )
+
     def claim_next_job(
         self,
         *,
@@ -2770,6 +2821,13 @@ class SQLiteDatabase(DatabaseInterface):
         except (IndexError, KeyError):
             pass
 
+        # V19: agent association
+        agent_id = None
+        try:
+            agent_id = row["agent_id"]
+        except (IndexError, KeyError):
+            pass
+
         return SessionRecord(
             id=row["id"],
             session_file_path=Path(row["session_file_path"]),
@@ -2790,6 +2848,7 @@ class SQLiteDatabase(DatabaseInterface):
             shared_by=shared_by,
             total_turns=total_turns,
             total_turns_mtime=total_turns_mtime,
+            agent_id=agent_id,
         )
 
     def _row_to_turn(self, row: sqlite3.Row) -> TurnRecord:
@@ -3015,3 +3074,127 @@ class SQLiteDatabase(DatabaseInterface):
         except sqlite3.OperationalError:
             pass
         return None
+
+    # -------------------------------------------------------------------------
+    # Agent info table methods (Schema V20)
+    # -------------------------------------------------------------------------
+
+    def _row_to_agent_info(self, row: sqlite3.Row) -> AgentInfoRecord:
+        """Convert a database row to an AgentInfoRecord."""
+        visibility = "visible"
+        try:
+            if "visibility" in row.keys():
+                visibility = row["visibility"] or "visible"
+        except Exception:
+            visibility = "visible"
+        return AgentInfoRecord(
+            id=row["id"],
+            name=row["name"],
+            description=row["description"] or "",
+            created_at=self._parse_datetime(row["created_at"]),
+            updated_at=self._parse_datetime(row["updated_at"]),
+            visibility=visibility,
+        )
+
+    def get_or_create_agent_info(
+        self, agent_id: str, name: Optional[str] = None
+    ) -> AgentInfoRecord:
+        """Get existing agent info or create a new one.
+
+        Args:
+            agent_id: UUID for the agent.
+            name: Display name (if None, caller should provide a generated name).
+        """
+        conn = self._get_connection()
+        cursor = conn.cursor()
+
+        try:
+            cursor.execute("SELECT * FROM agent_info WHERE id = ?", (agent_id,))
+            row = cursor.fetchone()
+            if row:
+                return self._row_to_agent_info(row)
+        except sqlite3.OperationalError:
+            pass
+
+        display_name = name or agent_id[:8]
+        cursor.execute(
+            """
+            INSERT INTO agent_info (id, name, description, visibility, created_at, updated_at)
+            VALUES (?, ?, '', 'visible', datetime('now'), datetime('now'))
+            """,
+            (agent_id, display_name),
+        )
+        conn.commit()
+
+        cursor.execute("SELECT * FROM agent_info WHERE id = ?", (agent_id,))
+        row = cursor.fetchone()
+        return self._row_to_agent_info(row)
+
+    def get_agent_info(self, agent_id: str) -> Optional[AgentInfoRecord]:
+        """Get agent info by ID, or None if not found."""
+        conn = self._get_connection()
+        try:
+            cursor = conn.execute("SELECT * FROM agent_info WHERE id = ?", (agent_id,))
+            row = cursor.fetchone()
+            if row:
+                return self._row_to_agent_info(row)
+        except sqlite3.OperationalError:
+            pass
+        return None
+
+    def update_agent_info(
+        self,
+        agent_id: str,
+        *,
+        name: Optional[str] = None,
+        description: Optional[str] = None,
+        visibility: Optional[str] = None,
+    ) -> Optional[AgentInfoRecord]:
+        """Update agent info fields. Returns updated record or None if not found."""
+        conn = self._get_connection()
+        sets: list[str] = []
+        params: list[Any] = []
+
+        if name is not None:
+            sets.append("name = ?")
+            params.append(name)
+        if description is not None:
+            sets.append("description = ?")
+            params.append(description)
+        if visibility is not None:
+            sets.append("visibility = ?")
+            params.append(visibility)
+
+        if not sets:
+            return self.get_agent_info(agent_id)
+
+        sets.append("updated_at = datetime('now')")
+        params.append(agent_id)
+
+        try:
+            conn.execute(
+                f"UPDATE agent_info SET {', '.join(sets)} WHERE id = ?",
+                params,
+            )
+            conn.commit()
+        except sqlite3.OperationalError:
+            return None
+
+        return self.get_agent_info(agent_id)
+
+    def list_agent_info(self, *, include_invisible: bool = False) -> list[AgentInfoRecord]:
+        """List agent info records, ordered by created_at descending."""
+        conn = self._get_connection()
+        try:
+            if include_invisible:
+                cursor = conn.execute("SELECT * FROM agent_info ORDER BY created_at DESC")
+            else:
+                try:
+                    cursor = conn.execute(
+                        "SELECT * FROM agent_info WHERE visibility = 'visible' ORDER BY created_at DESC"
+                    )
+                except sqlite3.OperationalError:
+                    cursor = conn.execute("SELECT * FROM agent_info ORDER BY created_at DESC")
+            return [self._row_to_agent_info(row) for row in cursor.fetchall()]
+        except sqlite3.OperationalError:
+            return []