kneo-client 0.1.0__tar.gz

kneo_client-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kneron, Inc. and kneo-client contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kneo_client-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: kneo-client
+Version: 0.1.0
+Summary: Typed Python SDK and adapter toolkit for the Kneo Agent Platform
+Author: Kneron, Inc. and kneo-client contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kneo-agent/kneo-client
+Project-URL: Documentation, https://kneo-agent.github.io/kneo-client/
+Project-URL: Issues, https://github.com/kneo-agent/kneo-client/issues
+Project-URL: Changelog, https://github.com/kneo-agent/kneo-client/blob/main/CHANGELOG.md
+Project-URL: Source, https://github.com/kneo-agent/kneo-client
+Keywords: kneo,agent,platform,sdk,client,ai,agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: anyio>=4.0
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: attrs>=23.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: respx>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.8; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: bandit>=1.7; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.27; extra == "docs"
+Provides-Extra: generator
+Requires-Dist: openapi-python-client>=0.21; extra == "generator"
+Dynamic: license-file
+
+# kneo-client
+
+Typed Python SDK and adapter toolkit for the [Kneo Agent Platform](https://github.com/kneo-agent/kneo-serv).
+
+Shared client layer for **Kneo Agent Studio** (development) and **Kneo Agent Dashboard** (operations). Owns auth, profiles, retries, idempotency, pagination, request IDs, and error normalization for the platform's `/v1` HTTP API.
+
+```python
+from kneo_client import KneoClient
+
+async with KneoClient(profile="default") as client:
+    run = await client.platform.runs.create(...)
+```
+
+A synchronous facade is provided for callers that do not run in an event loop.
+
+See the [project README](https://github.com/kneo-agent/kneo-client) for architecture and scope.
+
+## License
+
+MIT

kneo_client-0.1.0/README.md

@@ -0,0 +1,41 @@
+# Kneo Agent Client
+
+Typed Python SDK and adapter toolkit for the [Kneo Agent Platform](https://github.com/kneo-agent/kneo-serv).
+
+`kneo-client` is the shared client layer that powers **Kneo Agent Studio** (development) and **Kneo Agent Dashboard** (operations). It owns the operational semantics of talking to a Kneo Agent Platform instance — auth, profiles, retries, idempotency, pagination, request IDs, and consistent error normalization — so that downstream UIs do not each reinvent them.
+
+## Status
+
+`v0.1.0` release candidate (`0.1.0rc1`). All eight roadmap phases complete: core, platform adapter, agent adapter, helpers, examples, user docs, release plumbing, contract tests. The 0.1.0 cut is feature-complete and pending the rc → stable promotion (TestPyPI smoke → PyPI publish). See [docs/releases/release_notes_0.1.0.md](docs/releases/release_notes_0.1.0.md) for what's in this release and [docs/plan/release_checklist.md](docs/plan/release_checklist.md) for the publish sequence.
+
+## Architecture
+
+Three layers:
+
+1. **`kneo_client._generated`** — low-level client generated from `kneo_serv`'s `openapi.json` via `openapi-python-client`. Covers the stable `/v1` API. Treated as a private module.
+2. **`kneo_client.core`** — handwritten cross-cutting client: auth (Bearer / X-Kneo-Api-Key), profile resolution, httpx-based transport, retry/backoff/timeout policy, idempotency-key support, request-ID propagation, pagination helpers, normalized errors, redaction-aware logging.
+3. **Domain adapters**:
+   - **`kneo_client.platform`** — operational surface for the dashboard: health, runs, traces, checkpoints, replay, human tasks, audit, credentials, policies.
+   - **`kneo_client.agent`** — development surface for the studio: spec validate / compile / explain / run / policy-report.
+
+The public entry point is a unified `KneoClient` exposing `.platform` and `.agent` namespaces:
+
+```python
+from kneo_client import KneoClient
+
+async with KneoClient(profile="default") as client:
+    run = await client.platform.runs.create(...)
+    report = await client.agent.specs.policy_report(...)
+```
+
+A synchronous facade is provided for callers that do not run in an event loop.
+
+## Scope
+
+**In scope:** anything required to talk to the Kneo Agent Platform `/v1` API safely and consistently.
+
+**Out of scope:** business-logic redefinition of the platform; n8n / Dify / other workflow import/conversion (that belongs in Kneo Agent Studio as a development-domain library).
+
+## License
+
+[MIT](LICENSE)

kneo_client-0.1.0/README.pypi.md

@@ -0,0 +1,20 @@
+# kneo-client
+
+Typed Python SDK and adapter toolkit for the [Kneo Agent Platform](https://github.com/kneo-agent/kneo-serv).
+
+Shared client layer for **Kneo Agent Studio** (development) and **Kneo Agent Dashboard** (operations). Owns auth, profiles, retries, idempotency, pagination, request IDs, and error normalization for the platform's `/v1` HTTP API.
+
+```python
+from kneo_client import KneoClient
+
+async with KneoClient(profile="default") as client:
+    run = await client.platform.runs.create(...)
+```
+
+A synchronous facade is provided for callers that do not run in an event loop.
+
+See the [project README](https://github.com/kneo-agent/kneo-client) for architecture and scope.
+
+## License
+
+MIT

kneo_client-0.1.0/kneo_client/__init__.py

@@ -0,0 +1,71 @@
+"""Kneo Agent Client — typed Python SDK and adapter toolkit for the Kneo Agent Platform.
+
+The public entry point is :class:`KneoClient`, which exposes ``.platform``
+(operational surface for the Dashboard) and ``.agent`` (development
+surface for the Studio) namespaces backed by a single auth context and
+transport.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .agent import AgentClient
+from .core.profiles import Profile, load_profile
+from .core.retries import RetryPolicy
+from .core.transport import Transport
+from .platform import PlatformClient
+
+__version__ = "0.1.0"
+
+
+class KneoClient:
+    """Async client for a Kneo Agent Platform instance.
+
+    Construct directly with a :class:`Profile`, or via :meth:`from_profile`
+    to resolve from the standard config-file / env / kwargs chain.
+
+    Example::
+
+        async with KneoClient.from_profile() as client:
+            health = await client.platform.health.readyz()
+            run = await client.platform.runs.create(payload)
+            valid = await client.agent.specs.validate(spec_payload)
+    """
+
+    def __init__(
+        self,
+        profile: Profile,
+        *,
+        retry_policy: RetryPolicy | None = None,
+    ) -> None:
+        """Build a KneoClient bound to ``profile``."""
+        self._transport = Transport(profile, retry_policy=retry_policy)
+        self.platform: PlatformClient = PlatformClient(self._transport)
+        self.agent: AgentClient = AgentClient(self._transport)
+
+    @classmethod
+    def from_profile(cls, name: str | None = None, **overrides: Any) -> KneoClient:
+        """Resolve a profile via :func:`~kneo_client.core.profiles.load_profile` and build a KneoClient."""
+        profile = load_profile(name, **overrides)
+        return cls(profile)
+
+    @property
+    def profile(self) -> Profile:
+        """The resolved :class:`Profile` this client is bound to."""
+        return self._transport.profile
+
+    async def aclose(self) -> None:
+        """Close the underlying transport."""
+        await self._transport.aclose()
+
+    async def __aenter__(self) -> KneoClient:
+        """Enter the async context. Returns ``self``."""
+        return self
+
+    async def __aexit__(self, *exc: object) -> None:
+        """Close the transport on context exit."""
+        await self.aclose()
+
+
+__all__ = ("KneoClient", "__version__")

kneo_client-0.1.0/kneo_client/_generated/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Kneo Agent Platform API"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

kneo_client-0.1.0/kneo_client/_generated/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

kneo_client-0.1.0/kneo_client/_generated/api/audit_events/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

kneo_client-0.1.0/kneo_client/_generated/api/audit_events/list_audit_events_v1_audit_events_get.py

@@ -0,0 +1,206 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.audit_event_list_response import AuditEventListResponse
+from ...models.http_validation_error import HTTPValidationError
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    event_type: None | str | Unset = UNSET,
+    run_id: None | str | Unset = UNSET,
+    limit: int | Unset = 100,
+) -> dict[str, Any]:
+
+    params: dict[str, Any] = {}
+
+    json_event_type: None | str | Unset
+    if isinstance(event_type, Unset):
+        json_event_type = UNSET
+    else:
+        json_event_type = event_type
+    params["event_type"] = json_event_type
+
+    json_run_id: None | str | Unset
+    if isinstance(run_id, Unset):
+        json_run_id = UNSET
+    else:
+        json_run_id = run_id
+    params["run_id"] = json_run_id
+
+    params["limit"] = limit
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/audit-events",
+        "params": params,
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AuditEventListResponse | HTTPValidationError | None:
+    if response.status_code == 200:
+        response_200 = AuditEventListResponse.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AuditEventListResponse | HTTPValidationError]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    event_type: None | str | Unset = UNSET,
+    run_id: None | str | Unset = UNSET,
+    limit: int | Unset = 100,
+) -> Response[AuditEventListResponse | HTTPValidationError]:
+    """List Audit Events
+
+    Args:
+        event_type (None | str | Unset):
+        run_id (None | str | Unset):
+        limit (int | Unset):  Default: 100.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AuditEventListResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        event_type=event_type,
+        run_id=run_id,
+        limit=limit,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    event_type: None | str | Unset = UNSET,
+    run_id: None | str | Unset = UNSET,
+    limit: int | Unset = 100,
+) -> AuditEventListResponse | HTTPValidationError | None:
+    """List Audit Events
+
+    Args:
+        event_type (None | str | Unset):
+        run_id (None | str | Unset):
+        limit (int | Unset):  Default: 100.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AuditEventListResponse | HTTPValidationError
+    """
+
+    return sync_detailed(
+        client=client,
+        event_type=event_type,
+        run_id=run_id,
+        limit=limit,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    event_type: None | str | Unset = UNSET,
+    run_id: None | str | Unset = UNSET,
+    limit: int | Unset = 100,
+) -> Response[AuditEventListResponse | HTTPValidationError]:
+    """List Audit Events
+
+    Args:
+        event_type (None | str | Unset):
+        run_id (None | str | Unset):
+        limit (int | Unset):  Default: 100.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AuditEventListResponse | HTTPValidationError]
+    """
+
+    kwargs = _get_kwargs(
+        event_type=event_type,
+        run_id=run_id,
+        limit=limit,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    event_type: None | str | Unset = UNSET,
+    run_id: None | str | Unset = UNSET,
+    limit: int | Unset = 100,
+) -> AuditEventListResponse | HTTPValidationError | None:
+    """List Audit Events
+
+    Args:
+        event_type (None | str | Unset):
+        run_id (None | str | Unset):
+        limit (int | Unset):  Default: 100.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AuditEventListResponse | HTTPValidationError
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            event_type=event_type,
+            run_id=run_id,
+            limit=limit,
+        )
+    ).parsed

kneo_client-0.1.0/kneo_client/_generated/api/health/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

kneo_client-0.1.0/kneo_client/_generated/api/health/healthz_v1_healthz_get.py

@@ -0,0 +1,128 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.health_response import HealthResponse
+from ...types import Response
+
+
+def _get_kwargs() -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/v1/healthz",
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> HealthResponse | None:
+    if response.status_code == 200:
+        response_200 = HealthResponse.from_dict(response.json())
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[HealthResponse]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[HealthResponse]:
+    """Healthz
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HealthResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+) -> HealthResponse | None:
+    """Healthz
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HealthResponse
+    """
+
+    return sync_detailed(
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[HealthResponse]:
+    """Healthz
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[HealthResponse]
+    """
+
+    kwargs = _get_kwargs()
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+) -> HealthResponse | None:
+    """Healthz
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        HealthResponse
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+        )
+    ).parsed