manifest

type App struct {
	// ID is the app's manifest-local identifier; tools[].ui references it.
	// Required and unique within the manifest.
	ID string `yaml:"id"`
	// URI is the ui:// resource URI the App is served under. Required, and must
	// be a well-formed ui:// URI (RFC §7.1).
	URI string `yaml:"uri"`
	// Entry is the path to the App's UI entrypoint, relative to the project
	// root (e.g. web/src/apps/customer-health.svelte). Required.
	Entry string `yaml:"entry"`
	// DisplayModes is the subset of inline|fullscreen|pip the App supports
	// (RFC §7.2). At least one is required.
	DisplayModes []DisplayMode `yaml:"display_modes"`
	// CSP is the App's Content-Security-Policy opt-outs. An empty CSP is the
	// secure default — a single-file bundle with no external origins (RFC §7.4).
	CSP CSP `yaml:"csp"`
	// Visibility is the surfaces the App is exposed to (RFC §7.1 _meta.ui).
	Visibility []Visibility `yaml:"visibility"`
}

type BundleStrategy string

type CSP struct {
	// Connect is the set of origins the App may open network connections to
	// (CSP connect-src).
	Connect []string `yaml:"connect"`
	// Resource is the set of origins the App may load passive resources from
	// (images, fonts, styles).
	Resource []string `yaml:"resource"`
}

type ContractReference struct {
	// Package is the import path of the package the type lives in.
	Package string
	// TypeName is the exported type identifier within that package.
	TypeName string
}

type ContractResolver interface {
	// Resolve returns the JSON Schema for the named contract reference. It
	// returns an error wrapping ErrContractUnresolved when the reference names
	// no known type.
	Resolve(ref string) (*jsonschema.Schema, error)
}

type DiscoveredApp struct {
	// ID is the manifest-local identifier — the apps[].id a tools[].ui targets.
	ID string
	// URI is the ui:// resource URI the App is served under.
	URI string
	// Entry is the .svelte source path relative to the project root.
	Entry string
	// DisplayModes is the subset of inline|fullscreen|pip the App supports.
	// When empty, WriteDiscoveredApps defaults a new entry to [inline] — the
	// minimal valid set (a manifest apps[] entry requires at least one mode,
	// RFC §7.2); a developer widens it by editing dockyard.app.yaml.
	DisplayModes []DisplayMode
}

type DisplayMode string

type Error struct {
	// Source is the manifest file path (or another identifier passed to Load).
	Source string
	// Line is the 1-based YAML line; 0 when no position is available, in which
	// case the rendered message degrades to "file" rather than "file:line".
	Line int
	// Field is the dotted manifest path of the fault, e.g. "tools[0].input".
	Field string
	// Msg is the human-facing description.
	Msg string
}

type ErrorList []*Error

type Manifest struct {
	// Name is the app's wire identifier — a short, kebab-or-snake-case token.
	Name string `yaml:"name"`
	// Title is the human-facing display name.
	Title string `yaml:"title"`
	// Version is the app's semantic version (MAJOR.MINOR.PATCH).
	Version string `yaml:"version"`
	// Runtime declares which deployment modes and UI framework the app supports.
	Runtime Runtime `yaml:"runtime"`
	// Tools is the app's MCP tools. At least one is required.
	Tools []Tool `yaml:"tools"`
	// Apps is the app's ui:// resources. Optional — a plain MCP server has none
	// (RFC §4.1: a UI resource is additive, not a requirement).
	Apps []App `yaml:"apps"`
	// Tasks holds the app's MCP Tasks lifecycle limits (RFC §8.5). Optional —
	// an app with no task-supporting tool omits it and the zero value disables
	// every limit.
	Tasks Tasks `yaml:"tasks"`
	// Quality holds the quality.* gates dockyard validate enforces (RFC §9.4).
	Quality Quality `yaml:"quality"`
}

type Quality struct {
	RequireLoadingState    bool `yaml:"require_loading_state"`
	RequireEmptyState      bool `yaml:"require_empty_state"`
	RequireErrorState      bool `yaml:"require_error_state"`
	RequirePermissionState bool `yaml:"require_permission_state"`
	RequireFixtures        bool `yaml:"require_fixtures"`
	RequireContractTests   bool `yaml:"require_contract_tests"`
	RequireSpecCompliance  bool `yaml:"require_spec_compliance"`
}

type RegistryResolver struct {
	// contains filtered or unexported fields
}

type Runtime struct {
	// Transports is the set of deployment modes the app supports. V1: stdio,
	// http (RFC §5.2). At least one is required.
	Transports []Transport `yaml:"transports"`
	// UI configures the App UI build. Optional — a plain MCP server omits it.
	UI *RuntimeUI `yaml:"ui"`
}

type RuntimeUI struct {
	// Framework is the UI framework. V1: svelte only.
	Framework UIFramework `yaml:"framework"`
	// Bundle is the bundle strategy. single-file is the default and yields a
	// zero-external-origin App so the deny-by-default CSP just works (RFC §7.4).
	Bundle BundleStrategy `yaml:"bundle"`
}

type TaskSupport string

type Tasks struct {
	// MaxTTLMillis is the largest task retention duration the runtime honours,
	// in milliseconds. A requestor asking for more is clamped down. Zero means
	// unlimited retention (no clamp).
	MaxTTLMillis int64 `yaml:"max_ttl_millis"`
	// DefaultTTLMillis is the retention applied to a task whose requestor
	// expressed no TTL preference, in milliseconds. Zero means unlimited.
	DefaultTTLMillis int64 `yaml:"default_ttl_millis"`
	// PurgeIntervalMillis is how often the background TTL purge sweep runs, in
	// milliseconds. Zero disables the sweep.
	PurgeIntervalMillis int64 `yaml:"purge_interval_millis"`
	// MaxConcurrentPerRequestor caps the number of non-terminal tasks one
	// authorization context may hold at once. Zero means no cap.
	MaxConcurrentPerRequestor int `yaml:"max_concurrent_per_requestor"`
}

type Tool struct {
	// Name is the tool's MCP wire name. Required and unique within the manifest.
	Name string `yaml:"name"`
	// Description is the model-facing hint.
	Description string `yaml:"description"`
	// Input is the Go type reference for the tool input contract — a
	// "pkg/path.TypeName" string the codegen pipeline resolves. Required.
	Input string `yaml:"input"`
	// Output is the Go type reference for the tool output contract. Required.
	Output string `yaml:"output"`
	// UI links the tool to an apps[] entry by its id (RFC §4.2). Optional — a
	// tool without a UI is a plain MCP tool.
	UI string `yaml:"ui"`
	// TaskSupport declares the tool's relationship to the Tasks extension
	// (RFC §8.4). Defaults to forbidden when omitted.
	TaskSupport TaskSupport `yaml:"task_support"`
}

type ToolContracts struct {
	// Input is the resolved schema for the tool's input contract.
	Input *jsonschema.Schema
	// Output is the resolved schema for the tool's output contract.
	Output *jsonschema.Schema
}

type Transport string

type UIFramework string

type Visibility string