akribes 0.21.17__py3-none-any.whl

akribes-0.21.17.dist-info/METADATA

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: akribes
+Version: 0.21.17
+Summary: Pythonic async client for the Akribes workflow server
+Author-email: Podesta <info@podesta.ai>
+License: MIT
+Project-URL: Homepage, https://akribes.ai
+Project-URL: Repository, https://github.com/PodestaAI/akribes-sdks
+Project-URL: Documentation, https://akribes.ai
+Project-URL: Issues, https://github.com/PodestaAI/akribes-sdks/issues
+Project-URL: Changelog, https://github.com/PodestaAI/akribes-sdks/blob/main/packages/akribes-sdk-python/CHANGELOG.md
+Keywords: akribes,llm,ai-workflows,agent,dsl,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+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.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: pydantic>=2.6
+Requires-Dist: typing-extensions>=4.10
+Requires-Dist: websockets>=12.0
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.20; extra == "otel"
+Provides-Extra: test
+Requires-Dist: pytest>=8.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "test"
+Requires-Dist: respx>=0.21.0; extra == "test"
+Requires-Dist: opentelemetry-api>=1.20; extra == "test"
+Requires-Dist: opentelemetry-sdk>=1.20; extra == "test"
+Dynamic: license-file
+
+# akribes
+
+Pythonic async client for the [Akribes](https://akribes.ai) workflow server.
+
+Requires Python 3.10+.
+
+## Install
+
+```bash
+pip install akribes
+# or with optional OpenTelemetry support:
+pip install 'akribes[otel]'
+```
+
+## Quick start
+
+```python
+import asyncio
+from akribes_sdk import AkribesClient
+
+async def main():
+    async with AkribesClient("https://akribes.example.com", token="akribes_tk_...") as client:
+        proj = client.project(2)
+        output = await proj.script("summarize").run_and_await(brief="explain quantum")
+        print(output.execution_id, output.result)
+
+asyncio.run(main())
+```
+
+## Construction
+
+```python
+import os
+from datetime import timedelta
+from akribes_sdk import AkribesClient, RetryPolicy
+
+client = AkribesClient(
+    "https://akribes.example.com",
+    token=os.environ["AKRIBES_TOKEN"],
+    timeout=timedelta(seconds=30),
+    retry=RetryPolicy(max_attempts=4),      # retries transients + 429 by default
+    otel=True,                               # opt-in OTel auto-instrumentation
+)
+```
+
+## Project handles
+
+```python
+proj = client.project(2)                              # sync, lazy
+proj = await client.get_project("podesta-staging")    # async, resolves name → id
+sandbox = await client.sandbox()                       # per-user sandbox project
+```
+
+## Typed inputs (codegen)
+
+Generate typed `ScriptType[I, O]` stubs from a live server:
+
+```bash
+akribes types pull --project podesta --lang python --out src/akribes_types/
+```
+
+Then:
+
+```python
+from akribes_types.podesta import summarize   # ScriptType[I, O] with typed input/output
+
+out = await proj.run(summarize, brief="hi", tone="formal")
+# IDE knows brief: str, tone: Literal["formal","casual"]
+print(out.execution_id, out.result)
+```
+
+## Streaming
+
+```python
+run = await proj.executions.run_stream("summarize", brief="hi")
+async for evt in run:
+    match evt.kind:
+        case "agent_chunk": print(evt.chunk, end="")
+        case "task_end":    print(f"\n[task {evt.task!r} done]")
+        case "error":       print(f"\n[error {evt.message}]")
+output = await run.output()
+```
+
+## Document ingest
+
+```python
+from pathlib import Path
+
+# One-liner
+result = await proj.documents.ingest_and_wait(Path("invoice.pdf"))
+
+# With progress
+handle = proj.documents.ingest(Path("invoice.pdf"))
+async for evt in handle:
+    print(evt)
+result = await handle.result()
+```
+
+## Subscribe (long-lived events)
+
+```python
+async with proj.events.subscribe(interests=[{"script_name": "summarize"}]) as sub:
+    async for evt in sub:
+        print(evt)
+```
+
+Heartbeat runs for the lifetime of the subscription only — not automatically on client construction.
+
+## Pagination
+
+```python
+async for script in proj.scripts.list():
+    print(script.name)
+
+# Or materialise
+scripts = await proj.scripts.list().to_list()
+first   = await proj.scripts.list().first()
+top10   = await proj.scripts.list().take(10)
+```
+
+## Error handling
+
+```python
+from akribes_sdk import (
+    AkribesError, AuthError, NotFoundError, TransientError,
+    RateLimitError, ScriptError, AkribesTimeoutError,
+)
+
+try:
+    output = await proj.run_and_await("summarize", brief="hi")
+except AuthError:        # 401/403
+    ...
+except NotFoundError:    # 404
+    ...
+except TransientError:   # 502/503 (retried by default)
+    ...
+except RateLimitError:   # 429 (retried by default, respects Retry-After)
+    ...
+except ScriptError as e: # workflow failed; e.error_kind, e.execution_id
+    ...
+```
+
+## Tokens
+
+```python
+from datetime import timedelta
+minted = await client.tokens.mint(
+    scopes={"projects": "*", "role": "admin"},
+    expires_in=timedelta(hours=8),
+    label="web-session",
+    user_email="alice@acme.com",
+)
+print(minted.token)   # ship to the browser
+```
+
+## Authentication
+
+`AkribesClient` accepts either a **service token** (long-lived, set via
+`AKRIBES_SERVICE_TOKEN_<NAME>=<scope>:<secret>` on the server) or a **scoped
+token** (`akribes_tk_...` — legacy `aura_tk_...` still accepted — minted
+via `client.tokens.mint(...)`).
+
+### Prefer `Authorization: Bearer` over `?token=…` (#789)
+
+`AkribesClient` always sends the token in the `Authorization` header
+for HTTP requests and WebSocket upgrades. The `?token=…` query-string
+form exists only because browser `EventSource` / `WebSocket`
+constructors cannot set arbitrary headers — treat it as a browser-only
+escape hatch.
+
+For CLIs, scripts, and backend services, avoid `?token=…` because:
+
+- Reverse proxies, ingress controllers, and CDNs log the full URL
+  (including the token) in access logs by default.
+- CI runners (Forgejo Actions, GitHub Actions) echo `curl` commands
+  into job logs.
+- Browsers leak `?token=` in the `Referer` header on cross-origin
+  sub-resource requests.
+
+The server stamps `X-Token-Source: query-param` on responses to any
+request that used the query fallback so operators can chart adoption.
+
+---
+
+See `examples/` for runnable end-to-end demos.
+
+Upgrading from v0.20.x? See [MIGRATION-0.21.md](./MIGRATION-0.21.md).
+
+- Source mirror: <https://github.com/PodestaAI/akribes-sdks>
+- Language guide: <https://akribes.ai/docs>
+- Issues: <https://github.com/PodestaAI/akribes-sdks/issues>
+
+## License
+
+MIT

akribes-0.21.17.dist-info/RECORD

@@ -0,0 +1,39 @@
+akribes-0.21.17.dist-info/licenses/LICENSE,sha256=AkGMPHFQaCG_v30NPbjxK4Gvj2UqBLkPmWa842xo9gU,1064
+akribes_sdk/__init__.py,sha256=huhcS2SH6PRD5RVTYtxkqhzkxwiDWA7LdpdIQX5SZwU,8621
+akribes_sdk/_handles.py,sha256=7V87-x-wWPyPAUGbJotQvL_5w6CIGE8jVhFMQ-vX3Cs,11682
+akribes_sdk/_otel.py,sha256=rJJBuIuSbbivuc6z8N51NkpCBIgt2atCh9GuYAkuPVw,1942
+akribes_sdk/_pagination.py,sha256=_zZaWkN6TS5MsQzbmlrRWn1nBIpN1QjU-n-V3PuLwv8,2009
+akribes_sdk/_parsers.py,sha256=EldBzsArWuH9u4GIkYPeG3lkman1G2-bRdecGIQRfO0,25110
+akribes_sdk/_retry.py,sha256=CW90qQKS0870hDE8DtNwjkZXN2XtTJVO21olg1DYrhU,4713
+akribes_sdk/_timing.py,sha256=2mRLSsRSaHXhp-ujy_Ivkz7ePsIQNh9nx67qdoI_P04,631
+akribes_sdk/_token_safety.py,sha256=9CdBcgtp7DK7H9tUP5ZpjdeSxI49UGhXWBJ4gj63MII,1492
+akribes_sdk/_transport.py,sha256=CrTfAWDyDhuDN38pmXFPxGmq30ivnBaPA3gtSHZ7L6M,14334
+akribes_sdk/client.py,sha256=VhDVmjYjFv52b3JgJFFhBC22tnRf8UBnrHit2RW6JM0,22503
+akribes_sdk/errors.py,sha256=lcdX-g7IqbFGwWrwUS2fn3d9UcXXqi7V8PRER4hUti8,15317
+akribes_sdk/ingest_handle.py,sha256=1jx126EJdaF6EuNFSiKUSSdaJjIqVAvNulvKvz8Gj5A,3900
+akribes_sdk/models.py,sha256=mQM864VLPwACuxjsPItOm0PkB9OYXGs7f2Ma21KRWow,47928
+akribes_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+akribes_sdk/run_stream.py,sha256=Mw79KqpFPUY_AgdYHilIbyeBGfURW1s7mWpN-Ec7XpI,19452
+akribes_sdk/script_type.py,sha256=6bKg54xBSXcoFQ62HvSIOyh33glZqx4hZjDL4gtajMU,2075
+akribes_sdk/types.py,sha256=ZRXhaknLcSe5-qZsAUw8zanAN_Pa9uK8aaMBW_GyVdk,2172
+akribes_sdk/workflow_events.py,sha256=EXYhZlHOiJkNSq71GB_4KaguSAfe--Z0-ESztaVL4mU,38734
+akribes_sdk/resources/__init__.py,sha256=wtUaAaiauWI_Jdqf4QdwLuOoxvEZ-6H9S5KhvfGFaQc,1050
+akribes_sdk/resources/_base.py,sha256=65IM5lbaRwkww9qd1NKm9Mt-eMnnlNbqqxLoEdKXgPc,3239
+akribes_sdk/resources/_sentinel.py,sha256=_ri_arV94v5Nw5VepXcS6q6Qb443c_TJBhEnT7Nw1_0,669
+akribes_sdk/resources/channels.py,sha256=Nf__iBVXiDwTQGszg0l_dHp7PdMjxgfqJmNUOq-7RbQ,1705
+akribes_sdk/resources/clients.py,sha256=p7GvIOeTDeTTjCXpL-1xwqGsI715NXGnEF3EBLxV2Z8,3377
+akribes_sdk/resources/documents.py,sha256=fETPctomD7fi7IIkGVfuRG2vtLHZH0tA5FjlDG3kphk,16586
+akribes_sdk/resources/drafts.py,sha256=2qLmJOnMl410jjMO-etfv7TUM_xcU0-sqSpxdFq5J_o,1246
+akribes_sdk/resources/evals.py,sha256=yk82xqP2YHU871ouf_EgIB21-1PxwIEPKWS1PTq6974,8595
+akribes_sdk/resources/events.py,sha256=DhHMkVTnqk2qsrhU-1EdJuRIoKwWUqDIYZimp0AyS7M,32207
+akribes_sdk/resources/executions.py,sha256=D8YEEJ6rMxrz0j_v08DYMPOYie6WBaiLBA-UdR5wG2s,21206
+akribes_sdk/resources/mcp.py,sha256=IdEh0YUvQPzDBYkNzxcX166UHBvHF0qfkWgMNQUR4LM,1976
+akribes_sdk/resources/me.py,sha256=VWCxW4M1bdL7CTMngdWR58wIlwDQ3ZPNZIRVYlUX0dM,1065
+akribes_sdk/resources/projects.py,sha256=ObNUoxDWT7RI1qIve-V1a7XDc_xfb_vR4b-tO5O0wW8,6335
+akribes_sdk/resources/scripts.py,sha256=RtqXhSZ2x631WgkXraM3UlDHmS3eYKQCGprkhwXTRbg,3438
+akribes_sdk/resources/tokens.py,sha256=g9KXyZLUZp58Thm2Qkahw3bQD2GnhBBsrpLfyjxPpOk,3437
+akribes_sdk/resources/versions.py,sha256=QIyUlsRbN0XavKrE1ZIOEBt07xM3dvSZvuv0x1u_BLA,3437
+akribes-0.21.17.dist-info/METADATA,sha256=tttXX78Db15Zu1p2kUbmcDu_9ap4bSwSmbbbBKzU_4s,6896
+akribes-0.21.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+akribes-0.21.17.dist-info/top_level.txt,sha256=jJZu7eTgBdHI5CtfG1o3NknV2tCv2n3OcJ15Fhs6KBg,12
+akribes-0.21.17.dist-info/RECORD,,

akribes-0.21.17.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

akribes-0.21.17.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Podesta
+
+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.

akribes-0.21.17.dist-info/top_level.txt

@@ -0,0 +1 @@
+akribes_sdk

akribes_sdk/__init__.py

@@ -0,0 +1,365 @@
+"""Akribes SDK for Python — async client for the Akribes workflow server.
+
+Quick start::
+
+    import asyncio, os
+    from akribes_sdk import AkribesClient
+
+    async def main():
+        async with AkribesClient(
+            "https://akribes.example.com",
+            token=os.environ["AKRIBES_TOKEN"],
+        ) as client:
+            proj = client.project(2)
+            output = await proj.script("summarize").run_and_await(brief="…")
+            print(output.execution_id, output.result)
+
+    asyncio.run(main())
+
+Event stream layering
+---------------------
+Three progressively richer APIs sit on top of the same SSE connection:
+
+1. Layer 1 — :class:`EngineEvent` (raw ``{type, payload}``): escape hatch
+   for anything the typed layer doesn't model.
+2. Layer 2 — :class:`WorkflowEvent`: frozen-dataclass discriminated union
+   matched on ``evt.kind`` (a ``Literal`` tag), with an :class:`Other`
+   catch-all. Use :func:`to_workflow_event` for ad-hoc conversion.
+3. Layer 3 — :class:`RunStream` from
+   :meth:`Executions.run_stream`: async-iterable handle that also exposes
+   ``await .output()``, ``.execution_id``, and ``.on.<category>(cb)``
+   callback registration.
+"""
+
+from akribes_sdk._handles import ProjectHandle, ScriptHandle
+from akribes_sdk._pagination import AsyncPage
+from akribes_sdk._retry import ExponentialBackoff, RetryPolicy
+from akribes_sdk.client import AkribesClient
+from akribes_sdk.ingest_handle import IngestHandle, IngestEvent
+from akribes_sdk.script_type import ScriptType
+from akribes_sdk.errors import (
+    AkribesConnectionError,
+    AkribesConversionError,
+    AkribesError,
+    AkribesHTTPError,
+    AkribesTimeoutError,
+    AuthError,
+    DocumentConversionError,
+    IngestProtocolError,
+    IngestTimeoutError,
+    BadGateway502,
+    GatewayTimeout504,
+    NotFoundError,
+    RateLimitError,
+    ScriptError,
+    ScriptInputMismatchError,
+    ScriptSchemaChangedError,
+    ServerError500,
+    ServiceUnavailable503,
+    TransientError,
+)
+from akribes_sdk.resources.documents import (
+    DEFAULT_INGEST_POLL_TIMEOUT_MS,
+    DocumentsClient,
+    ingest_poll_timeout_ms_from_env,
+)
+from akribes_sdk.resources.me import Me
+from akribes_sdk.models import (
+    AdhocRunResult,
+    AgentOutputEvent,
+    AgentUnableTrigger,
+    BreakingInterest,
+    ClaimHit,
+    ClaimMiss,
+    ClaimResult,
+    ClientInfo,
+    ContextCompactedEvent,
+    ContextOverflowEvent,
+    ContractWarning,
+    ConversionStatus,
+    ConvertResult,
+    CostAggregation,
+    CostByChannel,
+    CostByScript,
+    CostByVersion,
+    DagPositionTrigger,
+    Draft,
+    EngineEvent,
+    EngineEventType,
+    IngestPhase,
+    IngestProgress,
+    ErrorKind,
+    EvalResult,
+    EvalRun,
+    EvalSuite,
+    EvalSuiteSummary,
+    ExecutionChildSummary,
+    ExecutionEvents,
+    ExecutionOutput,
+    ExecutionStatus,
+    ExecutionStatusValue,
+    DocumentMeta,
+    GraphEdge,
+    GraphNode,
+    GraphResponse,
+    ScriptGraph,
+    HubEvent,
+    InputField,
+    LatestVersion,
+    LogEvent,
+    McpDriftResult,
+    McpHealth,
+    McpRefreshResult,
+    McpServerSummary,
+    McpToolSummary,
+    Project,
+    ProjectScope,
+    ProjectCost,
+    PublishDryRunResult,
+    PutDraftResponse,
+    ReconvertResult,
+    RunResult,
+    ScriptCost,
+    RuntimeEndEvent,
+    RuntimeErrorEvent,
+    RuntimeStartEvent,
+    RuntimeStderrEvent,
+    RuntimeStdoutEvent,
+    S3CredentialsRef,
+    S3DocumentRef,
+    S3PresignedRef,
+    SandboxInfo,
+    Script,
+    ScriptChannel,
+    ScriptVersion,
+    UploadResult,
+    SuspendedEvent,
+    SuspendTrigger,
+    TaskEndEvent,
+    TaskStartEvent,
+    TokenInfo,
+    TokenMinted,
+    TokenRole,
+    TokenScopes,
+    TokenUsage,
+    ToolApprovalPendingEvent,
+    TypedEngineEvent,
+    TypeRef,
+    UnableCategoryValue,
+    UnableRecord,
+    UnknownEvent,
+    UnknownTrigger,
+    ValidationErrorWire,
+    ValidationExhaustedTrigger,
+    ValidationFailureEvent,
+    WorkflowEndEvent,
+    WorkflowStartEvent,
+    parse_engine_event,
+    parse_suspend_trigger,
+)
+from akribes_sdk.run_stream import RunStream, RunStreamCallbacks
+from akribes_sdk.workflow_events import (
+    AgentChunk,
+    Breakpoint,
+    Checkpoint,
+    End,
+    EventCategory,
+    Other,
+    RuntimeEnd,
+    RuntimeError,
+    RuntimeStart,
+    RuntimeStatus,
+    RuntimeStderr,
+    RuntimeStdout,
+    WorkflowTotals,
+    RuntimeStep,
+    RuntimeWorkflowEvent,
+    Start,
+    TaskEnd,
+    TaskStart,
+    ToolApproval,
+    ToolCallEnd,
+    ToolCallStart,
+    ValidationFailure,
+    WorkflowError,
+    WorkflowErrorKind,
+    WorkflowEvent,
+    category_of,
+    reduce_runtime_events,
+    reduce_runtime_events_async,
+    to_workflow_event,
+)
+# Re-export the per-variant `ErrorEvent` class from the legacy typed-engine-event
+# layer in `models`. The new typed `WorkflowEvent::Error` variant lives at
+# `WorkflowError` to avoid the name clash.
+from akribes_sdk.models import ErrorEvent
+
+__version__ = "0.21.0"
+
+__all__ = [
+    "__version__",
+    # Client + handles
+    "AkribesClient",
+    "AsyncPage",
+    "IngestHandle",
+    "IngestEvent",
+    "ProjectHandle",
+    "ScriptHandle",
+    "ScriptType",
+    # Retry policy
+    "RetryPolicy",
+    "ExponentialBackoff",
+    # Errors
+    "AkribesError",
+    "AkribesConnectionError",
+    "AkribesHTTPError",
+    "AuthError",
+    "NotFoundError",
+    "RateLimitError",
+    "TransientError",
+    "ServerError500",
+    "BadGateway502",
+    "ServiceUnavailable503",
+    "GatewayTimeout504",
+    "ScriptError",
+    "AkribesTimeoutError",
+    "AkribesConversionError",
+    "DocumentConversionError",
+    "IngestProtocolError",
+    "IngestTimeoutError",
+    "ScriptSchemaChangedError",
+    "ScriptInputMismatchError",
+    # Models
+    "AdhocRunResult",
+    "BreakingInterest",
+    "ClaimHit",
+    "ClaimMiss",
+    "ClaimResult",
+    "ClientInfo",
+    "ContractWarning",
+    "ContextCompactedEvent",
+    "ContextOverflowEvent",
+    "ConversionStatus",
+    "CostAggregation",
+    "CostByChannel",
+    "CostByScript",
+    "CostByVersion",
+    "ConvertResult",
+    "Draft",
+    "EngineEvent",
+    "EngineEventType",
+    "ErrorEvent",
+    "ErrorKind",
+    "EvalResult",
+    "EvalRun",
+    "EvalSuite",
+    "EvalSuiteSummary",
+    "ExecutionEvents",
+    "ExecutionOutput",
+    "ExecutionChildSummary",
+    "DocumentMeta",
+    "ExecutionStatus",
+    "ExecutionStatusValue",
+    "GraphEdge",
+    "GraphNode",
+    "GraphResponse",
+    "ScriptGraph",
+    "HubEvent",
+    "IngestPhase",
+    "IngestProgress",
+    "InputField",
+    "LatestVersion",
+    "McpDriftResult",
+    "McpHealth",
+    "McpRefreshResult",
+    "McpServerSummary",
+    "McpToolSummary",
+    "Project",
+    "ProjectScope",
+    "ProjectCost",
+    "PublishDryRunResult",
+    "PutDraftResponse",
+    "ReconvertResult",
+    "RunResult",
+    "ScriptCost",
+    "S3CredentialsRef",
+    "S3DocumentRef",
+    "S3PresignedRef",
+    "SandboxInfo",
+    "Script",
+    "ScriptChannel",
+    "ScriptVersion",
+    "TokenInfo",
+    "UploadResult",
+    # Documents resource
+    "DEFAULT_INGEST_POLL_TIMEOUT_MS",
+    "DocumentsClient",
+    "Me",
+    "ingest_poll_timeout_ms_from_env",
+    "TokenMinted",
+    "TokenRole",
+    "TokenScopes",
+    "TokenUsage",
+    "TypeRef",
+    # SuspendTrigger + UnableRecord (Wave 4 — EPA S4 + S6)
+    "AgentUnableTrigger",
+    "DagPositionTrigger",
+    "SuspendTrigger",
+    "UnableCategoryValue",
+    "UnableRecord",
+    "UnknownTrigger",
+    "ValidationErrorWire",
+    "ValidationExhaustedTrigger",
+    "parse_suspend_trigger",
+    # Legacy per-variant event classes (still exported for back-compat)
+    "AgentOutputEvent",
+    "LogEvent",
+    "RuntimeEndEvent",
+    "RuntimeErrorEvent",
+    "RuntimeStartEvent",
+    "RuntimeStderrEvent",
+    "RuntimeStdoutEvent",
+    "SuspendedEvent",
+    "TaskEndEvent",
+    "TaskStartEvent",
+    "ToolApprovalPendingEvent",
+    "TypedEngineEvent",
+    "UnknownEvent",
+    "ValidationFailureEvent",
+    "WorkflowEndEvent",
+    "WorkflowStartEvent",
+    "parse_engine_event",
+    # Typed WorkflowEvent (Layer 2)
+    "AgentChunk",
+    "Breakpoint",
+    "Checkpoint",
+    "End",
+    "WorkflowTotals",
+    "EventCategory",
+    "Other",
+    "RuntimeEnd",
+    "RuntimeError",
+    "RuntimeStart",
+    "RuntimeStatus",
+    "RuntimeStderr",
+    "RuntimeStdout",
+    "RuntimeStep",
+    "RuntimeWorkflowEvent",
+    "Start",
+    "TaskEnd",
+    "TaskStart",
+    "ToolApproval",
+    "ToolCallEnd",
+    "ToolCallStart",
+    "ValidationFailure",
+    "WorkflowError",
+    "WorkflowErrorKind",
+    "WorkflowEvent",
+    "category_of",
+    "reduce_runtime_events",
+    "reduce_runtime_events_async",
+    "to_workflow_event",
+    # RunStream (Layer 3)
+    "RunStream",
+    "RunStreamCallbacks",
+]