turingpulse-interfaces 1.0.0__tar.gz

turingpulse_interfaces-1.0.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: turingpulse-interfaces
+Version: 1.0.0
+Summary: Shared Pydantic models for TuringPulse platform
+Author: TuringPulse
+Requires-Python: >=3.11
+Requires-Dist: pydantic<3.0.0,>=2.7.0

turingpulse_interfaces-1.0.0/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "turingpulse-interfaces"
+version = "1.0.0"
+description = "Shared Pydantic models for TuringPulse platform"
+authors = [{name = "TuringPulse"}]
+requires-python = ">=3.11"
+dependencies = [
+    "pydantic>=2.7.0,<3.0.0",
+]
+
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"

turingpulse_interfaces-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

turingpulse_interfaces-1.0.0/turingpulse_interfaces/__init__.py

@@ -0,0 +1,55 @@
+"""Shared Pydantic models for TuringPulse services."""
+
+from .granularity import (
+    LEGACY_RESOLUTION_MAP,
+    RANGE_TO_RESOLUTION,
+    RESOLUTION_CH_INTERVAL,
+    RESOLUTION_DELTAS,
+    VALID_RESOLUTIONS,
+    Resolution,
+    normalize_resolution,
+    resolve_granularity,
+)
+from .llm import LLMProvider
+from .models import (
+    AgentEvent,
+    AgentEventPayload,
+    AgentEventType,
+    AgentNode,
+    AgentRun,
+    AgentRunMetrics,
+    AgentTask,
+    AttachmentDirection,
+    AttachmentMetadata,
+    AttachmentUploadResponse,
+    HITLAction,
+    TaskStatus,
+    TokenBreakdown,
+    ToolCallInfo,
+)
+
+__all__ = [
+    "AgentEvent",
+    "AgentEventPayload",
+    "AgentEventType",
+    "AgentRun",
+    "AgentRunMetrics",
+    "AgentNode",
+    "AgentTask",
+    "AttachmentDirection",
+    "AttachmentMetadata",
+    "AttachmentUploadResponse",
+    "HITLAction",
+    "LEGACY_RESOLUTION_MAP",
+    "LLMProvider",
+    "RANGE_TO_RESOLUTION",
+    "RESOLUTION_CH_INTERVAL",
+    "RESOLUTION_DELTAS",
+    "Resolution",
+    "TaskStatus",
+    "TokenBreakdown",
+    "ToolCallInfo",
+    "VALID_RESOLUTIONS",
+    "normalize_resolution",
+    "resolve_granularity",
+]

turingpulse_interfaces-1.0.0/turingpulse_interfaces/granularity.py

