api

type AddCommentRequest struct {
	// AnchorContent Plain-text snapshot of the selected range, used to re-anchor the comment after file edits. `None` if not provided.
	AnchorContent *string `json:"anchor_content,omitempty"`

	// Body The comment text.
	Body string `json:"body"`

	// EndIndex 0-based absolute character offset (exclusive) within the file where the anchor range ends.
	EndIndex int `json:"end_index"`

	// Path File path relative to workspace root, e.g. `"src/App.tsx"`.
	Path string `json:"path"`

	// StartIndex 0-based absolute character offset (inclusive) within the file where the anchor range begins.
	StartIndex int `json:"start_index"`
}

type AddCommentV1SessionsSessionIDCommentsPostJSONRequestBody = AddCommentRequest

type AgentObject struct {
	// Builtin Whether this is a server-*seeded* built-in agent (deterministic, name-derived id) as opposed to an operator/user-registered template (random id, e.g. via `omnigent server --agent`) or a session-scoped upload. The Web UI's new-session picker uses this to decide whether a same-named `omnigent run` upload may shadow the catalog entry: seeded built-ins are protected, while a user-registered template is superseded by a newer same-named upload. Always `False` for session-scoped agents.
	Builtin *bool `json:"builtin,omitempty"`

	// CreatedAt Unix epoch timestamp of creation.
	CreatedAt int `json:"created_at"`

	// Description Optional free-text description of the agent's purpose.
	Description *string `json:"description,omitempty"`

	// Harness The agent's harness/kind, e.g. `"codex"`, `"codex-native"`, or `"claude-native"` for `executor.type: omnigent` agents, otherwise the executor type (`"claude_sdk"`, `"agents_sdk"`). `None` when the bundle cannot be loaded. Lets the Web UI Add Agent picker recognise an agent's kind (Codex vs Claude) without hardcoding by name slug.
	Harness *string `json:"harness,omitempty"`

	// ID Unique agent identifier, e.g. `"ag_abc123"`.
	ID string `json:"id"`

	// MCPServers MCP servers the agent is connected to (secret fields omitted). Empty list when the spec declares no MCP servers or when the bundle cannot be loaded.
	MCPServers []MCPServerSummary `json:"mcp_servers,omitempty"`

	// MCPServersEditable Whether the MCP list can be edited through the session UI. Built-in template agents are read-only; session-scoped uploaded agents are editable.
	MCPServersEditable *bool `json:"mcp_servers_editable,omitempty"`

	// Name Human-readable agent name, e.g. `"research-agent"`.
	Name string `json:"name"`

	// Object Fixed resource type, always `"agent"`.
	Object *string `json:"object,omitempty"`

	// Policies Guardrails policies declared on the agent. Each entry summarises the policy name, type, and phases. Empty list when the spec declares no policies or when the bundle cannot be loaded.
	Policies []PolicySummary `json:"policies,omitempty"`

	// Skills Skills bundled in the agent spec (`skills/<dir>/SKILL.md`). Lets the Web UI's new-session composer offer a slash-command menu before a session (and its runner) exists. Host-discovered skills are runner-owned, so they are NOT listed here — the session snapshot's `skills` field carries the merged set once a runner is bound. Empty list when the spec bundles no skills or when the bundle cannot be loaded.
	Skills []SkillSummary `json:"skills,omitempty"`

	// Terminals Terminal names declared in the spec's `terminals:` block, in declaration order, e.g. `["shell"]`. The Web UI gates its "new terminal" affordance on this list (creation is only offered for agents with terminal access) and offers these names as the launchable choices. Empty list when the spec declares no terminals or when the bundle cannot be loaded.
	Terminals []string `json:"terminals,omitempty"`

	// UpdatedAt Unix epoch timestamp of the last update, or `None` if never updated.
	UpdatedAt *int `json:"updated_at,omitempty"`

	// Version Monotonic version counter. Starts at 1, incremented on each update.
	Version *int `json:"version,omitempty"`
}

type AutomaticSessionRenameRequest struct {
	Title string `json:"title"`
}

type AutomaticSessionRenameResponse struct {
	Reason  *string `json:"reason,omitempty"`
	Renamed bool    `json:"renamed"`
	Title   *string `json:"title,omitempty"`
}

type AutomaticallyRenameSessionV1SessionsSessionIDAutoTitlePostJSONRequestBody = AutomaticSessionRenameRequest

type BodyUpdateSessionAgentV1SessionsSessionIDAgentPut struct {
	Bundle openapi_types.File `json:"bundle"`
}

type BodyUploadSessionFileV1SessionsSessionIDResourcesFilesPost struct {
	File openapi_types.File `json:"file"`
}

type BrandingInfo struct {
	AppName   *string           `json:"app_name"`
	Heading   *string           `json:"heading"`
	Logos     BrandingLogosInfo `json:"logos"`
	PoweredBy bool              `json:"powered_by"`
}

type BrandingLogosInfo struct {
	Favicon *string `json:"favicon"`
	Loading *string `json:"loading"`
	Main    *string `json:"main"`
}

type BrowserActionRequestEvent struct {
	// Action The browser action to perform — the `browser_` tool name with the prefix stripped, e.g. `"navigate"`, `"snapshot"`, `"click"`, `"type"`, `"screenshot"`.
	Action string `json:"action"`

	// ActionID Unique correlation id for this request, e.g. `"baction_abc123"`. Echoed on the claim and result routes.
	ActionID string `json:"action_id"`

	// Args Action arguments forwarded from the tool call, e.g. `{"url": "https://example.com"}`.
	Args           map[string]interface{} `json:"args"`
	SequenceNumber *int                   `json:"sequence_number,omitempty"`

	// Type Always `"browser.action_request"`.
	Type string `json:"type"`
}

type CancelledEvent struct {
	// Response The final response object with `status="cancelled"`.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.cancelled"`.
	Type string `json:"type"`
}

type ChildSessionList struct {
	Data    []ChildSessionSummary `json:"data,omitempty"`
	FirstID *string               `json:"first_id,omitempty"`
	HasMore *bool                 `json:"has_more,omitempty"`
	LastID  *string               `json:"last_id,omitempty"`
	Object  *string               `json:"object,omitempty"`
}

type ChildSessionSummary struct {
	// AgentID Agent id recorded on the latest task, e.g. `"ag_abc123"`. `None` if the child has no tasks yet (rare — `_spawn_one` creates a task atomically with the conversation).
	AgentID *string `json:"agent_id,omitempty"`

	// AgentName Agent type recorded on the latest task, e.g. `"researcher"`. Mirrors the `tool` prefix in `title` and is provided alongside it because the title is a denormalized string while `agent_name` is the durable per-task value.
	AgentName *string `json:"agent_name,omitempty"`

	// Busy `True` when the child's session loop is live. Mirrors the algorithm used by `GET /v1/sessions/{id}` to compute `status`: read the live in-memory cache first (`"running"`/`"waiting"` → busy), and fall back to the latest task's status on cache miss (`"queued"` / `"in_progress"` → busy). For NO_DBOS sessions the tasks table is not populated during active runs, so the cache consult is what keeps the rail's "Working" badge correct.
	Busy *bool `json:"busy,omitempty"`

	// CreatedAt Unix epoch timestamp of child creation.
	CreatedAt int `json:"created_at"`

	// CurrentTaskID Latest task id for the child (newest by `created_at`), e.g. `"task_abc123"`. `None` if no tasks exist.
	CurrentTaskID *string `json:"current_task_id,omitempty"`

	// CurrentTaskStatus Status of the latest task, e.g. `"completed"`, `"in_progress"`, `"failed"`. `None` if no tasks exist.
	CurrentTaskStatus *string `json:"current_task_status,omitempty"`

	// ID Child conversation/session identifier, e.g. `"conv_child123"`.
	ID string `json:"id"`

	// Kind Conversation kind discriminator, always `"sub_agent"` for rows surfaced by this endpoint.
	Kind *string `json:"kind,omitempty"`

	// Labels Session-scoped guardrails labels on the child conversation (mirrors `ConversationObject.labels`).
	Labels map[string]string `json:"labels,omitempty"`

	// LastMessagePreview Single-line preview of the most recent message item in the child's conversation, truncated to ~150 chars with a trailing ellipsis when longer. `None` when the child has no message items yet (rare — the spawn tool immediately commits a user message). Lets the UI render a real-time "what's the sub-agent saying right now" line without fetching the child's full item history.
	LastMessagePreview *string `json:"last_message_preview,omitempty"`

	// LastTaskError Error details from the child's most recent failed run, e.g. `{"code": "required_terminal_exited", "message": "..."}`. `None` when the child has no durable failure detail. This is the typed projection of runner-owned failure labels; clients should not parse those labels directly.
	LastTaskError map[string]string `json:"last_task_error,omitempty"`

	// Object Fixed resource type, always `"child_session"`.
	Object *string `json:"object,omitempty"`

	// ParentSessionID Parent conversation id (echo of the route's `session_id` path parameter), e.g. `"conv_parent987"`. Stable join key for clients that cache child rows across multiple parents.
	ParentSessionID string `json:"parent_session_id"`

	// PendingElicitationsCount Number of approval / input prompts the child is currently blocked on, read from the server's `omnigent.runtime.pending_elicitations` index. `> 0` means the sub-agent is parked awaiting user input — the Agents rail renders an "awaiting input" badge so a fanned-out sub-agent that needs attention is visible without opening its chat. Mirrors `SessionListItem.pending_elicitations_count`.
	PendingElicitationsCount *int `json:"pending_elicitations_count,omitempty"`

	// RoutedModel Model this sub-agent runs on when one was pinned for it, e.g. `"databricks-claude-opus-4-8"`. Read from the child's `model_override` — the field intelligent routing writes when it picks a model for a spawned child. `None` when the child inherits the parent/spec model.
	RoutedModel *string `json:"routed_model,omitempty"`

	// RoutingDecisionID Identifier of the routing decision that produced `routed_model`, mirroring `RoutingDecisionData.decision_id`. Read from the child's `omnigent.routing.decision_id` label, stamped when routing pins the model. `None` when the child was not routed.
	RoutingDecisionID *string `json:"routing_decision_id,omitempty"`

	// SessionName Sub-agent instance name, the suffix of `title` after the first `":"`, e.g. `"auth"`. `None` if `title` is `None` or missing a colon.
	SessionName *string `json:"session_name,omitempty"`
	TaskSummary *string `json:"task_summary,omitempty"`

	// Title Sub-agent title, `"{agent_type}:{session_name}"` as written by `omnigent.tools.builtins.spawn._spawn_one`, e.g. `"researcher:auth"`. `None` only for legacy / malformed rows; the spawn path always sets it.
	Title *string `json:"title,omitempty"`

	// Tool UI-facing sub-agent label. For Omnigent-spawned children this is derived from the prefix of `title` before the first `":"`, e.g. `"researcher"`. For Codex-native children this is the Codex-assigned `agent_nickname` when available, then `agent_role`, then `"Codex"`. Falls back to the raw title for legacy / malformed rows; `None` only when `title` itself is `None` or empty.
	Tool *string `json:"tool,omitempty"`

	// UpdatedAt Unix epoch timestamp of the child's most recent update.
	UpdatedAt int `json:"updated_at"`
}

type ClearCodexGoalResponse struct {
	// Cleared `True` when Codex removed an existing goal; `False` when no goal was present.
	Cleared bool `json:"cleared"`
}

type ClientTaskCancelEvent struct {
	// CallID Synthetic `call_id` the SDK uses to reconcile the local task; `None` when no pending tool call row exists for the task.
	CallID         *string `json:"call_id,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// TaskID Identifier of the client-side task being cancelled, e.g. `"resp_async_abc"`.
	TaskID string `json:"task_id"`

	// Type Always `"response.client_task.cancel"`.
	Type string `json:"type"`
}

type CodexGoalObject struct {
	// CreatedAt Unix timestamp when the goal was created, e.g. `1776272400`. `None` when not provided by Codex.
	CreatedAt *int `json:"created_at,omitempty"`

	// Objective Goal objective text, e.g. `"Finish the migration and keep tests green"`.
	Objective string `json:"objective"`

	// Status Raw Codex goal lifecycle status, e.g. `"active"`.
	Status string `json:"status"`

	// ThreadID Codex app-server thread id, e.g. `"thr_123"`.
	ThreadID string `json:"thread_id"`

	// TimeUsedSeconds Wall-clock seconds spent on this goal, e.g. `60`.
	TimeUsedSeconds int `json:"time_used_seconds"`

	// TokenBudget Optional token budget, e.g. `40000`. `None` means no explicit budget is set.
	TokenBudget *int `json:"token_budget,omitempty"`

	// TokensUsed Tokens spent while pursuing this goal, e.g. `1024`.
	TokensUsed int `json:"tokens_used"`

	// UpdatedAt Unix timestamp when the goal was last updated, e.g. `1776272460`. `None` when not provided by Codex.
	UpdatedAt *int `json:"updated_at,omitempty"`
}

type CodexGoalResponse struct {
	// Goal Current goal state, or `None` when the session has no persisted Codex goal.
	Goal *CodexGoalObject `json:"goal"`
}

type CompactionCompletedEvent struct {
	CompactedMessages []map[string]interface{} `json:"compacted_messages,omitempty"`
	SequenceNumber    *int                     `json:"sequence_number,omitempty"`

	// Summary Text summary of the compacted conversation, or `None` for server-side compaction (already persisted).
	Summary *string `json:"summary,omitempty"`

	// SummaryModel Model used for summarization, or `None` if truncation-based or server-side.
	SummaryModel *string `json:"summary_model,omitempty"`

	// TotalTokens Tiktoken estimate of the post-compaction message context size, e.g. `8421`. Used by clients to update the context-ring immediately without waiting for the next `response.completed` usage report. `None` when token counting is unavailable.
	TotalTokens *int `json:"total_tokens,omitempty"`

	// Type Always `"response.compaction.completed"`.
	Type string `json:"type"`
}

type CompactionData struct {
	CompactedMessages []map[string]interface{} `json:"compacted_messages,omitempty"`

	// LastItemID The item ID (inclusive) of the last conversation item covered by this summary, e.g. `"msg_abc123"`. Items at positions <= this item are summarized and do not need to be loaded for prompt construction.
	LastItemID string `json:"last_item_id"`

	// Model The model used to generate the summary, e.g. `"openai/gpt-4o"`.
	Model *string `json:"model,omitempty"`

	// Summary The LLM-generated summary text covering all conversation items up through `last_item_id`, e.g. `"User asked to analyze a dataset. Agent loaded data.csv and computed statistics."`.
	Summary string `json:"summary"`

	// TokenCount Approximate token count of the summary text, for budget tracking, e.g. `342`.
	TokenCount int  `json:"token_count"`
	WindowID   *int `json:"window_id,omitempty"`
}

type CompactionFailedEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// Type Always `"response.compaction.failed"`.
	Type string `json:"type"`
}

type CompactionInProgressEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// Type Always `"response.compaction.in_progress"`.
	Type string `json:"type"`
}

type CompletedEvent struct {
	// Response The final response object with `status="completed"`.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.completed"`.
	Type string `json:"type"`
}

