type APIError struct {
	// Status is the HTTP status code.
	Status int
	// Message is the human-readable reason given by the gateway.
	Message string
	// Body is the JSON error body, when the gateway sent one.
	Body json.RawMessage
}

type AdminResponse struct {
	// Success is whether it was accepted.
	Success bool `json:"success"`
	// Message says what happens next.
	Message string `json:"message"`
}

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

type AgentCostStats struct {
	// AgentAlias is the agent.
	AgentAlias string `json:"agent_alias"`
	// CostUSD is the cost, USD.
	CostUSD float64 `json:"cost_usd"`
	// TotalTokens is all tokens.
	TotalTokens uint64 `json:"total_tokens"`
	// InputTokens is the input tokens.
	InputTokens uint64 `json:"input_tokens"`
	// OutputTokens is the output tokens.
	OutputTokens uint64 `json:"output_tokens"`
	// CachedInputTokens is the cached input tokens.
	CachedInputTokens uint64 `json:"cached_input_tokens"`
	// RequestCount is the calls.
	RequestCount int `json:"request_count"`
}

type AgentOptions struct {
	// Channels, as type.alias.
	Channels []string `json:"channels"`
	// ChannelTypes are the channel types.
	ChannelTypes []string `json:"channel_types"`
	// ModelProviders, as type.alias.
	ModelProviders []string `json:"model_providers"`
	// RiskProfiles are the risk profiles.
	RiskProfiles []string `json:"risk_profiles"`
	// RuntimeProfiles are the runtime profiles.
	RuntimeProfiles []string `json:"runtime_profiles"`
	// SkillBundles are the skill bundles.
	SkillBundles []string `json:"skill_bundles"`
	// KnowledgeBundles are the knowledge bundles.
	KnowledgeBundles []string `json:"knowledge_bundles"`
	// MCPBundles are the MCP bundles.
	MCPBundles []string `json:"mcp_bundles"`
	// Agents are the agents.
	Agents []string `json:"agents"`
}

type AgentReply struct {
	// Response is the reply.
	Response string `json:"response"`
	// Model is the model that answered.
	Model string `json:"model"`
}

type AgentSkills struct {
	// Agent is the agent.
	Agent string `json:"agent"`
	// Skills are the loaded skills: name, description, origin (workspace,
	// open-skills, plugin, bundle), editable, …
	Skills []json.RawMessage `json:"skills"`
	// Dropped are the skills left out, with reason_kind and reason.
	Dropped []json.RawMessage `json:"dropped,omitempty"`
}

type AliasSource string

type Bound struct {
	// Saved says whether the configuration was saved.
	Saved bool `json:"saved"`
	// AlreadyBound says whether the identity was already allowed.
	AlreadyBound bool `json:"already_bound"`
	// Group is the peer group it was added to.
	Group string `json:"group"`
	// Channel is the channel.
	Channel string `json:"channel"`
}

type CLITool struct {
	// Name is the command name.
	Name string `json:"name"`
	// Path is the full path.
	Path string `json:"path"`
	// Version is the reported version.
	Version *string `json:"version,omitempty"`
	// Category is the kind of tool (VersionControl, Language, …).
	Category string `json:"category"`
}

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

type CanvasFrame struct {
	// FrameID is the frame id.
	FrameID string `json:"frame_id"`
	// ContentType is html, svg, markdown or text.
	ContentType string `json:"content_type"`
	// Content is the content.
	Content string `json:"content"`
	// Timestamp is when it was published.
	Timestamp string `json:"timestamp"`
}

type CatalogModelProvider struct {
	// Name is the provider family name.
	Name string `json:"name"`
	// DisplayName is shown to people.
	DisplayName string `json:"display_name"`
	// Local says whether it runs locally.
	Local bool `json:"local"`
}

type CatalogModels struct {
	// ModelProvider is the provider family name.
	ModelProvider string `json:"model_provider"`
	// Models are the model ids.
	Models []string `json:"models"`
	// Pricing holds the prices per model, when the provider publishes them.
	Pricing map[string]ModelPricing `json:"pricing,omitempty"`
	// Local says whether it runs locally.
	Local bool `json:"local"`
	// Live says whether the list came live from the provider.
	Live bool `json:"live"`
}

type Channel struct {
	// Name is type.alias, the name the other calls take.
	Name string `json:"name"`
	// Type is the channel type (whatsapp, telegram, …).
	Type string `json:"type"`
	// Alias is the alias.
	Alias string `json:"alias"`
	// OwningAgent is the agent it belongs to.
	OwningAgent *string `json:"owning_agent,omitempty"`
	// Enabled says whether it is enabled.
	Enabled bool `json:"enabled"`
	// Compiled says whether this build includes its type.
	Compiled bool `json:"compiled"`
	// Status is active, inactive, error, unknown or not_compiled.
	Status string `json:"status"`
	// Health is healthy, degraded, down or unavailable.
	Health string `json:"health"`
	// Readiness says what it still needs (enabled, bound_to_agent,
	// authenticated, listening, each ready/missing/unknown, plus notes).
	Readiness json.RawMessage `json:"readiness,omitempty"`
	// MessageCount is the number of messages the channel has carried.
	MessageCount int `json:"message_count"`
	// LastMessageAt is when the last one went through (RFC 3339).
	LastMessageAt *string `json:"last_message_at,omitempty"`
}

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

