models

type AsyncRunResponse struct {

	// job id
	// Example: job-abc123def456
	JobID string `json:"job_id,omitempty"`
}

type ClaudeStatusResponse struct {

	// configured
	// Example: true
	Configured bool `json:"configured,omitempty"`

	// message
	// Example: Claude is configured
	Message string `json:"message,omitempty"`
}

type ComponentHealth struct {

	// Error message if status is "error"
	Error string `json:"error,omitempty"`

	// Name of the component
	// Example: podman
	Name string `json:"name,omitempty"`

	// Status is "ok" or "error"
	// Example: ok
	Status string `json:"status,omitempty"`
}

type CrashInfo struct {

	// Exit code (if available)
	ExitCode int64 `json:"exit_code,omitempty"`

	// Partial output captured before crash
	PartialOutput string `json:"partial_output,omitempty"`

	// Human-readable crash reason
	Reason string `json:"reason,omitempty"`

	// Signal that killed the process (SIGSEGV, SIGKILL, etc.)
	Signal string `json:"signal,omitempty"`

	// Whether the task appeared to complete before crashing
	TaskCompleted bool `json:"task_completed,omitempty"`
}

type CreateSecretRequest struct {

	// name
	// Example: github-token
	// Required: true
	Name *string `json:"name"`

	// value
	// Example: ghp_xxxxxxxxxxxx
	// Required: true
	Value *string `json:"value"`
}

type CreateSecretResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// name
	// Example: github-token
	Name string `json:"name,omitempty"`

	// success
	// Example: true
	Success bool `json:"success,omitempty"`
}

type DeleteSecretResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// name
	// Example: github-token
	Name string `json:"name,omitempty"`

	// success
	// Example: true
	Success bool `json:"success,omitempty"`
}

type ErrorResponse struct {

	// error
	Error string `json:"error,omitempty"`
}

type HealthResponse struct {

	// components
	Components []*ComponentHealth `json:"components,omitempty"`

	// name
	// Example: stromboli
	Name string `json:"name,omitempty"`

	// status
	// Example: ok
	Status string `json:"status,omitempty"`

	// version
	// Example: 0.1.4
	Version string `json:"version,omitempty"`
}

type ImageDetailResponse struct {

	// compatibility rank
	// Example: 3
	CompatibilityRank int64 `json:"compatibility_rank,omitempty"`

	// compatible
	// Example: true
	Compatible bool `json:"compatible,omitempty"`

	// created
	// Example: 2024-01-15T10:30:00Z
	Created string `json:"created,omitempty"`

	// description
	// Example: Python development image
	Description string `json:"description,omitempty"`

	// has claude cli
	// Example: false
	HasClaudeCli bool `json:"has_claude_cli,omitempty"`

	// id
	// Example: sha256:abc123def456
	ID string `json:"id,omitempty"`

	// labels
	Labels map[string]string `json:"labels,omitempty"`

	// rank description
	// Example: Standard glibc-based (compatible)
	RankDescription string `json:"rank_description,omitempty"`

	// repository
	// Example: python
	Repository string `json:"repository,omitempty"`

	// size
	// Example: 125000000
	Size int64 `json:"size,omitempty"`

	// tag
	// Example: 3.12-slim
	Tag string `json:"tag,omitempty"`

	// tools
	// Example: ["python","pip"]
	Tools []string `json:"tools,omitempty"`
}

type ImageInfoResponse struct {

	// compatibility rank
	// Example: 3
	CompatibilityRank int64 `json:"compatibility_rank,omitempty"`

	// compatible
	// Example: true
	Compatible bool `json:"compatible,omitempty"`

	// created
	// Example: 2024-01-15T10:30:00Z
	Created string `json:"created,omitempty"`

	// description
	// Example: Python development image
	Description string `json:"description,omitempty"`

	// has claude cli
	// Example: false
	HasClaudeCli bool `json:"has_claude_cli,omitempty"`

	// id
	// Example: sha256:abc123def456
	ID string `json:"id,omitempty"`

	// repository
	// Example: python
	Repository string `json:"repository,omitempty"`

	// size
	// Example: 125000000
	Size int64 `json:"size,omitempty"`

	// tag
	// Example: 3.12-slim
	Tag string `json:"tag,omitempty"`

	// tools
	// Example: ["python","pip"]
	Tools []string `json:"tools,omitempty"`
}