type ConversationDeleted struct {
	// Deleted Always `True`.
	Deleted *bool `json:"deleted,omitempty"`

	// ID ID of the deleted conversation, e.g. `"conv_abc123"`.
	ID string `json:"id"`

	// Object Fixed resource type, always `"conversation.deleted"`.
	Object *string `json:"object,omitempty"`
}

type ConversationItem struct {
	// CreatedAt Unix epoch timestamp of creation.
	CreatedAt int `json:"created_at"`

	// CreatedBy Identity of the human actor who authored this item, or `None` for agent/tool/system items and single-user mode. Lets owner and collaborator messages be distinguished.
	CreatedBy *string `json:"created_by,omitempty"`

	// Data The typed data payload (MessageData, etc.).
	Data json.RawMessage `json:"data"`

	// ID Store-assigned item ID, e.g. `"msg_abc123"`.
	ID string `json:"id"`

	// ResponseID The task/response ID this item belongs to.
	ResponseID string `json:"response_id"`

	// Status Item status, e.g. `"completed"`.
	Status string `json:"status"`

	// Type Item type, e.g. `"message"`, `"function_call"`.
	Type string `json:"type"`
}

type ConversationRef struct {
	// ID Conversation identifier, e.g. `"conv_abc123"`.
	ID string `json:"id"`
}

type CopyFilesRequest struct {
	// FileIds Non-empty, unique ids of the source-owned files to copy, e.g. `["file_abc123"]`.
	FileIds []string `json:"file_ids"`

	// SourceSessionID Session that owns the source files, e.g. `"conv_parent"`. Must be a strict ancestor of the destination.
	SourceSessionID string `json:"source_session_id"`
}

type CopySessionFilesV1SessionsSessionIDResourcesFilesCopyPostJSONRequestBody = CopyFilesRequest

type CreateDefaultPolicyRequest struct {
	// FactoryParams Optional dict of kwargs passed to the handler when it is a factory function. Only valid for `type="python"`, e.g. `{"limit": 10}`.
	FactoryParams map[string]interface{} `json:"factory_params,omitempty"`

	// Handler Dotted import path (python) or HTTPS URL (url), e.g. `"github_mcp_policy.block_non_misc_push"` or `"https://example.com/policies/eval"`.
	Handler string `json:"handler"`

	// Name Human-readable policy name. Must be globally unique, e.g. `"block_non_feature_branch_push"`.
	Name string `json:"name"`

	// Type Handler discriminator: `"python"`, `"url"`,
	Type string `json:"type"`
}

type CreateDirectoryRequest struct {
	// Path Absolute path of the directory to create on the host machine, e.g. `"/Users/corey/projects/new-app"`, or a tilde-prefixed path (`"~/scratch"`) the host expands against its own process owner. Missing parents are created.
	Path string `json:"path"`
}

type CreateHostDirectoryV1HostsHostIDDirectoriesPostJSONRequestBody = CreateDirectoryRequest

type CreateMcpServerV1SessionsSessionIDAgentMcpServersPostJSONRequestBody = UpsertMCPServerRequest

type CreatePolicyV1PoliciesPostJSONRequestBody = CreateDefaultPolicyRequest

type CreatePolicyV1SessionsSessionIDPoliciesPostJSONRequestBody = CreateSessionPolicyRequest

type CreateProjectRequest struct {
	// Config Optional default session settings (opaque JSON object). Omitted / empty stores no defaults.
	Config map[string]interface{} `json:"config,omitempty"`

	// Name Human-readable project name. Trimmed; must be non-empty and at most 100 characters; unique among the caller's projects.
	Name string `json:"name"`
}

type CreateProjectV1ProjectsPostJSONRequestBody = CreateProjectRequest

type CreateSessionPolicyRequest struct {
	// FactoryParams Optional dict of kwargs passed to the handler when it is a factory function. Only valid for `type="python"`, e.g. `{"limit": 10}`.
	FactoryParams map[string]interface{} `json:"factory_params,omitempty"`

	// Handler Dotted import path (python) or HTTPS URL (url), e.g. `"github_mcp_policy.block_non_misc_push"` or `"https://example.com/policies/eval"`.
	Handler string `json:"handler"`

	// Name Human-readable policy name. Must be unique within the session, e.g. `"block_non_feature_branch_push"`.
	Name string `json:"name"`

	// Type Handler discriminator: `"python"` or `"url"`.
	Type string `json:"type"`
}

type CreatedEvent struct {
	// Response The newly-allocated response object.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.created"`.
	Type string `json:"type"`
}

type DailyCost struct {
	CostUSD *float64 `json:"cost_usd,omitempty"`
	Day     string   `json:"day"`
}

type DeleteSessionV1SessionsSessionIDDeleteParams struct {
	// DeleteBranch Opt-in git cleanup, as a query param (`?delete_branch=true`). When `True` and the session has a server-created worktree (`git_branch` set), the host removes the worktree directory and deletes its branch (`git worktree remove --force` then `git branch -D`). Ignored for sessions with no worktree. Best-effort: a cleanup failure does not block the delete. Defaults to `False` (worktree and branch left untouched). See designs/SESSION_GIT_WORKTREE.md.
	DeleteBranch *bool `form:"delete_branch,omitempty" json:"delete_branch,omitempty"`
}

type ElicitationRequestEvent struct {
	// ElicitationID Unique correlation id for this request — appears in the consumer's approval event payload, e.g. `"elicit_abc123"`.
	ElicitationID string `json:"elicitation_id"`

	// Method MCP method literal — always `"elicitation/create"` (the value of `_MCP_ELICITATION_METHOD` in `omnigent/runtime/policies/approval.py`).
	Method *string `json:"method,omitempty"`

	// Params The MCP-shaped params block carrying the prompt and (form-mode only) the requested schema.
	Params         ElicitationRequestParams `json:"params"`
	SequenceNumber *int                     `json:"sequence_number,omitempty"`

	// Type Always `"response.elicitation_request"`.
	Type string `json:"type"`
}

type ElicitationRequestParams struct {
	// ContentPreview Truncated preview of the underlying request payload (≤1024 chars in current AP), for the consumer's renderer.
	ContentPreview *string `json:"content_preview,omitempty"`

	// Message Human-readable prompt the consumer renders, e.g. `"Approve running 'rm -rf /tmp/cache'?"`.
	Message string `json:"message"`

	// Mode MCP-standard discriminator. `"form"` collects structured input via `requestedSchema`; `"url"` directs upstream to an external URL for OAuth / out-of-band interaction.
	Mode *string `json:"mode,omitempty"`

	// Phase Omnigent policy-engine phase the elicitation belongs to, e.g. `"pre_tool_use"`.
	Phase *string `json:"phase,omitempty"`

	// PolicyName Omnigent policy that triggered the elicitation, e.g. `"approve_shell_commands"`.
	PolicyName *string `json:"policy_name,omitempty"`

	// RequestedSchema JSON-Schema dict for form mode (or `None` for url mode). camelCase preserved per MCP spec, e.g. `{"type": "object", "properties": {"approve": {"type": "boolean"}}}`.
	RequestedSchema map[string]interface{} `json:"requestedSchema,omitempty"`

	// TargetSessionID AP session whose resolve endpoint owns this elicitation, e.g. `"conv_child123"`. Present when a child/sub-agent prompt is mirrored into an ancestor stream; `None` means resolve against the current session.
	TargetSessionID *string `json:"target_session_id,omitempty"`

	// URL External URL for url mode (or `None` for form mode), e.g. `"https://oauth.example.com/authorize?..."`.
	URL                  *string                `json:"url,omitempty"`
	AdditionalProperties map[string]interface{} `json:"-"`
}

type ElicitationResolvedEvent struct {
	// ElicitationID Correlation id of the elicitation being cleared, e.g. `"elicit_abc123"`. Must match the id of a prior `ElicitationRequestEvent`.
	ElicitationID  string `json:"elicitation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"response.elicitation_resolved"`.
	Type string `json:"type"`
}

type ErrorData struct {
	// Code Stable error classifier, e.g. `"native_terminal_start_failed"`.
	Code string `json:"code"`

	// Message Human-readable error message, e.g. `"Native Codex requires the 'codex' CLI on PATH."`.
	Message string `json:"message"`

	// Source Error source, e.g. `"execution"`.
	Source string `json:"source"`
}

type ErrorDetail struct {
	// Cause Optional one/two-sentence explanation of why it failed. Paired with `title`.
	Cause *string `json:"cause,omitempty"`

	// Code Error code string, e.g. `"server_error"`, `"invalid_input"`.
	Code string `json:"code"`

	// Message Human-readable error description. Always populated; older clients render this verbatim.
	Message string `json:"message"`

	// Remediation Optional concrete next step to fix it, e.g. a command to run. `None` when there is no single clear fix.
	Remediation *string `json:"remediation,omitempty"`

	// Title Optional short headline naming what went wrong, e.g. `"Claude Code can't run as root"`. Present when the runner recognized the failure (see `omnigent.runner.launch_failure`); lets the UI show a clear card title instead of the raw `code`.
	Title *string `json:"title,omitempty"`
}

type ErrorEvent struct {
	// Error Classified error description.
	Error          RetryErrorDetail `json:"error"`
	SequenceNumber *int             `json:"sequence_number,omitempty"`

	// Source Origin of the error — `"llm"` for LLM-call failures, `"execution"` for timeouts, `"tool"` for tool failures (currently emitted by retry exhaustion paths).
	Source string `json:"source"`

	// ToolName Tool identifier when `source == "tool"`; `None` for the other sources.
	ToolName *string `json:"tool_name,omitempty"`

	// Type Always `"response.error"`.
	Type string `json:"type"`
}

type FailedEvent struct {
	// Response The final response object with `status="failed"` and `error` populated.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.failed"`.
	Type string `json:"type"`
}

type ForkSessionV1SessionsSourceIDForkPostJSONRequestBody = SessionForkRequest

type FunctionCallData struct {
	// Arguments JSON-encoded arguments string.
	Arguments string `json:"arguments"`

	// CallID Unique call identifier from the LLM, e.g. `"call_abc123"`.
	CallID string `json:"call_id"`
	Model  string `json:"model"`

	// Name Tool function name, e.g. `"search.web"`.
	Name string `json:"name"`
}

type FunctionCallOutputData struct {
	// CallID The call_id this output corresponds to, e.g. `"call_abc123"`.
	CallID string `json:"call_id"`

	// Output The tool's string result.
	Output string `json:"output"`
}

type GetSessionV1SessionsSessionIDGetParams struct {
	// IncludeItems When `False`, skip the committed-items read and return `items=[]`. The web chat surface passes `False` because it hydrates the transcript via the paginated `GET /sessions/{id}/items` endpoint in parallel and never reads the snapshot's copy; the items read is the single most expensive step of the snapshot build.
	IncludeItems *bool `form:"include_items,omitempty" json:"include_items,omitempty"`

	// IncludeLiveness When `False`, skip the runner/host liveness lookup and return `runner_online`/`host_online` as `None`. The web chat surface passes `False` because it sources liveness from the `/health` poll and the WS stream, not the snapshot.
	IncludeLiveness *bool `form:"include_liveness,omitempty" json:"include_liveness,omitempty"`

	// RefreshState When `True`, refresh runner-derived snapshot overlays from the live session instead of serving stale AP-process caches. Browser reload/bind requests use this to recover from fixed bugs without restarting the AP server.
	RefreshState *bool `form:"refresh_state,omitempty" json:"refresh_state,omitempty"`
}

type GrantPermissionRequest struct {
	// Level Numeric permission level: `1` = read, `2` = edit, `3` = manage.
	Level int `json:"level"`

	// UserID The user to grant access to, e.g. `"alice@example.com"` or `"__public__"` for public read access.
	UserID string `json:"user_id"`
}

type GrantPermissionV1SessionsSessionIDPermissionsPutJSONRequestBody = GrantPermissionRequest

type HTTPValidationError struct {
	Detail []ValidationError `json:"detail,omitempty"`
}

type HealthHealthGetParams struct {
	// SessionID Optional single session id, e.g. `"conv_abc123"`.
	SessionID *string `form:"session_id,omitempty" json:"session_id,omitempty"`

	// SessionIds Optional comma-separated session ids for batch lookup, e.g. `"conv_abc,conv_def,conv_ghi"`.
	SessionIds *string `form:"session_ids,omitempty" json:"session_ids,omitempty"`
}

type HeartbeatEvent struct {
	// LastEventSeq Sequence number of the last non- heartbeat event seen on the same stream, e.g. `42`. `None` before any user-visible event has fired (first heartbeat of the turn, before deltas land), or when the producer chose not to populate it.
	LastEventSeq   *int `json:"last_event_seq,omitempty"`
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// ServerTime ISO 8601 UTC timestamp at emission, e.g. `"2026-04-27T15:30:00Z"`. `None` when the producer chose not to populate it (legacy emitters).
	ServerTime *string `json:"server_time,omitempty"`

	// Type Always `"response.heartbeat"`.
	Type string `json:"type"`
}

type ImportItemInput struct {
	Data       map[string]interface{} `json:"data"`
	ResponseID string                 `json:"response_id"`
	Type       string                 `json:"type"`
}

type ImportSessionRequest struct {
	ExternalSessionID string            `json:"external_session_id"`
	Force             *bool             `json:"force,omitempty"`
	Items             []ImportItemInput `json:"items"`
	Source            string            `json:"source"`
	Workspace         *string           `json:"workspace,omitempty"`
}

type ImportSessionResponse struct {
	ItemCount int    `json:"item_count"`
	SessionID string `json:"session_id"`
	Status    string `json:"status"`
}