type ChatFrame struct {
	// Type is the frame type, one of the Frame* constants or another.
	Type string

	// Content of a chunk or thinking frame.
	Content string

	// SessionID, Resumed (whether it existed), MessageCount (messages it
	// holds) and Name of a session_start frame.
	SessionID    string
	Resumed      bool
	MessageCount int
	// Name of the session (session_start) or of the tool (tool_call,
	// tool_result).
	Name string

	// ID of a tool_call or tool_result; Args of the call; Output of the
	// result.
	ID     string
	Args   json.RawMessage
	Output json.RawMessage

	// RequestID, Tool, ArgumentsSummary (what it would do) and TimeoutSecs
	// (seconds before it is denied) of an approval_request; answer it with
	// [ChatSession.AnswerApproval].
	RequestID        string
	Tool             string
	ArgumentsSummary string
	TimeoutSecs      uint64

	// Done is the end of the turn, for a done frame.
	Done *TurnResult

	// Message and Code (PROVIDER_ERROR, SESSION_QUEUE_FULL, …) of an error
	// frame.
	Message string
	Code    string

	// Raw is the frame as sent.
	Raw json.RawMessage
}

type ChatOptions struct {
	// SessionID is the session to resume or create (a new one without it).
	SessionID string
	// Name names the session.
	Name string
	// Cwd is the working directory for the session (must exist on the host).
	Cwd string
}

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

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

type ComponentHealth struct {
	// Status is "ok", "error", …
	Status string `json:"status"`
	// UpdatedAt is the last update (RFC 3339).
	UpdatedAt string `json:"updated_at"`
	// LastOK is the last time it was healthy.
	LastOK *string `json:"last_ok,omitempty"`
	// LastError is the last error.
	LastError *string `json:"last_error,omitempty"`
	// RestartCount is how many times it was restarted.
	RestartCount uint64 `json:"restart_count"`
}

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

type ConfigEntry struct {
	// Path is the dotted path.
	Path string `json:"path"`
	// Category groups fields.
	Category string `json:"category"`
	// Kind is string, bool, integer, float, enum, alias-ref, string-array,
	// object-array or object.
	Kind string `json:"kind"`
	// TypeHint is the Rust type, e.g. Option<String>.
	TypeHint string `json:"type_hint"`
	// Value is the display value; absent for secrets.
	Value json.RawMessage `json:"value,omitempty"`
	// Populated says whether it has a value.
	Populated bool `json:"populated"`
	// IsSecret says whether it is a secret.
	IsSecret bool `json:"is_secret"`
	// IsEnvOverridden says whether an environment variable overrides it.
	IsEnvOverridden bool `json:"is_env_overridden"`
	// EnumVariants are the allowed values of an enum.
	EnumVariants []string `json:"enum_variants,omitempty"`
	// Section is the setup section it belongs to.
	Section *string `json:"section,omitempty"`
	// Tab is the dashboard tab.
	Tab string `json:"tab"`
	// Multiline says whether it is edited as multi-line text.
	Multiline bool `json:"multiline"`
}

type ConfigList struct {
	// Entries are the fields.
	Entries []ConfigEntry `json:"entries"`
	// Drifted lists the fields whose value on disk differs from the
	// gateway's.
	Drifted []DriftEntry `json:"drifted,omitempty"`
}

type ConfigSection struct {
	// Key is the section key, e.g. providers.models.
	Key string `json:"key"`
	// Label is shown to people.
	Label string `json:"label"`
	// Help is the help text.
	Help string `json:"help"`
	// HasPicker says whether it offers items to pick
	// ([ConfigAPI.SectionItems]).
	HasPicker bool `json:"has_picker"`
	// Completed says whether it is completed.
	Completed bool `json:"completed"`
	// Ready says whether it is ready to use.
	Ready bool `json:"ready"`
	// Group is the group it is shown under.
	Group string `json:"group"`
	// IsQuickstart says whether the quickstart includes it.
	IsQuickstart bool `json:"is_quickstart"`
	// Shape is direct_form, one_tier_alias_map, typed_family_map or
	// backend_picker.
	Shape *string `json:"shape,omitempty"`
	// CostCategory is the cost category.
	CostCategory string `json:"cost_category"`
}

type ConfigStatus struct {
	// NeedsQuickstart says whether the quickstart still has to run.
	NeedsQuickstart bool `json:"needs_quickstart"`
	// Reason is has_dispatchable_agent, incomplete_agent or fresh_install.
	Reason string `json:"reason"`
	// HasPartialState says whether part of the setup is done.
	HasPartialState bool `json:"has_partial_state"`
	// Missing lists the steps left, in words.
	Missing []string `json:"missing"`
}

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

type CostSummary struct {
	// SessionCostUSD is the cost of the current session, USD.
	SessionCostUSD float64 `json:"session_cost_usd"`
	// DailyCostUSD is the cost today, USD.
	DailyCostUSD float64 `json:"daily_cost_usd"`
	// MonthlyCostUSD is the cost this month, USD.
	MonthlyCostUSD float64 `json:"monthly_cost_usd"`
	// TotalTokens is the tokens in the window.
	TotalTokens uint64 `json:"total_tokens"`
	// RequestCount is the model calls in the window.
	RequestCount int `json:"request_count"`
	// ByModel is the usage by model.
	ByModel map[string]ModelStats `json:"by_model,omitempty"`
	// ByAgent is the usage by agent.
	ByAgent map[string]AgentCostStats `json:"by_agent,omitempty"`
}

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

