adl

type CompiledSpec struct {
	V             int            `json:"v"`
	Metadata      SpecMetadata   `json:"metadata"`
	Model         Model          `json:"model"`
	Persona       *Persona       `json:"persona,omitempty"`
	Task          string         `json:"task"`
	Tools         []ResolvedRef  `json:"tools"`
	Extensions    []ResolvedRef  `json:"extensions"`
	Skills        []ResolvedRef  `json:"skills"`
	Subagents     []ResolvedRef  `json:"subagents,omitempty"`
	MCPServers    []MCPServer    `json:"mcpServers,omitempty"`
	Installs      []string       `json:"installs,omitempty"`
	Runtime       RuntimeConfig  `json:"runtime"`
	Guardrails    *Guardrails    `json:"guardrails,omitempty"`
	Observability *Observability `json:"observability,omitempty"`
	// OutputSchema (slice 7.2 of v0.7) is an optional JSON Schema the agent's
	// final assistant message must conform to. When set AND `--output-file
	// <path>` is passed, the CLI extracts JSON from the last assistant message
	// (stripping a single “`json fenced block if present), validates against
	// this schema, and writes the validated JSON to <path>. Without
	// `--output-file` the field has no runtime effect; we gate validation on a
	// consumer being present. The compiler passes the schema through verbatim
	// — we don't constrain its meta-schema.
	//
	// Pointer-to-map (not bare map) is intentional: the empty schema
	// `outputSchema: {}` is meaningful (it requires JSON-syntax output with no
	// further constraints). A `map[string]any` field with `omitempty` would
	// drop a zero-length map at JSON marshal time and the compiled-spec stream
	// (agentctl compile, K8s in-Pod handoff) would lose the distinction
	// between "no schema" and "JSON-only schema." Pointer omitempty only drops
	// nil pointers, so empty-map values survive. Codex pass 3 of slice 7.2.
	OutputSchema *map[string]any `json:"outputSchema,omitempty"`
	// SessionID is set by the CLI when the user passes --resume <id>.
	// When present, the runtime opens/continues the named persistent session
	// instead of creating a throw-away in-memory session.
	SessionID *string `json:"sessionId,omitempty"`
}

type Guardrails struct {
	// HallucinationDetector controls how the runtime reacts to fabricated
	// tool-call XML in assistant message text. Valid values are "warn",
	// "block" (default at runtime), and "correct". See the schema description
	// of spec.guardrails.hallucinationDetector for behavior details.
	HallucinationDetector string `json:"hallucinationDetector,omitempty"`
}

type KubernetesSecretRef struct {
	Name string   `json:"name" yaml:"name"`
	Keys []string `json:"keys,omitempty" yaml:"keys,omitempty"`
}

type KubernetesTarget struct {
	// Namespace in which the agent Pod + its ConfigMap are created.
	// Default applied at runtime: "default".
	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
	// Image to launch. Default applied at runtime:
	// "ghcr.io/ccdevelopforfun/agent-runtime-base:0.1.1".
	Image string `json:"image,omitempty" yaml:"image,omitempty"`
	// SecretRef points at a Kubernetes Secret in the same namespace that
	// holds adapter credentials. Required when the spec needs API keys
	// (Anthropic etc.); each declared Keys entry is mapped to an env var
	// of the same name on the Pod.
	SecretRef *KubernetesSecretRef `json:"secretRef,omitempty" yaml:"secretRef,omitempty"`
}

type MCPServer struct {
	Name      string `json:"name"`
	Transport string `json:"transport"`
	Lifecycle string `json:"lifecycle,omitempty"`
	// stdio fields
	Command string            `json:"command,omitempty"`
	Args    []string          `json:"args,omitempty"`
	Env     map[string]string `json:"env,omitempty"`
	// http/sse fields
	URL     string            `json:"url,omitempty"`
	Headers map[string]string `json:"headers,omitempty"`
}

type Model struct {
	Provider    string   `json:"provider"`
	Name        string   `json:"name"`
	Temperature *float64 `json:"temperature,omitempty"`
}

type Observability struct {
	Tracing        bool `json:"tracing,omitempty"`
	CaptureContent bool `json:"captureContent,omitempty"`
}

type Persona struct {
	Role         string `json:"role,omitempty"`
	Instructions string `json:"instructions,omitempty"`
}

