vibey-engine 2.0.0__py3-none-any.whl

agyloop/__init__.py

@@ -0,0 +1,4 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Autonomous Google Antigravity and Gemini session runner."""
+
+__version__ = "0.5.0"

agyloop/application/__init__.py

@@ -0,0 +1,2 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Application layer for agyloop use cases."""

agyloop/application/dto.py

@@ -0,0 +1,43 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Data transfer objects passed between application/ and infrastructure/ adapters.
+Not domain value objects — these carry the raw shape of one SDK interaction
+before domain.classify.classify() and domain.completion.evaluate() reduce them
+to CapacityState / CompletionVerdict."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime
+
+from agyloop.domain.classify import TurnSignals
+from agyloop.domain.completion import StructuredVerdict
+
+
+@dataclass(frozen=True, slots=True)
+class TurnOutcome:
+    """What one real or probe turn produced, translated from raw SDK messages
+    by infrastructure/agent/translate.py."""
+
+    signals: TurnSignals
+    verdict: StructuredVerdict | None
+    output_text: str
+    session_id: str | None
+    cost_usd: float = 0.0
+    prompt_tokens: int = 0
+    completion_tokens: int = 0
+    raw_events: tuple[dict[str, object], ...] = ()
+
+
+@dataclass(frozen=True, slots=True)
+class ProbeResult:
+    signals: TurnSignals
+    at: datetime
+
+
+@dataclass(frozen=True, slots=True)
+class RunResult:
+    success: bool
+    reason: str
+    session_id: str | None
+    turns_spent: int
+    dollars_spent: float

agyloop/application/interfaces/__init__.py

@@ -0,0 +1,80 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Application interfaces -- every seam implemented by infrastructure/ and
+never imported from it.
+
+One module per collaborator family so a reader finds a seam by what it does
+rather than by scrolling one long file. `application/ports.py` re-exports
+this package unchanged, so existing imports keep working.
+"""
+
+from __future__ import annotations
+
+from agyloop.application.interfaces.agent import (
+    AgentGateway,
+    CapacityProbe,
+    RunResources,
+    SessionCatalog,
+)
+from agyloop.application.interfaces.api import (
+    ApiGateway,
+)
+from agyloop.application.interfaces.class_contracts import AutonomousRunnerInterface
+from agyloop.application.interfaces.control import (
+    ControlInbox,
+    RunControl,
+)
+from agyloop.application.interfaces.doctor import (
+    AuthLane,
+    AuthResolution,
+    DoctorEnvironment,
+    HarnessStatus,
+)
+from agyloop.application.interfaces.observability import (
+    AuditLog,
+    Logger,
+    Notifier,
+    ProgressReporter,
+    RunEventSink,
+    StateBus,
+)
+from agyloop.application.interfaces.storage import (
+    RunSnapshotSink,
+    RunStateStore,
+    SavePointStore,
+    SessionLock,
+)
+from agyloop.application.interfaces.system import (
+    Clock,
+    Sleeper,
+)
+from agyloop.application.interfaces.ui import (
+    StreamUi,
+)
+
+__all__ = [
+    "AgentGateway",
+    "AutonomousRunnerInterface",
+    "ApiGateway",
+    "AuditLog",
+    "CapacityProbe",
+    "AuthLane",
+    "AuthResolution",
+    "Clock",
+    "ControlInbox",
+    "DoctorEnvironment",
+    "HarnessStatus",
+    "Logger",
+    "Notifier",
+    "ProgressReporter",
+    "RunControl",
+    "RunEventSink",
+    "RunResources",
+    "RunSnapshotSink",
+    "RunStateStore",
+    "SavePointStore",
+    "SessionCatalog",
+    "SessionLock",
+    "Sleeper",
+    "StateBus",
+    "StreamUi",
+]

agyloop/application/interfaces/agent.py

@@ -0,0 +1,54 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""The vendor session seam: sending turns, probing capacity, enumerating
+sessions, and the run-scoped resources attached to one."""
+
+from __future__ import annotations
+
+from typing import Any, Protocol, runtime_checkable
+
+from agyloop.application.dto import TurnOutcome
+from agyloop.domain.model_profile import ModelEffortProfile
+from agyloop.domain.session import SessionRef
+
+
+@runtime_checkable
+class AgentGateway(Protocol):
+    """Wraps a live google.antigravity Agent session. The port must not leak
+    google.antigravity types: ``set_permission_mode`` takes an agyloop enum
+    (autonomous | scoped | safe | yolo) that a later adapter compiles into a
+    policy list. Deliberately not a one-shot query — the session survives a
+    capacity rejection so the run can probe and resume.
+    """
+
+    async def send_turn(self, prompt_text: str) -> TurnOutcome: ...
+    async def close(self) -> None: ...
+    async def set_profile(self, profile: ModelEffortProfile) -> None: ...
+    async def set_permission_mode(self, mode: str) -> None: ...
+    async def set_cwd(self, cwd: str) -> None: ...
+    async def set_session_resources(self, **kwargs: Any) -> None: ...
+    def resolve_tool_approval(self, request_id: str, *, allow: bool, reason: str = "") -> bool: ...
+
+
+@runtime_checkable
+class RunResources(Protocol):
+    """Run-scoped attachments / skills / folders / memories applied mid-run."""
+
+    def apply_mutate(
+        self, *, action: str, kind: str, value: str, name: str | None = None
+    ) -> dict[str, Any]: ...
+    def gateway_payload(self) -> dict[str, Any]: ...
+    def set_permission_mode(self, mode: str) -> None: ...
+    def set_cwd(self, path: str) -> None: ...
+
+
+@runtime_checkable
+class CapacityProbe(Protocol):
+    async def probe(self) -> TurnOutcome: ...
+
+
+@runtime_checkable
+class SessionCatalog(Protocol):
+    """Enumerates agyloop's run registry, not vendor conversations."""
+
+    def most_recent(self, cwd: str) -> SessionRef | None: ...
+    def list_all(self, cwd: str | None = None) -> list[SessionRef]: ...

