roboz 0.1.2.dev5__tar.gz → 0.1.2.dev6__tar.gz

{roboz-0.1.2.dev5 → roboz-0.1.2.dev6}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.1.2.dev6 - 2026-09-15
+
+- Breaking: make the `roboz` root a lazy authoring facade. It now exports only
+  `Agent`, `Skill`, `Tool`, `Factory`, `tool`, and `factory` alongside discoverable
+  domain namespaces. Import models from `roboz.models`, agent helpers from
+  `roboz.agent`, built-in tools from `roboz.tools`, and context protocols from
+  `roboz.tooling`. See [the import migration guide](docs/imports.md).
+
 ## 0.1.2.dev5 - 2026-09-13
 
 - Add `LLMEndpointRoute`, a typed live-selection layer above concrete chat

{roboz-0.1.2.dev5 → roboz-0.1.2.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: roboz
-Version: 0.1.2.dev5
+Version: 0.1.2.dev6
 Import-Name: roboz
 Summary: Typed primitives for composable agentic workflows
 Project-URL: Homepage, https://github.com/Tachion-Oy/roboz
@@ -27,12 +27,22 @@ Provides-Extra: proton-bridge-beta
 Requires-Dist: roboz-proton-bridge<0.2.0,>=0.1.0b1; extra == 'proton-bridge-beta'
 Description-Content-Type: text/markdown
 
-# RoboZ
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/roboz-logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/roboz-logo-light.svg">
+    <img alt="RoboZ" src="docs/assets/roboz-logo-dark.svg" width="560">
+  </picture>
 
-**Chain tools. Skip calls.**
+  <p><strong>Chain tools. Skip calls.</strong></p>
+</div>
 
 RoboZ is a framework for building llm powered agents. The core ingredient is that every tool can may be chained conditionally to a subsequent tool thus allowing easy injection of deterministic flows into agentic processes.
 
+The package root contains the concise agent and tool authoring API. Models, LLM
+operations, built-in tools, and runtime interfaces live in their corresponding
+domain namespaces; see [public imports](docs/imports.md).
+
 [![CI](https://github.com/Tachion-Oy/roboz/actions/workflows/ci.yml/badge.svg)](https://github.com/Tachion-Oy/roboz/actions/workflows/ci.yml)
 [![Python 3.13+](https://img.shields.io/badge/Python-3.13%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
@@ -69,37 +79,38 @@ TBD
 
 
 ```python
-import roboz as rz
+from roboz import tool
+from roboz.models import Empty, Message
 
 
-class LunchPreference(rz.Empty):
+class LunchPreference(Empty):
     cuisine: str | None
 
 
-class Restaurant(rz.Empty):
+class Restaurant(Empty):
     name: str
     seats_available: bool
 
 
-class Booking(rz.Empty):
+class Booking(Empty):
     confirmation: str
 
 
-@rz.tool
+@tool
 def plan_lunch_with_bob(
-    input: rz.Empty, messages: list[rz.Message]
+    input: Empty, messages: list[Message]
 ) -> LunchPreference:
     ...
 
 
-@rz.tool
+@tool
 def retry_plan_lunch_with_bob(
-    input: Restaurant, messages: list[rz.Message]
+    input: Restaurant, messages: list[Message]
 ) -> LunchPreference:
     ...
 
 
-@rz.tool(
+@tool(
     chained_to=[plan_lunch_with_bob, retry_plan_lunch_with_bob],
     chain_condition=lambda output: (
         isinstance(output, LunchPreference)
@@ -107,7 +118,7 @@ def retry_plan_lunch_with_bob(
     ),
 )
 def find_restaurant(
-    input: LunchPreference, messages: list[rz.Message]
+    input: LunchPreference, messages: list[Message]
 ) -> Restaurant:
     ...
 
@@ -120,13 +131,13 @@ retry_plan_lunch_with_bob.chain(
 )
 
 
-@rz.tool(
+@tool(
     chained_to=find_restaurant,
     chain_condition=lambda output: (
         isinstance(output, Restaurant) and output.seats_available
     ),
 )
-def book_a_table(input: Restaurant, messages: list[rz.Message]) -> Booking:
+def book_a_table(input: Restaurant, messages: list[Message]) -> Booking:
     ...
 ```
 
@@ -209,11 +220,11 @@ install integrations only where they are needed.
 
 | Primitive | Role |
 | --- | --- |
-| `rz.Agent` | Owns the active tool surface, prompt, invoke loop, and runtime events. |
-| `@rz.tool` | Defines an action with typed input and output models. |
-| `@rz.factory` | Binds a concrete typed context or resource to a tool. |
-| `rz.Skill` | Packages reusable instructions and optional tools. |
-| `rz.Message` | Carries content and its model-context lifecycle. |
+| `roboz.Agent` | Owns the active tool surface, prompt, invoke loop, and runtime events. |
+| `roboz.tool` | Defines an action with typed input and output models. |
+| `roboz.factory` | Binds a concrete typed context or resource to a tool. |
+| `roboz.Skill` | Packages reusable instructions and optional tools. |
+| `roboz.models.Message` | Carries content and its model-context lifecycle. |
 | `roboz.deployment.DeployableAgent` | Composes capabilities, subagents, and background agents. |
 
 ## Optional ecosystem

{roboz-0.1.2.dev5 → roboz-0.1.2.dev6}/README.md

@@ -1,9 +1,19 @@
-# RoboZ
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/roboz-logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/roboz-logo-light.svg">
+    <img alt="RoboZ" src="docs/assets/roboz-logo-dark.svg" width="560">
+  </picture>
 
-**Chain tools. Skip calls.**
+  <p><strong>Chain tools. Skip calls.</strong></p>
+</div>
 
 RoboZ is a framework for building llm powered agents. The core ingredient is that every tool can may be chained conditionally to a subsequent tool thus allowing easy injection of deterministic flows into agentic processes.
 
+The package root contains the concise agent and tool authoring API. Models, LLM
+operations, built-in tools, and runtime interfaces live in their corresponding
+domain namespaces; see [public imports](docs/imports.md).
+
 [![CI](https://github.com/Tachion-Oy/roboz/actions/workflows/ci.yml/badge.svg)](https://github.com/Tachion-Oy/roboz/actions/workflows/ci.yml)
 [![Python 3.13+](https://img.shields.io/badge/Python-3.13%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
@@ -40,37 +50,38 @@ TBD
 
 
 ```python
-import roboz as rz
+from roboz import tool
+from roboz.models import Empty, Message
 
 
-class LunchPreference(rz.Empty):
+class LunchPreference(Empty):
     cuisine: str | None
 
 
-class Restaurant(rz.Empty):
+class Restaurant(Empty):
     name: str
     seats_available: bool
 
 
-class Booking(rz.Empty):
+class Booking(Empty):
     confirmation: str
 
 
-@rz.tool
+@tool
 def plan_lunch_with_bob(
-    input: rz.Empty, messages: list[rz.Message]
+    input: Empty, messages: list[Message]
 ) -> LunchPreference:
     ...
 
 
-@rz.tool
+@tool
 def retry_plan_lunch_with_bob(
-    input: Restaurant, messages: list[rz.Message]
+    input: Restaurant, messages: list[Message]
 ) -> LunchPreference:
     ...
 
 
-@rz.tool(
+@tool(
     chained_to=[plan_lunch_with_bob, retry_plan_lunch_with_bob],
     chain_condition=lambda output: (
         isinstance(output, LunchPreference)
@@ -78,7 +89,7 @@ def retry_plan_lunch_with_bob(
     ),
 )
 def find_restaurant(
-    input: LunchPreference, messages: list[rz.Message]
+    input: LunchPreference, messages: list[Message]
 ) -> Restaurant:
     ...
 
@@ -91,13 +102,13 @@ retry_plan_lunch_with_bob.chain(
 )
 
 
-@rz.tool(
+@tool(
     chained_to=find_restaurant,
     chain_condition=lambda output: (
         isinstance(output, Restaurant) and output.seats_available
     ),
 )
-def book_a_table(input: Restaurant, messages: list[rz.Message]) -> Booking:
+def book_a_table(input: Restaurant, messages: list[Message]) -> Booking:
     ...
 ```
 
@@ -180,11 +191,11 @@ install integrations only where they are needed.
 
 | Primitive | Role |
 | --- | --- |
-| `rz.Agent` | Owns the active tool surface, prompt, invoke loop, and runtime events. |
-| `@rz.tool` | Defines an action with typed input and output models. |
-| `@rz.factory` | Binds a concrete typed context or resource to a tool. |
-| `rz.Skill` | Packages reusable instructions and optional tools. |
-| `rz.Message` | Carries content and its model-context lifecycle. |
+| `roboz.Agent` | Owns the active tool surface, prompt, invoke loop, and runtime events. |
+| `roboz.tool` | Defines an action with typed input and output models. |
+| `roboz.factory` | Binds a concrete typed context or resource to a tool. |
+| `roboz.Skill` | Packages reusable instructions and optional tools. |
+| `roboz.models.Message` | Carries content and its model-context lifecycle. |
 | `roboz.deployment.DeployableAgent` | Composes capabilities, subagents, and background agents. |
 
 ## Optional ecosystem

{roboz-0.1.2.dev5 → roboz-0.1.2.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "roboz"
-version = "0.1.2.dev5"
+version = "0.1.2.dev6"
 description = "Typed primitives for composable agentic workflows"
 readme = "README.md"
 authors = [{ name = "Tachion Oy" }]

roboz-0.1.2.dev6/src/roboz/__init__.py

@@ -0,0 +1,48 @@
+"""Lazy domain namespaces and concise authoring primitives for Roboz."""
+
+from importlib import import_module
+from typing import Final
+
+_DOMAINS: Final = frozenset(
+    {
+        "agent",
+        "dependencies",
+        "deployment",
+        "exceptions",
+        "llm",
+        "models",
+        "runtime",
+        "skill",
+        "tooling",
+        "tools",
+    }
+)
+_AUTHORING_EXPORTS: Final = {
+    "Agent": ("roboz.agent", "Agent"),
+    "Factory": ("roboz.tooling", "Factory"),
+    "Skill": ("roboz.skill", "Skill"),
+    "Tool": ("roboz.tooling", "Tool"),
+    "factory": ("roboz.tooling", "factory"),
+    "tool": ("roboz.tooling", "tool"),
+}
+
+__all__ = list(_AUTHORING_EXPORTS) + sorted(_DOMAINS)  # pyright: ignore[reportUnsupportedDunderAll]
+
+
+def __getattr__(name: str) -> object:
+    """Load a declared public namespace or authoring primitive on first access."""
+    if name in _DOMAINS:
+        value = import_module(f"{__name__}.{name}")
+    else:
+        try:
+            module_name, attribute = _AUTHORING_EXPORTS[name]
+        except KeyError:
+            raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+        value = getattr(import_module(module_name), attribute)
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    """Return loaded globals together with every declared lazy export."""
+    return sorted(set(globals()) | set(__all__))

roboz-0.1.2.dev6/src/roboz/__init__.pyi

@@ -0,0 +1,20 @@
+"""Typed public namespaces and concise authoring primitives for Roboz."""
+
+from roboz import agent as agent
+from roboz import dependencies as dependencies
+from roboz import deployment as deployment
+from roboz import exceptions as exceptions
+from roboz import llm as llm
+from roboz import models as models
+from roboz import runtime as runtime
+from roboz import skill as skill
+from roboz import tooling as tooling
+from roboz import tools as tools
+from roboz.agent import Agent as Agent
+from roboz.skill import Skill as Skill
+from roboz.tooling import Factory as Factory
+from roboz.tooling import Tool as Tool
+from roboz.tooling import factory as factory
+from roboz.tooling import tool as tool
+
+__all__: list[str]

{roboz-0.1.2.dev5 → roboz-0.1.2.dev6}/src/roboz/tooling/__init__.py

@@ -2,5 +2,13 @@
 
 from roboz.tooling.context import HasExternalDependencies, Materializable
 from roboz.tooling.core import Factory, Tool
+from roboz.tooling.decorators import factory, tool
 
-__all__ = ["HasExternalDependencies", "Materializable", "Factory", "Tool"]
+__all__ = [
+    "Factory",
+    "HasExternalDependencies",
+    "Materializable",
+    "Tool",
+    "factory",
+    "tool",
+]

roboz-0.1.2.dev5/src/roboz/__init__.py

@@ -1,71 +0,0 @@
-"""Agent, skill, data, tool, and factory authoring primitives for Roboz."""
-
-from roboz.agent import (
-    Agent,
-    BackgroundAgentStatus,
-    prompt_agent,
-    run_background_agent,
-    run_subagent,
-)
-from roboz.skill import Skill
-from roboz.tools import (
-    PromptUser,
-    message_user,
-    prompt_user,
-    prompt_user_at_start,
-    stop,
-    stop_after,
-)
-from roboz.models import (
-    AgentBaseModel,
-    All,
-    Empty,
-    HashMaps,
-    Int,
-    Invoke,
-    Location,
-    LocationStr,
-    Message,
-    Role,
-    Stop,
-    StopLocation,
-    Str,
-    Strs,
-)
-from roboz.tooling import HasExternalDependencies, Materializable, Factory, Tool
-from roboz.tooling.decorators import factory, tool
-
-__all__ = [
-    "Agent",
-    "AgentBaseModel",
-    "All",
-    "BackgroundAgentStatus",
-    "HasExternalDependencies",
-    "Empty",
-    "Factory",
-    "HashMaps",
-    "Int",
-    "Invoke",
-    "Location",
-    "LocationStr",
-    "Materializable",
-    "Message",
-    "PromptUser",
-    "Role",
-    "Skill",
-    "Stop",
-    "StopLocation",
-    "Str",
-    "Strs",
-    "Tool",
-    "factory",
-    "message_user",
-    "prompt_agent",
-    "prompt_user",
-    "prompt_user_at_start",
-    "run_background_agent",
-    "run_subagent",
-    "stop",
-    "stop_after",
-    "tool",
-]