hyperfluid 0.1.0__py3-none-any.whl

hyperfluid/models/signal_thresholds_dto.py

@@ -0,0 +1,25 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+
+from ..serialization import BaseModel
+
+
+@dataclasses.dataclass(kw_only=True)
+class SignalThresholdsDto(BaseModel):
+    """One signal's effective thresholds. `*_is_override` tells the UI whether it
+    is showing a platform default or the org's own value, so "reset to default"
+    can be offered only when it means something."""
+
+    critical_is_override: bool
+
+    critical_pct: int
+
+    signal: str
+    """`pvc_disk` | `bucket_quota`. `cfs_throttling` never appears here — its
+    threshold is fixed platform-wide (see `AlertSignal::is_overridable`)."""
+
+    warning_is_override: bool
+
+    warning_pct: int

hyperfluid/models/skill_registry_catalog_entry.py

@@ -0,0 +1,42 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .skill_registry_scope_dto import SkillRegistryScopeDto
+
+
+@dataclasses.dataclass(kw_only=True)
+class SkillRegistryCatalogEntry(BaseModel):
+    """One catalog row: everything the picker needs, no skill bodies."""
+
+    auto_attach: bool
+
+    has_root_doc: bool
+    """Whether the registry ships a `REGISTRY.md`."""
+
+    name: str
+    """The value to put in a workstation's `skill_registries[].name`."""
+
+    read_only: bool
+
+    revision: int
+
+    scope: SkillRegistryScopeDto
+
+    skill_count: int
+
+    description: str | None = None
+
+    display_name: str | None = None
+
+    id: UUID | None = None
+    """`null` for a platform registry."""
+
+    updated_at: datetime | None = None

hyperfluid/models/skill_registry_ref_dto.py

@@ -0,0 +1,23 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .skill_registry_scope_dto import SkillRegistryScopeDto
+
+
+@dataclasses.dataclass(kw_only=True)
+class SkillRegistryRefDto(BaseModel):
+    """A registry a workstation attaches, by name + scope. The wire field on
+    `DevWorkstation.spec` is snake_case `skill_registries`; this is one element
+    of it."""
+
+    name: str
+    """Registry name (the CR name, and the directory it is mounted at inside the
+    pod: `/run/skills/<name>`)."""
+
+    scope: SkillRegistryScopeDto | None = None

hyperfluid/models/skill_registry_response.py

@@ -0,0 +1,54 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .skill_registry_scope_dto import SkillRegistryScopeDto
+    from .skill_response import SkillResponse
+
+
+@dataclasses.dataclass(kw_only=True)
+class SkillRegistryResponse(BaseModel):
+    """A registry with all of its skills — the editor's payload."""
+
+    auto_attach: bool
+    """Console policy: the create wizard pre-checks this registry. Always
+    `false` for a platform registry other than the stock essentials one,
+    which the wizard pre-checks by name."""
+
+    name: str
+    """Slug. Immutable once created: it is the CR name and the in-pod mount
+    directory, so renaming would move every attached workstation's path."""
+
+    read_only: bool
+    """`true` for platform registries: they are installed by the chart and no
+    console call can change them."""
+
+    revision: int
+    """Bumped on every mutation; stamped onto the projected CR so the operator
+    can tell a real change from a re-apply."""
+
+    scope: SkillRegistryScopeDto
+
+    skills: list[SkillResponse]
+
+    created_at: datetime | None = None
+
+    description: str | None = None
+
+    display_name: str | None = None
+
+    id: UUID | None = None
+    """`null` for a platform registry (no DB row; address it by `name`)."""
+
+    root_doc: str | None = None
+    """`REGISTRY.md` — registry-level instructions merged into the agent's
+    system context."""
+
+    updated_at: datetime | None = None

hyperfluid/models/skill_registry_scope_dto.py

@@ -0,0 +1,17 @@
+# this file is @generated
+import typing as t
+
+from ..serialization import StrEnum
+
+
+class SkillRegistryScopeDto(StrEnum):
+    """Where a registry comes from. Same two values as the CRD's
+    `WorkstationSkillRegistryScope`, re-declared here because the CRD type is a
+    `schemars` type and the API surface is a `utoipa` one."""
+
+    PLATFORM = "platform"
+    HARBOR = "harbor"
+
+
+SkillRegistryScopeDtoLiteral: t.TypeAlias = t.Literal["platform", "harbor"]
+"""The values of :class:`SkillRegistryScopeDto`, which arguments take as plain strings too."""

hyperfluid/models/skill_response.py

