cf-agents 0.1.0__tar.gz

cf_agents-0.1.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.3
+Name: cf-agents
+Version: 0.1.0
+Summary: Cloudflare Agents for Python Workers
+Author: Viswa Marepalli
+Author-email: Viswa Marepalli <reachvishm@gmail.com>
+Requires-Dist: typing-extensions>=4.12
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+<sub>
+    <img src="https://raw.githubusercontent.com/justanotherbyte/agents-py/refs/heads/main/.github/agents.svg" height="36">
+</sub>
+&nbsp;
+agents-py
+</h1>
+<p align="center">
+<sup>
+Cloudflare Agents for Python Workers
+</sup>
+</p>
+
+

cf_agents-0.1.0/README.md

@@ -0,0 +1,14 @@
+<h1 align="center">
+<sub>
+    <img src="https://raw.githubusercontent.com/justanotherbyte/agents-py/refs/heads/main/.github/agents.svg" height="36">
+</sub>
+&nbsp;
+agents-py
+</h1>
+<p align="center">
+<sup>
+Cloudflare Agents for Python Workers
+</sup>
+</p>
+
+

cf_agents-0.1.0/pyproject.toml

@@ -0,0 +1,79 @@
+[project]
+name = "cf-agents"
+version = "0.1.0"
+description = "Cloudflare Agents for Python Workers"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = ["typing-extensions>=4.12"]
+
+[[project.authors]]
+name = "Viswa Marepalli"
+email = "reachvishm@gmail.com"
+
+[build-system]
+requires = ["uv_build>=0.12.19,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "agents"
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+extend-exclude = [
+    "verify",
+    ".design",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "N",
+    "UP",
+    "B",
+    "SIM",
+    "C4",
+    "PIE",
+    "RUF",
+    "ANN",
+    "D",
+]
+ignore = ["ANN401"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "D",
+    "ANN",
+]
+"src/agents/__init__.py" = [
+    "F403",
+    "F405",
+]
+"src/agents/chat/{chunks,messages}.py" = ["RUF009"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ty.environment]
+python-version = "3.12"
+
+[tool.ty.analysis]
+allowed-unresolved-imports = [
+    "js",
+    "pyodide",
+    "pyodide.**",
+]
+
+[dependency-groups]
+dev = [
+    "pytest",
+    "ruff",
+    "ty",
+    "workers-runtime-sdk",
+]

cf_agents-0.1.0/pyproject.toml.orig

@@ -0,0 +1,58 @@
+[project]
+name = "cf-agents"
+version = "0.1.0"
+description = "Cloudflare Agents for Python Workers"
+readme = "README.md"
+authors = [
+    { name = "Viswa Marepalli", email = "reachvishm@gmail.com" }
+]
+requires-python = ">=3.12"
+dependencies = ["typing-extensions>=4.12"]
+
+[build-system]
+requires = ["uv_build>=0.12.19,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "agents"
+
+[dependency-groups]
+dev = ["pytest", "ruff", "ty", "workers-runtime-sdk"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+extend-exclude = ["verify", ".design"]   # the verification Worker and design docs aren't SDK code
+
+[tool.ruff.lint]
+select = [
+    "E", "W", "F",      # pycodestyle, pyflakes
+    "I",                # import sorting
+    "N",                # PEP 8 naming
+    "UP",               # modern syntax for the target version
+    "B",                # bugbear
+    "SIM", "C4", "PIE", # simplifications
+    "RUF",              # ruff-specific
+    "ANN",              # annotations everywhere
+    "D",                # docstrings
+]
+ignore = ["ANN401"]     # Any is allowed where decided (code_semantics.md §3)
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D", "ANN"]
+# Wildcard re-exports with a static __all__ (checked by tests/test_public_api.py).
+"src/agents/__init__.py" = ["F403", "F405"]
+# wire() returns a dataclasses.field() (utilities.md §5), which RUF009 can't see.
+"src/agents/chat/{chunks,messages}.py" = ["RUF009"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ty.environment]
+python-version = "3.12"
+
+[tool.ty.analysis]
+allowed-unresolved-imports = ["js", "pyodide", "pyodide.**"]

cf_agents-0.1.0/src/agents/__init__.py

@@ -0,0 +1,175 @@
+"""Python port of the Cloudflare Agents SDK.
+
+Re-exports each subpackage's public names (its ``__all__``). Keep ``__all__``
+below in step with the subpackages' (``tests/test_public_api.py`` checks it).
+"""
+
+from .agent import *
+from .chat import *
+from .core import *
+from .dynamic_agents import *
+from .fibers import *
+from .lifecycle import *
+from .observability import *
+from .queue import *
+from .schedules import *
+from .sessions import *
+from .state import *
+from .streams import *
+from .tasks import *
+from .websockets import *
+
+__all__ = (
+    "DEFAULT_MAX_CHUNK_BYTES",
+    "AIChatAgent",
+    "AIChatAgentOptions",
+    "Agent",
+    "AgentOptions",
+    "AgentPathStep",
+    "AgentRoute",
+    "AgentStub",
+    "AgentsException",
+    "AnyToolPart",
+    "AppendEvent",
+    "AppendResult",
+    "CallableMetadata",
+    "CancelledRun",
+    "ChatMessageOptions",
+    "ChatResponseResult",
+    "ChatStreamError",
+    "ClearEvent",
+    "ClientToolSchema",
+    "CompletedRun",
+    "Connection",
+    "ConnectionContext",
+    "ConnectionStateTooLargeError",
+    "CurrentAgent",
+    "DataPart",
+    "Debounce",
+    "DeleteEvent",
+    "Disposable",
+    "DuplicateConnectionIdError",
+    "DuplicateTaskStepError",
+    "Duration",
+    "DynamicAgents",
+    "FailedRun",
+    "FiberAborted",
+    "FiberCompleted",
+    "FiberConflictError",
+    "FiberContext",
+    "FiberErrored",
+    "FiberInspection",
+    "FiberInterrupted",
+    "FiberNotFoundError",
+    "FiberRecoveryContext",
+    "FiberRecoveryResult",
+    "FiberStatus",
+    "Fibers",
+    "FilePart",
+    "InvalidCronExpressionError",
+    "JSONValue",
+    "JobContext",
+    "JobOutcome",
+    "KeepAlive",
+    "Lifecycle",
+    "LifecycleCapability",
+    "LifecycleEvent",
+    "LifecycleJob",
+    "LifecycleJobs",
+    "LifecycleRoutes",
+    "LifecycleServices",
+    "LifecycleStatus",
+    "LoggingObservability",
+    "MemoryLimitContext",
+    "MessageConcurrency",
+    "MissingTaskDefinitionError",
+    "NonRetryableError",
+    "Observability",
+    "ObservabilityEvent",
+    "PendingRun",
+    "Queue",
+    "QueueItem",
+    "ReadonlyConnectionError",
+    "ReasoningPart",
+    "RecentHistoryResult",
+    "Reschedule",
+    "RetryOptions",
+    "RouteAddress",
+    "RouteContext",
+    "RoutingRetryEvent",
+    "RoutingRetryOptions",
+    "RunningRun",
+    "SaveMessagesResult",
+    "Schedule",
+    "ScheduleType",
+    "Scheduler",
+    "Session",
+    "SessionChangeEvent",
+    "SessionChangeListener",
+    "SessionMessage",
+    "SessionRowStat",
+    "Sessions",
+    "Source",
+    "SourceDocumentPart",
+    "SourceUrlPart",
+    "Sql",
+    "SqlError",
+    "SqlValue",
+    "StartFiberResult",
+    "State",
+    "StateSource",
+    "StepInterruption",
+    "StepRetries",
+    "StepStartPart",
+    "StepTimeoutError",
+    "StreamChunk",
+    "StreamClosedError",
+    "StreamNotFoundError",
+    "StreamSerializationError",
+    "StreamState",
+    "StreamStatus",
+    "StreamWriter",
+    "StreamingResponse",
+    "Streams",
+    "SubAgentAbortedError",
+    "SubAgentInfo",
+    "TaskError",
+    "TaskHandle",
+    "TaskReceipt",
+    "TaskReplayDivergedError",
+    "TaskRun",
+    "TaskRunState",
+    "TaskSerializationError",
+    "TaskStep",
+    "TaskStepAttempt",
+    "Tasks",
+    "TextPart",
+    "ToolApproval",
+    "ToolApprovalRequestedPart",
+    "ToolApprovalRespondedPart",
+    "ToolInputAvailablePart",
+    "ToolInputStreamingPart",
+    "ToolOutputAvailablePart",
+    "ToolOutputDeniedPart",
+    "ToolOutputErrorPart",
+    "ToolPart",
+    "ToolState",
+    "UIMessage",
+    "UIMessagePart",
+    "UnknownPart",
+    "UpdateEvent",
+    "WaitingRun",
+    "WebSocketHandlers",
+    "WebSockets",
+    "build_agent_path",
+    "build_agent_url",
+    "callable",
+    "get_agent_by_name",
+    "get_current_agent",
+    "get_sub_agent_by_name",
+    "retry",
+    "route_agent_request",
+    "route_sub_agent_request",
+    "subscribe",
+    "task",
+)