type ImportSessionV1ImportsPostJSONRequestBody = ImportSessionRequest

type InProgressEvent struct {
	// Response The response object with `status="in_progress"`.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.in_progress"`.
	Type string `json:"type"`
}

type IncompleteDetails struct {
	// Reason Reason the response stopped early, e.g. `"max_output_tokens"`, `"max_tool_calls"`.
	Reason string `json:"reason"`
}

type IncompleteEvent struct {
	// Response The final response object with `status="incomplete"` and `incomplete_details` populated describing the reason.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.incomplete"`.
	Type string `json:"type"`
}

type LaunchRunnerRequest struct {
	// Git Optional git worktree options. In create mode the server creates a worktree for a new branch off `workspace` on the host and binds the runner to it (the fork-resume path; mirrors `POST /v1/sessions`). In bind mode (`existing_worktree=True`) `workspace` already IS a worktree — no worktree is created; `branch_name` is recorded as the session's `git_branch` for display and opt-in cleanup. `None` binds `workspace` directly. `host_id` is always present (it is in the path), so no host check is needed here.
	Git *SessionGitOptions `json:"git,omitempty"`

	// SessionID Session to bind the new runner to, e.g. `"conv_abc123"`.
	SessionID string `json:"session_id"`

	// Workspace Absolute path on the host machine to use as the runner's working directory, e.g. `"/Users/corey/projects/frontend"`. When `git` is set, this is interpreted as the source repository directory and the runner starts in the created worktree instead.
	Workspace string `json:"workspace"`
}

type LaunchRunnerV1HostsHostIDRunnersPostJSONRequestBody = LaunchRunnerRequest

type ListBuiltinAgentsV1AgentsGetParams struct {
	// Limit Maximum number of agents to return (1-1000).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor — return agents after this id.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor — return agents before this id.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort order, `"asc"` or `"desc"`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`
}

type ListChildSessionsV1SessionsSessionIDChildSessionsGetParams struct {
	// Limit Maximum number of children to return (1-1000, default 20 — sub-agent fan-out is typically sparse compared to conversation items).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor — return children whose id appears after this one in sort order, e.g. `"conv_child123"`.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor — return children before this one.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort direction, `"desc"` (newest-first, default) or `"asc"`. Sort column is `created_at`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`

	// Tool When set, only return children whose title starts with this agent type (the segment before the `":"`). Combined with `session_name` to form the exact title `"{tool}:{session_name}"` for server-side filtering.
	Tool *string `form:"tool,omitempty" json:"tool,omitempty"`

	// SessionName When set alongside `tool`, only return children whose title matches `"{tool}:{session_name}"` exactly.
	SessionName *string `form:"session_name,omitempty" json:"session_name,omitempty"`
}

type ListCommentsV1SessionsSessionIDCommentsGetParams struct {
	// Path When provided, only return comments for this file, e.g. `"src/App.tsx"`.
	Path *string `form:"path,omitempty" json:"path,omitempty"`
}

type ListEnvironmentRootV1SessionsSessionIDResourcesEnvironmentsEnvironmentIDFilesystemGetParams struct {
	// Limit Maximum number of entries to return (1-1000, default 20).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor entry id for forward pagination.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor entry id for backward pagination.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort order, `"asc"` or `"desc"`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`
}

type ListHostFilesystemRootV1HostsHostIDFilesystemGetParams struct {
	// Limit Max entries per page.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Optional forward pagination cursor (entry path), e.g. `"/Users/corey/projects/m"`.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Optional backward pagination cursor.
	Before *string `form:"before,omitempty" json:"before,omitempty"`
}

type ListHostFilesystemV1HostsHostIDFilesystemPathGetParams struct {
	// Limit Max entries per page.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Optional forward pagination cursor.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Optional backward pagination cursor.
	Before *string `form:"before,omitempty" json:"before,omitempty"`
}

type ListHostWorktreesV1HostsHostIDWorktreesGetParams struct {
	// Path Absolute path inside the repo on the host to list worktrees for, e.g. `"/Users/alice/myrepo"`.
	Path string `form:"path" json:"path"`
}

type ListPermissionsV1SessionsSessionIDPermissionsGetParams struct {
	// Limit Max grants to return (1–1000, default 100).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor: user_id to start after
	After *string `form:"after,omitempty" json:"after,omitempty"`
}

type ListSessionFilesV1SessionsSessionIDResourcesFilesGetParams struct {
	// Limit Maximum number of files to return.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor file ID for forward pagination.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor file ID for backward pagination.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort direction, `"desc"` or `"asc"`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`
}

type ListSessionItemsV1SessionsSessionIDItemsGetParams struct {
	// Limit Maximum number of items to return (1-1000, default 100).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor — return items after this item ID, e.g. `"msg_abc123"`.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor — return items before this item ID.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort order, `"asc"` (chronological, default) or `"desc"`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`
}

type ListSessionResourcesV1SessionsSessionIDResourcesGetParams struct {
	// Type Optional resource-type filter, e.g. `"environment"` / `"terminal"` / `"file"`. Forwarded to the runner (its registry applies it) and honored by the local-registry fallback and the file-store merge below.
	Type *string `form:"type,omitempty" json:"type,omitempty"`
}

type ListSessionsV1SessionsGetParams struct {
	// Limit Maximum number of sessions to return (1-1000, default 20).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor — return sessions after this session ID in sort order, e.g. `"conv_abc123"`.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor — return sessions before this session ID.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// AgentID When set, only return sessions bound to this agent, e.g. `"ag_abc123"`. `None` returns sessions across all agents.
	AgentID *string `form:"agent_id,omitempty" json:"agent_id,omitempty"`

	// AgentName When set, only return sessions whose bound agent row has this name. This intentionally includes session-scoped agents that share a name but have distinct bundles. `None` disables the filter.
	AgentName *string `form:"agent_name,omitempty" json:"agent_name,omitempty"`

	// Order Sort direction, `"desc"` (newest-first) or `"asc"` (oldest-first).
	Order *string `form:"order,omitempty" json:"order,omitempty"`

	// SortBy Column to sort on, `"created_at"` or `"updated_at"`.
	SortBy *string `form:"sort_by,omitempty" json:"sort_by,omitempty"`

	// SearchQuery Case-insensitive substring filter on the session title or conversation content. `None` or empty string disables the filter. A session matches if its title contains the query or any of its conversation items' text does. Powers the sidebar's session search.
	SearchQuery *string `form:"search_query,omitempty" json:"search_query,omitempty"`

	// IncludeArchived When `False` (default), archived sessions are omitted. When `True`, archived sessions are returned alongside active ones (the sidebar groups them into an "Archived" section). Powers the sidebar's "Show archived" toggle.
	IncludeArchived *bool `form:"include_archived,omitempty" json:"include_archived,omitempty"`

	// Kind Conversation kind to return. `"default"` (the default) returns only top-level user-initiated sessions — the sidebar's view. `"sub_agent"` returns only sub-agent child sessions. `"any"` returns both; this lets the new-session agent picker discover agents that are only bound to sub-agent sessions (e.g. ones uploaded via `sys_session_create`).
	Kind    *string `form:"kind,omitempty" json:"kind,omitempty"`
	Project *string `form:"project,omitempty" json:"project,omitempty"`

	// Pinned When `True`, return only sessions the user has pinned (the `omnigent.pinned` label). Lets the sidebar enumerate pinned sessions that fall outside the loaded pagination window. `False` (default) disables it.
	Pinned *bool `form:"pinned,omitempty" json:"pinned,omitempty"`
}

type MCPServerStartup struct {
	// Error Failure detail when `status == "failed"`, e.g. `"handshaking with MCP server failed"`. `None` otherwise.
	Error *string `json:"error,omitempty"`

	// Status Latest startup state reported by the harness, mirroring Codex's `McpServerStartupState` enum.
	Status string `json:"status"`
}

type MCPServerSummary struct {
	// Args Command-line arguments for `transport="stdio"` servers, e.g. `["mcp-server-github"]`. Empty list when unset.
	Args []string `json:"args,omitempty"`

	// Command Executable path for `transport="stdio"` servers, e.g. `"uvx"`. `None` for http servers.
	Command *string `json:"command,omitempty"`

	// Description Optional free-text description from the spec, e.g. `"GitHub MCP server"`. `None` when unset.
	Description *string `json:"description,omitempty"`

	// Headers HTTP headers for `transport="http"` servers. Values are always `"[REDACTED]"`; only the key names are exposed.
	Headers map[string]string `json:"headers,omitempty"`

	// Name Server name as declared in the agent spec, e.g. `"github"`.
	Name string `json:"name"`

	// Transport Transport type — `"stdio"` or `"http"`.
	Transport string `json:"transport"`

	// URL HTTP(S) endpoint URL for `transport="http"` servers, e.g. `"https://mcp.example.com/sse"`. `None` for stdio servers.
	URL *string `json:"url,omitempty"`
}

type MessageData struct {
	// Content Heterogeneous content blocks, e.g. `[{"type": "input_text", "text": "Hello"}]`.
	Content []map[string]interface{} `json:"content"`

	// Interrupted `True` when an assistant message is a durable partial response from an interrupted external-native turn, e.g. Codex `turn/completed` with status `"interrupted"`. Defaults to `False` and is omitted from serialized payloads in that case.
	Interrupted *bool `json:"interrupted,omitempty"`

	// IsMeta `True` for durable context that must be replayed to agents but hidden from user-facing transcripts, e.g. injected skill instructions. Defaults to `False` and is omitted from serialized payloads in that case.
	IsMeta *bool   `json:"is_meta,omitempty"`
	Model  *string `json:"model,omitempty"`

	// Role `"user"` or `"assistant"`.
	Role string `json:"role"`
}

type MintRunnerOwnerTokenV1RunnersRunnerIDTokenPost200JSONResponseBody0 = string

type MintRunnerOwnerTokenV1RunnersRunnerIDTokenPost200JSONResponseBody1 = int

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

type ModelUsage struct {
	// CacheCreationInputTokens Cumulative tokens written to the prompt cache, e.g. `2000`. `None` when not recorded.
	CacheCreationInputTokens *int `json:"cache_creation_input_tokens,omitempty"`

	// CacheReadInputTokens Cumulative tokens read from the prompt cache, e.g. `8000`. `None` when not recorded.
	CacheReadInputTokens *int `json:"cache_read_input_tokens,omitempty"`

	// InputTokens Cumulative non-cached input (prompt) tokens for this model over the subtree, e.g. `12000`. `None` when not recorded.
	InputTokens *int `json:"input_tokens,omitempty"`

	// OutputTokens Cumulative output (completion) tokens, e.g. `3400`. `None` when not recorded.
	OutputTokens *int `json:"output_tokens,omitempty"`

	// TotalCostUSD Cumulative USD spend attributed to this model, e.g. `0.42`. Present **only when this model's turns were priced** (same "priced ⟺ key present" contract as the session total); `None` when the model is unpriced, so the sum of priced per-model costs equals the session `total_cost_usd`.
	TotalCostUSD *float64 `json:"total_cost_usd,omitempty"`

	// TotalTokens Cumulative total tokens (counts cache buckets too, as the harness reports), e.g. `15400`. `None` when not recorded.
	TotalTokens *int `json:"total_tokens,omitempty"`
}

type NativeModelOption struct {
	DefaultReasoningEffort    *string                       `json:"defaultReasoningEffort,omitempty"`
	DisplayName               *string                       `json:"displayName,omitempty"`
	ID                        string                        `json:"id"`
	IsDefault                 *bool                         `json:"isDefault,omitempty"`
	Model                     *string                       `json:"model,omitempty"`
	SupportedReasoningEfforts []NativeReasoningEffortOption `json:"supportedReasoningEfforts,omitempty"`
}

type NativeReasoningEffortOption struct {
	Description     *string `json:"description,omitempty"`
	ReasoningEffort string  `json:"reasoningEffort"`
}

type NativeToolData struct {
	// Item The raw dict from the Responses API output, e.g. `{"type": "web_search_call", "id": "ws_abc", "status": "completed", "action": {...}}`.
	Item map[string]interface{} `json:"item"`
}

type OutputFileDoneEvent struct {
	// ContentType MIME content type if the annotation supplied one, e.g. `"application/pdf"`. `None` otherwise.
	ContentType *string `json:"content_type,omitempty"`

	// FileID Identifier of the materialized file, e.g. `"file_abc123"`.
	FileID string `json:"file_id"`

	// Filename Original filename if the annotation supplied one, e.g. `"report.pdf"`. `None` otherwise.
	Filename       *string `json:"filename,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// Type Always `"response.output_file.done"`.
	Type string `json:"type"`
}

type OutputItemDoneEvent struct {
	// Item The completed item dict. Heterogeneous and item-type-specific; see `omnigent/entities/conversation.py` for the per-type `*Data` shapes that drive serialization. Example for a function_call item: `{"id": "fc_abc123", "type": "function_call", "status": "action_required", "name": "search.web", "arguments": "{\"q\": \"foo\"}", "call_id": "call_xyz"}`.
	Item           map[string]interface{} `json:"item"`
	SequenceNumber *int                   `json:"sequence_number,omitempty"`

	// Type Always `"response.output_item.done"`.
	Type string `json:"type"`
}

type OutputTextDeltaEvent struct {
	// Delta The text fragment for this chunk, e.g. `"Hello"`.
	Delta string `json:"delta"`

	// Final Optional provider completion marker for the message.
	Final *bool `json:"final,omitempty"`

	// Index 0-based chunk order within the message, e.g. `3`. Used to suppress repeated chunks; `None` for in-process streaming.
	Index *int `json:"index,omitempty"`

	// MessageID For native terminal streaming, the provider's stable per-message id, e.g. `"2ca51d97-2f0f-493a-aed7-85a5b56c5747"`. `None` for ordinary in-process task streaming, where deltas group by the active response.
	MessageID      *string `json:"message_id,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// Type Always `"response.output_text.delta"`.
	Type string `json:"type"`
}