@@ -0,0 +1,31 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+
+@dataclasses.dataclass(kw_only=True)
+class SkillResponse(BaseModel):
+    """One skill of a registry, with its markdown body.
+
+    `content` is the body **only**: the YAML front matter (including the skill's
+    `name` and `description`) is composed by the operator when it renders the
+    file into the workstation, so a body that starts with `---` is rejected on
+    write."""
+
+    content: str
+
+    name: str
+
+    created_at: datetime | None = None
+
+    description: str | None = None
+
+    id: UUID | None = None
+    """`null` for a skill of a platform registry — it has no row."""
+
+    updated_at: datetime | None = None

hyperfluid/models/skipped_preview_port.py

@@ -0,0 +1,19 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+
+from ..serialization import BaseModel
+
+
+@dataclasses.dataclass(kw_only=True)
+class SkippedPreviewPort(BaseModel):
+    """A listening port the daemon deliberately did not offer. Diagnostics for the
+    UI ("bound to 127.0.0.1 only" / "does not speak HTTP"); never previewable."""
+
+    port: int
+
+    reason: str
+    """`loopback_only` | `not_http` today, free-form by contract: render an
+    unrecognised value with a default branch rather than assuming a closed
+    set (a pod keeps the daemon image it was created with)."""

hyperfluid/models/sort_dir.py

@@ -0,0 +1,15 @@
+# this file is @generated
+import typing as t
+
+from ..serialization import StrEnum
+
+
+class SortDir(StrEnum):
+    """The values of `SortDir`; others are kept as received."""
+
+    ASC = "asc"
+    DESC = "desc"
+
+
+SortDirLiteral: t.TypeAlias = t.Literal["asc", "desc"]
+"""The values of :class:`SortDir`, which arguments take as plain strings too."""

hyperfluid/models/source_sync_event.py

@@ -0,0 +1,47 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .source_sync_kind import SourceSyncKind
+
+
+@dataclasses.dataclass(kw_only=True)
+class SourceSyncEvent(BaseModel):
+    """One row of the sync history."""
+
+    attempts: int
+    """How many consecutive checks reported this same event."""
+
+    first_seen_at: datetime
+
+    id: UUID
+
+    kind: SourceSyncKind
+
+    last_seen_at: datetime
+
+    commit_author: str | None = None
+
+    commit_message: str | None = None
+
+    entry_hash: str | None = None
+
+    error: str | None = None
+    """Why a `failed` or `warning` event was recorded."""
+
+    image: str | None = None
+    """Image reference an `applied` event rolled out, or an `available` one
+    found."""
+
+    previous_image: str | None = None
+    """Image reference running before an `applied` event."""
+
+    revision: str | None = None
+    """Commit the event is about, when there is one."""

hyperfluid/models/source_sync_kind.py

@@ -0,0 +1,32 @@
+# this file is @generated
+import typing as t
+
+from ..serialization import StrEnum
+
+
+class SourceSyncKind(StrEnum):
+    """What happened to a Git source. Only events are recorded, never every check."""
+
+    APPLIED = "applied"
+    NO_CHANGE = "no_change"
+    FAILED = "failed"
+    RECOVERED = "recovered"
+    WARNING = "warning"
+    AVAILABLE = "available"
+    ATTACHED = "attached"
+    EDITED = "edited"
+    DETACHED = "detached"
+
+
+SourceSyncKindLiteral: t.TypeAlias = t.Literal[
+    "applied",
+    "no_change",
+    "failed",
+    "recovered",
+    "warning",
+    "available",
+    "attached",
+    "edited",
+    "detached",
+]
+"""The values of :class:`SourceSyncKind`, which arguments take as plain strings too."""

hyperfluid/models/spend_budget.py

@@ -0,0 +1,35 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .budget_author import BudgetAuthor
+    from .spend_window import SpendWindow
+
+
+@dataclasses.dataclass(kw_only=True)
+class SpendBudget(BaseModel):
+    """One ceiling."""
+
+    created_at: datetime
+
+    id: UUID
+
+    limit_micro_credits: int
+
+    organization_id: UUID
+
+    set_by: BudgetAuthor
+
+    updated_at: datetime
+
+    window: SpendWindow
+
+    api_key_id: UUID | None = None
+    """`None` for the organization-wide ceiling."""

hyperfluid/models/spend_window.py