type CronJob struct {
	// ID is the job id.
	ID string `json:"id"`
	// Expression is the schedule expression as written.
	Expression string `json:"expression"`
	// Schedule is the parsed schedule.
	Schedule Schedule `json:"schedule"`
	// Command is the shell command (shell jobs).
	Command string `json:"command"`
	// Prompt is the prompt (agent jobs).
	Prompt *string `json:"prompt,omitempty"`
	// Name is the name.
	Name *string `json:"name,omitempty"`
	// JobType is shell or agent.
	JobType string `json:"job_type"`
	// SessionTarget is isolated or main.
	SessionTarget string `json:"session_target"`
	// Model is the model override (agent jobs).
	Model *string `json:"model,omitempty"`
	// AgentAlias is the agent that owns it.
	AgentAlias string `json:"agent_alias"`
	// Enabled says whether it runs.
	Enabled bool `json:"enabled"`
	// Delivery is where its output goes.
	Delivery Delivery `json:"delivery"`
	// DeleteAfterRun says whether it is deleted after one run.
	DeleteAfterRun bool `json:"delete_after_run"`
	// AllowedTools lists the tools an agent job may use (nil: no
	// restriction).
	AllowedTools []string `json:"allowed_tools,omitempty"`
	// UsesMemory says whether an agent job uses memory.
	UsesMemory bool `json:"uses_memory"`
	// Source is imperative (API, CLI) or declarative (config file).
	Source string `json:"source"`
	// ShellOutputFormat is wrapped or raw (shell jobs).
	ShellOutputFormat *string `json:"shell_output_format,omitempty"`
	// CreatedAt is the creation time (RFC 3339).
	CreatedAt string `json:"created_at"`
	// NextRun is the next run (RFC 3339).
	NextRun string `json:"next_run"`
	// LastRun is the last run (RFC 3339).
	LastRun *string `json:"last_run,omitempty"`
	// LastStatus is the last status.
	LastStatus *string `json:"last_status,omitempty"`
	// LastOutput is the last output.
	LastOutput *string `json:"last_output,omitempty"`
}

type CronJobPatch struct {
	// Agent is the owning agent; required when changing a shell job's
	// command.
	Agent *string `json:"agent,omitempty"`
	// Name is the name.
	Name *string `json:"name,omitempty"`
	// Schedule is the cron expression.
	Schedule *string `json:"schedule,omitempty"`
	// Tz is the IANA time zone.
	Tz *string `json:"tz,omitempty"`
	// ClearTz removes the time zone.
	ClearTz *bool `json:"clear_tz,omitempty"`
	// Command is the shell command (or an agent job's prompt).
	Command *string `json:"command,omitempty"`
	// Prompt is the agent prompt.
	Prompt *string `json:"prompt,omitempty"`
	// Enabled pauses (false) or resumes the job.
	Enabled *bool `json:"enabled,omitempty"`
	// UsesMemory says whether an agent job uses memory.
	UsesMemory *bool `json:"uses_memory,omitempty"`
	// ShellOutputFormat is wrapped or raw.
	ShellOutputFormat *string `json:"shell_output_format,omitempty"`
}

type CronRun struct {
	// ID is the run id.
	ID int64 `json:"id"`
	// JobID is the job id.
	JobID string `json:"job_id"`
	// StartedAt is the start (RFC 3339).
	StartedAt string `json:"started_at"`
	// FinishedAt is the end (RFC 3339).
	FinishedAt string `json:"finished_at"`
	// Status is the status.
	Status string `json:"status"`
	// Output is the output.
	Output *string `json:"output,omitempty"`
	// DurationMs is the duration.
	DurationMs *int64 `json:"duration_ms,omitempty"`
}

type CronRunResult struct {
	// Status is the run status.
	Status string `json:"status"`
	// JobID is the job id.
	JobID string `json:"job_id"`
	// Success says whether the job succeeded.
	Success bool `json:"success"`
	// Output is its output.
	Output string `json:"output"`
	// DurationMs is the duration.
	DurationMs int64 `json:"duration_ms"`
	// StartedAt is the start (RFC 3339).
	StartedAt string `json:"started_at"`
	// FinishedAt is the end (RFC 3339).
	FinishedAt string `json:"finished_at"`
}

type CronSettings struct {
	// Enabled says whether the scheduler runs jobs.
	Enabled bool `json:"enabled"`
	// CatchUpOnStartup says whether missed runs run at startup.
	CatchUpOnStartup bool `json:"catch_up_on_startup"`
	// MaxRunHistory is the number of runs kept per job.
	MaxRunHistory uint32 `json:"max_run_history"`
}

type CronSettingsPatch struct {
	// Enabled says whether the scheduler runs jobs.
	Enabled *bool `json:"enabled,omitempty"`
	// CatchUpOnStartup says whether missed runs run at startup.
	CatchUpOnStartup *bool `json:"catch_up_on_startup,omitempty"`
	// MaxRunHistory is the number of runs kept per job.
	MaxRunHistory *uint32 `json:"max_run_history,omitempty"`
}

type Decision struct {
	// Kind is approve, deny, amend or revise.
	Kind string
	// Reason says why, for deny ("" for none).
	Reason string
	// Text is the checkpoint's new text, for amend.
	Text string
	// Guidance is how to redo the step, for revise.
	Guidance string
}

type DeletePlan struct {
	// Path is the map section.
	Path string `json:"path"`
	// Key is the alias.
	Key string `json:"key"`
	// Allowed says whether the delete would go through.
	Allowed bool `json:"allowed"`
	// Blockers are the references that block it.
	Blockers []ReferenceSite `json:"blockers"`
	// Scrubs are the references it would clear.
	Scrubs []ReferenceSite `json:"scrubs"`
	// LiveACPSessions counts, for agents, the live ACP sessions (they block
	// the delete).
	LiveACPSessions *int `json:"live_acp_sessions,omitempty"`
	// CascadesOwnedState says whether the agent's memory, cron jobs and
	// sessions go too.
	CascadesOwnedState bool `json:"cascades_owned_state"`
}

type Delivery struct {
	// Mode is none or announce (post it on a channel).
	Mode string `json:"mode"`
	// Channel is the channel, as type.alias.
	Channel *string `json:"channel,omitempty"`
	// To is the recipient on the channel.
	To *string `json:"to,omitempty"`
	// ThreadID is the thread to post in.
	ThreadID *string `json:"thread_id,omitempty"`
	// BestEffort says whether a delivery failure leaves the run successful
	// (true when absent from the JSON).
	BestEffort bool `json:"best_effort"`
}

