api

type AccessCheckRequest struct {
	Tags       map[string]string `json:"tags"`
	Backend    string            `json:"backend,omitempty"`
	Tools      []string          `json:"tools,omitempty"`
	DataLabels []string          `json:"data_labels,omitempty"`
	SkillID    string            `json:"skill_id,omitempty"`
}

type AccessCheckResponse struct {
	Allowed bool   `json:"allowed"`
	Reason  string `json:"reason,omitempty"`
}

type AddPolicyRequest struct {
	Name      string   `json:"name"`
	Subjects  []string `json:"subjects"`
	Resources []string `json:"resources"`
	Action    string   `json:"action"`
}

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

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

type CostModelRequest struct {
	InputCostPerMToken  float64 `json:"input_cost_per_mtoken"`
	OutputCostPerMToken float64 `json:"output_cost_per_mtoken"`
}

type ExecuteRequest struct {
	Backend  string          `json:"backend"`
	StageID  string          `json:"stage_id,omitempty"`
	Prompt   string          `json:"prompt,omitempty"`
	Messages []model.Message `json:"messages,omitempty"`
	Tools    []*mcp.Tool     `json:"tools,omitempty"`
	model.InferenceOptions

	WorkflowID  string            `json:"workflow_id,omitempty"`
	CachePolicy string            `json:"cache_policy,omitempty"`
	Tags        map[string]string `json:"tags,omitempty"`
	DataLabels  []string          `json:"data_labels,omitempty"`
	SkillID     string            `json:"skill_id,omitempty"`
}

type ExecuteResponse struct {
	Success  bool            `json:"success"`
	Response *model.Response `json:"response,omitempty"`
	Error    string          `json:"error,omitempty"`
}

type ListBackendsResponse struct {
	Backends []string `json:"backends"`
}

type ListPoliciesResponse struct {
	Policies []*access.Policy `json:"policies"`
}

type ListSkillsResponse struct {
	Skills []*core.SkillManifest `json:"skills"`
}

type RegisterBackendRequest struct {
	Name           string            `json:"name"`                      // backend name (used as "backend" in execute requests)
	Endpoint       string            `json:"endpoint"`                  // e.g. "http://vllm:8000/v1", "http://localhost:11434"
	Type           string            `json:"type"`                      // "openai" or "sglang"
	ModelID        string            `json:"model_id"`                  // full model identifier e.g. "openai:Qwen/Qwen3-4B-Instruct-2507", "openai:llama3"
	APIKeyEnvVar   string            `json:"api_key_env_var,omitempty"` // optional env var name for API key (for openai-type backends)
	MaxConcurrency *int              `json:"max_concurrency,omitempty"` // max concurrent requests (nil = default 1)
	QueueCapacity  *int              `json:"queue_capacity,omitempty"`  // max queued requests (nil = default 4096)
	CostModel      *CostModelRequest `json:"cost_model,omitempty"`      // optional token pricing
	Quality        *float64          `json:"quality,omitempty"`         // relative capability score in [0.0, 1.0]
}

type RegisterBackendResponse struct {
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type RegisterSkillRequest struct {
	Name             string   `json:"name"`
	RequiresBackends []string `json:"requires_backends"`
	RequiresTools    []string `json:"requires_tools,omitempty"`
	RequiresLabels   []string `json:"requires_labels,omitempty"`
}

type RegisterWorkflowRequest struct {
	WorkflowID        string                          `json:"workflow_id"`
	Edges             []WorkflowEdgeEntry             `json:"edges"`
	Declassifications []WorkflowDeclassificationEntry `json:"declassifications,omitempty"`
}

type ServerOptions struct {
	// RateLimitRPS limits requests per second for execute and backends. 0 = disabled.
	RateLimitRPS int
}

type WorkflowCompleteRequest struct {
	WorkflowID string   `json:"workflow_id"`
	Backends   []string `json:"backends"`
}

type WorkflowCompleteResponse struct {
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type WorkflowDeclassificationEntry struct {
	StageID string   `json:"stage_id"`
	Labels  []string `json:"labels"`
}

type WorkflowEdgeEntry struct {
	From string `json:"from"`
	To   string `json:"to"`
}