@@ -0,0 +1,24 @@
+# this file is @generated
+import typing as t
+
+from ..serialization import StrEnum
+
+
+class SpendWindow(StrEnum):
+    """What a ceiling is measured over.
+
+    Three of the four are rolling. A calendar window lets a caller spend its
+    whole day in the last minute of one and again in the first minute of the
+    next, which is exactly the burst a ceiling exists to prevent. `Monthly` is
+    the calendar month anyway, because that is what an invoice is and a monthly
+    ceiling that straddles two invoices explains nothing to the person reading
+    them."""
+
+    ROLLING4H = "rolling4h"
+    DAILY = "daily"
+    WEEKLY = "weekly"
+    MONTHLY = "monthly"
+
+
+SpendWindowLiteral: t.TypeAlias = t.Literal["rolling4h", "daily", "weekly", "monthly"]
+"""The values of :class:`SpendWindow`, which arguments take as plain strings too."""

hyperfluid/models/sql_copilot_repair_context.py

@@ -0,0 +1,20 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+
+from ..serialization import BaseModel
+
+
+@dataclasses.dataclass(kw_only=True)
+class SqlCopilotRepairContext(BaseModel):
+    """Carries a previously-generated SQL statement back to the model along with
+    why it didn't validate, so the copilot can fix it instead of starting
+    over. Constructed by the handler (not the frontend) when a first
+    generation fails `TinyQueryService::validate_sql` — there is no
+    user-facing "fix it" trigger yet, unlike the dashboards copilot's repair
+    mode, but the shape mirrors it so one is a small addition later."""
+
+    error: str
+
+    sql: str

hyperfluid/models/sql_copilot_request.py

@@ -0,0 +1,29 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from uuid import UUID
+
+from ..serialization import UNSET, BaseModel, Unset
+
+if t.TYPE_CHECKING:
+    from .sql_copilot_repair_context import SqlCopilotRepairContext
+
+
+@dataclasses.dataclass(kw_only=True)
+class SqlCopilotRequest(BaseModel):
+    """The `SqlCopilotRequest` object."""
+
+    data_dock_id: UUID
+    """Data Dock whose schema grounds the generation."""
+
+    model: str | None | Unset = UNSET
+    """Model override; defaults to the platform's generation model."""
+
+    prompt: str | None = None
+    """The user's natural-language ask ("insert a daily rollup of order
+    totals into a new table"). May be empty when `repair` drives the
+    request."""
+
+    repair: SqlCopilotRepairContext | None | Unset = UNSET

hyperfluid/models/sql_copilot_response.py

@@ -0,0 +1,29 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+
+from ..serialization import BaseModel
+
+
+@dataclasses.dataclass(kw_only=True)
+class SqlCopilotResponse(BaseModel):
+    """The `SqlCopilotResponse` object."""
+
+    model: str
+    """Model that produced the SQL."""
+
+    sql: str
+    """No SELECT-only restriction — unlike the dashboards copilot, Tiny
+    Query is a general SQL IDE (the scheduled-queries feature is built
+    around INSERT/CTAS rollups), and running the result is still a
+    separate, explicit action."""
+
+    statement_type: str
+    """Leading-keyword classification of `sql` (SELECT/INSERT/CTAS/DDL/
+    DELETE/UPDATE/OTHER, see `detect_statement_type`) — lets the frontend
+    hold the review popover open and flag non-SELECT output instead of
+    silently dropping it into the editor."""
+
+    notes: str | None = None
+    """Copilot commentary shown alongside the result (assumptions, caveats)."""

hyperfluid/models/start_health_scan_response.py

@@ -0,0 +1,17 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .iceberg_health_scan import IcebergHealthScan
+
+
+@dataclasses.dataclass(kw_only=True)
+class StartHealthScanResponse(BaseModel):
+    """Result of asking for a sweep."""
+
+    scan: IcebergHealthScan

hyperfluid/models/storage_zone_view.py

