flyteplugins-agents-core

The shared contract every Flyte agent-SDK adapter is built on, so they all follow one common format.

It is SDK-agnostic — no agent SDK is a dependency here. Adapters depend on it and implement the contract; assert_adapter_conforms enforces that in CI.

What's in it

durable_step(request_key, run, *, name, dumps, loads) — record a call as a durable, replayable flyte.trace leaf (the model-turn durability mechanism). The real, non-serializable call is captured in the run closure, so the trace only ever sees the serializable request_key.
fingerprint(payload) — a deterministic memo key from a request payload.
ToolTaskResolver / attach_tool_resolver(task) — make a tool-backing task resolve to itself on the worker (via the tool's __wrapped_task__ hook) instead of re-dispatching, which would otherwise recurse indefinitely.
ReportTimeline — render agent events into a tab of the Flyte task report.
flyteplugins.agents.core.testing.assert_adapter_conforms(module) — the conformance check every adapter runs as a one-line test.

The rule every adapter follows

The agent run is a Flyte @env.task (the durable parent); each model turn is a flyte.trace (a memoized, replayable leaf); each tool is a Flyte task invoked as a durable child action.

Writing an adapter

A flyteplugins-agents-<sdk> package depends on this core and exposes, at minimum, tool and run_agent (see the conformance contract). Its tool object exposes __wrapped_task__; run_agent runs the SDK's loop inside the calling @env.task, wraps the model in a durable provider built on durable_step, and renders the trace via ReportTimeline.

Release files for flyteplugins-agents-core 2.5.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for flyteplugins-agents-core 2.5.16
File	Interpreter	ABI	Platform	Reset
flyteplugins_agents_core-2.5.16-py3-none-any.whl 13.1 kB Jul 29, 2026	Python 3	none	any	Details

Release files / flyteplugins_agents_core-2.5.16-py3-none-any.whl

Download URL	flyteplugins_agents_core-2.5.16-py3-none-any.whl
Size	13.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`38ad0651c411c087ef962727db42f134ecccd2250513a841bcd4e3d9078a8b51`
BLAKE2b-256 checksum How to use checksums	`52ace32bdcdb716b2f766295bc1b944644a491098f9027ca0cc391ac113fa90d`
Upload date	Jul 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`