prism-models 0.7.6__py3-none-any.whl → 0.7.8__py3-none-any.whl

prism_models/__init__.py

@@ -17,6 +17,7 @@ from prism_models.chat import Contact, Conversation, ConversationMessage, Conver
 from prism_models.content import Chunk, ChunkConfig, Collection, CollectionDocument, Document, IntegrationConfig, Source, Vector
 from prism_models.feedback import Augmentation, Feedback, FeedbackAnalysis, FeedbackStatus, FeedbackType
 from prism_models.qdrant import QdrantVectorPayload, DestinationVectorPayload, PydanticType
+from prism_models.notification import NotificationTarget, NotificationOutbox
 
 __all__ = [
     "POSTGRES_NAMING_CONVENTION",
@@ -51,4 +52,6 @@ __all__ = [
     "Source",
     "TimestampMixin",
     "Vector",
+    "NotificationTarget",
+    "NotificationOutbox",
 ]

prism_models/agent_profile.py

@@ -36,6 +36,8 @@ class Profile(BaseModel):
         String(255), nullable=True, default="openai:gpt-4.1"
     )
     is_active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
+    
+    is_default: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
 
     __table_args__ = (UniqueConstraint("name", name="uq_profile_name"),)
 

prism_models/migration/versions/2026_01_29_1312_ed197421f25a_add_notification_tables.py

@@ -0,0 +1,87 @@
+"""add notification tables
+
+Revision ID: ed197421f25a
+Revises: 53d6d0b55f11
+Create Date: 2026-01-29 13:12:33.275063
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+# revision identifiers, used by Alembic.
+revision: str = 'ed197421f25a'
+down_revision: Union[str, Sequence[str], None] = '53d6d0b55f11'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('notification_target',
+    sa.Column('provider', sa.String(length=50), nullable=False),
+    sa.Column('target_key', sa.String(length=100), nullable=False),
+    sa.Column('display_name', sa.String(length=255), nullable=True),
+    sa.Column('webhook_url', sa.Text(), nullable=False),
+    sa.Column('is_enabled', sa.Boolean(), nullable=False),
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('deleted_at', sa.DateTime(timezone=True), nullable=True),
+    sa.PrimaryKeyConstraint('id', name=op.f('notification_target_pkey')),
+    sa.UniqueConstraint('provider', 'target_key', name='uq_notification_target_provider_key')
+    )
+    op.create_index(op.f('notification_target_id_idx'), 'notification_target', ['id'], unique=False)
+    op.create_table('notification_outbox',
+    sa.Column('provider', sa.String(length=50), nullable=False),
+    sa.Column('target_key', sa.String(length=100), nullable=False),
+    sa.Column('event_type', sa.String(length=100), nullable=False),
+    sa.Column('severity', sa.String(length=20), nullable=True),
+    sa.Column('dedupe_key', sa.String(length=255), nullable=False),
+    sa.Column('correlation_id', sa.String(length=100), nullable=True),
+    sa.Column('entity_type', sa.String(length=50), nullable=True),
+    sa.Column('entity_id', sa.String(length=100), nullable=True),
+    sa.Column('payload', postgresql.JSONB(astext_type=sa.Text()), nullable=False),
+    sa.Column('status', sa.String(length=20), nullable=False),
+    sa.Column('priority', sa.Integer(), nullable=False),
+    sa.Column('attempts', sa.Integer(), nullable=False),
+    sa.Column('max_attempts', sa.Integer(), nullable=False),
+    sa.Column('next_attempt_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('last_error', sa.Text(), nullable=True),
+    sa.Column('sent_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('expires_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('locked_by', sa.String(length=100), nullable=True),
+    sa.Column('locked_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('id', sa.Integer(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), server_default=sa.text('now()'), nullable=False),
+    sa.Column('deleted_at', sa.DateTime(timezone=True), nullable=True),
+    sa.ForeignKeyConstraint(['provider', 'target_key'], ['notification_target.provider', 'notification_target.target_key'], name='fk_notification_outbox_target'),
+    sa.PrimaryKeyConstraint('id', name=op.f('notification_outbox_pkey')),
+    sa.UniqueConstraint('dedupe_key', name=op.f('notification_outbox_dedupe_key_key'))
+    )
+    op.create_index('ix_notification_outbox_entity', 'notification_outbox', ['entity_type', 'entity_id'], unique=False)
+    op.create_index('ix_notification_outbox_ready', 'notification_outbox', ['status', 'priority', 'next_attempt_at'], unique=False)
+    op.create_index(op.f('notification_outbox_correlation_id_idx'), 'notification_outbox', ['correlation_id'], unique=False)
+    op.create_index(op.f('notification_outbox_expires_at_idx'), 'notification_outbox', ['expires_at'], unique=False)
+    op.create_index(op.f('notification_outbox_id_idx'), 'notification_outbox', ['id'], unique=False)
+    op.create_index(op.f('notification_outbox_status_idx'), 'notification_outbox', ['status'], unique=False)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(op.f('notification_outbox_status_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_id_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_expires_at_idx'), table_name='notification_outbox')
+    op.drop_index(op.f('notification_outbox_correlation_id_idx'), table_name='notification_outbox')
+    op.drop_index('ix_notification_outbox_ready', table_name='notification_outbox')
+    op.drop_index('ix_notification_outbox_entity', table_name='notification_outbox')
+    op.drop_table('notification_outbox')
+    op.drop_index(op.f('notification_target_id_idx'), table_name='notification_target')
+    op.drop_table('notification_target')
+    # ### end Alembic commands ###

prism_models/migration/versions/2026_02_03_1308_04c9051208cd_default_column_added_to_profile.py

@@ -0,0 +1,32 @@
+"""Default column added to profile
+
+Revision ID: 04c9051208cd
+Revises: ed197421f25a
+Create Date: 2026-02-03 13:08:18.193148
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '04c9051208cd'
+down_revision: Union[str, Sequence[str], None] = 'ed197421f25a'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column('profile', sa.Column('is_default', sa.Boolean(), nullable=False))
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column('profile', 'is_default')
+    # ### end Alembic commands ###