type ImagePullRequest struct {

	// image
	// Example: python:3.12-slim
	// Required: true
	Image *string `json:"image"`

	// platform
	// Example: linux/amd64
	Platform string `json:"platform,omitempty"`

	// quiet
	// Example: true
	Quiet bool `json:"quiet,omitempty"`
}

type ImagePullResponse struct {

	// image
	// Example: python:3.12-slim
	Image string `json:"image,omitempty"`

	// image id
	// Example: sha256:abc123def456
	ImageID string `json:"image_id,omitempty"`

	// success
	// Example: true
	Success bool `json:"success,omitempty"`
}

type ImageSearchResponse struct {

	// results
	Results []*SearchResultResponse `json:"results,omitempty"`
}

type ImagesListResponse struct {

	// images
	Images []*ImageInfoResponse `json:"images,omitempty"`
}

type JobListResponse struct {

	// jobs
	Jobs []*JobResponse `json:"jobs,omitempty"`
}

type JobResponse struct {

	// crash info
	CrashInfo *CrashInfo `json:"crash_info,omitempty"`

	// created at
	// Example: 2024-01-15T10:30:00Z
	CreatedAt string `json:"created_at,omitempty"`

	// error
	Error string `json:"error,omitempty"`

	// id
	// Example: job-abc123def456
	ID string `json:"id,omitempty"`

	// output
	// Example: Hello!
	Output string `json:"output,omitempty"`

	// session id
	// Example: sess-abc123def456
	SessionID string `json:"session_id,omitempty"`

	// status
	// Example: running
	Status Status `json:"status,omitempty"`

	// updated at
	// Example: 2024-01-15T10:31:00Z
	UpdatedAt string `json:"updated_at,omitempty"`
}

type LogoutResponse struct {

	// message
	Message string `json:"message,omitempty"`

	// success
	Success bool `json:"success,omitempty"`
}

type RefreshRequest struct {

	// refresh token
	// Required: true
	RefreshToken *string `json:"refresh_token"`
}

type RunRequest struct {

	// Claude configuration - all CLI options exposed
	Claude StromboliInternalTypesClaudeOptions `json:"claude,omitempty"`

	// Podman configuration
	Podman StromboliInternalTypesPodmanOptions `json:"podman,omitempty"`

	// Required: the prompt to send to Claude
	// Example: Analyze this code and suggest improvements
	// Required: true
	Prompt *string `json:"prompt"`

	// Webhook URL to notify when job completes (async only)
	// Example: https://example.com/webhook
	WebhookURL string `json:"webhook_url,omitempty"`

	// Working directory inside the container where Claude will spawn
	// Use podman.volumes to mount host paths into the container
	// Example: /workspace
	Workdir string `json:"workdir,omitempty"`
}

type RunResponse struct {

	// Error message (when failed)
	Error string `json:"error,omitempty"`

	// Unique run identifier
	// Example: run-abc123def456
	ID string `json:"id,omitempty"`

	// Claude's output (when successful)
	// Example: Here is my analysis...
	Output string `json:"output,omitempty"`

	// Session ID for conversation continuation
	// Example: sess-abc123def456
	SessionID string `json:"session_id,omitempty"`

	// Execution status: completed, error
	// Example: completed
	Status string `json:"status,omitempty"`
}

type SearchResultResponse struct {

	// automated
	// Example: false
	Automated bool `json:"automated,omitempty"`

	// description
	// Example: Python is an interpreted programming language
	Description string `json:"description,omitempty"`

	// index
	// Example: docker.io
	Index string `json:"index,omitempty"`

	// name
	// Example: python
	Name string `json:"name,omitempty"`

	// official
	// Example: true
	Official bool `json:"official,omitempty"`

	// stars
	// Example: 8500
	Stars int64 `json:"stars,omitempty"`
}

type SecretInfoResponse struct {

	// created at
	// Example: 2024-01-15T10:30:00Z
	CreatedAt string `json:"created_at,omitempty"`

	// id
	// Example: abc123def456
	ID string `json:"id,omitempty"`

	// name
	// Example: github-token
	Name string `json:"name,omitempty"`
}

type SecretsListResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// secrets
	Secrets []*SecretInfoResponse `json:"secrets,omitempty"`
}

type SessionDestroyResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// session id
	// Example: sess-abc123
	SessionID string `json:"session_id,omitempty"`

	// success
	// Example: true
	Success bool `json:"success,omitempty"`
}

type SessionListResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// sessions
	// Example: ["sess-abc123","sess-def456"]
	Sessions []string `json:"sessions,omitempty"`
}