type Device struct {
	// ID is the device id.
	ID string `json:"id"`
	// Name is the name given at pairing.
	Name *string `json:"name,omitempty"`
	// DeviceType is the type given at pairing (legacy for tokens older than
	// the registry).
	DeviceType *string `json:"device_type,omitempty"`
	// PairedAt is when it paired (RFC 3339).
	PairedAt string `json:"paired_at"`
	// LastSeen is when it was last seen (RFC 3339).
	LastSeen string `json:"last_seen"`
	// IPAddress is the address it paired from.
	IPAddress *string `json:"ip_address,omitempty"`
	// Capabilities are the advertised capabilities.
	Capabilities []string `json:"capabilities,omitempty"`
}

type Diagnostic struct {
	// Severity is "ok", "warn" or "error".
	Severity string `json:"severity"`
	// Category is the area checked.
	Category string `json:"category"`
	// Message is the finding.
	Message string `json:"message"`
}

type DoctorReport struct {
	// Results holds each check.
	Results []Diagnostic `json:"results"`
	// Summary counts the results by severity.
	Summary DoctorSummary `json:"summary"`
}

type DoctorSummary struct {
	// OK is the number of checks passed.
	OK int `json:"ok"`
	// Warnings is the number of warnings.
	Warnings int `json:"warnings"`
	// Errors is the number of errors.
	Errors int `json:"errors"`
}

type DriftEntry struct {
	// Path is the dotted path.
	Path string `json:"path"`
	// Secret says whether it is a secret (no values shown).
	Secret bool `json:"secret"`
	// Drifted is always true.
	Drifted bool `json:"drifted"`
	// InMemoryValue is the gateway's value.
	InMemoryValue json.RawMessage `json:"in_memory_value,omitempty"`
	// OnDiskValue is the value in config.toml.
	OnDiskValue json.RawMessage `json:"on_disk_value,omitempty"`
}

type Event map[string]json.RawMessage

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

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

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

type FileContent struct {
	// Path is the file.
	Path string `json:"path"`
	// Size is its size in bytes.
	Size uint64 `json:"size"`
	// IsText says whether it is text.
	IsText bool `json:"is_text"`
	// Content is the content, in Encoding.
	Content string `json:"content"`
	// Encoding is utf8 or base64.
	Encoding string `json:"encoding"`
}

type FileEntry struct {
	// Name is the entry's name.
	Name string `json:"name"`
	// Kind is dir or file.
	Kind string `json:"kind"`
	// Size is the size of a file.
	Size *uint64 `json:"size,omitempty"`
	// Protected says whether it may not be changed.
	Protected bool `json:"protected"`
}

type FileListing struct {
	// Path is the directory.
	Path string `json:"path"`
	// Entries are the directories first, then the files, alphabetically.
	Entries []FileEntry `json:"entries"`
}

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

type Health struct {
	// Status is always "ok" while the gateway answers.
	Status string `json:"status"`
	// Paired is whether at least one client is paired.
	Paired bool `json:"paired"`
	// RequirePairing is whether requests need a bearer token.
	RequirePairing bool `json:"require_pairing"`
	// Runtime is the component health (raw when the gateway could not
	// serialize it).
	Runtime json.RawMessage `json:"runtime"`
}

type HealthSnapshot struct {
	// PID is the daemon process id.
	PID uint32 `json:"pid"`
	// UpdatedAt is when it was computed (RFC 3339).
	UpdatedAt string `json:"updated_at"`
	// UptimeSeconds is the time since the daemon started.
	UptimeSeconds uint64 `json:"uptime_seconds"`
	// Components is the health per component (gateway,
	// channel:whatsapp.x, …).
	Components map[string]ComponentHealth `json:"components"`
}

type Integration struct {
	// Name is the integration's name.
	Name string `json:"name"`
	// Description says what it does.
	Description string `json:"description"`
	// Category is "Chat", "AiModel", "ToolsAutomation" or "Platform".
	Category string `json:"category"`
	// CategoryLabel is the category in words.
	CategoryLabel string `json:"category_label"`
	// Status is "Available" or "Active".
	Status string `json:"status"`
}

type IntegrationSetting struct {
	// Enabled is whether it is active.
	Enabled bool `json:"enabled"`
	// Category is its category.
	Category string `json:"category"`
	// Status is its status.
	Status string `json:"status"`
}

type LogPage struct {
	// Events are the log events (OpenTelemetry-like JSON, see ZeroClaw's
	// LogEvent).
	Events []json.RawMessage `json:"events"`
	// NextCursorLineOffset is the cursor for the next (older) page.
	NextCursorLineOffset *uint64 `json:"next_cursor_line_offset,omitempty"`
	// AtEnd is whether this is the oldest page.
	AtEnd bool `json:"at_end"`
	// DaemonStartedAt is when the daemon started.
	DaemonStartedAt string `json:"daemon_started_at"`
	// AttributionKeys are the attribution fields that can be filtered on.
	AttributionKeys []string `json:"attribution_keys,omitempty"`
}

type LogQuery struct {
	// SinceTS keeps events at or after (RFC 3339).
	SinceTS string
	// UntilTS keeps events before (RFC 3339).
	UntilTS string
	// UntilLineOffset is the paging cursor: the previous page's
	// NextCursorLineOffset.
	UntilLineOffset *uint64
	// Action is the event action.
	Action string
	// Category is the event category.
	Category string
	// Outcome is the event outcome.
	Outcome string
	// SeverityMin is the minimum severity number.
	SeverityMin int
	// TraceID is the trace id.
	TraceID string
	// Q is free text.
	Q string
	// HideInternal leaves out the daemon's internal events.
	HideInternal bool
	// Limit is the page size (gateway default 200).
	Limit int
	// Attributes are exact matches on attribution fields (agent_alias,
	// channel, session_key, tool, …).
	Attributes map[string]string
}

