sonf 0.1.0__tar.gz

sonf-0.1.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.3
+Name: sonf
+Version: 0.1.0
+Summary: Python SDK primitives for Sonf, work management for AI agents.
+Author: Syeda Nawal Fatima
+Author-email: Syeda Nawal Fatima <177872742+nawal-syeda@users.noreply.github.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Sonf
+
+**Work management for AI agents.**
+
+Sonf is an agent-native platform for monitoring, coordinating, and supervising AI agents.
+
+The project is currently under active development.
+
+## License
+
+No open-source license is granted at this time.
+
+Copyright © 2026 Wishlabs AI. All rights reserved.
+
+Unauthorized copying, redistribution, modification, publication, or commercial use of this source code is prohibited without prior written permission.

sonf-0.1.0/README.md

@@ -0,0 +1,15 @@
+# Sonf
+
+**Work management for AI agents.**
+
+Sonf is an agent-native platform for monitoring, coordinating, and supervising AI agents.
+
+The project is currently under active development.
+
+## License
+
+No open-source license is granted at this time.
+
+Copyright © 2026 Wishlabs AI. All rights reserved.
+
+Unauthorized copying, redistribution, modification, publication, or commercial use of this source code is prohibited without prior written permission.

sonf-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "sonf"
+version = "0.1.0"
+description = "Python SDK primitives for Sonf, work management for AI agents."
+readme = "README.md"
+authors = [
+    { name = "Syeda Nawal Fatima", email = "177872742+nawal-syeda@users.noreply.github.com" }
+]
+requires-python = ">=3.10"
+dependencies = []
+
+
+[build-system]
+requires = ["uv_build>=0.11.12,<0.12.0"]
+build-backend = "uv_build"
+[tool.uv.build-backend]
+module-name = "sonf"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.16.9",
+]

sonf-0.1.0/src/sonf/__init__.py

@@ -0,0 +1,10 @@
+# src/sonf/__init__.py
+
+from sonf.events import EventType, SonfEvent
+
+__version__ = "0.0.1"
+
+__all__ = [
+    "EventType",
+    "SonfEvent",
+]

sonf-0.1.0/src/sonf/events.py

@@ -0,0 +1,100 @@
+# src/sonf/events.py
+
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from datetime import UTC, datetime
+from enum import Enum
+from typing import Any
+from uuid import UUID, uuid4
+
+
+class EventType(str, Enum):
+    """Events that an agent can report to Sonf."""
+
+    TASK_STARTED = "task_started"
+    TASK_PROGRESS = "task_progress"
+    TASK_COMPLETED = "task_completed"
+    TASK_FAILED = "task_failed"
+    TASK_CANCELLED = "task_cancelled"
+
+    MESSAGE_SENT = "message_sent"
+
+    TOOL_STARTED = "tool_started"
+    TOOL_COMPLETED = "tool_completed"
+    TOOL_FAILED = "tool_failed"
+
+    APPROVAL_REQUESTED = "approval_requested"
+    APPROVAL_RESOLVED = "approval_resolved"
+
+
+@dataclass(frozen=True, slots=True)
+class SonfEvent:
+    """A single event emitted by an agent or agent runtime."""
+
+    agent_id: str
+    event_type: EventType
+
+    task_id: str | None = None
+    run_id: str | None = None
+
+    payload: dict[str, Any] = field(default_factory=dict)
+
+    event_id: UUID = field(default_factory=uuid4)
+
+    occurred_at: datetime = field(
+        default_factory=lambda: datetime.now(UTC)
+    )
+
+    schema_version: int = field(default=1, init=False)
+
+    def __post_init__(self) -> None:
+        self._validate_identifier("agent_id", self.agent_id)
+
+        if self.task_id is not None:
+            self._validate_identifier("task_id", self.task_id)
+
+        if self.run_id is not None:
+            self._validate_identifier("run_id", self.run_id)
+
+        if (
+            self.occurred_at.tzinfo is None
+            or self.occurred_at.utcoffset() is None
+        ):
+            raise ValueError("occurred_at must be timezone-aware")
+
+        try:
+            json.dumps(self.payload)
+        except (TypeError, ValueError) as exc:
+            raise ValueError(
+                "payload must contain only JSON-serializable values"
+            ) from exc
+
+    @staticmethod
+    def _validate_identifier(name: str, value: str) -> None:
+        if not isinstance(value, str) or not value.strip():
+            raise ValueError(f"{name} must be a non-empty string")
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return a JSON-serializable representation of the event."""
+
+        return {
+            "schema_version": self.schema_version,
+            "event_id": str(self.event_id),
+            "event_type": self.event_type.value,
+            "agent_id": self.agent_id,
+            "task_id": self.task_id,
+            "run_id": self.run_id,
+            "occurred_at": self.occurred_at.isoformat(),
+            "payload": self.payload,
+        }
+
+    def to_json(self) -> str:
+        """Serialize the event to JSON."""
+
+        return json.dumps(
+            self.to_dict(),
+            ensure_ascii=False,
+            separators=(",", ":"),
+        )