type PaginatedList struct {
	// Data Page of results. Items are heterogeneous (`ResponseObject`, `ConversationObject`, `FileObject`, or dicts) and list is invariant, so no single concrete type satisfies all callers.
	Data []interface{} `json:"data,omitempty"`

	// FirstID ID of the first item in the page, or `None` if the page is empty, e.g. `"resp_abc123"`.
	FirstID *string `json:"first_id,omitempty"`

	// HasMore Whether more items exist beyond this page.
	HasMore *bool `json:"has_more,omitempty"`

	// LastID ID of the last item in the page, or `None` if the page is empty, e.g. `"resp_xyz789"`.
	LastID *string `json:"last_id,omitempty"`

	// Object Fixed resource type, always `"list"`.
	Object *string `json:"object,omitempty"`
}

type PermissionObject struct {
	// ConversationID The session, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Level Numeric permission level (1=read, 2=edit, 3=manage).
	Level int `json:"level"`

	// UserID The grantee, e.g. `"alice@example.com"`.
	UserID string `json:"user_id"`
}

type PolicyDeniedEvent struct {
	// ConversationID Session/conversation id the DENY applies to, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Phase The policy phase the DENY landed on, e.g. `"tool_call"`.
	Phase *string `json:"phase,omitempty"`

	// Reason Human-readable deny reason from the deciding policy, e.g. `"Blocked by policy."`.
	Reason         *string `json:"reason,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// Type Always `"response.policy_denied"`.
	Type string `json:"type"`
}

type PolicySummary struct {
	// Description Short detail string about the policy implementation. For function policies: the callable dotted path. For prompt policies: the first line of the prompt. `None` when not available.
	Description *string `json:"description,omitempty"`

	// Name Policy name as declared in the agent spec, e.g. `"block_long_sleep"`.
	Name string `json:"name"`

	// On List of phase selectors the policy fires on, e.g. `["tool_call"]` or `["request", "response"]`.
	On []string `json:"on"`

	// Type Policy type discriminator — `"function"` or `"prompt"`.
	Type string `json:"type"`
}

type PresenceViewer struct {
	// Idle Whether every stream the user holds reports an idle (backgrounded) tab. The web greys idle viewers' avatars.
	Idle *bool `json:"idle,omitempty"`

	// JoinedAt ISO 8601 UTC timestamp of when the user joined, e.g. `"2026-06-10T17:00:00Z"`. Stable across reconnects within the server's leave-grace window.
	JoinedAt string `json:"joined_at"`

	// UserID The viewer's authenticated identity, e.g. `"alice@example.com"`. Never the reserved single-user `"local"` sentinel — presence only tracks distinct human actors (see `attribution_user`).
	UserID string `json:"user_id"`
}

type PutReadStateV1SessionsSessionIDReadStatePutJSONRequestBody = ReadStatePutRequest

type QueuedEvent struct {
	// Response The response object with `status="queued"`.
	Response       ResponseObject `json:"response"`
	SequenceNumber *int           `json:"sequence_number,omitempty"`

	// Type Always `"response.queued"`.
	Type string `json:"type"`
}

type ReadOrListEnvironmentPathV1SessionsSessionIDResourcesEnvironmentsEnvironmentIDFilesystemRelativePathGetParams struct {
	// Limit Maximum number of entries to return for directory listings (1-1000, default 20). Ignored for file reads.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// After Cursor entry id for forward pagination.
	After *string `form:"after,omitempty" json:"after,omitempty"`

	// Before Cursor entry id for backward pagination.
	Before *string `form:"before,omitempty" json:"before,omitempty"`

	// Order Sort order, `"asc"` or `"desc"`.
	Order *string `form:"order,omitempty" json:"order,omitempty"`
}

type ReadStatePutRequest struct {
	// LastSeen Wall-clock baseline in seconds, e.g. `1717000000`. Marking seen sets this to "now"; marking unread pins it to `updated_at - 1` so the row reads unseen.
	LastSeen int `json:"last_seen"`

	// Unread Whether this session is explicitly flagged unread for the caller.
	Unread bool `json:"unread"`
}

type ReasoningData struct {
	// Content Raw reasoning content blocks, or `None` if redacted.
	Content []map[string]string `json:"content,omitempty"`

	// EncryptedContent Encrypted reasoning content, or `None`.
	EncryptedContent *string `json:"encrypted_content,omitempty"`
	Model            string  `json:"model"`

	// Summary Summary text blocks, e.g. `[{"type": "summary_text", "text": "..."}]`.
	Summary []map[string]string `json:"summary"`
}

type ReasoningStartedEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// Type Always `"response.reasoning.started"`.
	Type string `json:"type"`
}

type ReasoningSummaryTextDeltaEvent struct {
	// Delta The summary text fragment, e.g. `"Will use the search tool to gather context."`.
	Delta          string `json:"delta"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"response.reasoning_summary_text.delta"`.
	Type string `json:"type"`
}

type ReasoningTextDeltaEvent struct {
	// Delta The reasoning text fragment, e.g. `"Considering the user's intent..."`.
	Delta          string `json:"delta"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"response.reasoning_text.delta"`.
	Type string `json:"type"`
}

type ResourceEventData struct {
	// EventType The SSE event type literal, e.g. `"session.resource.created"` or `"session.resource.deleted"`.
	EventType string `json:"event_type"`

	// Resource Full resource object dict for `created` events. `None` for `deleted` events.
	Resource map[string]interface{} `json:"resource,omitempty"`

	// ResourceID Opaque id of the affected resource, e.g. `"terminal_bash_s1"` or `"file_abc123"`.
	ResourceID string `json:"resource_id"`

	// ResourceType Kind of resource, e.g. `"terminal"`, `"file"`, `"environment"`.
	ResourceType string `json:"resource_type"`
}

type ResponseObject struct {
	// Background Whether this response was created as a background task.
	Background *bool `json:"background,omitempty"`

	// CompletedAt Unix epoch timestamp of completion, or `None` if not yet complete.
	CompletedAt *int `json:"completed_at,omitempty"`

	// Conversation Reference to the owning conversation.
	Conversation *ConversationRef `json:"conversation,omitempty"`

	// CreatedAt Unix epoch timestamp of creation.
	CreatedAt int `json:"created_at"`

	// Error Error details if the response failed.
	Error *ErrorDetail `json:"error,omitempty"`

	// ID Unique response identifier, e.g. `"resp_abc123"`.
	ID string `json:"id"`

	// IncompleteDetails Details if the response is incomplete (e.g. hit token limit).
	IncompleteDetails *IncompleteDetails `json:"incomplete_details,omitempty"`

	// Instructions Per-request system instructions override, or `None`.
	Instructions *string `json:"instructions,omitempty"`

	// Model Agent name that produced this response, e.g. `"research-agent"`.
	Model string `json:"model"`

	// Object Fixed resource type, always `"response"`.
	Object *string `json:"object,omitempty"`

	// Output Heterogeneous output items (messages, reasoning, function_calls) serialized as dicts; shape varies by item type. Empty for non-completed responses.
	Output []map[string]interface{} `json:"output,omitempty"`

	// PreviousResponseID ID of the prior response in the conversation thread, or `None` for the first turn.
	PreviousResponseID *string `json:"previous_response_id,omitempty"`

	// Reasoning Reasoning configuration, e.g. `{"effort": "medium"}`.
	Reasoning map[string]string `json:"reasoning,omitempty"`

	// Status Lifecycle status, one of `"queued"`, `"in_progress"`, `"completed"`, `"failed"`, `"incomplete"`, `"cancelled"`.
	Status string `json:"status"`

	// Store Whether this response is persisted. Always `True`.
	Store *bool `json:"store,omitempty"`

	// Usage Token usage statistics, or `None` if not yet available.
	Usage *Usage `json:"usage,omitempty"`
}

type RetryErrorDetail struct {
	// Code Stable error classifier, e.g. `"timeout"`, `"rate_limit"`.
	Code string `json:"code"`

	// Detail Optional provider-specific structured fields (e.g. `{"status_code": 429, "retry_after": 5}`); `None` when the classifier had no extra context.
	Detail map[string]interface{} `json:"detail,omitempty"`

	// Message Human-readable summary, e.g. `"Connection timed out after 30s"`.
	Message string `json:"message"`
}

type RetryEvent struct {
	// Attempt 1-based count of the upcoming attempt (i.e. attempt that will run AFTER this delay), e.g. `2` for the first retry.
	Attempt int `json:"attempt"`

	// DelaySeconds Seconds the producer will sleep before retrying, rounded to two decimals, e.g. `1.5`.
	DelaySeconds float64 `json:"delay_seconds"`

	// Error Classified error description for the failure being retried.
	Error RetryErrorDetail `json:"error"`

	// MaxAttempts Total tries allowed by the retry policy, e.g. `3`. Lets clients render "attempt 2 of 3".
	MaxAttempts    int  `json:"max_attempts"`
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// Source Origin of the retried failure — `"llm"` for LLM-call retries, `"tool"` for tool-call retries.
	Source string `json:"source"`

	// ToolName Tool identifier when `source == "tool"`, e.g. `"search.web"`. `None` for LLM retries.
	ToolName *string `json:"tool_name,omitempty"`

	// Type Always `"response.retry"`.
	Type string `json:"type"`
}

type RoutingDecisionData struct {
	Agent *string `json:"agent,omitempty"`

	// Applied `True` when the brain actually ran on `model` this turn (optimize mode, no user pin); `False` when the router only WOULD have picked it (advise/shadow mode, or a user model pin won) — the UI renders "would have picked".
	Applied bool `json:"applied"`

	// AttemptedOverride Model the spawning agent asked for and the router overrode, e.g. `"databricks-gpt-5-5"` — an LLM-supplied `args.model` on a child session, or a native spawn's own `requested_model`. `None` when nothing was asked for, or when the router's pick names the same arm as the ask.
	AttemptedOverride *string `json:"attempted_override,omitempty"`

	// DecisionID Router decision identifier, e.g. `"3f1c…"`. Correlates the transcript item with the routing telemetry event and the child-sessions API row. `None` for decisions made before decision ids existed.
	DecisionID *string `json:"decision_id,omitempty"`

	// Harness Harness the decision applies to, e.g. `"claude-native"` or `"codex"`. `None` when the decision picked a model only (no harness dimension).
	Harness *string `json:"harness,omitempty"`

	// Model The concrete brain model the router chose, e.g. `"databricks-claude-opus-4-8"`.
	Model string `json:"model"`

	// Rationale The router's one-line explanation, shown as muted secondary text, e.g. `"Multi-file refactor needs deep reasoning."`.
	Rationale string `json:"rationale"`

	// RawModel The router-vocabulary pick before resolution to a servable catalog id, e.g. `"gpt-5-6-sol"`. `None` when the pick needed no resolution.
	RawModel *string `json:"raw_model,omitempty"`

	// RouterSource Which router produced the decision — `"databricks-aigw"` for the external AI-Gateway `task_v1` service, `"oss-llm"` for the built-in judge. Deliberately a plain `str` rather than a `Literal`: a source added later must still round-trip through stored rows and the wire instead of failing validation. `None` on rows written before the field existed.
	RouterSource *string `json:"router_source,omitempty"`

	// Scope What the decision governs — `"session"` (auto-harness session routing), `"turn"` (per-turn routing), `"child_session"` (an Omnigent-spawned sub-agent) or `"native_subagent"` (a Task / `spawn_agent` spawn routed inside the harness). Defaults to `"turn"` so rows persisted before this field deserialize.
	Scope *string `json:"scope,omitempty"`
}

type RunnerStatusV1RunnersRunnerIDStatusGet200JSONResponseBody0 = string

type RunnerStatusV1RunnersRunnerIDStatusGet200JSONResponseBody1 = bool

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

type SandboxStatus struct {
	// Error Failure detail when `stage == "failed"`, e.g. `"managed sandbox launch failed: spend limit reached"`. `None` otherwise.
	Error *string `json:"error,omitempty"`

	// Stage Current launch stage, e.g. `"provisioning"` — one of `SandboxLaunchStage`, in pipeline order: `provisioning` (creating the sandbox) → `cloning` (cloning the repository workspace; skipped when the session has none) → `starting` (starting the in-sandbox host) → `connecting` (launching the agent runner) → `ready` / `failed`.
	Stage string `json:"stage"`
}

type SearchEnvironmentFilesUnderV1SessionsSessionIDResourcesEnvironmentsEnvironmentIDSearchPathGetParams struct {
	// Q Case-insensitive search substring.
	Q string `form:"q" json:"q"`

	// Include Comma-separated include globs.
	Include *string `form:"include,omitempty" json:"include,omitempty"`

	// Exclude Comma-separated exclude globs.
	Exclude *string `form:"exclude,omitempty" json:"exclude,omitempty"`

	// Limit Maximum number of results (1-500, default 500).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}

type SearchEnvironmentFilesV1SessionsSessionIDResourcesEnvironmentsEnvironmentIDSearchGetParams struct {
	// Q Case-insensitive search substring, e.g. `"test.md"`. Must contain at least one non-whitespace character.
	Q string `form:"q" json:"q"`

	// Include Comma-separated glob patterns scoping which files are returned, e.g. `"*.ts,src/**"`.
	Include *string `form:"include,omitempty" json:"include,omitempty"`

	// Exclude Comma-separated glob patterns for files to drop, e.g. `"**/node_modules,*.test.ts"`.
	Exclude *string `form:"exclude,omitempty" json:"exclude,omitempty"`

	// Limit Maximum number of results (1-500, default 500).
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`
}

type SendCommentsRequest struct {
	// CommentIds IDs of comments to send.
	CommentIds []string `json:"comment_ids"`

	// Instruction Optional custom instruction prefix; defaults to the standard "Please address the following file review comments." header.
	Instruction *string `json:"instruction,omitempty"`
}

type SendToAgentV1SessionsSessionIDCommentsSendPostJSONRequestBody = SendCommentsRequest

type ServerInfoResponse struct {
	AccountsEnabled         bool                    `json:"accounts_enabled"`
	Branding                BrandingInfo            `json:"branding"`
	DatabricksFeatures      bool                    `json:"databricks_features"`
	DictationAvailable      bool                    `json:"dictation_available"`
	Features                map[string]bool         `json:"features"`
	HarnessInstallEnabled   bool                    `json:"harness_install_enabled"`
	InstallableHarnesses    []string                `json:"installable_harnesses"`
	LoginURL                *string                 `json:"login_url"`
	ManagedSandboxesEnabled bool                    `json:"managed_sandboxes_enabled"`
	NeedsSetup              bool                    `json:"needs_setup"`
	PublicSharingEnabled    bool                    `json:"public_sharing_enabled"`
	SandboxProvider         *string                 `json:"sandbox_provider"`
	SandboxProviders        []string                `json:"sandbox_providers"`
	ServerVersion           string                  `json:"server_version"`
	SharingMode             string                  `json:"sharing_mode"`
	SingleUser              bool                    `json:"single_user"`
	SmartRoutingEnabled     bool                    `json:"smart_routing_enabled"`
	SmartRoutingSources     SmartRoutingSourcesInfo `json:"smart_routing_sources"`
}

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