@@ -0,0 +1,85 @@
+"""
+Time-series granularity definitions — Single Source of Truth.
+
+This module defines the canonical resolution types, the mapping from time
+range duration to recommended resolution, and helpers consumed by both
+Python backends and (via the mirrored TypeScript module) the portal.
+
+Only trace-metric time-series endpoints use these resolutions.  Pre-computed
+KPI values, drift/anomaly events, and dimensional list endpoints are *not*
+affected by resolution.
+"""
+
+from __future__ import annotations
+
+from datetime import timedelta
+from enum import Enum
+from typing import Dict, List, Set, Tuple
+
+
+class Resolution(str, Enum):
+    """Supported time-series bucket widths."""
+
+    ONE_MINUTE = "1m"
+    FIVE_MINUTES = "5m"
+    FIFTEEN_MINUTES = "15m"
+    ONE_HOUR = "1h"
+    SIX_HOURS = "6h"
+    ONE_DAY = "1d"
+
+
+RESOLUTION_DELTAS: Dict[Resolution, timedelta] = {
+    Resolution.ONE_MINUTE: timedelta(minutes=1),
+    Resolution.FIVE_MINUTES: timedelta(minutes=5),
+    Resolution.FIFTEEN_MINUTES: timedelta(minutes=15),
+    Resolution.ONE_HOUR: timedelta(hours=1),
+    Resolution.SIX_HOURS: timedelta(hours=6),
+    Resolution.ONE_DAY: timedelta(days=1),
+}
+
+RESOLUTION_CH_INTERVAL: Dict[Resolution, str] = {
+    Resolution.ONE_MINUTE: "1 MINUTE",
+    Resolution.FIVE_MINUTES: "5 MINUTE",
+    Resolution.FIFTEEN_MINUTES: "15 MINUTE",
+    Resolution.ONE_HOUR: "1 HOUR",
+    Resolution.SIX_HOURS: "6 HOUR",
+    Resolution.ONE_DAY: "1 DAY",
+}
+
+# Ordered list of (max_hours_inclusive, resolution).
+# The first entry whose threshold >= the requested duration wins.
+RANGE_TO_RESOLUTION: List[Tuple[float, Resolution]] = [
+    (1, Resolution.ONE_MINUTE),
+    (6, Resolution.FIVE_MINUTES),
+    (24, Resolution.FIFTEEN_MINUTES),
+    (72, Resolution.ONE_HOUR),
+    (336, Resolution.SIX_HOURS),
+    (float("inf"), Resolution.ONE_DAY),
+]
+
+VALID_RESOLUTIONS: Set[str] = {r.value for r in Resolution}
+
+# Legacy values accepted by earlier API versions.
+LEGACY_RESOLUTION_MAP: Dict[str, Resolution] = {
+    "minute": Resolution.ONE_MINUTE,
+    "hour": Resolution.ONE_HOUR,
+    "day": Resolution.ONE_DAY,
+}
+
+
+def resolve_granularity(duration_hours: float) -> Resolution:
+    """Return the recommended resolution for a given time-range duration."""
+    for threshold_hours, resolution in RANGE_TO_RESOLUTION:
+        if duration_hours <= threshold_hours:
+            return resolution
+    return Resolution.ONE_DAY
+
+
+def normalize_resolution(value: str) -> Resolution:
+    """Accept both new (``"5m"``) and legacy (``"minute"``) resolution strings.
+
+    Raises ``ValueError`` when *value* is not recognised.
+    """
+    if value in LEGACY_RESOLUTION_MAP:
+        return LEGACY_RESOLUTION_MAP[value]
+    return Resolution(value)

turingpulse_interfaces-1.0.0/turingpulse_interfaces/llm.py

@@ -0,0 +1,17 @@
+"""Shared LLM provider configuration model."""
+
+from __future__ import annotations
+
+from typing import Dict
+
+from pydantic import BaseModel, Field
+
+
+class LLMProvider(BaseModel):
+    name: str
+    provider: str
+    model: str
+    framework: str
+    max_context_tokens: int | None = None
+    temperature: float | None = None
+    metadata: Dict[str, str] = Field(default_factory=dict)

turingpulse_interfaces-1.0.0/turingpulse_interfaces/models.py

