Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

urn

package module

Go to main page

Versions in this module

v0

v0.0.18

Oct 28, 2026

Changes in this version

+ func ComposeActionUrnV2(root, agentSlug, code string) (string, error)

v0.0.17

Oct 12, 2026

Changes in this version

+ func ComposeAgentTaskUrnV2(root, app, taskID string) (string, error)

+ func ComposeTickerUrnV2(root, app, tickerSlug string) (string, error)

+ type NodeLikeURNParts struct

+ Fragment string

+ Loc string

+ MemoryURN string

+ func SplitEdgeUrn(input string) (NodeLikeURNParts, error)

type Reason

+ const ReasonFragmentUnsupported

+ const ReasonRootIDShaped

v0.0.13

Aug 16, 2026

Changes in this version

+ const CanonicalScheme

+ const LegacyScheme

+ const MaxAtomLen

+ var CoreTypes = []string

+ var DisplayURNTypes = []string

+ var NodeParts = []string

+ var NodeRoles = []string

+ var NodeTypes = []string

+ var RoleMarkers = []string

+ var TypeMarkers = map[string]bool

+ var V2URNTypes = []string

+ func AgentSlugFromUrn(agentURN string) string

+ func AssertFullyQualifiedUrn(input, expectedType string) error

+ func ComposeAppRunUrnV2(root, app, runID string) (string, error)

+ func ComposeDataFragmentV2(parentURN string) (string, error)

+ func ComposeEdgeUrn(memURN, loc string) (string, error)

+ func ComposeInstalledAgentUrn(appURN, agentURN string) (string, error)

+ func ComposeNodeRevUrnV2(root, mem, loc, rev string) (string, error)

+ func ComposeNodeUrn(memURN, loc string) (string, error)

+ func ComposeSecretUrnV2(root, name string) (string, error)

+ func ComposeUrnV2(typ, root string, segments ...string) (string, error)

+ func ComposeWorkerUrnV2(root, app, workerSlug string) (string, error)

+ func DeriveSlugFromName(name string) (string, error)

+ func FormatCanonicalUrn(typ, bareValue string) (string, error)

+ func FormatUrn(typ, value string) string

+ func HasSchemePrefix(input string) bool

+ func IsFlatV2(input string) bool

+ func IsParserCanonical(input string) bool

+ func IsValidSlug(slug string) bool

+ func LegacyMemoryUrnToCanonical(bareLegacyURN string) string

+ func NormalizeScheme(input string) string

+ func NormalizeUrnForLookup(bareURN string) string

+ func ToParserCanonical(input string) (string, error)

+ func ValidateAtomShape(input, atom string) error

+ func ValidateOrgSlug(slug string) error

+ func ValidateUrnType(parsed LegacyParsedURN, expected string) *string

+ func ValidateUserHandle(handle string) error

+ func ValidateUserSlug(slug string) error

+ type LegacyParsedURN struct

+ Type string

+ Value string

+ func ParseUrnInput(input string) LegacyParsedURN

+ type NodeURNParts struct

+ Loc string

+ MemoryURN string

+ func SplitNodeUrn(input string) (NodeURNParts, error)

+ type NotQualifiedError struct

+ ExpectedType string

+ OffendingValue string

+ func (e *NotQualifiedError) Code() string

+ func (e *NotQualifiedError) Error() string

+ type ParseError struct

+ Input string

+ OffendingSegment string

+ Reason Reason

+ func (e *ParseError) Error() string

+ type ParseForResult struct

+ Canonical string

+ IsLegacy bool

+ func ParseFor(row UrnRow) (ParseForResult, error)

+ type ParsedDisplayURN struct

+ BareValue string

+ FullURN string

+ Type string

+ func ParseDisplayUrn(value, typeHint string) ParsedDisplayURN

+ type ParsedNodeRevURNV2 struct

+ Loc string

+ Memory string

+ Rev string

+ Root string

+ Scheme string

+ Type string

+ func ParseNodeRevUrnV2(input string) (ParsedNodeRevURNV2, error)

+ type ParsedURN struct

+ InputForm string

+ NeedsResolverCanonicalization bool

+ ParserCanonical string

+ ParserRewrites []string

+ PathSegments []string

+ Type string

+ func ParseUrn(input string) (ParsedURN, error)

+ type ParsedURNV2 struct

+ Fragment string

+ Root string

+ Scheme string

+ Segments []string

+ Type string

+ func ParseUrnV2(input string) (ParsedURNV2, error)

+ type Reason string

+ const ReasonAlreadyPrefixedValue

+ const ReasonEmptyBareValue

+ const ReasonEmptyDerivedSlug

+ const ReasonEmptySegment

+ const ReasonHandleHasDot

+ const ReasonInvalidCharset

+ const ReasonInvalidSegmentShape

+ const ReasonLocSegmentRejected

+ const ReasonMalformedGrammar

+ const ReasonOrgRootNotDotted

+ const ReasonOrgUrnNotBare

+ const ReasonReservedWordSlug

+ const ReasonSlugNotLowercase

+ const ReasonSlugTooLong

+ const ReasonTrailingDoubleColon

+ const ReasonUnknownType

+ type UrnRow struct

+ URN string

+ URNNormalizedAt *time.Time