type MapKeyResponse struct {
	// Path is the map section.
	Path string `json:"path"`
	// Key is the alias.
	Key string `json:"key"`
	// Created says whether a new alias was created.
	Created bool `json:"created"`
	// Warnings lists cleanup steps that failed after the change was saved.
	Warnings []string `json:"warnings,omitempty"`
}

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

type MemoryEntry struct {
	// ID is the entry id.
	ID string `json:"id"`
	// Key is the key.
	Key string `json:"key"`
	// Content is the content.
	Content string `json:"content"`
	// Category is the category.
	Category string `json:"category"`
	// Timestamp is when it was stored.
	Timestamp string `json:"timestamp"`
	// SessionID is the session it came from.
	SessionID *string `json:"session_id,omitempty"`
	// Score is the relevance of a recall match.
	Score *float64 `json:"score,omitempty"`
	// Namespace is the namespace.
	Namespace *string `json:"namespace,omitempty"`
	// Importance is the importance.
	Importance *float64 `json:"importance,omitempty"`
	// SupersededBy is the entry that replaced it.
	SupersededBy *string `json:"superseded_by,omitempty"`
	// Kind is "episodic", "procedural" or {"semantic": "fact"|…}.
	Kind json.RawMessage `json:"kind,omitempty"`
	// Pinned says whether it is pinned.
	Pinned bool `json:"pinned"`
	// AgentAlias is the owning agent.
	AgentAlias *string `json:"agent_alias,omitempty"`
}

type MemoryQuery struct {
	// Query is the text to recall by.
	Query string
	// Category is an exact category (core, daily, conversation or custom).
	Category string
	// Since keeps entries at or after it (RFC 3339).
	Since string
	// Until keeps entries before it (RFC 3339).
	Until string
	// Agent searches an agent's memory instead of the shared one.
	Agent string
}

type Middleware func(next http.RoundTripper) http.RoundTripper

type MigrateResponse struct {
	// Migrated says whether the file changed.
	Migrated bool `json:"migrated"`
	// BackupPath is where the previous file was kept.
	BackupPath *string `json:"backup_path,omitempty"`
	// SchemaVersion is the schema version now on disk.
	SchemaVersion int `json:"schema_version"`
}

type ModelPricing struct {
	// Prompt is the input price.
	Prompt *string `json:"prompt,omitempty"`
	// Completion is the output price.
	Completion *string `json:"completion,omitempty"`
	// InputCacheRead is the cached input read price.
	InputCacheRead *string `json:"input_cache_read,omitempty"`
	// InputCacheWrite is the cached input write price.
	InputCacheWrite *string `json:"input_cache_write,omitempty"`
}

type ModelStats struct {
	// Model is the model.
	Model string `json:"model"`
	// CostUSD is the cost, USD.
	CostUSD float64 `json:"cost_usd"`
	// InputTokens is the input tokens.
	InputTokens uint64 `json:"input_tokens"`
	// CachedInputTokens is the cached input tokens.
	CachedInputTokens uint64 `json:"cached_input_tokens"`
	// OutputTokens is the output tokens.
	OutputTokens uint64 `json:"output_tokens"`
	// TotalTokens is all tokens.
	TotalTokens uint64 `json:"total_tokens"`
	// RequestCount is the calls.
	RequestCount int `json:"request_count"`
}

type NewCronJob struct {
	// Agent is the owning agent (must be configured).
	Agent string `json:"agent"`
	// Schedule is the cron expression.
	Schedule string `json:"schedule"`
	// Name is the name.
	Name string `json:"name,omitempty"`
	// Tz is the IANA time zone of the schedule.
	Tz string `json:"tz,omitempty"`
	// Command is the shell command.
	Command string `json:"command,omitempty"`
	// JobType is shell or agent.
	JobType string `json:"job_type,omitempty"`
	// Prompt is the agent prompt.
	Prompt string `json:"prompt,omitempty"`
	// Delivery is where the output goes.
	Delivery *Delivery `json:"delivery,omitempty"`
	// SessionTarget is isolated (default) or main.
	SessionTarget string `json:"session_target,omitempty"`
	// Model is the model override.
	Model string `json:"model,omitempty"`
	// AllowedTools lists the tools an agent job may use (nil: no
	// restriction; a pointer to an empty list: none).
	AllowedTools *[]string `json:"allowed_tools,omitempty"`
	// DeleteAfterRun deletes the job after its first run.
	DeleteAfterRun *bool `json:"delete_after_run,omitempty"`
	// UsesMemory says whether an agent job uses memory (default true).
	UsesMemory *bool `json:"uses_memory,omitempty"`
	// ShellOutputFormat is wrapped (default) or raw: how a shell job's
	// output is announced.
	ShellOutputFormat string `json:"shell_output_format,omitempty"`
}

type Option func(*settings)

type Paired struct {
	// Paired is always true.
	Paired bool `json:"paired"`
	// Persisted says whether the token was saved in the gateway's
	// configuration.
	Persisted bool `json:"persisted,omitempty"`
	// Token is the bearer token. Keep it secret.
	Token string `json:"token"`
	// Message is the gateway's note.
	Message *string `json:"message,omitempty"`
}

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

type PairingCode struct {
	// Success says whether the request succeeded.
	Success bool `json:"success,omitempty"`
	// PairingRequired says whether the gateway requires pairing.
	PairingRequired bool `json:"pairing_required"`
	// PairingCode is the six-digit code, when one is pending and may be
	// shown.
	PairingCode *string `json:"pairing_code,omitempty"`
	// Message is the gateway's note.
	Message *string `json:"message,omitempty"`
}

type PatchOp struct {
	// Op is add, replace, remove, test or comment.
	Op string `json:"op"`
	// Path is dotted, or a JSON Pointer (/a/b).
	Path string `json:"path"`
	// Value is the value for add, replace and test, encoded as JSON.
	Value any `json:"value,omitempty"`
	// Comment is the TOML comment written above the key.
	Comment string `json:"comment,omitempty"`
}