type SessionAgentChangedEvent struct {
	// AgentID The session-scoped clone now bound to the session, e.g. `"ag_abc123"`.
	AgentID string `json:"agent_id"`

	// AgentName Display name of the agent the session now runs, e.g. `"claude-native-ui"`. Deliberately the clean target-agent name — not the clone row's `"… (switch ag_…)"` disambiguation name — because clients render it verbatim. Category: **transient** (SSE-only). The switch is persisted on the conversation row, so on reconnect clients read the new binding from the session snapshot rather than from a replayed event.
	AgentName string `json:"agent_name"`

	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.agent_changed"`.
	Type string `json:"type"`
}

type SessionChangedFilesInvalidatedEvent struct {
	// EnvironmentID Environment whose changes were invalidated, e.g. `"default"`.
	EnvironmentID  *string `json:"environment_id,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// SessionID Owning session/conversation id.
	SessionID string `json:"session_id"`

	// Type Always `"session.changed_files.invalidated"`.
	Type string `json:"type"`
}

type SessionChildSessionUpdatedEvent struct {
	// Child A PARTIAL `ChildSessionSummary` — the snapshot-on-connect sends the full summary, while live runner deltas carry only the fields that changed (a status delta omits `last_message_preview`; a preview delta carries only it). The web merges present fields over the cached row, so the payload is an open dict rather than the strict model.
	Child map[string]interface{} `json:"child"`

	// ChildSessionID The child session id, e.g. `"conv_child_abc123"`.
	ChildSessionID string `json:"child_session_id"`

	// ConversationID The PARENT (carrier) session id.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.child_session.updated"`.
	Type string `json:"type"`
}

type SessionCollaborationModeEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Mode The active collaboration mode string, e.g. `"plan"` or `"default"`. Category: **transient** (SSE-only). The server also writes `omnigent.codex_native.collaboration_mode` on the conversation labels, so reconnect clients restore the same state from the session snapshot.
	Mode           string `json:"mode"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.collaboration_mode"`.
	Type string `json:"type"`
}

type SessionCreatedEvent struct {
	// AgentID Registered agent id the child runs as, e.g. `"agent_xyz"`. `None` is permitted only for legacy spawn paths that did not record an agent id; new code MUST set it.
	AgentID *string `json:"agent_id,omitempty"`

	// ChildSessionID The newly-created child session id, e.g. `"conv_child456"`. Same as `conversation_id` on the child's own stream when consumers pivot to it.
	ChildSessionID string `json:"child_session_id"`

	// ConversationID The PARENT session/conversation id — this event rides the parent's stream, e.g. `"conv_parent123"`.
	ConversationID string `json:"conversation_id"`

	// ParentSessionID Echo of `conversation_id` for consumers that key on a dedicated "parent" field rather than the carrier `conversation_id`. Always equal to `conversation_id`; included for forward-compat with clients that may relay these events across stream boundaries. Category: **transient** (SSE-only). The corresponding durable record of "a child session exists" lives in the conversation store as the child conversation row itself (`parent_conversation_id` foreign key) and the parent's tunneled `function_call` item — reconnecting clients discover children by walking the parent's persisted history, not by replaying this event.
	ParentSessionID *string `json:"parent_session_id,omitempty"`
	SequenceNumber  *int    `json:"sequence_number,omitempty"`

	// Type Always `"session.created"`.
	Type string `json:"type"`
}

type SessionForkRequest struct {
	// AgentID Built-in agent to bind the fork to, switching it away from the source's agent/harness (e.g. fork a Claude session into a Codex one, or a Claude-SDK session into Claude Code). When `None`, the fork keeps the source's agent. Must be a built-in agent (one listed by `GET /v1/agents`).
	AgentID *string `json:"agent_id,omitempty"`

	// Title Title for the forked session. When `None`, the server derives `"Fork of <source_title>"`.
	Title *string `json:"title,omitempty"`

	// UpToResponseID Truncation point for the copied history, e.g. `"resp_abc123"`. When set, only items up to and including the last item of that response are copied — items after it are dropped from the fork. When `None` (default), the full history is copied.
	UpToResponseID *string `json:"up_to_response_id,omitempty"`
}

type SessionGitOptions struct {
	// BaseBranch Optional base ref to branch from, e.g. `"main"` or `"origin/main"`. `None` branches from the source repository's current `HEAD`. Create mode only — invalid with `existing_worktree`.
	BaseBranch *string `json:"base_branch,omitempty"`

	// BranchName In create mode, the new branch to create and check out, e.g. `"feature/login"`. In bind mode, the branch already checked out in the existing worktree. Validated against git ref-format rules; invalid names fail with `invalid_input`.
	BranchName string `json:"branch_name"`

	// ExistingWorktree When `True`, bind to the pre-existing worktree at `workspace` instead of creating one (see above).
	ExistingWorktree *bool `json:"existing_worktree,omitempty"`
}

type SessionHeartbeatEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// ServerTime ISO 8601 UTC timestamp at emission, e.g. `"2026-05-25T10:30:00Z"`. `None` when the producer chose not to populate it.
	ServerTime *string `json:"server_time,omitempty"`

	// Type Always `"session.heartbeat"`.
	Type string `json:"type"`
}

type SessionInputConsumedEvent struct {
	// Data The decoded queued-item payload — see `SessionInputConsumedPayload`.
	Data           SessionInputConsumedPayload `json:"data"`
	SequenceNumber *int                        `json:"sequence_number,omitempty"`

	// Type Always `"session.input.consumed"`.
	Type string `json:"type"`
}

type SessionInputConsumedPayload struct {
	// ClearedPendingID When this consumed message drains a `omnigent.runtime.pending_inputs` entry (a native- terminal web message round-tripping back from the transcript), the drained entry's id, e.g. `"pending_a1b2c3"`. Lets a client drop the matching optimistic bubble by id instead of by position. `None` for non-native messages and for messages that matched no pending entry (e.g. typed directly in the TUI).
	ClearedPendingID *string `json:"cleared_pending_id,omitempty"`

	// CreatedBy Email of the human actor who posted the item, e.g. `"alice@example.com"`. `None` for agent/tool/system items and single-user mode. Mirrors `ConversationItem.to_api_dict` for live attribution.
	CreatedBy *string `json:"created_by,omitempty"`

	// Data Decoded item payload, e.g. `{"role": "user", "content": [{"type": "input_text", "text": "Hello"}]}`. Heterogeneous and `type`-specific.
	Data map[string]interface{} `json:"data"`

	// ItemID Stable identifier of the conversation item just persisted, e.g. `"item_abc123"`.
	ItemID string `json:"item_id"`

	// Type The item type discriminator — `"message"` for user messages, `"function_call_output"` for tool results, etc. Mirrors `omnigent.server.schemas.SessionEventInput`'s `type` field.
	Type string `json:"type"`
}

type SessionInterruptedEvent struct {
	// Data The interrupt metadata — see `SessionInterruptedPayload`.
	Data           SessionInterruptedPayload `json:"data"`
	SequenceNumber *int                      `json:"sequence_number,omitempty"`

	// Type Always `"session.interrupted"`.
	Type string `json:"type"`
}

type SessionInterruptedPayload struct {
	// RequestedAt Unix epoch seconds when the interrupt request reached the server, e.g. `1704067200`.
	RequestedAt int `json:"requested_at"`

	// ResponseID Optional active response id for terminal-backed integrations, e.g. `"codex_turn_abc123"`.
	ResponseID *string `json:"response_id,omitempty"`
}

type SessionLabelsResponse struct {
	// ID Session identifier, e.g. `"conv_abc123"`.
	ID string `json:"id"`

	// Labels Session-scoped guardrails labels. Empty dict when no labels have been written.
	Labels map[string]string `json:"labels,omitempty"`
}

type SessionList struct {
	Data    []SessionListItem `json:"data,omitempty"`
	FirstID *string           `json:"first_id,omitempty"`
	HasMore *bool             `json:"has_more,omitempty"`
	LastID  *string           `json:"last_id,omitempty"`
	Object  *string           `json:"object,omitempty"`
}

type SessionListItem struct {
	// AgentID Durable identifier of the bound agent.
	AgentID string `json:"agent_id"`

	// AgentName Human-readable name of the bound agent, e.g. `"research-agent"`. `None` when the agent row cannot be found.
	AgentName *string `json:"agent_name,omitempty"`

	// Archived Whether the session is archived. Archived sessions are returned by `GET /v1/sessions` only when the request passes `include_archived=true`; the sidebar groups them into a dedicated "Archived" section. `False` for normal sessions.
	Archived *bool `json:"archived,omitempty"`

	// CommentsCount Total number of review comments (any status) on this session. Together with `comments_updated_at` it forms a change fingerprint: an add or edit bumps the timestamp, a delete changes the count, so the web client can invalidate its cached comment list when either field changes in a `WS /v1/sessions/updates` frame. `0` when the session has no comments or the server has no comment store wired.
	CommentsCount *int `json:"comments_count,omitempty"`

	// CommentsUpdatedAt Unix epoch **microseconds** of the most recently mutated comment on this session (max `updated_at` across its comments). Microsecond precision keeps back-to-back mutations within one second distinguishable while staying an exact integer in JavaScript; clients only compare it for change. `None` when the session has no comments or the server has no comment store wired.
	CommentsUpdatedAt *int `json:"comments_updated_at,omitempty"`

	// CreatedAt Unix epoch seconds of creation.
	CreatedAt int `json:"created_at"`

	// ExternalSessionID Runtime-native session id this conversation wraps, e.g. a Claude Code session uuid for `omnigent claude` sessions. `None` for regular AP-only conversations. Lets the sidebar / picker render a runtime badge without a follow-up GET.
	ExternalSessionID *string `json:"external_session_id,omitempty"`

	// GitBranch Git branch checked out in the session's worktree, e.g. `"feature/login"`. Set only when the session was created with a server-created git worktree; `None` otherwise. The Web UI uses a non-`None` value to offer the "delete local branch" cleanup checkbox on session delete. See designs/SESSION_GIT_WORKTREE.md.
	GitBranch *string `json:"git_branch,omitempty"`

	// HostID Host that launched the runner for this session.
	HostID *string `json:"host_id,omitempty"`

	// HostOnline Whether the session's host tunnel is live (status online and fresh within the host liveness TTL). `None` when the session has no `host_id` (CLI/local). Distinguishes "runner down but host can relaunch" from "host offline" for the open-session view; not used by the sidebar.
	HostOnline *bool `json:"host_online,omitempty"`

	// ID Session/conversation identifier, e.g. `"conv_abc123"`.
	ID string `json:"id"`

	// Labels Session-scoped guardrails labels.
	Labels map[string]string `json:"labels,omitempty"`

	// Owner The user_id of the session owner, or `None` when permissions are disabled. Included so the sidebar can display the owner without a separate API call.
	Owner           *string `json:"owner,omitempty"`
	ParentSessionID *string `json:"parent_session_id,omitempty"`

	// PendingElicitationsCount Number of approval prompts currently waiting on this session. Powers the sidebar's "needs attention" badge so a user with several sessions running can tell which ones are blocked on them without opening each chat. Sourced from the Omnigent server's in-memory `omnigent.runtime.pending_elicitations` index, which mirrors every `response.elicitation_request` event passing through `session_stream` and decrements when a verdict is dispatched. `0` when the session has no outstanding elicitations.
	PendingElicitationsCount *int `json:"pending_elicitations_count,omitempty"`

	// PermissionLevel The requesting user's numeric permission level on this session: `1` = read, `2` = edit, `3` = manage. `None` when permissions are disabled.
	PermissionLevel *int    `json:"permission_level,omitempty"`
	ProjectID       *string `json:"project_id,omitempty"`

	// ReasoningEffort Per-session reasoning-effort hint.
	ReasoningEffort *string `json:"reasoning_effort,omitempty"`

	// RunnerID Runner currently bound to the session.
	RunnerID *string `json:"runner_id,omitempty"`

	// RunnerOnline Strict runner liveness — `True` iff a runner tunnel is currently registered for this session. Matches `GET /health`'s `runner_online` value. Strict: a dead runner on a live host reads `False` here (no host-relaunch optimism folded in), unlike the legacy conflated value. `None` when the server has no runner liveness lookup wired.
	RunnerOnline *bool `json:"runner_online,omitempty"`

	// SearchSnippet Excerpt of the chat content that matched the request's `search_query`, centered on the match with `…` marking elided ends, so the search UI can show *where* a session matched in its body. Present whenever the query hit an item body (even if the title also matched); `None` on non-search reads and when only the title matched.
	SearchSnippet *string `json:"search_snippet,omitempty"`

	// Status Derived session lifecycle status.
	Status string `json:"status"`

	// Title Optional human-readable title.
	Title *string `json:"title,omitempty"`

	// UpdatedAt Unix epoch seconds of last update.
	UpdatedAt int `json:"updated_at"`

	// ViewerLastSeen The *requesting user's* "last seen" wall-clock baseline in seconds for this session, or `None` when they have never seen it. Per-viewer (built from the server's in-memory per-user read-state, written by `PUT /v1/sessions/{id}/read-state`); the unread dot shows when `updated_at > viewer_last_seen` and the session is finished. In-memory only — resets on a server restart.
	ViewerLastSeen *int `json:"viewer_last_seen,omitempty"`

	// ViewerUnread Whether the *requesting user* explicitly marked this session unread. Per-viewer; lifts the active-row dot suppression on the client. `False` by default.
	ViewerUnread *bool `json:"viewer_unread,omitempty"`

	// Workspace Absolute path on disk where the runner cd's, e.g. `"/Users/corey/universe/src/foo"`. `None` for sessions that haven't been bound to a host workspace.
	Workspace *string `json:"workspace,omitempty"`
}

type SessionMCPStartupEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Servers Latest per-server startup map, e.g. `{"safe": {"status": "starting", "error": None}}`. Category: **transient** (SSE + snapshot cache). Not persisted; a client connecting mid-startup seeds from the session snapshot's `mcp_startup` field and updates live off this event.
	Servers map[string]MCPServerStartup `json:"servers"`

	// Type Always `"session.mcp_startup"`.
	Type string `json:"type"`
}

type SessionModelEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Model Tier alias the session is now on, e.g. `"opus"` — Claude Code's version-agnostic alias, matching the picker's vocabulary (not a pinned `"claude-opus-4-8"` id). Category: **transient** (SSE-only). The server also writes `model_override` on the conversation, so on reconnect clients restore the selection from the snapshot's `model_override` rather than from a replayed event.
	Model          string `json:"model"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.model"`.
	Type string `json:"type"`
}

type SessionModelOptionsEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`. Category: **transient** (SSE-only). On reconnect, clients seed Native model / effort controls from the session snapshot.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.model_options"`.
	Type string `json:"type"`
}

type SessionPresenceEvent struct {
	// ConversationID The conversation whose stream delivered this event — the root or a sub-agent conversation, e.g. `"conv_abc123"`. Matches the streamed conversation (not necessarily the tree's root) so clients can guard events by the conversation they are viewing.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.presence"`.
	Type string `json:"type"`

	// Viewers All users currently viewing any conversation in the session tree (including the receiving user — the web filters self out for display), ordered by join time.
	Viewers []PresenceViewer `json:"viewers"`
}

type SessionProjectSummary struct {
	// ID First-class project id when one exists, or `None` for a label-only project not yet promoted to the `projects` table.
	ID *string `json:"id,omitempty"`

	// Name Project name (the folder's display name and union key).
	Name string `json:"name"`
}

type SessionReasoningEffortEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// ReasoningEffort Reasoning effort now active for the session, e.g. `"medium"`, or `None` when Codex cleared to its default. Category: **transient** (SSE-only). The server also writes `reasoning_effort` on the conversation, so on reconnect clients restore the selection from the session snapshot rather than from a replayed event.
	ReasoningEffort *string `json:"reasoning_effort,omitempty"`
	SequenceNumber  *int    `json:"sequence_number,omitempty"`

	// Type Always `"session.reasoning_effort"`.
	Type string `json:"type"`
}

type SessionResourceCreatedEvent struct {
	// Resource The newly created resource object.
	Resource       map[string]interface{} `json:"resource"`
	SequenceNumber *int                   `json:"sequence_number,omitempty"`

	// Type Always `"session.resource.created"`.
	Type string `json:"type"`
}

type SessionResourceDeletedEvent struct {
	// ResourceID Opaque id of the deleted resource.
	ResourceID string `json:"resource_id"`

	// ResourceType Type of the deleted resource, e.g. `"terminal"`, `"file"`.
	ResourceType   string `json:"resource_type"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// SessionID Owning session/conversation id.
	SessionID string `json:"session_id"`

	// Type Always `"session.resource.deleted"`.
	Type string `json:"type"`
}

type SessionResourceObject struct {
	// Environment For terminal resources, the environment id the terminal actually runs in. Omitted for non-terminal resources.
	Environment *string `json:"environment,omitempty"`

	// ID Opaque resource identifier, e.g. `"default"` or `"terminal_bash_s1"`.
	ID string `json:"id"`

	// Metadata Resource-type-specific metadata.
	Metadata map[string]interface{} `json:"metadata,omitempty"`

	// Name Human-readable display name. Not required to be globally unique.
	Name string `json:"name"`

	// Object Fixed resource type, always `"session.resource"`.
	Object string `json:"object"`

	// SessionID Owning session/conversation id.
	SessionID string `json:"session_id"`

	// Type Resource kind, initially `"environment"`, `"terminal"`, or `"file"`.
	Type string `json:"type"`
}

type SessionResourcePaginatedList struct {
	Data    []SessionResourceObject `json:"data,omitempty"`
	FirstID *string                 `json:"first_id,omitempty"`
	HasMore *bool                   `json:"has_more,omitempty"`
	LastID  *string                 `json:"last_id,omitempty"`
	Object  *string                 `json:"object,omitempty"`
}

type SessionResponse struct {
	// ActiveResponseID Response id of the turn currently in flight, or `None` when the session is idle. Sourced from the server's `_session_active_response_cache` at snapshot build time so a client connecting mid-turn can reopen a streaming `activeResponse` — the SSE stream is snapshot + live tail with no replay, so the turn-start `running` edge that carried this id is not re-sent on reconnect. Today only native-terminal forwarders (claude-native) stamp a turn id on their status edges; other harnesses leave this `None`.
	ActiveResponseID *string `json:"active_response_id,omitempty"`

	// AgentID Durable identifier of the bound agent, e.g. `"ag_abc123"`. Stable across renames of the agent.
	AgentID string `json:"agent_id"`

	// AgentName Human-readable name of the bound agent, e.g. `"research-agent"`. Loaded from the agent row at snapshot-build time. `None` when the agent row cannot be found (deleted or orphaned session).
	AgentName *string `json:"agent_name,omitempty"`

	// Archived Whether the session is archived. Archived sessions are hidden from the default sidebar listing and surface only behind the "Show archived" toggle. `False` for normal sessions. Toggled via `PATCH /v1/sessions/{id}`.
	Archived *bool `json:"archived,omitempty"`

	// BackgroundTaskCount Background shells (claude-native) still running as of the last status edge, so a reload re-shows "N shells still running" even though the session has settled to `"idle"`. `None` (the default / omitted) when no shells are tracked.
	BackgroundTaskCount *int `json:"background_task_count,omitempty"`

	// ContextWindow The model's context window size in tokens as looked up server-side from litellm's registry (or from the `AP_CONTEXT_WINDOW_OVERRIDE` env var), e.g. `200_000`. `None` when the model is not in litellm's registry and no override is set.
	ContextWindow *int `json:"context_window,omitempty"`

	// CostControlModeOverride Per-session cost-control switch: `"on"` activates the spec's configured cost-control mode, `"off"` disables cost control for this session. `None` means no override is active (the spec default applies). Set at create time or via `PATCH /v1/sessions/{id}` (the web "Cost Optimized" toggle); read by the cost-control advisor pipeline.
	CostControlModeOverride *string `json:"cost_control_mode_override,omitempty"`

	// CreatedAt Unix epoch seconds of creation.
	CreatedAt int `json:"created_at"`

	// ExternalSessionID Runtime-native session id this conversation wraps, e.g. a Claude Code session uuid for `omnigent claude` sessions. `None` for regular AP-only conversations. Populated by the wrapper bridge.
	ExternalSessionID *string `json:"external_session_id,omitempty"`

	// GitBranch Git branch checked out in the session's worktree, e.g. `"feature/login"`. Set only when the session was created with a server-created git worktree; `None` otherwise. The Web UI uses a non-`None` value to offer the "delete local branch" cleanup checkbox on session delete. See designs/SESSION_GIT_WORKTREE.md.
	GitBranch *string `json:"git_branch,omitempty"`

	// Harness The bound agent's canonical harness, e.g. `"claude-sdk"` or `"openai-agents"`. Lets the client render the active credential for the correct provider family instead of inferring it from the model string (which is wrong when the agent declares no model). `None` when the agent cannot be looked up.
	Harness *string `json:"harness,omitempty"`

	// HostID Host that launched (or should launch) the runner for this session, e.g. `"host_a1b2c3d4..."`. `None` for CLI-initiated sessions.
	HostID *string `json:"host_id,omitempty"`

	// HostOnline Whether the session's host tunnel is live (status online and fresh within the host liveness TTL). `None` when the session has no `host_id` (CLI/local). Used only to choose what the open view shows when `runner_online` is `False` — host alive ⇒ "send a message to wake the runner"; host dead ⇒ "reconnect / fork". Never participates in the reachability decision.
	HostOnline *bool `json:"host_online,omitempty"`

	// HostResumable Whether this session is bound to a dormant managed host the server can wake in place (its provider sets `SandboxLauncher.can_resume`). The open view reads it only when `host_online` is `False`, to split a confirmed host-down into a recoverable "asleep" state (send a message — the relaunch path resumes the sandbox) versus the terminal `host_offline` dead-end (reconnect from your machine / fork). `False` for non-managed or non-resumable hosts.
	HostResumable *bool `json:"host_resumable,omitempty"`

	// ID Unique session identifier (also the underlying conversation ID), e.g. `"conv_abc123"`.
	ID string `json:"id"`

	// Items Committed conversation items in chronological order. Empty for a freshly created session.
	Items []ConversationItem `json:"items,omitempty"`
	Kind  *string            `json:"kind,omitempty"`

	// Labels Session-scoped guardrails labels. Empty dict when no labels have been written.
	Labels map[string]string `json:"labels,omitempty"`

	// LastTaskError Error details from the most recently failed task. Only present when `status == "failed"` and the task stored an error. Lets clients display the failure reason on historical load without relying on the transient `response.error` SSE event (which may have been emitted before the web client subscribed). Format mirrors the `RetryErrorDetail` SSE shape: `{"code": "executor_error", "message": "..."}`. `None` in all other cases.
	LastTaskError map[string]string `json:"last_task_error,omitempty"`

	// LastTotalTokens Total token count (input + output) from the most recently completed task's `usage`, e.g. `45231`. `None` when no task has completed yet. Lets clients seed their context-ring on conversation resume without waiting for the next `response.completed` SSE event.
	LastTotalTokens *int `json:"last_total_tokens,omitempty"`

	// LLMModel The LLM model identifier from the bound agent's spec, e.g. `"anthropic/claude-sonnet-4-6"`. `None` when the agent has no explicit `llm:` block or the agent cannot be looked up.
	LLMModel   *string                     `json:"llm_model,omitempty"`
	MCPStartup map[string]MCPServerStartup `json:"mcp_startup,omitempty"`

	// ModelOptions Runner-owned model-picker options for native sessions. Claude supplies launch-time gateway aliases; Codex includes each model's supported reasoning efforts. Empty while unavailable.
	ModelOptions []NativeModelOption `json:"model_options,omitempty"`

	// ModelOverride Per-session LLM model override, e.g. `"claude-opus-4-7"`. `None` means no override is active (the agent's `llm_model` applies). Set via `PATCH /v1/sessions/{id}` or the REPL's `/model` command; both write the same column so the web UI and the TUI stay in sync.
	ModelOverride *string `json:"model_override,omitempty"`

	// ParentSessionID For sub-agent sessions, the parent conversation's id, e.g. `"conv_parent987"`. `None` for top-level sessions. Lets clients identify a session as a child and link back to its parent without an extra round-trip — the same conversation row exposes this via `parent_conversation_id` internally.
	ParentSessionID *string `json:"parent_session_id,omitempty"`

	// PendingElicitations Outstanding approval prompts on this session at the moment the snapshot was built — the original `response.elicitation_request` event dicts. Lets the UI render the ApprovalCard on cold load, since the live SSE stream has no replay and a prompt emitted before the user opened the chat would otherwise vanish. Empty list when no prompts are outstanding. Sourced from the Omnigent server's in-memory `omnigent.runtime.pending_elicitations` index.
	PendingElicitations []map[string]interface{} `json:"pending_elicitations,omitempty"`

	// PendingInputs Un-consumed web-composer user messages on native-terminal (claude-native / codex-native) sessions at snapshot time, each `{"pending_id", "content"}`. Native sessions don't persist a web message at POST time (the transcript forwarder is the single writer), so a client that posted then navigated away / rebound would lose its optimistic bubble; replaying these re-hydrates it. Empty list otherwise. Sourced from the in-memory `omnigent.runtime.pending_inputs` index.
	PendingInputs []map[string]interface{} `json:"pending_inputs,omitempty"`

	// PermissionLevel The requesting user's numeric permission level on this session: `1` = read, `2` = edit, `3` = manage. `None` when permissions are disabled (single-user mode without a permission store).
	PermissionLevel *int    `json:"permission_level,omitempty"`
	ProjectID       *string `json:"project_id,omitempty"`

	// ReasoningEffort Per-session reasoning-effort hint. Accepted metadata values are `"none"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, and `"max"`. Provider-specific support is validated when a turn executes. `None` means use the agent default.
	ReasoningEffort *string `json:"reasoning_effort,omitempty"`

	// RootConversationID The id of this session's spawn-tree root, e.g. `"conv_root1"`. Equals `id` for top-level sessions; for sub-agents it points at the top-level ancestor. Lets orchestration tools (e.g. `sys_session_close`) confirm a target shares the caller's spawn tree over the REST path. `None` only when the underlying row predates the `root_conversation_id` column (not expected post-migration).
	RootConversationID *string `json:"root_conversation_id,omitempty"`

	// RunnerID Runner currently bound to this session, e.g. `"runner_abc123"`. `None` until a client binds one via `PATCH /v1/sessions/{id}`.
	RunnerID *string `json:"runner_id,omitempty"`

	// RunnerOnline Strict runner liveness — `True` iff a runner tunnel is currently registered for this session. This is the sole reachability signal: `True` means the client can chat normally. It does **not** fold in host-relaunch optimism (a dead runner on a live host reads `False` here, not `True`) — the open-session view pairs it with `host_online` to decide what to show. `None` when the server has no runner liveness lookup wired.
	RunnerOnline *bool `json:"runner_online,omitempty"`

	// SandboxStatus Managed-sandbox launch progress while the session's background sandbox launch is in flight or has failed — see `SandboxStatus`. `None` for sessions without a managed launch and once the launch succeeds. Sourced from the Omnigent server's in-memory `_session_sandbox_status_cache` at snapshot build time, so a client opening the session mid-launch sees the current stage.
	SandboxStatus *SandboxStatus `json:"sandbox_status,omitempty"`

	// Skills Skills the bound agent has access to — the merged result of the agent spec's bundled `skills` and the host-scope skills discovered along the agent workdir / `~/.claude/skills/` (subject to the spec's `skills_filter`). Mirrors what the TUI passes to the runner at startup. Empty list when the agent spec cannot be loaded, or when bundled + host discovery yields nothing.
	Skills []SkillSummary `json:"skills,omitempty"`

	// Status Session lifecycle status. One of `"idle"` (no loop running), `"running"` (loop executing), `"waiting"` (loop parked on background work / sub-agents), or `"failed"` (terminal failure). Current read paths collapse `"waiting"` -> `"running"` before building this snapshot; the literal stays a superset of what the runtime can produce so a server that forwards the raw status never 500s on serialization.
	Status string `json:"status"`

	// SubAgentName For sub-agent sessions, the sub-agent type name within the parent's spec tree, e.g. `"summarizer"`. `None` for top-level sessions.
	SubAgentName *string `json:"sub_agent_name,omitempty"`

	// SubagentRoutingOverride Per-session subagent-routing switch, two-state: `"on"` routes subagent spawns, and `"off"` or `None` (unset) both leave them unrouted — the in-session "Subagent routing" row renders either as "Default". `None` on a row created before this became explicit inherits nothing. Stamped `"on"` at create for Smart Routing sessions; also set via `PATCH /v1/sessions/{id}`.
	SubagentRoutingOverride *string `json:"subagent_routing_override,omitempty"`

	// TerminalLaunchArgs Pass-through CLI args the native terminal wrapper (claude / codex) was launched with, e.g. `["--dangerously-skip-permissions"]`. `None` for non-native sessions or a native session launched with none. Lets the launcher reproduce the command on resume.
	TerminalLaunchArgs []string `json:"terminal_launch_args,omitempty"`

	// TerminalPending `True` while the runner is auto-creating a terminal-first session's terminal (claude-native / codex-native), so the Web UI shows a spinner on the Terminal pill instead of a silent greyed-out button. Cleared to `False` once the terminal lands or auto-create fails; from then on the client relies purely on whether a terminal resource exists. Sourced from the Omnigent server's in-memory `_session_terminal_pending_cache` at snapshot build time, so a client connecting mid-spin-up still sees the spinner.
	TerminalPending *bool `json:"terminal_pending,omitempty"`

	// Title Optional human-readable title, e.g. `"debugging auth flow"`. `None` when unset.
	Title *string `json:"title,omitempty"`

	// Todos Current Claude Code todo list items for `omnigent claude` sessions, as raw dicts from Claude's todo JSON file. Each dict has `content`, `status`, and `activeForm` keys. Empty list for non-claude-native sessions or when no todos have been reported yet. Sourced from the Omnigent server's in-memory `_session_todos_cache`.
	Todos []map[string]interface{} `json:"todos,omitempty"`

	// TotalCostUSD Cumulative LLM spend for this session in USD, e.g. `0.42`. `None` when the session is **unpriced** — no turn has been priced yet (the model is absent from the pricing catalog, or no usage has been recorded) — so clients render "—" rather than a misleading `$0.00`. Server-computed (cache-aware for relay/codex, exact billing for claude-native), the same total the cost-budget policy gates on. Lets clients seed their cost indicator on resume without waiting for the next `session.usage` SSE event.
	TotalCostUSD *float64 `json:"total_cost_usd,omitempty"`

	// UpdatedAt Unix epoch timestamp of the last persisted session activity. Advances when conversation items are appended and on session metadata edits (rename, agent switch, archive); a mid-stall rename therefore resets the clock, so an orchestrator treating this as a pure item-append heartbeat should account for that. Can be compared across snapshots independently of lifecycle status.
	UpdatedAt *int `json:"updated_at,omitempty"`

	// UsageByModel Per-model breakdown of the same subtree usage, keyed by the raw harness model id, e.g. `{"claude-sonnet-4-6": ModelUsage(input_tokens=12000, ...)}`. `None` when no per-model usage has been recorded (older sessions recorded before this field existed, or before the first turn). Lets the UI show which models a session spent its tokens / budget on.
	UsageByModel map[string]ModelUsage `json:"usage_by_model,omitempty"`

	// Workspace Absolute path on disk where the runner cd's, e.g. `"/Users/corey/universe/src/foo"`. Set when the session was bound to a host workspace at create-time, or when the CLI captured `os.getcwd()` at session-create. Always `None` when not yet validated against a host. When a git worktree was created for the session, this is the worktree directory path.
	Workspace *string `json:"workspace,omitempty"`
}

type SessionSandboxStatusEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Error Failure detail when `stage == "failed"`, e.g. `"managed sandbox launch failed: spend limit reached"`. `None` otherwise. Category: **transient** (SSE-only). On reconnect, clients seed the progress indicator from the session snapshot's `sandbox_status` field, which is populated by `_session_sandbox_status_cache` at snapshot build time.
	Error          *string `json:"error,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// Stage The launch stage just entered, e.g. `"provisioning"` — see `SandboxStatus` for the full pipeline order.
	Stage string `json:"stage"`

	// Type Always `"session.sandbox_status"`.
	Type string `json:"type"`
}

type SessionSkillsEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`. Category: **transient** (SSE-only). On reconnect, clients seed the menu from the session snapshot's `skills` field, which is populated by the runner-skills cache at snapshot build time.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"session.skills"`.
	Type string `json:"type"`
}

type SessionStatusEvent struct {
	BackgroundTaskCount *int `json:"background_task_count,omitempty"`

	// BlockedOn Short human phrase naming what a still-`running` session is parked on, e.g. `"permission prompt"` or `"dialog open"`. Set by terminal-backed integrations whose agent can block on a dialog the web UI does not mirror, so the client can say *why* nothing is moving instead of showing a bare spinner. `None` whenever the session is not parked. Unrelated to the `waiting` status above, which means the turn has ended and only background work remains. Category: **transient** (SSE-only). Status is rederived on reconnect from the cached last-relayed turn lifecycle event or by re-querying the runner; not persisted by the runtime.
	BlockedOn *string `json:"blocked_on,omitempty"`

	// ConversationID The conversation/session identifier whose status changed, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Error Machine-readable failure detail, present only when `status == "failed"`. Carries the message the runner attached when a turn died — most importantly a SETUP-phase failure (spec resolution, spawn-env build) that ends the turn before any `response.failed` event is emitted. `None` for every non-failed transition. Clients render `error.message` as the terminal error line; without it a setup failure shows as a silent end.
	Error *ErrorDetail `json:"error,omitempty"`

	// ResponseID Optional active response id for terminal-backed integrations, e.g. `"codex_turn_abc123"`. Clients use it to associate coarse session status edges with the assistant bubble they describe. `None` for ordinary in-process runtime edges.
	ResponseID     *string `json:"response_id,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// Status New session status. `"launching"` (session or child task created, but no concrete harness start observed), `"idle"` (no loop running), `"running"` (loop executing), `"waiting"` (parent turn parked on the async-work drain), or `"failed"` (terminal failure).
	Status string `json:"status"`

	// Type Always `"session.status"`.
	Type string `json:"type"`
}

type SessionSupersededEvent struct {
	// ConversationID The superseded (old) conversation id this event rides the stream of, e.g. `"conv_old"`.
	ConversationID string `json:"conversation_id"`

	// Reason Why the session was superseded. Currently always `"clear"` (a Claude Code `/clear`); kept as a field so the client can branch on future supersession causes.
	Reason         *string `json:"reason,omitempty"`
	SequenceNumber *int    `json:"sequence_number,omitempty"`

	// TargetConversationID The conversation to follow to, e.g. `"conv_new"`.
	TargetConversationID string `json:"target_conversation_id"`

	// Type Always `"session.superseded"`.
	Type string `json:"type"`
}

type SessionSwitchAgentRequest struct {
	// AgentID Built-in agent to switch the session to, e.g. `"ag_builtin_codex"`. Must be a built-in agent (one listed by `GET /v1/agents`) and different from the session's current agent.
	AgentID string `json:"agent_id"`
}

type SessionTerminalActivityEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// SessionID Owning session/conversation id.
	SessionID string `json:"session_id"`

	// TerminalID Opaque terminal resource id, e.g. `"terminal_zsh_s1"`.
	TerminalID string `json:"terminal_id"`

	// Type Always `"session.terminal.activity"`.
	Type string `json:"type"`
}

type SessionTerminalPendingEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`

	// Pending `True` while the terminal is being created; `False` once it lands or auto-create fails. Category: **transient** (SSE-only). On reconnect, clients seed the spinner from the session snapshot's `terminal_pending` field, which is populated by `_session_terminal_pending_cache` at snapshot build time.
	Pending        bool `json:"pending"`
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// Type Always `"session.terminal_pending"`.
	Type string `json:"type"`
}

type SessionTodosEvent struct {
	// ConversationID Session identifier, e.g. `"conv_abc123"`.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Todos Current todo items read from Claude's todo file. Each entry is a raw dict with `content` (str), `status` (`"pending"` | `"in_progress"` | `"completed"`), and `activeForm` (str, the gerund form) keys, e.g. `[{"content": "Fix the bug", "status": "in_progress", "activeForm": "Fixing the bug"}]`. Category: **transient** (SSE-only). On reconnect, clients seed the panel from the session snapshot's `todos` field, which is populated by `_session_todos_cache` at snapshot build time.
	Todos []map[string]interface{} `json:"todos"`

	// Type Always `"session.todos"`.
	Type string `json:"type"`
}

type SessionUsage struct {
	AgentName *string `json:"agent_name,omitempty"`

	// CostUSD Authoritative cumulative USD spend for this session's subtree.
	CostUSD *float64 `json:"cost_usd,omitempty"`

	// CreatedAt Unix epoch seconds of creation.
	CreatedAt int     `json:"created_at"`
	Harness   *string `json:"harness,omitempty"`

	// ID Session/conversation identifier, e.g. `"conv_abc123"`.
	ID       string  `json:"id"`
	LLMModel *string `json:"llm_model,omitempty"`

	// Models Per-model recorded cost, keyed by the raw harness model id (e.g. `{"claude-opus-4-8": 14.03}`). Empty when no per-model cost was recorded. May not sum to `cost_usd` (see above).
	Models         map[string]float64 `json:"models,omitempty"`
	OtherHarnesses []string           `json:"other_harnesses,omitempty"`

	// Title Optional human-readable title.
	Title *string `json:"title,omitempty"`

	// UpdatedAt Unix epoch seconds of last activity.
	UpdatedAt int `json:"updated_at"`
}