@@ -0,0 +1,138 @@
+"""Pydantic models shared across TuringPulse services."""
+
+from datetime import datetime
+from enum import Enum
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class AgentEventType(str, Enum):
+    SPAN = "span"
+    METRIC = "metric"
+    STATE = "state"
+    AGENT_STEP = "agent_step"  # Used by TuringPulse SDK for workflow node spans
+
+
+class TokenBreakdown(BaseModel):
+    prompt: int = 0
+    completion: int = 0
+
+
+class ToolCallInfo(BaseModel):
+    """Information about a tool call made by an agent."""
+    tool_name: str
+    tool_args: Dict[str, Any] = Field(default_factory=dict)
+    tool_result: Optional[str] = None
+    tool_id: Optional[str] = None
+    success: bool = True
+    error_message: Optional[str] = None
+
+
+class AgentEventPayload(BaseModel):
+    name: str
+    duration_ms: Optional[int] = None
+    tokens: Optional[TokenBreakdown] = None
+    cost_usd: Optional[float] = None
+    status: Optional[str] = None
+    reasoning: Optional[str] = None
+    # Changed from Dict[str, str] to Dict[str, Any] to support numeric metadata values
+    metadata: Dict[str, Any] = Field(default_factory=dict)
+    # Tool calls made by the agent
+    tool_calls: Optional[List[ToolCallInfo]] = None
+
+
+class AgentEvent(BaseModel):
+    run_id: str
+    agent_id: str
+    timestamp: datetime
+    type: AgentEventType
+    payload: AgentEventPayload
+    workflow_name: Optional[str] = None
+
+
+class AgentNode(BaseModel):
+    node_id: str
+    name: str
+    runtime_ms: int
+    status: str
+    parent_node_id: Optional[str] = None
+
+
+class AgentRunMetrics(BaseModel):
+    latency_ms: int
+    cost_usd: float
+    tokens_total: int
+
+
+class AgentRun(BaseModel):
+    run_id: str
+    agent_id: str
+    tenant_id: Optional[str] = None  # Tenant isolation
+    project_id: Optional[str] = None  # Project isolation (UUID)
+    workflow_id: Optional[str] = None  # Workflow ID for strict filtering
+    workflow_name: Optional[str] = None  # Workflow display name
+    workflow_run_id: Optional[str] = None  # Workflow run ID
+    started_at: datetime
+    completed_at: Optional[datetime]
+    status: str
+    metrics: Optional[AgentRunMetrics]
+    nodes: List[AgentNode] = Field(default_factory=list)
+
+
+class TaskStatus(str, Enum):
+    TODO = "todo"
+    IN_PROGRESS = "in_progress"
+    BLOCKED = "blocked"
+    NEEDS_HUMAN = "needs_human"
+    COMPLETED = "completed"
+
+
+class HITLAction(BaseModel):
+    reviewer: str
+    comment: str
+    created_at: datetime
+    resolution: Optional[str]
+
+
+class AgentTask(BaseModel):
+    task_id: str
+    title: str
+    status: TaskStatus = TaskStatus.TODO
+    assignee: Optional[str]
+    agent_run_id: Optional[str]
+    hitl_required: bool = False
+    metadata: Dict[str, str] = Field(default_factory=dict)
+    hitl_actions: List[HITLAction] = Field(default_factory=list)
+
+
+class AttachmentDirection(str, Enum):
+    INPUT = "input"
+    OUTPUT = "output"
+
+
+class AttachmentMetadata(BaseModel):
+    """Metadata for a document attached to a span."""
+
+    attachment_id: str
+    filename: str
+    mime_type: str
+    size_bytes: int
+    compressed_size_bytes: Optional[int] = None
+    direction: AttachmentDirection
+    storage_path: str
+    extracted_text_length: Optional[int] = None
+    extraction_method: Optional[str] = None
+    checksum_sha256: Optional[str] = None
+
+
+class AttachmentUploadResponse(BaseModel):
+    """Response from the attachment upload endpoint."""
+
+    attachment_id: str
+    filename: str
+    mime_type: str
+    size_bytes: int
+    extracted_text: Optional[str] = None
+    storage_path: str
+    deduplicated: bool = False

turingpulse_interfaces-1.0.0/turingpulse_interfaces.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: turingpulse-interfaces
+Version: 1.0.0
+Summary: Shared Pydantic models for TuringPulse platform
+Author: TuringPulse
+Requires-Python: >=3.11
+Requires-Dist: pydantic<3.0.0,>=2.7.0

turingpulse_interfaces-1.0.0/turingpulse_interfaces.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+pyproject.toml
+turingpulse_interfaces/__init__.py
+turingpulse_interfaces/granularity.py
+turingpulse_interfaces/llm.py
+turingpulse_interfaces/models.py
+turingpulse_interfaces.egg-info/PKG-INFO
+turingpulse_interfaces.egg-info/SOURCES.txt
+turingpulse_interfaces.egg-info/dependency_links.txt
+turingpulse_interfaces.egg-info/requires.txt
+turingpulse_interfaces.egg-info/top_level.txt

turingpulse_interfaces-1.0.0/turingpulse_interfaces.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

turingpulse_interfaces-1.0.0/turingpulse_interfaces.egg-info/requires.txt

@@ -0,0 +1 @@
+pydantic<3.0.0,>=2.7.0

turingpulse_interfaces-1.0.0/turingpulse_interfaces.egg-info/top_level.txt

@@ -0,0 +1 @@
+turingpulse_interfaces