type PatchOpResult struct {
	// Op is the operation.
	Op string `json:"op"`
	// Path is the dotted path.
	Path string `json:"path"`
	// Value is the new display value (absent for secrets and comments).
	Value json.RawMessage `json:"value,omitempty"`
	// Populated says, for secrets, whether it now has a value.
	Populated *bool `json:"populated,omitempty"`
	// Comment is, for comment, the comment written.
	Comment *string `json:"comment,omitempty"`
}

type PatchResponse struct {
	// Saved is always true on success: the patch was saved.
	Saved bool `json:"saved"`
	// Results holds one result per operation, in order.
	Results []PatchOpResult `json:"results"`
	// Warnings lists validation problems outside the patched paths.
	Warnings []ValidationWarning `json:"warnings,omitempty"`
}

type PendingApproval struct {
	// RunID is the run id.
	RunID string `json:"run_id"`
	// SopName is the SOP.
	SopName string `json:"sop_name"`
	// Step is the step waiting.
	Step uint32 `json:"step"`
	// TotalSteps is the number of steps in all.
	TotalSteps uint32 `json:"total_steps"`
	// WaitingSince is since when.
	WaitingSince *string `json:"waiting_since,omitempty"`
	// Kind is approval or checkpoint.
	Kind string `json:"kind"`
}

type PersonalityContext struct {
	AgentName          string
	UserName           string
	Timezone           string
	CommunicationStyle string
	// IncludeMemory, when set, says whether to render MEMORY.md.
	IncludeMemory *bool
}

type PersonalityFile struct {
	// Filename is the file name.
	Filename string `json:"filename"`
	// Content is the content (absent when the file does not exist).
	Content *string `json:"content,omitempty"`
	// Exists says whether it exists.
	Exists bool `json:"exists"`
	// Truncated says whether the content was cut at the size limit.
	Truncated bool `json:"truncated"`
	// MtimeMs is its modification time, for [AgentAPI.WritePersonality].
	MtimeMs *int64 `json:"mtime_ms,omitempty"`
}

type PersonalityFileEntry struct {
	// Filename is the file name.
	Filename string `json:"filename"`
	// Exists says whether it exists.
	Exists bool `json:"exists"`
	// Size is its size in bytes.
	Size uint64 `json:"size"`
	// MtimeMs is its modification time, ms since the epoch.
	MtimeMs *int64 `json:"mtime_ms,omitempty"`
}

type PersonalityFiles struct {
	// Files holds each editable file.
	Files []PersonalityFileEntry `json:"files"`
	// MaxChars is the maximum characters per file.
	MaxChars int `json:"max_chars"`
}

type PersonalityTemplates struct {
	// Preset is the preset used.
	Preset string `json:"preset"`
	// Files holds each file: {filename, content}.
	Files []json.RawMessage `json:"files"`
}

type PersonalityWritten struct {
	// BytesWritten is the number of bytes written.
	BytesWritten uint64 `json:"bytes_written"`
	// MtimeMs is the new modification time.
	MtimeMs *int64 `json:"mtime_ms,omitempty"`
}

type ProcessStats struct {
	// RSSBytes is the resident memory.
	RSSBytes uint64 `json:"rss_bytes"`
	// SystemRAMTotalBytes is the host memory.
	SystemRAMTotalBytes uint64 `json:"system_ram_total_bytes"`
	// CPUPercent is the CPU use.
	CPUPercent *float64 `json:"cpu_percent,omitempty"`
	// NumCPUs is the number of host CPUs.
	NumCPUs uint32 `json:"num_cpus"`
}

type PropValue struct {
	// Path is the dotted path.
	Path string `json:"path"`
	// Value is the gateway's display value (null after a reset); absent
	// for secrets.
	Value json.RawMessage `json:"value,omitempty"`
	// Warnings lists validation problems of the configuration.
	Warnings []ValidationWarning `json:"warnings,omitempty"`
	// Populated says, for a secret, whether it has a value.
	Populated *bool `json:"populated,omitempty"`
}

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

type ReferenceSite struct {
	// Path is the dotted path of the referencing field.
	Path string `json:"path"`
	// RawValue is its raw value.
	RawValue string `json:"raw_value"`
}

type Relinked struct {
	// Channel is the channel.
	Channel string `json:"channel"`
	// Outcome is cleared or nothing_to_clear.
	Outcome string `json:"outcome"`
	// Removed lists the files removed.
	Removed []string `json:"removed,omitempty"`
	// RestartRequired says whether a reload is needed for the channel to
	// pair again.
	RestartRequired bool `json:"restart_required,omitempty"`
	// Note is the gateway's note.
	Note *string `json:"note,omitempty"`
}

type RenameResponse struct {
	// Path is the map section.
	Path string `json:"path"`
	// From is the old alias.
	From string `json:"from"`
	// To is the new alias.
	To string `json:"to"`
	// Renamed says whether it was renamed.
	Renamed bool `json:"renamed"`
	// Warnings lists follow-up steps that failed (re-sending the rename
	// finishes them).
	Warnings []string `json:"warnings,omitempty"`
}

type RetryPolicy struct {
	// MaxRetries is how many times a request is tried again at most.
	MaxRetries int
	// BaseDelay is the wait before the first retry.
	BaseDelay time.Duration
	// MaxDelay caps the wait between retries.
	MaxDelay time.Duration
	// Jitter randomizes each wait between half and all of its delay.
	Jitter bool
}

type RoundTripperFunc func(*http.Request) (*http.Response, error)

type Schedule struct {
	// Kind is cron, at or every.
	Kind string
	// Expr is the cron expression.
	Expr string
	// Tz is the time zone of a cron schedule (nil: UTC).
	Tz *string
	// At is the time of an at schedule (RFC 3339).
	At string
	// EveryMs is the interval of an every schedule.
	EveryMs uint64
}

