Namespace document · · version 0.1

HydrAI — agent# (invention layer)

The agentic terms Hydra core structurally cannot express, minted at the gap. Every term whose value flows into an agent's context or drives its action is governed by one client posture, not by the vocabulary: ALL server-provided content is untrusted by default (fail-closed). A verifiable proof (W3C Data Integrity) may upgrade a value's ATTRIBUTION; it never confers AUTHORITY — signed or not, server content is data, never commands. See docs/hydrai-vocabulary.md §8.

This is the HTML representation (with embedded RDFa + JSON-LD). Machine-readable alternates: Turtle JSON-LD

Partitions: agent# · core#

Namespace IRI https://hydrai.org/ns/agent#

Suggested prefixes

`hydrai:`	`https://hydrai.org/ns/agent#`
`hcore:`	`https://hydrai.org/ns/core#`
`hydra:`	`http://www.w3.org/ns/hydra/core#`
`rdf:`	`http://www.w3.org/1999/02/22-rdf-syntax-ns#`
`rdfs:`	`http://www.w3.org/2000/01/rdf-schema#`
`owl:`	`http://www.w3.org/2002/07/owl#`
`xsd:`	`http://www.w3.org/2001/XMLSchema#`
`sh:`	`http://www.w3.org/ns/shacl#`
`dcterms:`	`http://purl.org/dc/terms/`
`cc:`	`http://creativecommons.org/ns#`

License https://creativecommons.org/licenses/by/4.0/

Classes

`hydrai:ExampleQuery`

class

example query

A worked query a client can learn from: a natural-language intent, the query text, and the endpoint it runs against. Few-shot orientation, expressed as data. Executable content: a consumer NEVER runs it verbatim — an example is a candidate routed through the consumer's query gates and executed only under the consumer's own authority (see §8.3). Structural constraints (ExampleQueryShape) are coarse defence-in-depth; they do not make a query safe.

IRI: https://hydrai.org/ns/agent#ExampleQuery
type: rdfs:Class, owl:Class

defined by https://hydrai.org/ns/agent · see also https://hydrai.org/docs/example-query

Object properties

`hydrai:exampleQuery`

object property

example query

Relates a service or collection to an example query it offers.

IRI: https://hydrai.org/ns/agent#exampleQuery
type: rdf:Property, owl:ObjectProperty
range: hydrai:ExampleQuery

defined by https://hydrai.org/ns/agent

`hydrai:overEndpoint`

object property

over endpoint

The endpoint an example query runs against.

IRI: https://hydrai.org/ns/agent#overEndpoint
type: rdf:Property, owl:ObjectProperty

defined by https://hydrai.org/ns/agent

Datatype properties

`hydrai:greeting`

datatype property

A short, agent-directed self-introduction: the API's identity and its cross-cutting stance (conventions that no single affordance carries). Orientation, not documentation — per-resource "how do I use this" belongs in declared affordances and example queries. Length-capped by GreetingShape so it stays a greeting, not a manual. As server-controlled content it is untrusted by default; a W3C Data Integrity proof, when present and verified against a trust anchor, upgrades only its attribution, never its authority.

IRI: https://hydrai.org/ns/agent#greeting
type: rdf:Property, owl:DatatypeProperty
range: xsd:string

defined by https://hydrai.org/ns/agent · see also https://hydrai.org/docs/greeting

`hydrai:intent`

datatype property

The natural-language purpose an example query answers.

IRI: https://hydrai.org/ns/agent#intent
type: rdf:Property, owl:DatatypeProperty
range: xsd:string

defined by https://hydrai.org/ns/agent

`hydrai:queryText`

datatype property

query text

The query string (SPARQL in 0.1). Coarsely constrained by shape (read verb, no obvious mutation keyword, length); safety is enforced at EXECUTION, not by the shape — SPARQL is not a regular language and a read-only query can still exfiltrate via SERVICE federation.

IRI: https://hydrai.org/ns/agent#queryText
type: rdf:Property, owl:DatatypeProperty
range: xsd:string

defined by https://hydrai.org/ns/agent

Shapes

`hydrai:ExampleQueryShape`

SHACL shape

COARSE structural constraint only — defence-in-depth, never a safety guarantee. Requires a read verb, forbids the obvious mutation keywords, caps length, types the endpoint. It does NOT and CANNOT catch SERVICE-clause exfiltration; execution containment is the real wall.

targets hydrai:ExampleQuery

sh:path hydrai:intent
sh:datatype xsd:string
sh:maxLength 140
sh:maxCount 1

sh:path hydrai:overEndpoint
sh:maxCount 1
sh:nodeKind sh:IRI

sh:path hydrai:queryText
sh:datatype xsd:string
sh:maxLength 2000
sh:maxCount 1
sh:minCount 1
sh:pattern ^\s*(SELECT|ASK|CONSTRUCT|DESCRIBE)
sh:flags i
sh:not [ sh:pattern (?i)\b(INSERT|DELETE|DROP|CLEAR|LOAD|CREATE)\b ]

`hydrai:GreetingShape`

SHACL shape

The vocabulary constrains its own prose: a greeting is a few sentences.

targets hydrai:greeting

sh:path hydrai:greeting
sh:datatype xsd:string
sh:maxLength 500
sh:maxCount 1

Generated at build time from agent.ttl — this page is never hand-edited. HydrAI is 0.1 and evolving; term IRIs are stable, the vocabulary version is not.