type SessionMessageResponse struct {

	// error
	Error string `json:"error,omitempty"`

	// message
	Message *StromboliInternalHistoryMessage `json:"message,omitempty"`
}

type SessionMessagesResponse struct {

	// has more
	HasMore bool `json:"has_more,omitempty"`

	// limit
	Limit int64 `json:"limit,omitempty"`

	// messages
	Messages []*StromboliInternalHistoryMessage `json:"messages,omitempty"`

	// offset
	Offset int64 `json:"offset,omitempty"`

	// total
	Total int64 `json:"total,omitempty"`
}

type Status string

type StromboliInternalHistoryContentBlock struct {

	// Tool result content (for tool_result)
	// Example: file1.txt\nfile2.txt
	Content string `json:"content,omitempty"`

	// Tool use ID (for tool_use and tool_result)
	// Example: toolu_01G5uAJ4YZ26yyJbXNnG2byM
	ID string `json:"id,omitempty"`

	// Tool input (for tool_use)
	Input map[string]interface{} `json:"input,omitempty"`

	// Whether tool execution errored
	// Example: false
	IsError bool `json:"is_error,omitempty"`

	// Tool name (for tool_use)
	// Example: Bash
	Name string `json:"name,omitempty"`

	// Text content (for text blocks)
	// Example: I'll help you with that.
	Text string `json:"text,omitempty"`

	// Tool use ID reference (for tool_result)
	// Example: toolu_01G5uAJ4YZ26yyJbXNnG2byM
	ToolUseID string `json:"tool_use_id,omitempty"`

	// Block type: text, tool_use, tool_result
	// Example: tool_use
	Type string `json:"type,omitempty"`
}

type StromboliInternalHistoryMessage struct {

	// The actual message content
	Content StromboliInternalHistoryMessageContent `json:"content,omitempty"`

	// Working directory at time of message
	// Example: /workspace
	Cwd string `json:"cwd,omitempty"`

	// Git branch at time of message
	// Example: main
	GitBranch string `json:"git_branch,omitempty"`

	// Parent message UUID for threading
	// Example: 92242819-b7d1-48d4-b023-6134c3e9f63a
	ParentUUID string `json:"parent_uuid,omitempty"`

	// Permission mode active for this message
	// Example: bypassPermissions
	PermissionMode string `json:"permission_mode,omitempty"`

	// Session ID this message belongs to
	// Example: c7518652-f0ea-436e-9143-327085022abd
	SessionID string `json:"session_id,omitempty"`

	// Timestamp when the message was created
	// Example: 2026-01-24T10:06:42.906Z
	Timestamp string `json:"timestamp,omitempty"`

	// Tool use result (for tool_result messages)
	ToolResult StromboliInternalHistoryToolResult `json:"tool_result,omitempty"`

	// Message type: user, assistant, queue-operation
	// Example: assistant
	Type StromboliInternalHistoryMessageType `json:"type,omitempty"`

	// Unique identifier for this message
	// Example: 40adde19-546a-43e8-ad25-31ef4faa4112
	UUID string `json:"uuid,omitempty"`

	// Claude Code version
	// Example: 2.1.19
	Version string `json:"version,omitempty"`
}

type StromboliInternalHistoryMessageContent struct {

	// Content blocks (text, tool_use, tool_result)
	Content []*StromboliInternalHistoryContentBlock `json:"content,omitempty"`

	// Message ID from API
	// Example: msg_017ETE4Wk32ZXAQJp3GXP1Bo
	MessageID string `json:"message_id,omitempty"`

	// Model used (for assistant messages)
	// Example: claude-opus-4-5-20251101
	Model string `json:"model,omitempty"`

	// Role: user or assistant
	// Example: assistant
	Role string `json:"role,omitempty"`

	// Stop reason (for assistant messages)
	// Example: end_turn
	StopReason string `json:"stop_reason,omitempty"`

	// Token usage
	Usage StromboliInternalHistoryUsage `json:"usage,omitempty"`
}

type StromboliInternalHistoryMessageType string

type StromboliInternalHistoryToolResult struct {

	// Whether execution was interrupted
	// Example: false
	Interrupted bool `json:"interrupted,omitempty"`

	// Whether result is an image
	// Example: false
	IsImage bool `json:"is_image,omitempty"`

	// Standard error
	Stderr string `json:"stderr,omitempty"`

	// Standard output
	// Example: file1.txt\nfile2.txt
	Stdout string `json:"stdout,omitempty"`
}