type SectionItem struct {
	// Key is the item key.
	Key string `json:"key"`
	// Label is shown to people.
	Label string `json:"label"`
	// Description describes it.
	Description *string `json:"description,omitempty"`
	// Badge is configured, needs setup, active or created.
	Badge *string `json:"badge,omitempty"`
}

type SectionItems struct {
	// Section is the section key.
	Section string `json:"section"`
	// Items are the items.
	Items []SectionItem `json:"items"`
	// Help is the help text.
	Help string `json:"help"`
}

type SelectedItem struct {
	// FieldsPrefix is the prefix of the fields to fill ([ConfigAPI.List]).
	FieldsPrefix string `json:"fields_prefix"`
	// Created says whether something was created.
	Created bool `json:"created"`
}

type Session struct {
	// SessionID is the display id (gw_ removed).
	SessionID string `json:"session_id"`
	// SessionKey is the full key (gw_…, whatsapp_<channel>_<peer>…).
	SessionKey *string `json:"session_key,omitempty"`
	// CreatedAt is the creation time (RFC 3339).
	CreatedAt string `json:"created_at"`
	// LastActivity is the last activity (RFC 3339).
	LastActivity string `json:"last_activity"`
	// MessageCount is the number of messages in it.
	MessageCount int `json:"message_count"`
	// AgentAlias is the agent that answers it.
	AgentAlias *string `json:"agent_alias,omitempty"`
	// ChannelID is the channel it came through (whatsapp.alias).
	ChannelID *string `json:"channel_id,omitempty"`
	// Name is the name given to it.
	Name *string `json:"name,omitempty"`
}

type SessionMessage struct {
	// Role is user, assistant, tool, …
	Role string `json:"role"`
	// Content is the content (tool calls and results are JSON text).
	Content string `json:"content"`
	// CreatedAt is when it was stored.
	CreatedAt *string `json:"created_at,omitempty"`
}

type SessionState struct {
	// SessionID is the session id as asked.
	SessionID string `json:"session_id"`
	// State is idle, running or error.
	State string `json:"state"`
	// TurnID is the running turn.
	TurnID *string `json:"turn_id,omitempty"`
	// TurnStartedAt is when it started.
	TurnStartedAt *string `json:"turn_started_at,omitempty"`
}

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

type Skill struct {
	// Bundle is the bundle.
	Bundle string `json:"bundle"`
	// Name is the skill's name.
	Name string `json:"name"`
	// Frontmatter is the front matter.
	Frontmatter json.RawMessage `json:"frontmatter"`
	// Body is the Markdown body.
	Body string `json:"body"`
}

type SkillBundle struct {
	// Alias is the bundle's alias.
	Alias string `json:"alias"`
	// Directory is its directory.
	Directory string `json:"directory"`
	// Include lists the skills it includes.
	Include []string `json:"include,omitempty"`
	// Exclude lists the skills it leaves out.
	Exclude []string `json:"exclude,omitempty"`
}

type SkillSummary struct {
	// Bundle is the bundle.
	Bundle string `json:"bundle"`
	// Name is the skill's name.
	Name string `json:"name"`
	// Directory is its directory.
	Directory string `json:"directory"`
	// Frontmatter is the front matter (name, description, tags,
	// slash_options, …).
	Frontmatter json.RawMessage `json:"frontmatter"`
}

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

type SopRun struct {
	// RunID is the run id.
	RunID string `json:"run_id"`
	// SopName is the SOP.
	SopName string `json:"sop_name"`
	// Status is pending, running, cancel_requested, waiting_approval,
	// paused_checkpoint, completed, failed or cancelled.
	Status string `json:"status"`
	// CurrentStep is the current step.
	CurrentStep uint32 `json:"current_step"`
	// TotalSteps is the number of steps in all.
	TotalSteps uint32 `json:"total_steps"`
	// StartedAt is the start (RFC 3339).
	StartedAt string `json:"started_at"`
	// CompletedAt is the end.
	CompletedAt *string `json:"completed_at,omitempty"`
	// TriggerSource is what started it.
	TriggerSource string `json:"trigger_source"`
	// Active is whether it is still running.
	Active bool `json:"active"`
}

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

type Status struct {
	// Version is the ZeroClaw version.
	Version string `json:"version"`
	// ModelProvider is the model provider in use, as type.alias.
	ModelProvider *string `json:"model_provider,omitempty"`
	// Model is the model in use.
	Model string `json:"model"`
	// Temperature is the sampling temperature.
	Temperature *float64 `json:"temperature,omitempty"`
	// UptimeSeconds is the time since the daemon started.
	UptimeSeconds uint64 `json:"uptime_seconds"`
	// DaemonStartedAt is when the daemon started (RFC 3339).
	DaemonStartedAt string `json:"daemon_started_at"`
	// GatewayPort is the gateway port.
	GatewayPort uint16 `json:"gateway_port"`
	// Locale is the UI locale.
	Locale string `json:"locale"`
	// MemoryBackend is the memory backend.
	MemoryBackend string `json:"memory_backend"`
	// Paired is whether a client is paired.
	Paired bool `json:"paired"`
	// Channels are the configured channels, as type.alias.
	Channels map[string]bool `json:"channels"`
	// Nodes are the connected nodes and peers found on the network.
	Nodes json.RawMessage `json:"nodes,omitempty"`
	// Health is the component health.
	Health HealthSnapshot `json:"health"`
	// AgentAlias is the agent asked about, if any.
	AgentAlias *string `json:"agent_alias,omitempty"`
	// Process holds the process figures.
	Process *ProcessStats `json:"process,omitempty"`
	// CheckUpdates is whether the daemon checks for updates.
	CheckUpdates bool `json:"check_updates"`
	// AllowSelfUpgrade is whether self-upgrade is allowed.
	AllowSelfUpgrade bool `json:"allow_self_upgrade"`
	// RestartMode is "supervised", "self_respawn" or "manual".
	RestartMode *string `json:"restart_mode,omitempty"`
	// RestartHint says how to restart the daemon.
	RestartHint *string `json:"restart_hint,omitempty"`
	// LiveChannelConfig is the configuration a running channel picks up
	// without a restart.
	LiveChannelConfig []string `json:"live_channel_config,omitempty"`
}

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