type SessionUsageEvent struct {
	// ContextTokens `input + cache_creation + cache_read` from the latest assistant `message.usage`. `None` on a window-only broadcast.
	ContextTokens *int `json:"context_tokens,omitempty"`

	// ContextWindow Resolved window in tokens (e.g. 200_000 normally, 1_000_000 with `opus[1m]` / `sonnet[1m]`). `None` on a tokens-only broadcast.
	ContextWindow *int `json:"context_window,omitempty"`

	// ConversationID Session identifier.
	ConversationID string `json:"conversation_id"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// TotalCostUSD Cumulative session spend in USD after this update, e.g. `0.42` — the server-computed total the cost-budget policy gates on. Present **only when the session is priced**; omitted (`None`, stripped by `exclude_none`) when unpriced or on a broadcast that carries no cost change, so the client keeps its prior value (the snapshot seeds the initial "—" for an unpriced session). Once a session is priced the total only grows, so it never reverts to unpriced.
	TotalCostUSD *float64 `json:"total_cost_usd,omitempty"`

	// Type Always `"session.usage"`.
	Type string `json:"type"`

	// UsageByModel Per-model breakdown of the same subtree usage after this update, keyed by raw harness model id, e.g. `{"claude-sonnet-4-6": ModelUsage(input_tokens=12000, ...)}`. `None` (stripped by `exclude_none`) on a broadcast that carries no per-model change, so the client keeps its cached map. Category: **transient** (SSE-only). On reconnect, clients seed the ring from the session snapshot's `last_total_tokens` and `context_window`, the cost indicator from `total_cost_usd`, and the per-model token breakdown from `usage_by_model`.
	UsageByModel map[string]ModelUsage `json:"usage_by_model,omitempty"`
}

type SetCodexGoalRequest struct {
	// Objective Goal objective text, e.g. `"Finish the migration and keep tests green"`. Must be non-empty after trimming and no longer than 4000 characters, matching Codex app-server's goal contract.
	Objective string `json:"objective"`

	// Status Optional user-selected goal status. `"active"` starts or resumes the goal, and `"paused"` stores it paused. Omit this field to preserve Codex's current lifecycle state.
	Status *string `json:"status,omitempty"`

	// TokenBudget Optional positive token budget, e.g. `40000`. Explicit JSON `null` clears the Codex goal budget; omitting the field leaves it absent from the forwarded request.
	TokenBudget *int `json:"token_budget,omitempty"`
}

type SetCodexGoalV1SessionsSessionIDCodexGoalPutJSONRequestBody = SetCodexGoalRequest

type SetSharingRequest struct {
	PublicSharing *bool   `json:"public_sharing,omitempty"`
	SharingMode   *string `json:"sharing_mode,omitempty"`
}

type SetSharingV1SharingPutJSONRequestBody = SetSharingRequest

type SkillSummary struct {
	// Description One-line summary from the SKILL.md frontmatter, e.g. `"Triage open GitHub issues in the repo."`.
	Description string `json:"description"`

	// Name Skill identifier as parsed from the SKILL.md frontmatter, e.g. `"triage-issues"`. Lowercase kebab-case.
	Name string `json:"name"`
}

type SlashCommandData struct {
	// Arguments Raw `<command-args>` text. Empty when none.
	Arguments string `json:"arguments"`

	// Kind `"skill"` for plugin/Skill invocations, `"command"` for surfaced CLI built-ins (`/effort`, `/clear`, `/compact`, `/model`, `/ultrareview`). The web renderer uses this to pick the prefix label and icon. Defaults to `"skill"` so persisted items predating this field deserialize without backfill.
	Kind  *string `json:"kind,omitempty"`
	Model string  `json:"model"`

	// Name Command name with leading `/` stripped, e.g. `"dev-productivity:simplify"`.
	Name string `json:"name"`

	// Output `<local-command-stdout>` text when present, else `None` (the common case — Skills act via the next assistant turn, not stdout).
	Output *string `json:"output,omitempty"`
}

type SmartRoutingSourcesInfo struct {
	External bool `json:"external"`
	Oss      bool `json:"oss"`
}

type StoreHarnessCredentialRequest struct {
	// BaseURL The gateway base URL, required for `kind="gateway"`.
	BaseURL *string `json:"base_url,omitempty"`

	// DefaultModel Optional family default model id to pin.
	DefaultModel *string `json:"default_model,omitempty"`

	// EnvVar For `kind="adopt"`, the host env var to reference.
	EnvVar *string `json:"env_var,omitempty"`

	// Kind `"key"` (a vendor API key), `"gateway"` (a compatible proxy at `base_url`), or `"adopt"` (reference host env `env_var`).
	Kind string `json:"kind"`

	// Secret The API key / gateway token for `key` / `gateway`; `None` for `adopt`.
	Secret *string `json:"secret,omitempty"`

	// WireAPI Optional OpenAI wire protocol (`"chat"` / `"responses"`).
	WireAPI *string `json:"wire_api,omitempty"`
}

type StoreHostHarnessCredentialV1HostsHostIDHarnessesHarnessCredentialPostJSONRequestBody = StoreHarnessCredentialRequest

type StreamSessionV1SessionsSessionIDStreamGetParams struct {
	// Idle Presence idle flag computed by the web client at connect time (tab backgrounded ≥ its debounce). An idle *flip* mid-view arrives as a reconnect carrying the new value — there is no separate update endpoint.
	Idle *bool `form:"idle,omitempty" json:"idle,omitempty"`
}

type SwitchSessionAgentV1SessionsSessionIDSwitchAgentPostJSONRequestBody = SessionSwitchAgentRequest

type TerminalCommandData struct {
	// Input The raw command string, e.g. `"pwd"`. Present when `kind="input"`, `None` otherwise.
	Input *string `json:"input,omitempty"`

	// Kind `"input"` for the command text, `"output"` for the combined stdout/stderr result.
	Kind string `json:"kind"`

	// Stderr Captured stderr text. Present when `kind="output"`, `None` otherwise.
	Stderr *string `json:"stderr,omitempty"`

	// Stdout Captured stdout text. Present when `kind="output"`, `None` otherwise.
	Stdout *string `json:"stdout,omitempty"`
}

type ToolOutputDeltaEvent struct {
	// CallID Function-call correlation id.
	CallID string `json:"call_id"`

	// Delta Command stdout/stderr fragment.
	Delta          string `json:"delta"`
	SequenceNumber *int   `json:"sequence_number,omitempty"`

	// Type Always `"response.function_call_output.delta"`.
	Type string `json:"type"`
}

type TurnCancelledEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// SessionID Session/conversation identifier, e.g. `"conv_abc123"`.
	SessionID string `json:"session_id"`

	// Type Fixed literal `"turn.cancelled"`.
	Type string `json:"type"`
}

type TurnCompletedEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// SessionID Session/conversation identifier, e.g. `"conv_abc123"`.
	SessionID string `json:"session_id"`

	// Type Fixed literal `"turn.completed"`.
	Type string `json:"type"`
}

type TurnFailedEvent struct {
	// Error Error details, e.g. `{"message": "LLM timeout", "type": "TimeoutError"}`.
	Error          map[string]interface{} `json:"error,omitempty"`
	SequenceNumber *int                   `json:"sequence_number,omitempty"`

	// SessionID Session/conversation identifier, e.g. `"conv_abc123"`.
	SessionID string `json:"session_id"`

	// Type Fixed literal `"turn.failed"`.
	Type string `json:"type"`
}

type TurnStartedEvent struct {
	SequenceNumber *int `json:"sequence_number,omitempty"`

	// SessionID Session/conversation identifier, e.g. `"conv_abc123"`.
	SessionID string `json:"session_id"`

	// Type Fixed literal `"turn.started"`.
	Type string `json:"type"`
}

type UpdateCodexGoalStatusRequest struct {
	// Status Target Codex goal status, either `"paused"` or `"active"`.
	Status string `json:"status"`
}

type UpdateCodexGoalStatusV1SessionsSessionIDCodexGoalStatusPatchJSONRequestBody = UpdateCodexGoalStatusRequest

type UpdateCommentRequest struct {
	// Body New comment body. `None` leaves it unchanged.
	Body *string `json:"body,omitempty"`

	// Status New status, e.g. `"addressed"`. `None` leaves it unchanged.
	Status *string `json:"status,omitempty"`
}

type UpdateCommentV1SessionsSessionIDCommentsCommentIDPatchJSONRequestBody = UpdateCommentRequest

type UpdateDefaultPolicyRequest struct {
	// Enabled New enabled flag. `None` leaves it unchanged.
	Enabled *bool `json:"enabled,omitempty"`

	// Handler New handler path or URL. `None` leaves it unchanged.
	Handler *string `json:"handler,omitempty"`

	// Name New policy name. `None` leaves it unchanged.
	Name *string `json:"name,omitempty"`
}

type UpdateMcpServerV1SessionsSessionIDAgentMcpServersServerNamePutJSONRequestBody = UpsertMCPServerRequest

type UpdatePolicyV1PoliciesPolicyIDPatchJSONRequestBody = UpdateDefaultPolicyRequest

type UpdatePolicyV1SessionsSessionIDPoliciesPolicyIDPatchJSONRequestBody = UpdateSessionPolicyRequest

type UpdateProjectRequest struct {
	// Config New config object to replace the stored one. `None` leaves it unchanged; an empty object `{}` clears the stored defaults.
	Config map[string]interface{} `json:"config,omitempty"`

	// Name New project name. `None` leaves it unchanged; otherwise trimmed, non-empty, at most 100 characters.
	Name *string `json:"name,omitempty"`
}

type UpdateProjectV1ProjectsProjectIDPatchJSONRequestBody = UpdateProjectRequest

type UpdateSessionAgentV1SessionsSessionIDAgentPutMultipartRequestBody = BodyUpdateSessionAgentV1SessionsSessionIDAgentPut

type UpdateSessionPolicyRequest struct {
	// Enabled New enabled flag. `None` leaves it unchanged.
	Enabled *bool `json:"enabled,omitempty"`

	// Handler New handler path or URL. `None` leaves it unchanged.
	Handler *string `json:"handler,omitempty"`

	// Name New policy name. `None` leaves it unchanged.
	Name *string `json:"name,omitempty"`
}

type UpdateSessionRequest struct {
	// Archived New archived state. `True` archives (hides the session from the default sidebar listing), `False` unarchives, `None` leaves unchanged. Owner-only (unlike `title`, which needs only edit access).
	Archived *bool `json:"archived,omitempty"`

	// CollaborationMode Codex-native collaboration-mode string. `"plan"` enters Plan mode and `"default"` returns to Default mode for subsequent Codex turns. Only valid for sessions stamped with the codex-native wrapper label. Omitted leaves unchanged.
	CollaborationMode *string `json:"collaboration_mode,omitempty"`

	// CostControlModeOverride Per-session cost-control switch: `"on"` activates the spec's configured cost-control mode, `"off"` disables cost control for this session. Explicit JSON `null` clears the override back to the spec default; omitting the field leaves it unchanged (`"off"` is a real value here, so the field's *presence* — not a clear alias — is the clear signal, unlike `model_override`).
	CostControlModeOverride *string `json:"cost_control_mode_override,omitempty"`

	// ExternalSessionID Runtime-native session id captured by a wrapper bridge (e.g. Claude Code's session uuid for `omnigent claude` sessions). Idempotent on same-value writes; the server rejects attempts to overwrite an already-set different value with `invalid_input` to surface programmer errors. `None` leaves unchanged.
	ExternalSessionID *string `json:"external_session_id,omitempty"`

	// Labels Guardrails labels to upsert. Merges with existing labels; keys not present are left untouched.
	Labels map[string]string `json:"labels,omitempty"`

	// ModelOverride Per-session LLM model override, e.g. `"claude-opus-4-7"`. The value is forwarded as-is to the executor at turn start; the server does not enumerate valid models. Clear aliases such as `"default"`, `"off"`, or `"reset"` remove the override (matching the REPL's `/model` semantics). `None` leaves unchanged.
	ModelOverride *string `json:"model_override,omitempty"`

	// ProjectID File this session into a first-class project (see `designs/PROJECTS_PRD.md`). A non-empty id moves the session into that project; the empty string `""` unfiles it. **Omitting** the field leaves membership unchanged; an explicit `null` is rejected (400) so it can't silently unfile. Owner-only: because projects are owner-private, only the session owner may file it, and only into a project they own — the server verifies both. Independent of the legacy `omni_project` label, which is set via `labels`.
	ProjectID *string `json:"project_id,omitempty"`

	// ReasoningEffort Per-session reasoning-effort hint. Accepted metadata values are `"none"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, and `"max"`. Provider-specific support is validated when a turn executes. Clear aliases such as `"default"` remove the session override. `None` leaves unchanged.
	ReasoningEffort *string `json:"reasoning_effort,omitempty"`

	// RunnerID Identifier of a registered runner, e.g. `"runner_abc123"`. `None` leaves runner binding unchanged.
	RunnerID *string `json:"runner_id,omitempty"`

	// Silent When `True`, persist metadata changes but skip the runner-side side effects — specifically the native `/effort` / `/model` / Codex collaboration-mode forwards into the live runtime. Used by automatic bind-time handoffs (web's sticky-pref apply on session switch, the REPL's pre-create `/model` snapshot) where injecting a visible slash command into a freshly-spawned pane would render as an unexpected "Command model X" item before the user has sent anything. Default `False` preserves the user-driven picker / `/model` behaviour where the live forward IS the desired feedback.
	Silent *bool `json:"silent,omitempty"`

	// SubagentRoutingOverride Per-session subagent-routing switch: `"on"` routes subagent spawns, `"off"` leaves them unrouted. Explicit JSON `null` clears the override, which lands the session on Default (the same behavior as `"off"` — nothing is inherited); omitting the field leaves it unchanged (same presence-is-the-clear-signal rule as `cost_control_mode_override`). Effective on the next spawn, so it can be changed at any point in a session.
	SubagentRoutingOverride *string `json:"subagent_routing_override,omitempty"`

	// TerminalLaunchArgs Per-session native-terminal pass-through args, e.g. `["--dangerously-skip-permissions"]`. A list (including `[]`) replaces the stored value wholesale — resume is last-write-wins, never an append. Bounds (count / length) are validated server-side. `None` leaves unchanged.
	TerminalLaunchArgs []string `json:"terminal_launch_args,omitempty"`

	// Title New title, e.g. `"debugging auth flow"`. `None` leaves unchanged.
	Title *string `json:"title,omitempty"`
}

type UpdateSessionV1SessionsSessionIDPatchJSONRequestBody = UpdateSessionRequest

type UploadSessionFileV1SessionsSessionIDResourcesFilesPostMultipartRequestBody = BodyUploadSessionFileV1SessionsSessionIDResourcesFilesPost

type UpsertMCPServerRequest struct {
	Args        []string          `json:"args,omitempty"`
	Command     *string           `json:"command,omitempty"`
	Description *string           `json:"description,omitempty"`
	Headers     map[string]string `json:"headers,omitempty"`
	Name        string            `json:"name"`
	Transport   string            `json:"transport"`
	URL         *string           `json:"url,omitempty"`
}

type Usage struct {
	// CacheCreationInputTokens Prompt tokens written to the provider prompt cache (cache creation), billed at a premium rate. Like `cache_read_input_tokens`, this is separate from `input_tokens`; `0` when not reported.
	CacheCreationInputTokens *int `json:"cache_creation_input_tokens,omitempty"`

	// CacheReadInputTokens Prompt tokens served from a provider prompt cache (cache hit), billed at a reduced rate. Reported by Anthropic-style providers as a count *separate* from `input_tokens` (which carries only the non-cached portion); `0` when the provider does not break out cache usage. Consumed by the cache-aware server-side cost path.
	CacheReadInputTokens *int `json:"cache_read_input_tokens,omitempty"`

	// ContextTokens Context-fill estimate for the next turn — set only by executors that make multiple LLM sub-calls per turn (e.g. `openai-agents`). For single-call executors this is absent and `total_tokens` serves the same purpose. The toolbar context ring and `/context` command use this field when present, falling back to `total_tokens`.
	ContextTokens *int `json:"context_tokens,omitempty"`

	// CostUSD Authoritative per-turn cost in USD reported directly by the harness/provider (e.g. GitHub Copilot's AI-credit total). When present, the server-side cost path uses it in preference to the catalog token-price estimate; `None` when the harness doesn't report a cost (the common case, where cost is computed from token counts x catalog pricing).
	CostUSD *float64 `json:"cost_usd,omitempty"`

	// InputTokens Number of input (prompt) tokens consumed.
	InputTokens *int `json:"input_tokens,omitempty"`

	// Model The LLM model the harness actually used for this turn, e.g. `"claude-opus-4-8"` or `"databricks-gpt-5-5"`. Reported by relay executors so the server-side cost path can price the turn even when the agent spec pins no `llm.model` (e.g. supervisors that delegate / use the harness default). `None` when the executor doesn't report it; the cost path then falls back to the session override / spec model.
	Model *string `json:"model,omitempty"`

	// OutputTokens Number of output (completion) tokens generated.
	OutputTokens *int `json:"output_tokens,omitempty"`

	// OutputTokensDetails Breakdown of output token usage (e.g. reasoning tokens).
	OutputTokensDetails *UsageDetails `json:"output_tokens_details,omitempty"`

	// TotalTokens Sum of input and output tokens across all LLM sub-calls for this turn (billing total).
	TotalTokens *int `json:"total_tokens,omitempty"`
}

type UsageDetails struct {
	// ReasoningTokens Number of tokens consumed by chain-of-thought reasoning.
	ReasoningTokens *int `json:"reasoning_tokens,omitempty"`
}

type UsageReport struct {
	// CostLast30D Total spend over the last 30 UTC days (incl. today).
	CostLast30D *float64 `json:"cost_last_30d,omitempty"`

	// CostLast7D Total spend over the last 7 UTC days (incl. today).
	CostLast7D *float64 `json:"cost_last_7d,omitempty"`

	// CostToday Total spend on the current UTC day.
	CostToday  *float64    `json:"cost_today,omitempty"`
	DailyCosts []DailyCost `json:"daily_costs,omitempty"`
	Object     *string     `json:"object,omitempty"`

	// Sessions Per-session detail, newest activity first.
	Sessions []SessionUsage `json:"sessions,omitempty"`

	// TotalCostUSD All-time total spend from the daily rollup.
	TotalCostUSD *float64 `json:"total_cost_usd,omitempty"`
}

type ValidationError struct {
	Ctx   map[string]interface{}     `json:"ctx,omitempty"`
	Input interface{}                `json:"input,omitempty"`
	Loc   []ValidationError_Loc_Item `json:"loc"`
	Msg   string                     `json:"msg"`
	Type  string                     `json:"type"`
}

type ValidationErrorLoc0 = string

type ValidationErrorLoc1 = int

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