type ResolvedRef struct {
	Name string `json:"name"`
	// Entrypoint is the absolute path to a Pi extension module that
	// implements this ref. Empty for Pi-builtin tools (Builtin=true) and
	// for source-bound extensions (Source set; resolved at runtime).
	Entrypoint string `json:"entrypoint,omitempty"`
	// Source declares an npm/etc package; the runtime installs and
	// resolves it (see spec.extensions[].source in adl.v1alpha1).
	Source string `json:"source,omitempty"`
	// Builtin marks a Pi-shipped tool (bash, read, edit, write). The
	// runtime adds the name to Pi's tool allowlist without loading any
	// entrypoint. See compiler.go for the list.
	Builtin bool           `json:"builtin,omitempty"`
	Config  map[string]any `json:"config,omitempty"`
}

type ResolvedRunSpec struct {
	// Spec is the CompiledSpec the resolver received. Backends ship this
	// to the runtime adapter over stdin unchanged.
	Spec CompiledSpec `json:"spec"`
	// Binding is the RuntimeBinding the resolver matched, or nil when
	// the caller did not supply a Binding (the v0.2.x default flow).
	// Backends consult target.runtimeCommand and other target fields
	// from this binding when spawning the runtime adapter.
	Binding *RuntimeBinding `json:"binding,omitempty"`
}

type RuntimeBinding struct {
	APIVersion string             `json:"apiVersion" yaml:"apiVersion"`
	Kind       string             `json:"kind" yaml:"kind"`
	Metadata   RuntimeBindingMeta `json:"metadata" yaml:"metadata"`
	Spec       RuntimeBindingSpec `json:"spec" yaml:"spec"`
}

type RuntimeBindingMeta struct {
	Name        string `json:"name" yaml:"name"`
	Description string `json:"description,omitempty" yaml:"description,omitempty"`
}

type RuntimeBindingSelector struct {
	// RuntimeType must equal the Agent's spec.runtime.type. Allowed values
	// match the schema enum: local | local-pi | local-opencode.
	RuntimeType string `json:"runtimeType" yaml:"runtimeType"`
	// Capabilities this Binding's target provides. The matcher (slice 3.3)
	// will require every `true` requirement in the Agent's
	// spec.runtime.requirements to also be `true` here. Missing keys mean
	// the Binding does not advertise that capability.
	Capabilities map[string]bool `json:"capabilities,omitempty" yaml:"capabilities,omitempty"`
}

type RuntimeBindingSpec struct {
	Selector RuntimeBindingSelector `json:"selector" yaml:"selector"`
	Target   RuntimeBindingTarget   `json:"target" yaml:"target"`
}

type RuntimeBindingTarget struct {
	// Type is the backend implementation. v0.4: "local" | "kubernetes".
	Type string `json:"type" yaml:"type"`
	// RuntimeCommand overrides the runtime-adapter binary path for the
	// local backend only. Equivalent to setting AGENT_CONTROLLER_RUNTIME
	// at run time. Ignored when Type is "kubernetes".
	RuntimeCommand string `json:"runtimeCommand,omitempty" yaml:"runtimeCommand,omitempty"`
	// Strict (added v0.3.3b): when true, the capability matcher promotes
	// unmet spec.runtime.requirements from warn-but-proceed to a hard error.
	// agentctl run exits non-zero before any session.started event is
	// emitted. Default (false) preserves the warn-but-proceed policy
	// recorded in ROADMAP.md "Recorded design decisions".
	Strict bool `json:"strict,omitempty" yaml:"strict,omitempty"`
	// Kubernetes carries target-specific config when Type is "kubernetes".
	// Ignored otherwise. Slice 4.3 ships the v0.1 of this surface;
	// kubeconfig path / context / serviceAccount land in slice 4.4.
	Kubernetes *KubernetesTarget `json:"kubernetes,omitempty" yaml:"kubernetes,omitempty"`
}

type RuntimeConfig struct {
	Type string `json:"type"`
	// Requirements is a free-form capability map (added in v0.3.1).
	// Boolean flags advertising what the runtime must provide. Consumed in
	// two steps: v0.3.2 adds the RuntimeBinding schema (the resource that
	// advertises which capabilities a target provides), and v0.3.3 wires
	// the Backend.Resolve() matcher that compares them. Today (v0.3.1)
	// it's advisory metadata and passes through CompiledSpec unchanged.
	// v0.3.1 does NOT distinguish "absent" from "explicit empty map {}"
	// — both compile to a nil map here and are dropped from the JSON
	// envelope by `omitempty`. If a future slice needs to distinguish
	// (e.g. to mean "this spec verified it needs nothing"), promote the
	// field to *map[string]bool then.
	Requirements map[string]bool `json:"requirements,omitempty"`
}

type SpecMetadata struct {
	Name        string `json:"name"`
	Owner       string `json:"owner,omitempty"`
	Description string `json:"description,omitempty"`
}

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