type TemplateEntry struct {
	// Path is the dotted path.
	Path string `json:"path"`
	// Kind is map or list.
	Kind string `json:"kind"`
	// ValueType is the Rust type of an entry.
	ValueType string `json:"value_type"`
	// Description says what the section holds.
	Description string `json:"description"`
}

type ToolOption struct {
	// Value is the value.
	Value string `json:"value"`
	// Label is the label to show.
	Label *string `json:"label,omitempty"`
	// Hint is an extra hint.
	Hint *string `json:"hint,omitempty"`
}

type ToolSpec struct {
	// Name is the tool name.
	Name string `json:"name"`
	// Description says what it does.
	Description string `json:"description"`
	// Parameters is the JSON Schema of its arguments.
	Parameters json.RawMessage `json:"parameters"`
	// Output is the JSON Schema of its output, when declared.
	Output json.RawMessage `json:"output,omitempty"`
	// ParamDomains is the option domain of the parameters that take known
	// values.
	ParamDomains map[string]string `json:"param_domains,omitempty"`
}

type Tui struct {
	// TuiID is the client id.
	TuiID string `json:"tui_id"`
	// ConnectedAt is when it connected (RFC 3339).
	ConnectedAt string `json:"connected_at"`
	// PeerLabel says who it is.
	PeerLabel string `json:"peer_label"`
	// Transport is "unix" or "wss".
	Transport string `json:"transport"`
}

type TurnError struct {
	// Code is the stable code, e.g. "PROVIDER_ERROR" or "ABORTED"; empty
	// when the gateway sent none.
	Code string
	// Message says what went wrong.
	Message string
}

type TurnResult struct {
	// FullResponse is the whole reply.
	FullResponse string `json:"full_response"`
	// InputTokens used.
	InputTokens *uint64 `json:"input_tokens,omitempty"`
	// OutputTokens used.
	OutputTokens *uint64 `json:"output_tokens,omitempty"`
	// TokensUsed in all.
	TokensUsed *uint64 `json:"tokens_used,omitempty"`
	// CostUSD of the turn.
	CostUSD *float64 `json:"cost_usd,omitempty"`
	// Model used.
	Model string `json:"model"`
	// Provider used.
	Provider string `json:"provider"`
	// MaxContextTokens is the model's context size.
	MaxContextTokens *uint64 `json:"max_context_tokens,omitempty"`
	// LastInputTokens is the input tokens of the last model call.
	LastInputTokens *uint64 `json:"last_input_tokens,omitempty"`
}

type UpgradeStatus struct {
	// State is "idle", "running", "done", "restarting" or "failed".
	State string `json:"state"`
	// HandoffID is the upgrade id.
	HandoffID *string `json:"handoff_id,omitempty"`
	// Phase is the step, 0 to 6.
	Phase *uint8 `json:"phase,omitempty"`
	// LogTail holds the last log lines.
	LogTail []string `json:"log_tail,omitempty"`
	// PreviousVersion is the version before.
	PreviousVersion *string `json:"previous_version,omitempty"`
	// TargetVersion is the version being installed.
	TargetVersion *string `json:"target_version,omitempty"`
	// RestartMode is how the daemon restarts.
	RestartMode *string `json:"restart_mode,omitempty"`
	// RestartHint says how to restart it by hand.
	RestartHint *string `json:"restart_hint,omitempty"`
	// Error says why it failed.
	Error *string `json:"error,omitempty"`
}

type Upload struct {
	// Path is where it was stored.
	Path string `json:"path"`
	// Marker is [IMAGE:<path>], to put in a message.
	Marker string `json:"marker"`
}

type ValidationWarning struct {
	// Code is stable, e.g. pre_existing_validation_error.
	Code string `json:"code"`
	// Message explains it.
	Message string `json:"message"`
	// Path is the field concerned.
	Path string `json:"path"`
}

type VersionCheck struct {
	// CurrentVersion is the running version.
	CurrentVersion string `json:"current_version"`
	// LatestVersion is the latest release (nil when the check failed).
	LatestVersion *string `json:"latest_version,omitempty"`
	// IsNewer is whether the latest is newer.
	IsNewer bool `json:"is_newer"`
	// ReleaseURL is the release page.
	ReleaseURL *string `json:"release_url,omitempty"`
	// ReleaseNotes are the release notes (Markdown).
	ReleaseNotes *string `json:"release_notes,omitempty"`
	// PublishedAt is the release date.
	PublishedAt *string `json:"published_at,omitempty"`
	// Error says why the check failed.
	Error *string `json:"error,omitempty"`
}

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

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

type WebhookOptions struct {
	// Agent is the agent to answer (the default agent when empty).
	Agent string
	// Secret is sent as X-Webhook-Secret, when the gateway sets
	// webhook_secret.
	Secret string
	// IdempotencyKey is sent as X-Idempotency-Key: a repeat within the
	// gateway's window is not run again.
	IdempotencyKey string
	// SessionID is sent as X-Session-Id: it keeps calls in one conversation
	// ([A-Za-z0-9._-], at most 128 characters).
	SessionID string
}

type WebhookReply struct {
	// Reply is the agent's reply; nil when Duplicate.
	Reply *AgentReply
	// Duplicate is whether the idempotency key was already used.
	Duplicate bool
}