a2a

type AgentCapabilities struct {
	Streaming              bool `json:"streaming,omitempty"`
	PushNotifications      bool `json:"pushNotifications,omitempty"`
	StateTransitionHistory bool `json:"stateTransitionHistory,omitempty"`
}

type AgentCard struct {
	// Name is the human-readable agent name. Required.
	Name string `json:"name"`

	// Description is the agent's one-line summary. Optional in the
	// spec, but Forge always populates it.
	Description string `json:"description,omitempty"`

	// URL is the agent's primary service endpoint (the base URL where
	// the JSON-RPC and REST handlers live). Required.
	URL string `json:"url"`

	// Version is the agent's semantic version string (e.g. "0.1.0").
	// Required by A2A 0.3.0. Forge sources this from forge.yaml's
	// version field (or the build-time agent.json's version).
	Version string `json:"version"`

	// ProtocolVersion pins the A2A protocol version this card claims
	// to conform to. Forge always emits "0.3.0".
	ProtocolVersion string `json:"protocolVersion"`

	// DefaultInputModes lists the MIME types the agent accepts on
	// message parts when a skill doesn't override them. A2A 0.3.0
	// requires at least one entry. Forge defaults to text/plain +
	// application/json.
	DefaultInputModes []string `json:"defaultInputModes"`

	// DefaultOutputModes lists the MIME types the agent emits on
	// message parts when a skill doesn't override them. Required.
	DefaultOutputModes []string `json:"defaultOutputModes"`

	// Skills lists the agent's discoverable capabilities. Each entry
	// maps to an A2A AgentSkill object.
	Skills []Skill `json:"skills,omitempty"`

	// Capabilities declares optional A2A features the agent supports.
	Capabilities *AgentCapabilities `json:"capabilities,omitempty"`

	// SecuritySchemes maps a scheme name to its definition. Mirrors the
	// OpenAPI 3.1 securitySchemes shape per A2A 0.3.0. Forge derives
	// these from the configured auth chain (static_token → httpBearer,
	// oidc → openIdConnect, etc.).
	SecuritySchemes map[string]*SecurityScheme `json:"securitySchemes,omitempty"`

	// Security is the list of accepted security requirements. Each
	// entry is a map of scheme name → required scopes (empty array for
	// schemes that don't use scopes). Per OpenAPI semantics, the
	// outer list is OR (any one entry suffices), the inner map is AND.
	Security []map[string][]string `json:"security,omitempty"`

	// Provider identifies the organization publishing the agent.
	// Optional.
	Provider *AgentProvider `json:"provider,omitempty"`

	// DocumentationURL is a link to the agent's external docs. Optional.
	DocumentationURL string `json:"documentationUrl,omitempty"`

	// IconURL is a link to an icon for UI display. Optional.
	IconURL string `json:"iconUrl,omitempty"`
}

type AgentProvider struct {
	Organization string `json:"organization,omitempty"`
	URL          string `json:"url,omitempty"`
}

type Artifact struct {
	Name        string `json:"name,omitempty"`
	Description string `json:"description,omitempty"`
	Parts       []Part `json:"parts"`
}

type CancelTaskParams struct {
	ID     string `json:"id"`
	Reason string `json:"reason,omitempty"`
}

type FileContent struct {
	Name     string `json:"name,omitempty"`
	MimeType string `json:"mimeType,omitempty"`
	URI      string `json:"uri,omitempty"`
	Bytes    []byte `json:"bytes,omitempty"`
}

type GetTaskParams struct {
	ID string `json:"id"`
}

type JSONRPCError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    any    `json:"data,omitempty"`
}

type JSONRPCRequest struct {
	JSONRPC string          `json:"jsonrpc"`
	ID      any             `json:"id,omitempty"`
	Method  string          `json:"method"`
	Params  json.RawMessage `json:"params,omitempty"`
}

