Crate agentic_graph_spec 

Native Rust support for Agentic Graph Specification (AGS) 1.0.

The crate parses JSON/YAML graphs, validates structural and semantic rules, computes RFC 8785 identities, parses AGX expressions, and creates deterministic conformance-level-0 plans. It never executes a graph.

Structs

AgxCall

A function call discovered while parsing an AGX expression.

AgxError

Syntax error returned by the AGX parser.

EffectiveEdge

A normalized dependency or explicitly declared graph edge.

Finding

One machine-readable validation diagnostic.

GraphPlan

Deterministic, non-executing conformance-level-0 graph plan.

ParseError

AGS parsing failure with a stable diagnostic code.

ParsedExpression

Structural information collected from a valid AGX expression.

ValidationReport

The complete result of parsing and validating an AGS document.

Enums

CanonicalError

Failure while producing canonical JSON.

PlanError

Failure while constructing a deterministic graph plan.

Constants

AGS_VERSION

AGS specification version implemented by this crate.

SUPPORT_VERSION

Version of this Rust support library.

Functions

canonical_json

Serializes a value using RFC 8785 JSON Canonicalization Scheme rules.

graph_digest

Computes the AGS sha256-<base64> identity of a graph document.

graph_effective_edges

Combines depends_on relationships and explicit edges into a sorted edge set.

load

Loads an AGS document, selecting JSON for .json paths and YAML otherwise.

parse

Parses a JSON or YAML AGS document with duplicate-key rejection.

parse_expression

Parses and validates AGX syntax while collecting calls and references.

plan_graph

Produces a deterministic, non-executing AGS conformance-level-0 plan.

topological_order

Computes a deterministic, identifier-tiebroken topological node order.

validate

Runs embedded JSON Schema, semantic, topology, and AGX dataflow validation.

validate_path

Loads and validates an AGS document, returning parse failures as diagnostics.

Type Aliases

Document

A parsed AGS document represented as a JSON-compatible object.