agyloop/application/interfaces/api.py

@@ -0,0 +1,14 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""The generated REST surface seam."""
+
+from __future__ import annotations
+
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class ApiGateway(Protocol):
+    """Generated Gemini REST surface (ADR 0015). ``agyloop api`` is bound from
+    the committed Developer discovery baseline and guarded by a drift gate."""
+
+    def invoke(self, method_path: str, **kwargs: Any) -> Any: ...

agyloop/application/interfaces/class_contracts.py

@@ -0,0 +1,13 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Contract for the Antigravity autonomous runner."""
+
+from __future__ import annotations
+
+from typing import Protocol, runtime_checkable
+
+from agyloop.application.dto import RunResult
+
+
+@runtime_checkable
+class AutonomousRunnerInterface(Protocol):
+    async def run(self, *, initial_prompt: str, continue_prompt: str) -> RunResult: ...

agyloop/application/interfaces/control.py

@@ -0,0 +1,20 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""The out-of-band control plane: commands an operator drops for a live run."""
+
+from __future__ import annotations
+
+from typing import Protocol, runtime_checkable
+
+from agyloop.domain.control import ControlCommand
+
+
+@runtime_checkable
+class RunControl(Protocol):
+    def poll(self) -> list[ControlCommand]: ...
+
+
+@runtime_checkable
+class ControlInbox(Protocol):
+    """Where an out-of-band command is dropped for a live run to pick up."""
+
+    def enqueue(self, command: ControlCommand) -> object: ...

agyloop/application/interfaces/doctor.py

@@ -0,0 +1,48 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""What `doctor` needs from the outside world, and the vocabulary it answers in.
+
+Kept separate from the AgentGateway seam so `doctor` stays cheap to run and
+never requires a live SDK session. The result types live here too: they are
+part of the seam's vocabulary, not of the use case that consumes it.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Literal, Protocol, runtime_checkable
+
+AuthLane = Literal["developer_api", "enterprise", "unresolved"]
+
+
+@dataclass(frozen=True, slots=True)
+class AuthResolution:
+    """Effective auth lane plus the env/file source that selected it.
+
+    ``lane`` is ``unresolved`` when doctor cannot positively identify
+    Developer API vs Enterprise -- it never guesses.
+    """
+
+    lane: AuthLane
+    source: str
+    authenticated: bool
+    detail: str
+
+
+@dataclass(frozen=True, slots=True)
+class HarnessStatus:
+    """SDK harness availability and smoke-check result."""
+
+    available: bool
+    detail: str
+
+
+@runtime_checkable
+class DoctorEnvironment(Protocol):
+    """What doctor needs from the outside world -- no live SDK session."""
+
+    def resolve_auth(self) -> AuthResolution: ...
+    def interactive_hooks_registered(self) -> bool: ...
+    def find_agy_cli(self) -> str | None: ...
+    def agy_cli_version(self, path: str) -> str | None: ...
+    def configured_mcp_servers(self) -> list[str]: ...
+    def check_sdk_harness(self) -> HarnessStatus: ...

agyloop/application/interfaces/observability.py

@@ -0,0 +1,57 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Everything the run emits outward: logs, audit records, progress, events,
+state publications, usage reads, and operator notifications."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class ProgressReporter(Protocol):
+    def turn_sent(self, *, attempt: int) -> None: ...
+    def waiting(self, *, reason: str, until: datetime) -> None: ...
+    def finished(self, *, success: bool, reason: str) -> None: ...
+
+
+@runtime_checkable
+class AuditLog(Protocol):
+    def record(self, event_type: str, payload: dict[str, Any]) -> None: ...
+
+
+@runtime_checkable
+class Notifier(Protocol):
+    def notify(self, message: str) -> None: ...
+
+
+@runtime_checkable
+class Logger(Protocol):
+    """Structured application logging — implemented by infrastructure/logging."""
+
+    def bind(self, **kwargs: Any) -> Logger: ...
+    def debug(self, event: str, **kwargs: Any) -> None: ...
+    def info(self, event: str, **kwargs: Any) -> None: ...
+    def warning(self, event: str, **kwargs: Any) -> None: ...
+    def error(self, event: str, **kwargs: Any) -> None: ...
+
+
+@runtime_checkable
+class RunEventSink(Protocol):
+    def emit(self, event_type: str, payload: dict[str, Any] | None = None) -> None: ...
+    def bind(
+        self,
+        *,
+        session_id: str | None = None,
+        attempt: int | None = None,
+        phase: str | None = None,
+        trace_id: str | None = None,
+        turn_id: str | None = None,
+    ) -> None: ...
+
+
+@runtime_checkable
+class StateBus(Protocol):
+    """Publish run state changes for external pollers / subscribers."""
+
+    def publish(self, event_type: str, state: dict[str, Any]) -> None: ...

agyloop/application/interfaces/storage.py

@@ -0,0 +1,53 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Durable run state: the state store, the run lock, git save points, and the
+snapshot sink."""
+
+from __future__ import annotations
+
+from typing import Any, Protocol, runtime_checkable
+
+from agyloop.domain.savepoint import SavePointRef, UnwindResult
+from agyloop.domain.snapshot import SnapshotReason, SnapshotRef
+
+
+@runtime_checkable
+class RunStateStore(Protocol):
+    def save(self, run_id: str, state: dict[str, Any]) -> None: ...
+    def load(self, run_id: str) -> dict[str, Any] | None: ...
+
+
+@runtime_checkable
+class SessionLock(Protocol):
+    def acquire(self, session_id: str) -> bool: ...
+    def release(self, session_id: str) -> None: ...
+
+
+@runtime_checkable
+class SavePointStore(Protocol):
+    def create(
+        self,
+        *,
+        run_id: str,
+        label: str,
+        message: str = "",
+        attempt: int | None = None,
+        verdict_name: str = "Continue",
+        summary: str = "",
+        remaining_work: tuple[str, ...] = (),
+    ) -> SavePointRef | None: ...
+    def list_points(self, run_id: str) -> list[SavePointRef]: ...
+    def unwind(self, *, run_id: str, to: str, backup: bool) -> UnwindResult: ...
+    def changes_since(self, since_sha: str | None) -> str: ...
+
+
+@runtime_checkable
+class RunSnapshotSink(Protocol):
+    """Write handoff snapshots and publish path+digest on the state bus."""
+
+    def emit(
+        self,
+        reason: SnapshotReason,
+        *,
+        context: dict[str, Any] | None = None,
+        bundle: bool | None = None,
+    ) -> SnapshotRef | None: ...