type JSONRPCResponse struct {
	JSONRPC string        `json:"jsonrpc"`
	ID      any           `json:"id,omitempty"`
	Result  any           `json:"result,omitempty"`
	Error   *JSONRPCError `json:"error,omitempty"`
}

type Message struct {
	Role    MessageRole `json:"role"`
	Parts   []Part      `json:"parts"`
	Summary string      `json:"summary,omitempty"`
}

type MessageRole string

type OAuthFlow struct {
	AuthorizationURL string            `json:"authorizationUrl,omitempty"`
	TokenURL         string            `json:"tokenUrl,omitempty"`
	RefreshURL       string            `json:"refreshUrl,omitempty"`
	Scopes           map[string]string `json:"scopes,omitempty"`
}

type OAuthFlows struct {
	Implicit          *OAuthFlow `json:"implicit,omitempty"`
	Password          *OAuthFlow `json:"password,omitempty"`
	ClientCredentials *OAuthFlow `json:"clientCredentials,omitempty"`
	AuthorizationCode *OAuthFlow `json:"authorizationCode,omitempty"`
}

type Part struct {
	Kind PartKind     `json:"kind"`
	Text string       `json:"text,omitempty"`
	Data any          `json:"data,omitempty"`
	File *FileContent `json:"file,omitempty"`
}

type PartKind string

type SecurityScheme struct {
	// Type is one of: "http", "apiKey", "openIdConnect", "oauth2",
	// "mutualTLS".
	Type string `json:"type"`

	// Description is an optional human-readable explanation.
	Description string `json:"description,omitempty"`

	// http: Scheme is the HTTP auth scheme — typically "bearer" or
	// "basic". For "http" Type only.
	Scheme string `json:"scheme,omitempty"`

	// http (bearer): BearerFormat is a hint about the token format
	// (e.g. "JWT").
	BearerFormat string `json:"bearerFormat,omitempty"`

	// apiKey: In identifies where the API key is sent — "header",
	// "query", or "cookie".
	In string `json:"in,omitempty"`

	// apiKey: Name is the name of the header/query/cookie that carries
	// the key. For "apiKey" Type only.
	Name string `json:"name,omitempty"`

	// openIdConnect: OpenIDConnectURL is the OIDC discovery document
	// URL (issuer + /.well-known/openid-configuration).
	OpenIDConnectURL string `json:"openIdConnectUrl,omitempty"`

	// oauth2: Flows describes the supported OAuth 2.0 flows.
	Flows *OAuthFlows `json:"flows,omitempty"`
}

type SendTaskParams struct {
	ID      string  `json:"id"`
	Message Message `json:"message"`
}

type Skill struct {
	// ID is a slug-format identifier unique within the agent.
	ID string `json:"id"`

	// Name is the human-readable skill name.
	Name string `json:"name"`

	// Description is the skill's one-line summary.
	Description string `json:"description,omitempty"`

	// Tags is a free-form classification list (category, capability
	// labels, etc.). A2A 0.3.0 makes this required; Forge always
	// populates with at least one entry (derived from SKILL.md
	// frontmatter's `category` or `tags` list).
	Tags []string `json:"tags"`

	// Examples is an optional list of example prompts that exercise
	// this skill. Used by A2A clients to surface the skill in a UI.
	Examples []string `json:"examples,omitempty"`

	// InputModes overrides AgentCard.DefaultInputModes for this skill
	// only. Optional.
	InputModes []string `json:"inputModes,omitempty"`

	// OutputModes overrides AgentCard.DefaultOutputModes for this skill
	// only. Optional.
	OutputModes []string `json:"outputModes,omitempty"`
}

type Task struct {
	ID        string         `json:"id"`
	Status    TaskStatus     `json:"status"`
	History   []Message      `json:"history,omitempty"`
	Artifacts []Artifact     `json:"artifacts,omitempty"`
	Metadata  map[string]any `json:"metadata,omitempty"`
}

type TaskState string

type TaskStatus struct {
	State   TaskState `json:"state"`
	Message *Message  `json:"message,omitempty"`
}

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