prism_models/notification.py

@@ -0,0 +1,142 @@
+"""Notification models for outbox-based delivery to Teams channels."""
+
+import enum
+from datetime import datetime
+from typing import Optional
+
+from sqlalchemy import (
+    Boolean,
+    DateTime,
+    ForeignKeyConstraint,
+    Index,
+    Integer,
+    String,
+    Text,
+    UniqueConstraint,
+    func,
+)
+from sqlalchemy.dialects.postgresql import JSONB
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from prism_models.base import Base, BaseModel, TimestampMixin
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Enums
+# ─────────────────────────────────────────────────────────────────────────────
+
+
+class NotificationStatus(str, enum.Enum):
+    """Lifecycle states for outbox notifications."""
+
+    PENDING = "pending"
+    SENDING = "sending"
+    SENT = "sent"
+    FAILED = "failed"
+
+
+class NotificationSeverity(str, enum.Enum):
+    """Severity levels for notification prioritization and formatting."""
+
+    INFO = "info"
+    WARN = "warn"
+    ERROR = "error"
+    CRITICAL = "critical"
+
+
+class NotificationProvider(str, enum.Enum):
+    """Supported notification providers (only Teams for now)."""
+
+    TEAMS = "teams"
+
+class NotificationTarget(BaseModel):
+    """
+    Webhook destinations for notifications.
+
+    Each target represents a Teams channel webhook.
+    Multiple event types can route to the same target.
+    """
+
+    __tablename__ = "notification_target"
+
+    provider: Mapped[str] = mapped_column(String(50), nullable=False)
+    target_key: Mapped[str] = mapped_column(String(100), nullable=False)
+    display_name: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    webhook_url: Mapped[str] = mapped_column(Text, nullable=False)
+    is_enabled: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
+
+    outbox_entries: Mapped[list["NotificationOutbox"]] = relationship(
+        back_populates="target",
+        foreign_keys="[NotificationOutbox.provider, NotificationOutbox.target_key]",
+    )
+
+    __table_args__ = (
+        UniqueConstraint("provider", "target_key", name="uq_notification_target_provider_key"),
+    )
+
+    def __repr__(self):
+        return f"<NotificationTarget(id={self.id}, provider='{self.provider}', key='{self.target_key}')>"
+
+
+class NotificationOutbox(BaseModel):
+    """
+    Transactional outbox for reliable notification delivery.
+
+    Design notes:
+    - dedupe_key: Prevents duplicate sends at insert time
+    - entity_type + entity_id: Polymorphic reference to source entity
+    - locked_by + locked_at: Enables safe multi-worker polling
+    - priority: Critical alerts jump ahead of digests
+    - max_attempts: Per-notification retry limit
+    - expires_at: Auto-expire stale notifications
+    """
+
+    __tablename__ = "notification_outbox"
+
+    provider: Mapped[str] = mapped_column(String(50), nullable=False)
+    target_key: Mapped[str] = mapped_column(String(100), nullable=False)
+    event_type: Mapped[str] = mapped_column(String(100), nullable=False)
+    severity: Mapped[str | None] = mapped_column(String(20), nullable=True)
+
+    dedupe_key: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
+    correlation_id: Mapped[str | None] = mapped_column(String(100), nullable=True, index=True)
+
+    entity_type: Mapped[str | None] = mapped_column(String(50), nullable=True)
+    entity_id: Mapped[str | None] = mapped_column(String(100), nullable=True)
+
+    payload: Mapped[dict] = mapped_column(JSONB, nullable=False)
+
+    status: Mapped[str] = mapped_column(
+        String(20), default=NotificationStatus.PENDING.value, nullable=False, index=True
+    )
+    priority: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
+    attempts: Mapped[int] = mapped_column(Integer, default=0, nullable=False)
+    max_attempts: Mapped[int] = mapped_column(Integer, default=5, nullable=False)
+    next_attempt_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
+    last_error: Mapped[str | None] = mapped_column(Text, nullable=True)
+    sent_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+    expires_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True, index=True)
+
+    locked_by: Mapped[str | None] = mapped_column(String(100), nullable=True)
+    locked_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+    target: Mapped[Optional["NotificationTarget"]] = relationship(
+        back_populates="outbox_entries",
+        foreign_keys=[provider, target_key],
+    )
+
+    __table_args__ = (
+        ForeignKeyConstraint(
+            ["provider", "target_key"],
+            ["notification_target.provider", "notification_target.target_key"],
+            name="fk_notification_outbox_target",
+        ),
+        Index("ix_notification_outbox_ready", "status", "priority", "next_attempt_at"),
+        Index("ix_notification_outbox_entity", "entity_type", "entity_id"),
+    )
+
+    def __repr__(self):
+        return f"<NotificationOutbox(id={self.id}, event='{self.event_type}', status='{self.status}')>"