agyloop/application/interfaces/system.py

@@ -0,0 +1,17 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Time and sleeping -- the two ambient effects the run loop needs faked."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Protocol, runtime_checkable
+
+
+@runtime_checkable
+class Clock(Protocol):
+    def now(self) -> datetime: ...
+
+
+@runtime_checkable
+class Sleeper(Protocol):
+    async def sleep_until(self, instant: datetime) -> None: ...

agyloop/application/interfaces/ui.py

@@ -0,0 +1,19 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""The live view seam. Textual itself stays in infrastructure."""
+
+from __future__ import annotations
+
+from typing import Any, Protocol, runtime_checkable
+
+
+@runtime_checkable
+class StreamUi(Protocol):
+    """Optional full-screen stream UI — fed deltas; Textual lives in infrastructure."""
+
+    def on_delta(self, text: str, *, turn_id: str, seq: int) -> None: ...
+    def on_turn_boundary(self, *, turn_id: str, attempt: int) -> None: ...
+    def on_prompt(self, text: str) -> None: ...
+    def on_assistant(self, text: str) -> None: ...
+    def on_tool(self, name: str, summary: str) -> None: ...
+    def on_status(self, state: dict[str, Any]) -> None: ...
+    def close(self) -> None: ...

agyloop/application/ports.py

@@ -0,0 +1,66 @@
+# Made with ❤️ by [Vibey](https://the-vibey-project.github.io/vibey/), Developed by [Adam Matthew Steinberger](https://vibewithadam.matthewsteinberger.com/) ([@adammatthewsteinberger](https://github.com/adammatthewsteinberger/)).
+"""Backwards-compatible re-export of `application.interfaces`.
+
+The Protocols moved into `application/interfaces/` so every seam lives in
+one discoverable place, one module per collaborator family. This shim keeps
+the old `from agyloop.application.ports import X` path working; new code
+should import from `agyloop.application.interfaces`.
+"""
+
+from __future__ import annotations
+
+from agyloop.application.interfaces import (
+    AgentGateway,
+    ApiGateway,
+    AuditLog,
+    AuthLane,
+    AuthResolution,
+    AutonomousRunnerInterface,
+    CapacityProbe,
+    Clock,
+    ControlInbox,
+    DoctorEnvironment,
+    HarnessStatus,
+    Logger,
+    Notifier,
+    ProgressReporter,
+    RunControl,
+    RunEventSink,
+    RunResources,
+    RunSnapshotSink,
+    RunStateStore,
+    SavePointStore,
+    SessionCatalog,
+    SessionLock,
+    Sleeper,
+    StateBus,
+    StreamUi,
+)
+
+__all__ = [
+    "AgentGateway",
+    "AutonomousRunnerInterface",
+    "ApiGateway",
+    "AuditLog",
+    "CapacityProbe",
+    "AuthLane",
+    "AuthResolution",
+    "Clock",
+    "ControlInbox",
+    "DoctorEnvironment",
+    "HarnessStatus",
+    "Logger",
+    "Notifier",
+    "ProgressReporter",
+    "RunControl",
+    "RunEventSink",
+    "RunResources",
+    "RunSnapshotSink",
+    "RunStateStore",
+    "SavePointStore",
+    "SessionCatalog",
+    "SessionLock",
+    "Sleeper",
+    "StateBus",
+    "StreamUi",
+]