type StromboliInternalHistoryUsage struct {

	// cache creation input tokens
	// Example: 336
	CacheCreationInputTokens int64 `json:"cache_creation_input_tokens,omitempty"`

	// cache read input tokens
	// Example: 18121
	CacheReadInputTokens int64 `json:"cache_read_input_tokens,omitempty"`

	// input tokens
	// Example: 150
	InputTokens int64 `json:"input_tokens,omitempty"`

	// output tokens
	// Example: 42
	OutputTokens int64 `json:"output_tokens,omitempty"`
}

type StromboliInternalTypesClaudeOptions struct {

	// Additional directories for tool access
	AddDirs []string `json:"add_dirs,omitempty"`

	// Agent for current session
	// Example: reviewer
	Agent string `json:"agent,omitempty"`

	// Custom agents definition (JSON object)
	Agents map[string]interface{} `json:"agents,omitempty"`

	// Enable bypass as an option without enabling by default
	// Example: false
	AllowDangerouslySkipPermissions bool `json:"allow_dangerously_skip_permissions,omitempty"`

	// Allowed tools with patterns (e.g., "Bash(git:*)")
	// Example: ["Bash(git:*)","Read"]
	AllowedTools []string `json:"allowed_tools,omitempty"`

	// Append to default system prompt
	// Example: Focus on security best practices
	AppendSystemPrompt string `json:"append_system_prompt,omitempty"`

	// Beta headers for API requests
	Betas []string `json:"betas,omitempty"`

	// Continue most recent conversation in workspace (ignores session_id)
	// Example: false
	Continue bool `json:"continue,omitempty"`

	// Bypass all permission checks (use in sandboxed environments only)
	// Example: true
	DangerouslySkipPermissions bool `json:"dangerously_skip_permissions,omitempty"`

	// Debug mode with optional category filter
	// Example: api,hooks
	Debug string `json:"debug,omitempty"`

	// Disable all slash commands/skills
	// Example: false
	DisableSlashCommands bool `json:"disable_slash_commands,omitempty"`

	// Denied tools
	// Example: ["Write"]
	DisallowedTools []string `json:"disallowed_tools,omitempty"`

	// Fallback model when default is overloaded
	// Example: haiku
	FallbackModel string `json:"fallback_model,omitempty"`

	// File resources (format: file_id:path)
	Files []string `json:"files,omitempty"`

	// Create new session ID when resuming
	// Example: false
	ForkSession bool `json:"fork_session,omitempty"`

	// Include partial message chunks (stream-json only)
	// Example: false
	IncludePartialMessages bool `json:"include_partial_messages,omitempty"`

	// Input format: text, stream-json
	// Example: text
	InputFormat string `json:"input_format,omitempty"`

	// JSON Schema for structured output validation
	// Example: {\"type\":\"object\"}
	JSONSchema string `json:"json_schema,omitempty"`

	// Maximum dollar amount for API calls
	// Example: 5
	MaxBudgetUsd float64 `json:"max_budget_usd,omitempty"`

	// MCP server config files or JSON strings
	McpConfigs []string `json:"mcp_configs,omitempty"`

	// Model alias (sonnet, opus, haiku) or full name
	// Example: sonnet
	Model string `json:"model,omitempty"`

	// Don't save session to disk
	// Example: false
	NoPersistence bool `json:"no_persistence,omitempty"`

	// Output format: text, json, stream-json
	// Example: json
	OutputFormat string `json:"output_format,omitempty"`

	// Permission mode: acceptEdits, bypassPermissions, default, delegate, dontAsk, plan
	// Example: bypassPermissions
	PermissionMode string `json:"permission_mode,omitempty"`

	// Plugin directories
	PluginDirs []string `json:"plugin_dirs,omitempty"`

	// Re-emit user messages on stdout
	// Example: false
	ReplayUserMessages bool `json:"replay_user_messages,omitempty"`

	// Resume an existing session (requires session_id)
	// Example: true
	Resume bool `json:"resume,omitempty"`

	// Session ID (UUID) - used for both new and resumed sessions
	// Example: 550e8400-e29b-41d4-a716-446655440000
	SessionID string `json:"session_id,omitempty"`

	// Setting sources to load: user, project, local
	// Example: ["user","project"]
	SettingSources []string `json:"setting_sources,omitempty"`

	// Path to settings JSON file or JSON string
	Settings string `json:"settings,omitempty"`

	// Only use MCP servers from mcp_configs
	// Example: false
	StrictMcpConfig bool `json:"strict_mcp_config,omitempty"`

	// Replace default system prompt
	// Example: You are a senior Go developer
	SystemPrompt string `json:"system_prompt,omitempty"`

	// Built-in tools ("", "default", or specific names)
	// Example: ["Bash","Read","Edit"]
	Tools []string `json:"tools,omitempty"`

	// Enable verbose mode
	// Example: false
	Verbose bool `json:"verbose,omitempty"`
}

