artifact_provider.h File Reference

Provider-neutral generated artifacts and long-running operations. More...

#include <neograph/api.h>
#include <neograph/graph/cancel.h>
#include <neograph/json.h>
#include <asio/awaitable.hpp>
#include <chrono>
#include <cstdint>
#include <functional>
#include <memory>
#include <optional>
#include <string>
#include <string_view>
#include <vector>

Include dependency graph for artifact_provider.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	neograph::Artifact
	A durable reference to generated content. More...
struct	neograph::ArtifactOperation
	Final or latest observed state of an artifact operation. More...
struct	neograph::ArtifactPollPolicy
	Polling bound for one long-running operation. More...
class	neograph::ArtifactProvider
	One explicit asynchronous artifact-provider contract. More...
struct	neograph::ArtifactRequest
	Immutable-by-convention input owned by ArtifactProvider::execute_async. More...

Enumerations
enum class	neograph::ArtifactEventKind : std::uint8_t
	Incremental provider notification for ArtifactExecutionMode::Stream.
enum class	neograph::ArtifactExecutionMode : std::uint8_t
	How a provider delivers an artifact operation's result.
enum class	neograph::ArtifactOperationStatus : std::uint8_t
	Provider-neutral lifecycle state of one generated-artifact operation.

Functions
NEOGRAPH_API void	neograph::to_json (json &value, const Artifact &artifact)
	Serialize only durable artifact data; provider transport state is excluded.

Detailed Description

Provider-neutral generated artifacts and long-running operations.

Generated media APIs do not fit a text completion: their immediate response may be a final artifact, a stream of progress/artifact events, or a remote operation that must be polled. This contract keeps those modes explicit, carries only durable artifact references (never an unbounded byte buffer), and centralizes bounded, cancellation-aware LRO polling.

Definition in file artifact_provider.h.