@@ -0,0 +1,70 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .backend_driver import BackendDriver
+
+
+@dataclasses.dataclass(kw_only=True)
+class StorageZoneView(BaseModel):
+    """A `cephZones` catalog entry joined with whether the org has enabled it."""
+
+    driver: BackendDriver
+
+    enabled: bool
+    """Whether an OrgStorage exists for this org in this zone."""
+
+    grant_primary: bool
+    """The organization's `ObjectStorageGrant` on this zone marks it
+    `spec.primary` (ADR-0048, plan item 3.4a): the bucket-creation picker
+    defaults to it. Distinct from [`StorageZoneView::primary`], which
+    marks the platform's `default` zone, not an organization's choice."""
+
+    granted: bool
+    """Always `true`: this listing already excludes every zone the
+    organization's grant does not cover (ADR-0048 D4). Kept explicit so a
+    client never has to infer "granted" from list membership alone."""
+
+    name: str
+
+    primary: bool
+    """The primary zone every org has; always enabled and never removable."""
+
+    ready: bool
+    """Whether the zone's OrgStorage is Ready (only meaningful when enabled)."""
+
+    s3_gateway_enabled: bool
+    """Whether this zone runs an S3 gateway (`spec.s3Gateway.enabled`, else the
+    cluster default). The console uses it to hide gateway affordances rather
+    than offer one that can only 409."""
+
+    zone_id: str
+
+    description: str | None = None
+
+    endpoint: str | None = None
+    """The backend's own declared endpoint, present only for an `s3`-driver
+    backend (its `spec.s3.endpoint`) — known even before the organization
+    enables it. A `cephRgw` backend has no endpoint of its own; once
+    enabled its per-organization endpoint is `external_endpoint`."""
+
+    external_endpoint: str | None = None
+    """External S3 endpoint of the zone's OrgStorage, once provisioned. s0's
+    own external endpoint (ADR-0048 Amendment 1 / decommission PR 7,
+    decision 7, 2026-09-30: RGW no longer has one at all)."""
+
+    s3_name_prefix: str | None = None
+    """The fixed prefix every bucket's S3 name gets on this zone, present only
+    when its driver is `s3` (ADR-0048 D6): the console always prepends it,
+    so the create form shows it as a non-editable part of the name instead
+    of letting the tenant type a name the backend would refuse."""
+
+    tier: str | None = None
+    """The backend's free-form tier label (`standard`, `archive`, `nvme-hot`,
+    ...), presentation only (ADR-0048 decision 43). Absent when the backend
+    declares none: no default is resolved, and no tier is shown."""

hyperfluid/models/support_ticket_event_response.py

@@ -0,0 +1,38 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .message_author_kind import MessageAuthorKind
+
+
+@dataclasses.dataclass(kw_only=True)
+class SupportTicketEventResponse(BaseModel):
+    """One timeline entry.
+
+    On the tenant plane `actor_display` has already been redacted to a generic
+    label for a platform actor, and assignment rows are absent entirely — both
+    in SQL, by `list_events_for_tenant`. Which member of the platform team
+    acted is internal routing, exactly as it is on [`SupportTicketResponse`];
+    the timeline is the one surface where that could otherwise leak, because
+    `PlatformAdminIdentity::actor()` is an email address."""
+
+    actor_display: str
+
+    actor_kind: MessageAuthorKind
+
+    created_at: datetime
+
+    id: UUID
+
+    kind: str
+
+    from_value: str | None = None
+
+    to_value: str | None = None

hyperfluid/models/support_ticket_message_response.py

@@ -0,0 +1,34 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .message_author_kind import MessageAuthorKind
+
+
+@dataclasses.dataclass(kw_only=True)
+class SupportTicketMessageResponse(BaseModel):
+    """One message in a thread.
+
+    There is no `internal_note` field, and that is deliberate: the tenant read
+    filters internal notes out in SQL, so a flag here could only ever be
+    `false` — and publishing it would invite a future caller to trust it
+    instead of the query."""
+
+    author_display: str
+
+    author_kind: MessageAuthorKind
+
+    body_markdown: str
+
+    created_at: datetime
+
+    id: UUID
+
+    ticket_id: UUID

hyperfluid/models/support_ticket_response.py

@@ -0,0 +1,57 @@
+# this file is @generated
+from __future__ import annotations
+
+import dataclasses
+import typing as t
+from datetime import datetime
+from uuid import UUID
+
+from ..serialization import BaseModel
+
+if t.TYPE_CHECKING:
+    from .ticket_category import TicketCategory
+    from .ticket_priority import TicketPriority
+    from .ticket_status import TicketStatus
+
+
+@dataclasses.dataclass(kw_only=True)
+class SupportTicketResponse(BaseModel):
+    """One ticket as the tenant sees it.
+
+    Carries no `assigned_admin_sub`: which member of the platform team owns a
+    ticket is internal routing, and a customer learning the team's structure
+    from a ticket payload is a detail nobody asked to publish. The display name
+    on a reply is all the attribution the thread needs."""
+
+    category: TicketCategory
+
+    created_at: datetime
+
+    created_by_display: str
+
+    id: UUID
+
+    last_activity_at: datetime
+
+    organization_id: UUID
+
+    priority: TicketPriority
+
+    reference: str
+    """Human-readable handle, `HF-<n>` — what to quote on a call."""
+
+    status: TicketStatus
+
+    subject: str
+
+    updated_at: datetime
+
+    created_by_user_id: UUID | None = None
+
+    harbor_id: UUID | None = None
+
+    hyperfluid_version: str | None = None
+
+    resource_id: str | None = None
+
+    resource_kind: str | None = None