type StromboliInternalTypesEnvironmentConfig struct {

	// Optional build timeout override for compose (e.g., "15m")
	// If not specified, uses server default (10m)
	// Example: 15m
	BuildTimeout string `json:"build_timeout,omitempty"`

	// Path to compose file (required when type="compose")
	// Must be an absolute path ending in .yml or .yaml
	// Example: /home/user/project/docker-compose.yml
	Path string `json:"path,omitempty"`

	// Service name where Claude will run (required when type="compose")
	// Example: dev
	Service string `json:"service,omitempty"`

	// Type of environment: "" (default single container) or "compose"
	// Example: compose
	Type string `json:"type,omitempty"`
}

type StromboliInternalTypesLifecycleHooks struct {

	// HooksTimeout is the maximum duration for all hooks combined (e.g., "5m", "30s").
	// If not specified, hooks run with the container's timeout.
	// This is useful to prevent long-running hooks from blocking the main command.
	// Example: 5m
	HooksTimeout string `json:"hooks_timeout,omitempty"`

	// OnCreateCommand runs after container creation, before Claude starts (first run only)
	// Commands are executed sequentially via "podman exec"
	// Example: ["pip install -r requirements.txt"]
	OnCreateCommand []string `json:"on_create_command,omitempty"`

	// PostCreate runs after OnCreateCommand completes (first run only)
	// Commands are executed sequentially via "podman exec"
	// Example: ["npm run setup"]
	PostCreate []string `json:"post_create,omitempty"`

	// PostStart runs after container starts (every run, including continues)
	// Commands are executed sequentially via "podman exec"
	// Example: ["redis-server --daemonize yes"]
	PostStart []string `json:"post_start,omitempty"`
}

type StromboliInternalTypesPodmanOptions struct {

	// CPU shares (relative weight, default 1024)
	// Example: 512
	CPUShares int64 `json:"cpu_shares,omitempty"`

	// CPU limit (e.g., "0.5", "2")
	// Example: 1
	Cpus string `json:"cpus,omitempty"`

	// Environment specifies a compose-based multi-service environment.
	// When set, the agent runs inside the specified service of the compose stack
	// instead of a standalone container.
	Environment StromboliInternalTypesEnvironmentConfig `json:"environment,omitempty"`

	// Container image override (must match allowed patterns)
	// Example: python:3.12
	Image string `json:"image,omitempty"`

	// Lifecycle hooks for running commands at specific container events
	Lifecycle StromboliInternalTypesLifecycleHooks `json:"lifecycle,omitempty"`

	// Memory limit (e.g., "512m", "1g")
	// Example: 512m
	Memory string `json:"memory,omitempty"`

	// Secrets to inject as environment variables (env_var_name -> podman_secret_name)
	// The Podman secret must exist beforehand (created via `podman secret create`)
	// Example: {"GH_TOKEN": "github-token"} mounts secret "github-token" as env var GH_TOKEN
	SecretsEnv map[string]string `json:"secrets_env,omitempty"`

	// Container timeout (e.g., "5m", "1h", "30s")
	// Example: 5m
	Timeout string `json:"timeout,omitempty"`

	// Volume mounts (host:container or host:container:options format)
	// Example: ["/data:/data:ro"]
	Volumes []string `json:"volumes,omitempty"`
}

type TokenRequest struct {

	// client id
	// Required: true
	ClientID *string `json:"client_id"`
}

type TokenResponse struct {

	// access token
	AccessToken string `json:"access_token,omitempty"`

	// expires in
	ExpiresIn int64 `json:"expires_in,omitempty"`

	// refresh token
	RefreshToken string `json:"refresh_token,omitempty"`

	// token type
	TokenType string `json:"token_type,omitempty"`
}

type ValidateResponse struct {

	// expires at
	ExpiresAt int64 `json:"expires_at,omitempty"`

	// subject
	Subject string `json:"subject,omitempty"`

	// valid
	Valid bool `json:"valid,omitempty"`
}