{prism_models-0.7.6.dist-info → prism_models-0.7.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prism-models
-Version: 0.7.6
+Version: 0.7.8
 Requires-Python: >=3.12
 Requires-Dist: sqlalchemy[asyncio]>=2.0.0
 Requires-Dist: alembic>=1.16.0

{prism_models-0.7.6.dist-info → prism_models-0.7.8.dist-info}/RECORD

@@ -1,10 +1,11 @@
-prism_models/__init__.py,sha256=jD-ASYrK4-FW1txMuUnUCwvZCHN7d9ko8b_lCLuZS9s,1491
-prism_models/agent_profile.py,sha256=sNO9NfOpOFXgpkvxMry-5rcHNfFdWXtMV6b45JA0Wr8,8159
+prism_models/__init__.py,sha256=NBynAYHnMVNrnkDdO_PZ-LlL9vnqAF1DlrTotZY-ZKM,1620
+prism_models/agent_profile.py,sha256=g5gvkeYUO-W-eociuUWIE3X0Osu3BtOrjZKLjzet2Zs,8249
 prism_models/base.py,sha256=Ka8zNToTiTG0jNgzqqj2goGmPXt8zxuuSMYvotnb8wY,2281
 prism_models/chat.py,sha256=0nsp1u-zzibIYHEAvuz_lu8qzulzzVD7vOjSrwcHMjI,15205
 prism_models/config.py,sha256=gy_6HknnG17Clv8X_EBhaXEBFBLGR1PLjvN5-SFTo5E,962
 prism_models/content.py,sha256=mzVZw54UiLIdWB9-A_HdjigJNNWBevmTMbGW6copXBM,10361
 prism_models/feedback.py,sha256=k4EvZg6bJXhCuPCwYizUCIP1TYpSjBDGPdtvpKj_U4k,6761
+prism_models/notification.py,sha256=ho9oIfv9f09YpQ7zsdz6MYke0mMleKEs1wP3DRPNBSY,5427
 prism_models/qdrant.py,sha256=Ta0fsLsxbT3Evdm8KEo-zw6IzoNckuWDmDZNfBtqjfA,3950
 prism_models/migration/README,sha256=MVlc9TYmr57RbhXET6QxgyCcwWP7w-vLkEsirENqiIQ,38
 prism_models/migration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -67,7 +68,9 @@ prism_models/migration/versions/2025_12_17_1220_4d9291a3acb1_removed_qa_pair_chu
 prism_models/migration/versions/2026_01_14_1742_147509a82af8_changed_user_role_enums.py,sha256=S4ZSqgbCe0Xrp3Z1E10J1vg3Arh_bmCxk7YP1g67eDQ,2000
 prism_models/migration/versions/2026_01_15_1010_3b7d0b2e9f5a_add_contact_profile_table.py,sha256=5G-ZmYZGXJ4TNdZms3WDwhHKbUMVp2M94f5uBSVW-j4,2790
 prism_models/migration/versions/2026_01_26_1648_53d6d0b55f11_feedback_changes.py,sha256=KyAE4YxXE1FY8yC5aLoA6TXI9TlI1Bk4kNsT5RCSfBw,878
-prism_models-0.7.6.dist-info/METADATA,sha256=0MDnTMQHDJ2uKaQyBguMFoYZ2jx6TKj0izdDw1isFy4,283
-prism_models-0.7.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-prism_models-0.7.6.dist-info/top_level.txt,sha256=UNzqwpLgFYU0EoyB9LiB1jTtc89A1sQ24fSEyNVvgJI,13
-prism_models-0.7.6.dist-info/RECORD,,
+prism_models/migration/versions/2026_01_29_1312_ed197421f25a_add_notification_tables.py,sha256=KpP6B5vc55EJedHe04grvgQbyVzMSTh9t8d9qem6wVE,5197
+prism_models/migration/versions/2026_02_03_1308_04c9051208cd_default_column_added_to_profile.py,sha256=n2rkjSd8unV6ngqxA1tNCZBCCSF0KOzJzjfHiR4BVnc,891
+prism_models-0.7.8.dist-info/METADATA,sha256=uUHkcy_EOXosG60td54paJBmLnQb79arYAFFRG0Qexs,283
+prism_models-0.7.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+prism_models-0.7.8.dist-info/top_level.txt,sha256=UNzqwpLgFYU0EoyB9LiB1jTtc89A1sQ24fSEyNVvgJI,13
+prism_models-0.7.8.dist-info/RECORD,,