mcp

type AnalyticsConfig struct {
	// Enabled controls whether analytics are active. Default: true
	Enabled bool
	// AppVersion is the CLI version for tracking.
	AppVersion string
}

type AuditInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Schema optionally overrides the schema/database to inspect.
	Schema string `json:"schema,omitempty" jsonschema:"Schema or database name override"`
	// Table restricts the audit to a single table.
	Table string `json:"table,omitempty" jsonschema:"Optional table name"`
	// NullWarning sets the warning threshold for null rates.
	NullWarning float64 `json:"null_warning,omitempty" jsonschema:"Warning threshold for null percentage"`
	// NullError sets the error threshold for null rates.
	NullError float64 `json:"null_error,omitempty" jsonschema:"Error threshold for null percentage"`
}

type AuditOutput struct {
	Summary   AuditSummary        `json:"summary"`
	Results   []*dbmgr.TableAudit `json:"results"`
	Error     string              `json:"error,omitempty"`
	RequestID string              `json:"request_id,omitempty"`
}

type AuditSummary struct {
	TablesScanned int `json:"tables_scanned"`
	IssuesFound   int `json:"issues_found"`
}

type ColumnInfo struct {
	Name             string `json:"name"`
	Type             string `json:"type"`
	IsPrimary        bool   `json:"is_primary"`
	IsForeignKey     bool   `json:"is_foreign_key"`
	ReferencedTable  string `json:"referenced_table,omitempty"`
	ReferencedColumn string `json:"referenced_column,omitempty"`
}

type ColumnsInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Schema containing the table
	Schema string `json:"schema,omitempty" jsonschema:"Schema name (uses default if omitted)"`
	// Table name to describe
	Table string `json:"table" jsonschema:"Table name to describe"`
}

type ColumnsOutput struct {
	Columns   []ColumnInfo `json:"columns"`
	Table     string       `json:"table"`
	Schema    string       `json:"schema"`
	Error     string       `json:"error,omitempty"`
	RequestID string       `json:"request_id,omitempty"` // Unique ID for request tracing
}

type ConfirmInput struct {
	// Token is the confirmation token from a previous write response.
	Token string `json:"token" jsonschema:"Confirmation token from a previous whodb_query or hosted platform write response"`
}

type ConfirmOutput struct {
	PlatformSetupGuidance
	Columns     []string `json:"columns"`
	ColumnTypes []string `json:"column_types,omitempty"`
	Rows        [][]any  `json:"rows"`
	Error       string   `json:"error,omitempty"`
	Message     string   `json:"message,omitempty"`
	RequestID   string   `json:"request_id,omitempty"` // Unique ID for request tracing
}

type ConnectionInfo struct {
	Name     string `json:"name"`
	Type     string `json:"type"`
	Host     string `json:"host,omitempty"`
	Port     int    `json:"port,omitempty"`
	Database string `json:"database,omitempty"`
	Schema   string `json:"schema,omitempty"`
	Source   string `json:"source"` // "env" or "saved"
}

type ConnectionsInput struct{}

type ConnectionsOutput struct {
	Connections []ConnectionInfo `json:"connections"`
	Error       string           `json:"error,omitempty"`
	RequestID   string           `json:"request_id,omitempty"` // Unique ID for request tracing
}

type ERDColumn struct {
	Name             string `json:"name"`
	Type             string `json:"type,omitempty"`
	IsPrimary        bool   `json:"is_primary,omitempty"`
	IsForeignKey     bool   `json:"is_foreign_key,omitempty"`
	ReferencedTable  string `json:"referenced_table,omitempty"`
	ReferencedColumn string `json:"referenced_column,omitempty"`
}

type ERDInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Schema optionally overrides the schema/database to inspect.
	Schema string `json:"schema,omitempty" jsonschema:"Schema or database name override"`
}

type ERDOutput struct {
	Schema        string            `json:"schema,omitempty"`
	StorageUnits  []ERDStorageUnit  `json:"storage_units"`
	Relationships []ERDRelationship `json:"relationships"`
	Error         string            `json:"error,omitempty"`
	RequestID     string            `json:"request_id,omitempty"`
}

type ERDRelationship struct {
	SourceStorageUnit string `json:"source_storage_unit"`
	SourceColumn      string `json:"source_column,omitempty"`
	TargetStorageUnit string `json:"target_storage_unit"`
	TargetColumn      string `json:"target_column,omitempty"`
	RelationshipType  string `json:"relationship_type,omitempty"`
}

type ERDStorageUnit struct {
	Name    string      `json:"name"`
	Kind    string      `json:"kind,omitempty"`
	Columns []ERDColumn `json:"columns,omitempty"`
}

type ExplainInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Query is the SQL query to explain.
	Query string `json:"query" jsonschema:"SQL query to explain"`
}

type ExplainOutput struct {
	Columns     []string `json:"columns"`
	ColumnTypes []string `json:"column_types,omitempty"`
	Rows        [][]any  `json:"rows"`
	Error       string   `json:"error,omitempty"`
	RequestID   string   `json:"request_id,omitempty"`
}

type HTTPOptions struct {
	// Host to bind to (default: "localhost").
	Host string
	// Port to listen on (default: 3000).
	Port int
	// AuthToken, when non-empty, requires every /mcp request to present a matching
	// "Authorization: Bearer <token>" header. Recommended whenever the server binds
	// to a non-loopback interface.
	AuthToken string
}

type PendingConfirmation struct {
	Token      string
	Query      string
	Connection string
	ExpiresAt  time.Time
	// contains filtered or unexported fields
}

type PendingInfo struct {
	Token      string `json:"token"`
	Query      string `json:"query,omitempty"`
	Connection string `json:"connection,omitempty"`
	ExpiresAt  string `json:"expires_at"` // ISO 8601
}

type PendingInput struct{}

type PendingOutput struct {
	Pending   []PendingInfo `json:"pending"`
	Error     string        `json:"error,omitempty"`
	RequestID string        `json:"request_id,omitempty"`
}

type PendingPlatformAction struct {
	Token          string
	Operation      string
	Resource       string
	Action         string
	Summary        string
	Host           string
	OrgID          string
	ProjectID      string
	ProjectName    string
	SourceID       string
	SourceName     string
	SourceType     string
	Changes        []string
	CreateInput    platformapi.CreateSourceInput
	UpdateInput    platformapi.UpdateSourceInput
	Mutation       string
	Variables      map[string]any
	BundlePlan     *platformapi.BundlePlan
	WorkflowPlanID string
	WorkflowSteps  int
	IdempotencyKey string
	ExpiresAt      time.Time
	// contains filtered or unexported fields
}

type PlatformAccessInput struct {
	ResourceType string   `json:"resource_type,omitempty" jsonschema:"Resource type, for example dataset, app, or function"`
	ResourceID   string   `json:"resource_id,omitempty" jsonschema:"Resource id"`
	TeamID       string   `json:"team_id,omitempty" jsonschema:"Team id for team members"`
	Fields       []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields"`
}

type PlatformActionPreview struct {
	Operation    string                `json:"operation"`
	Resource     string                `json:"resource,omitempty"`
	Action       string                `json:"action,omitempty"`
	Summary      string                `json:"summary,omitempty"`
	Host         string                `json:"host"`
	OrgID        string                `json:"org_id"`
	ProjectID    string                `json:"project_id"`
	ProjectName  string                `json:"project_name,omitempty"`
	SourceID     string                `json:"source_id,omitempty"`
	SourceName   string                `json:"source_name,omitempty"`
	SourceType   string                `json:"source_type,omitempty"`
	Changes      []string              `json:"changes,omitempty"`
	FieldChanges []PlatformFieldChange `json:"field_changes,omitempty"`
	WillAffect   []string              `json:"will_affect,omitempty"`
	WorkflowID   string                `json:"workflow_id,omitempty"`
	StepCount    int                   `json:"step_count,omitempty"`
}

type PlatformAppInput struct {
	ID      string   `json:"id,omitempty" jsonschema:"App id for detail, files, or version view"`
	Version int      `json:"version,omitempty" jsonschema:"App version for a version view"`
	Env     string   `json:"env,omitempty" jsonschema:"Optional app environment for the current view"`
	Fields  []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields"`
}

type PlatformBuildPlan struct {
	Goal          string                  `json:"goal"`
	Scope         *PlatformOutputScope    `json:"scope,omitempty"`
	Prerequisites []PlatformWorkflowCheck `json:"prerequisites"`
	Phases        []PlatformPlanPhase     `json:"phases"`
	Gaps          []PlatformWorkflowGap   `json:"gaps"`
	Warnings      []string                `json:"warnings"`
}

type PlatformBuildPlanInput struct {
	Goal        string   `json:"goal" jsonschema:"User goal or desired app/data workflow to plan against."`
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder summaries. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit project lineage summary. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example phases, prerequisites, warnings."`
}

type PlatformBundleExportInput struct {
	IncludeFiles bool `json:"include_files,omitempty" jsonschema:"Include previewable uploaded file content up to max_file_bytes per file"`
	MaxFileBytes int  `json:"max_file_bytes,omitempty" jsonschema:"Maximum bytes to include per uploaded file when include_files is true"`
}

type PlatformBundleExportOutput struct {
	PlatformSetupGuidance
	Bundle    *platformapi.ProjectBundle `json:"bundle,omitempty"`
	Counts    map[string]int             `json:"counts,omitempty"`
	Error     string                     `json:"error,omitempty"`
	RequestID string                     `json:"request_id,omitempty"`
}

type PlatformBundlePlanInput struct {
	BundleJSON         string `json:"bundle_json" jsonschema:"Project bundle JSON from whodb_platform_bundle_export or resources export"`
	Prefix             string `json:"prefix,omitempty" jsonschema:"Optional prefix added to imported resource names"`
	RenameConflicts    bool   `json:"rename_conflicts,omitempty" jsonschema:"Create unique names for resources that conflict with existing resources"`
	OverwriteConflicts bool   `json:"overwrite_conflicts,omitempty" jsonschema:"Update resources that conflict with existing resources"`
}

type PlatformBundlePlanOutput struct {
	PlatformSetupGuidance
	Plan      *platformapi.BundlePlan `json:"plan,omitempty"`
	Counts    map[string]int          `json:"counts,omitempty"`
	Error     string                  `json:"error,omitempty"`
	RequestID string                  `json:"request_id,omitempty"`
}

type PlatformChangeImpact struct {
	Target         PlatformResourceGraphNode   `json:"target"`
	Action         string                      `json:"action,omitempty"`
	Affected       []PlatformResourceGraphNode `json:"affected"`
	Edges          []PlatformResourceGraphEdge `json:"edges"`
	SuggestedReads []string                    `json:"suggested_reads"`
	Warnings       []string                    `json:"warnings"`
}

type PlatformChangeImpactInput struct {
	Resource    string   `` /* 129-byte string literal not displayed */
	ID          string   `json:"id" jsonschema:"Resource id"`
	Action      string   `json:"action,omitempty" jsonschema:"Optional planned action, for example update, delete, run, deploy, promote_to_dataset"`
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder nodes. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit hosted lineage edges. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example target, affected, warnings."`
}

type PlatformCloneInput struct {
	Resource string `json:"resource" jsonschema:"Resource to clone: dataset, ontology, transform, or function"`
	Source   string `json:"source" jsonschema:"Source resource id, name, or api name"`
	NewName  string `json:"new_name" jsonschema:"New resource name or ontology api name/display name"`
}

type PlatformCreateDatasetInput struct {
	Name            string                       `json:"name" jsonschema:"Dataset name"`
	Description     string                       `json:"description,omitempty" jsonschema:"Optional dataset description"`
	SchemaMode      string                       `json:"schema_mode,omitempty" jsonschema:"Dataset schema mode, for example manual"`
	SourceID        string                       `json:"source_id,omitempty" jsonschema:"Optional hosted source id for source-backed datasets"`
	SourceObjectRef string                       `` /* 171-byte string literal not displayed */
	Columns         []PlatformDatasetColumnInput `json:"columns,omitempty" jsonschema:"Manual schema columns"`
}

type PlatformDataModelSummary struct {
	Sources        []PlatformWorkspaceItem     `json:"sources"`
	Datasets       []PlatformWorkspaceItem     `json:"datasets"`
	Ontologies     []PlatformWorkspaceItem     `json:"ontologies"`
	Relationships  []PlatformResourceGraphEdge `json:"relationships"`
	Gaps           []string                    `json:"gaps"`
	SuggestedTools []string                    `json:"suggested_tools"`
}

type PlatformDatasetColumnInput struct {
	Name       string `json:"name" jsonschema:"Column name"`
	Type       string `json:"type" jsonschema:"Column data type"`
	IsNullable bool   `json:"is_nullable,omitempty" jsonschema:"Whether the column may be null"`
	IsPrimary  bool   `json:"is_primary,omitempty" jsonschema:"Whether the column is part of the primary key"`
}

type PlatformDoctorInput struct{}

type PlatformDoctorOutput struct {
	Host                    string   `json:"host,omitempty"`
	Email                   string   `json:"email,omitempty"`
	WorkspaceSelected       bool     `json:"workspace_selected"`
	OrgID                   string   `json:"org_id,omitempty"`
	OrgName                 string   `json:"org_name,omitempty"`
	ProjectID               string   `json:"project_id,omitempty"`
	ProjectName             string   `json:"project_name,omitempty"`
	PlatformVersion         string   `json:"platform_version,omitempty"`
	ManifestProtocolVersion string   `json:"manifest_protocol_version,omitempty"`
	Checks                  []string `json:"checks"`
	Warnings                []string `json:"warnings,omitempty"`
	NextSteps               []string `json:"next_steps,omitempty"`
	Commands                []string `json:"commands,omitempty"`
	Error                   string   `json:"error,omitempty"`
	RequestID               string   `json:"request_id,omitempty"`
}

type PlatformEmptyInput struct {
	Name       string   `json:"name,omitempty" jsonschema:"Optional case-insensitive name substring filter for list tools"`
	Search     string   `json:"search,omitempty" jsonschema:"Optional case-insensitive search term; currently aliases name for list tools"`
	Type       string   `` /* 128-byte string literal not displayed */
	Status     string   `json:"status,omitempty" jsonschema:"Optional status filter for resources that expose status"`
	SchemaMode string   `json:"schema_mode,omitempty" jsonschema:"Optional dataset schema mode filter"`
	Deployed   string   `json:"deployed,omitempty" jsonschema:"Optional function deployment filter: true or false"`
	Limit      int      `json:"limit,omitempty" jsonschema:"Maximum list items to return; use offset to continue"`
	Offset     int      `json:"offset,omitempty" jsonschema:"Number of matching list items to skip"`
	Fields     []string `` /* 142-byte string literal not displayed */
}

type PlatformEntityInput struct {
	ID     string   `json:"id" jsonschema:"Resource id"`
	Fields []string `` /* 142-byte string literal not displayed */
}

type PlatformEntityWriteInput struct {
	ID string `json:"id" jsonschema:"Resource id"`
}

type PlatformErrorCode string

type PlatformFieldChange struct {
	Field    string         `json:"field"`
	After    map[string]any `json:"after,omitempty"`
	Redacted bool           `json:"redacted,omitempty"`
}

type PlatformFileColumnMapInput struct {
	SourceColumn  string `json:"source_column" jsonschema:"Column name in the file"`
	DatasetColumn string `json:"dataset_column" jsonschema:"Column name in the dataset"`
	DataType      string `json:"data_type" jsonschema:"Dataset data type"`
	IsNullable    bool   `json:"is_nullable,omitempty" jsonschema:"Whether the dataset column may be null"`
	IsPrimary     bool   `json:"is_primary,omitempty" jsonschema:"Whether the dataset column is part of the primary key"`
}

type PlatformFileInspectInput struct {
	FileID      string   `json:"file_id" jsonschema:"Project file id"`
	SheetIndex  *int     `json:"sheet_index,omitempty" jsonschema:"Optional spreadsheet sheet index"`
	IncludeRows bool     `json:"include_rows,omitempty" jsonschema:"Include preview rows. Defaults to false to keep context compact."`
	Fields      []string `` /* 132-byte string literal not displayed */
}

type PlatformFilePreviewInput struct {
	FileID     string   `json:"file_id" jsonschema:"Project file id"`
	SheetIndex *int     `json:"sheet_index,omitempty" jsonschema:"Optional spreadsheet sheet index"`
	Fields     []string `` /* 139-byte string literal not displayed */
}

type PlatformFileSearchInput struct {
	Query  string   `json:"query" jsonschema:"File search query"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformFilesInput struct {
	FolderID string   `json:"folder_id,omitempty" jsonschema:"Folder id. Omit for project root."`
	Name     string   `json:"name,omitempty" jsonschema:"Optional case-insensitive name substring filter"`
	Kind     string   `json:"kind,omitempty" jsonschema:"Optional entry kind filter: file or folder"`
	MIMEType string   `json:"mime_type,omitempty" jsonschema:"Optional file MIME type substring filter"`
	Fields   []string `` /* 142-byte string literal not displayed */
}

type PlatformGapAnalysis struct {
	Goal        string                `json:"goal,omitempty"`
	Scope       *PlatformOutputScope  `json:"scope,omitempty"`
	Counts      map[string]int        `json:"counts"`
	Ready       []string              `json:"ready"`
	Gaps        []PlatformWorkflowGap `json:"gaps"`
	NextActions []PlatformNextAction  `json:"next_actions"`
	Warnings    []string              `json:"warnings"`
}

type PlatformGapAnalysisInput struct {
	Goal        string   `json:"goal,omitempty" jsonschema:"Optional user goal or desired app/data workflow to analyze gaps against."`
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder summaries. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit project lineage summary. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example gaps, ready, counts, next_actions."`
}

type PlatformGenericWriteInput struct {
	Resource       string         `` /* 144-byte string literal not displayed */
	ID             string         `json:"id,omitempty" jsonschema:"Resource id for update, delete, or action operations"`
	Action         string         `` /* 133-byte string literal not displayed */
	IdempotencyKey string         `` /* 147-byte string literal not displayed */
	Payload        map[string]any `` /* 164-byte string literal not displayed */
	PayloadJSON    string         `` /* 159-byte string literal not displayed */
}

type PlatformGenericWriteOutput struct {
	PlatformSetupGuidance
	ConfirmationRequired bool                    `json:"confirmation_required,omitempty"`
	ConfirmationToken    string                  `json:"confirmation_token,omitempty"`
	ConfirmationAction   string                  `json:"confirmation_action,omitempty"`
	ConfirmationPreview  *PlatformActionPreview  `json:"confirmation_preview,omitempty"`
	ConfirmationExpiry   string                  `json:"confirmation_expiry,omitempty"`
	Warning              string                  `json:"warning,omitempty"`
	Status               string                  `json:"status,omitempty"`
	IdempotencyReplayed  bool                    `json:"idempotency_replayed,omitempty"`
	ResultJSON           string                  `json:"result_json,omitempty"`
	Error                string                  `json:"error,omitempty"`
	ErrorCode            string                  `json:"error_code,omitempty"`
	Retryable            bool                    `json:"retryable,omitempty"`
	SuggestedTools       []string                `json:"suggested_tools,omitempty"`
	Recovery             *PlatformRecoveryAdvice `json:"recovery,omitempty"`
	RequestID            string                  `json:"request_id,omitempty"`
}

type PlatformLineageInput struct {
	RootID    string   `json:"root_id" jsonschema:"Root node id"`
	RootType  string   `json:"root_type" jsonschema:"Root node type"`
	Direction string   `json:"direction,omitempty" jsonschema:"Optional lineage direction"`
	MaxDepth  int      `json:"max_depth,omitempty" jsonschema:"Optional maximum graph depth"`
	Fields    []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformLineageNeighborsInput struct {
	NodeID   string   `json:"node_id" jsonschema:"Node id"`
	NodeType string   `json:"node_type" jsonschema:"Node type"`
	Fields   []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformLineageSummary struct {
	NodeCount int `json:"node_count"`
	EdgeCount int `json:"edge_count"`
}

type PlatformNextAction struct {
	Priority       int      `json:"priority"`
	Area           string   `json:"area"`
	Title          string   `json:"title"`
	Reason         string   `json:"reason"`
	SuggestedTools []string `json:"suggested_tools"`
	ReadOnly       bool     `json:"read_only"`
}

type PlatformNextActions struct {
	Goal     string               `json:"goal,omitempty"`
	Actions  []PlatformNextAction `json:"actions"`
	Warnings []string             `json:"warnings"`
}

type PlatformNextActionsInput struct {
	Goal        string   `json:"goal,omitempty" jsonschema:"Optional user goal used to keep suggested actions relevant."`
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder summaries. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit project lineage summary. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example actions, warnings, goal."`
}

type PlatformOntologyFastLookupInput struct {
	EntityID string   `json:"entity_id" jsonschema:"Ontology id"`
	Fields   []string `json:"fields" jsonschema:"Ontology properties to include in the lookup"`
	Reason   string   `json:"reason,omitempty" jsonschema:"Optional reason for the lookup"`
}

type PlatformOntologyFollowLinkInput struct {
	EntityID    string   `json:"entity_id" jsonschema:"Ontology id"`
	PrimaryKey  string   `json:"primary_key" jsonschema:"Primary key value of the source ontology row"`
	LinkAPIName string   `json:"link_api_name" jsonschema:"Ontology link apiName to follow"`
	Limit       int      `json:"limit,omitempty" jsonschema:"Maximum rows to return"`
	Offset      int      `json:"offset,omitempty" jsonschema:"Row offset"`
	Fields      []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformOntologyRecordInput struct {
	EntityID      string            `json:"entity_id" jsonschema:"Ontology id"`
	Values        map[string]string `json:"values" jsonschema:"Record values keyed by ontology property"`
	UpdateColumns []string          `json:"update_columns,omitempty" jsonschema:"Ontology properties to update; required for update"`
}

type PlatformOrgInfo struct {
	ID       string `json:"id"`
	Name     string `json:"name"`
	Slug     string `json:"slug"`
	Selected bool   `json:"selected"`
}

type PlatformOrgsInput struct {
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformOrgsOutput struct {
	PlatformSetupGuidance
	Host      string               `json:"host,omitempty"`
	Orgs      []PlatformOrgInfo    `json:"orgs"`
	Items     []map[string]any     `json:"items,omitempty"`
	Count     int                  `json:"count"`
	Scope     *PlatformOutputScope `json:"scope,omitempty"`
	Fields    []string             `json:"fields,omitempty"`
	Warnings  []string             `json:"warnings,omitempty"`
	Error     string               `json:"error,omitempty"`
	RequestID string               `json:"request_id,omitempty"`
}

type PlatformOutputScope struct {
	Host        string `json:"host,omitempty"`
	OrgID       string `json:"org_id,omitempty"`
	OrgName     string `json:"org_name,omitempty"`
	ProjectID   string `json:"project_id,omitempty"`
	ProjectName string `json:"project_name,omitempty"`
}

type PlatformPackageInput struct {
	ID     string   `json:"id,omitempty" jsonschema:"Package or installation id"`
	Search string   `json:"search,omitempty" jsonschema:"Optional package library search"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields"`
}

type PlatformPackagePreviewInput struct {
	InputJSON string   `json:"input_json" jsonschema:"JSON object matching the selected package preview input type"`
	Fields    []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields"`
}

type PlatformPendingInfo struct {
	Token     string                `json:"token"`
	Action    PlatformActionPreview `json:"action"`
	ExpiresAt string                `json:"expires_at"`
}

type PlatformPendingInput struct{}

type PlatformPendingOutput struct {
	Pending   []PlatformPendingInfo `json:"pending"`
	Error     string                `json:"error,omitempty"`
	RequestID string                `json:"request_id,omitempty"`
}

type PlatformPlanPhase struct {
	Phase       string   `json:"phase"`
	Objective   string   `json:"objective"`
	ReadTools   []string `json:"read_tools,omitempty"`
	WriteTools  []string `json:"write_tools,omitempty"`
	VerifyTools []string `json:"verify_tools,omitempty"`
	Notes       []string `json:"notes,omitempty"`
}

type PlatformProjectCreateInput struct {
	Org         string `json:"org,omitempty" jsonschema:"Organization id, slug, or name. Defaults to the selected organization when available."`
	Name        string `json:"name" jsonschema:"Project name"`
	Description string `json:"description,omitempty" jsonschema:"Project description"`
}

type PlatformProjectDeleteInput struct {
	Org     string `json:"org,omitempty" jsonschema:"Organization id, slug, or name. Defaults to the selected organization when available."`
	Project string `json:"project" jsonschema:"Project id, slug, or name"`
}

type PlatformProjectHealth struct {
	Counts   map[string]int          `json:"counts"`
	Checks   []PlatformWorkflowCheck `json:"checks"`
	Warnings []string                `json:"warnings"`
	Scope    *PlatformOutputScope    `json:"scope,omitempty"`
	Next     []PlatformNextAction    `json:"next,omitempty"`
	Graph    *PlatformLineageSummary `json:"graph,omitempty"`
}

type PlatformProjectInfo struct {
	ID          string `json:"id"`
	OrgID       string `json:"org_id"`
	OrgName     string `json:"org_name,omitempty"`
	Name        string `json:"name"`
	Slug        string `json:"slug"`
	Description string `json:"description,omitempty"`
	Selected    bool   `json:"selected"`
}

type PlatformProjectRenameInput struct {
	Org     string `json:"org,omitempty" jsonschema:"Organization id, slug, or name. Defaults to the selected organization when available."`
	Project string `json:"project" jsonschema:"Project id, slug, or name"`
	Name    string `json:"name" jsonschema:"New project name"`
	Slug    string `json:"slug,omitempty" jsonschema:"Optional new project slug"`
}

type PlatformProjectsInput struct {
	Org    string   `json:"org,omitempty" jsonschema:"Organization id, slug, or name. Defaults to the selected organization when available."`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformProjectsOutput struct {
	PlatformSetupGuidance
	Host      string                `json:"host,omitempty"`
	OrgID     string                `json:"org_id,omitempty"`
	OrgName   string                `json:"org_name,omitempty"`
	Projects  []PlatformProjectInfo `json:"projects"`
	Items     []map[string]any      `json:"items,omitempty"`
	Count     int                   `json:"count"`
	Scope     *PlatformOutputScope  `json:"scope,omitempty"`
	Fields    []string              `json:"fields,omitempty"`
	Warnings  []string              `json:"warnings,omitempty"`
	Error     string                `json:"error,omitempty"`
	RequestID string                `json:"request_id,omitempty"`
}

type PlatformPromoteFileToDatasetInput struct {
	FileID      string                       `json:"file_id" jsonschema:"Hosted project file id"`
	Name        string                       `json:"name" jsonschema:"Dataset name"`
	Description string                       `json:"description,omitempty" jsonschema:"Optional dataset description"`
	SheetIndex  *int                         `json:"sheet_index,omitempty" jsonschema:"Optional tabular sheet index"`
	ColumnMap   []PlatformFileColumnMapInput `json:"column_map" jsonschema:"Column mappings, usually from whodb_platform_file_inspect"`
}

type PlatformProviderModelsInput struct {
	ProviderID string   `json:"provider_id" jsonschema:"Hosted AI provider id"`
	Fields     []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformReadOutput struct {
	PlatformSetupGuidance
	Data           any                     `json:"data,omitempty"`
	Items          []map[string]any        `json:"items,omitempty"`
	Count          int                     `json:"count"`
	Scope          *PlatformOutputScope    `json:"scope,omitempty"`
	Fields         []string                `json:"fields,omitempty"`
	Warnings       []string                `json:"warnings,omitempty"`
	Truncated      bool                    `json:"truncated"`
	Error          string                  `json:"error,omitempty"`
	ErrorCode      string                  `json:"error_code,omitempty"`
	Retryable      bool                    `json:"retryable,omitempty"`
	SuggestedTools []string                `json:"suggested_tools,omitempty"`
	Recovery       *PlatformRecoveryAdvice `json:"recovery,omitempty"`
	RequestID      string                  `json:"request_id,omitempty"`
}

type PlatformRecipeStep struct {
	Order       int      `json:"order"`
	Name        string   `json:"name"`
	Objective   string   `json:"objective"`
	ReadTools   []string `json:"read_tools,omitempty"`
	WriteTools  []string `json:"write_tools,omitempty"`
	VerifyTools []string `json:"verify_tools,omitempty"`
	Notes       []string `json:"notes,omitempty"`
}

type PlatformRecoveryAdvice struct {
	LikelyCause string
	NextSteps   []string
}

type PlatformResolveResourceInput struct {
	Resource string `json:"resource" jsonschema:"Resource type such as source, dataset, ontology, transform, function, secret, or ai_provider"`
	Query    string `json:"query" jsonschema:"Resource id, exact name, or name fragment"`
}

type PlatformResolveResourceOutput struct {
	PlatformSetupGuidance
	Resource       string                     `json:"resource,omitempty"`
	Query          string                     `json:"query,omitempty"`
	Resolved       *PlatformResolvedResource  `json:"resolved,omitempty"`
	Candidates     []PlatformResolvedResource `json:"candidates,omitempty"`
	Ambiguous      bool                       `json:"ambiguous,omitempty"`
	Error          string                     `json:"error,omitempty"`
	ErrorCode      string                     `json:"error_code,omitempty"`
	Retryable      bool                       `json:"retryable,omitempty"`
	SuggestedTools []string                   `json:"suggested_tools,omitempty"`
	RequestID      string                     `json:"request_id,omitempty"`
}

type PlatformResolvedResource struct {
	ID    string `json:"id"`
	Name  string `json:"name"`
	Type  string `json:"type"`
	Match string `json:"match"`
}

type PlatformResourceGraph struct {
	Nodes    []PlatformResourceGraphNode `json:"nodes"`
	Edges    []PlatformResourceGraphEdge `json:"edges"`
	Counts   map[string]int              `json:"counts"`
	Warnings []string                    `json:"warnings"`
}

type PlatformResourceGraphEdge struct {
	FromID   string `json:"from_id"`
	FromType string `json:"from_type"`
	ToID     string `json:"to_id"`
	ToType   string `json:"to_type"`
	Kind     string `json:"kind"`
}

type PlatformResourceGraphInput struct {
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder nodes. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit hosted lineage edges. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example nodes, edges, warnings."`
}

type PlatformResourceGraphNode struct {
	ID       string            `json:"id"`
	Type     string            `json:"type"`
	Name     string            `json:"name,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type PlatformRestoreInput struct {
	Resource string `json:"resource" jsonschema:"Soft-deletable resource: source, ontology, dataset, transform, function, app, folder, or file"`
	ID       string `json:"id" jsonschema:"Deleted resource id"`
}

type PlatformRowsInput struct {
	ID     string   `json:"id" jsonschema:"Resource id"`
	Limit  int      `json:"limit,omitempty" jsonschema:"Maximum rows to return"`
	Offset int      `json:"offset,omitempty" jsonschema:"Row offset"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformRuntimeReadiness struct {
	AIProviders []PlatformWorkspaceItem `json:"ai_providers"`
	Secrets     []PlatformWorkspaceItem `json:"secrets"`
	Functions   []PlatformWorkspaceItem `json:"functions"`
	Transforms  []PlatformWorkspaceItem `json:"transforms"`
	Checks      []PlatformWorkflowCheck `json:"checks"`
	Warnings    []string                `json:"warnings"`
}

type PlatformSetupGuidance struct {
	SetupStatus string   `json:"setup_status,omitempty"`
	Commands    []string `json:"commands,omitempty"`
	NextSteps   []string `json:"next_steps,omitempty"`
}

type PlatformSetupStatusInput struct{}

type PlatformSetupStatusOutput struct {
	Host              string   `json:"host"`
	Status            string   `json:"status"`
	Authenticated     bool     `json:"authenticated"`
	WorkspaceSelected bool     `json:"workspace_selected"`
	Email             string   `json:"email,omitempty"`
	AccountID         string   `json:"account_id,omitempty"`
	OrgID             string   `json:"org_id,omitempty"`
	OrgName           string   `json:"org_name,omitempty"`
	ProjectID         string   `json:"project_id,omitempty"`
	ProjectName       string   `json:"project_name,omitempty"`
	Commands          []string `json:"commands"`
	NextSteps         []string `json:"next_steps"`
	Error             string   `json:"error,omitempty"`
	RequestID         string   `json:"request_id,omitempty"`
}

type PlatformSourceColumnsInput struct {
	Source string   `json:"source" jsonschema:"Hosted source id or name"`
	Ref    string   `json:"ref" jsonschema:"Object ref as kind:path, for example table:public.users"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformSourceColumnsOutput struct {
	PlatformSetupGuidance
	Columns   []platformapi.Column `json:"columns"`
	Items     []map[string]any     `json:"items,omitempty"`
	Count     int                  `json:"count"`
	Scope     *PlatformOutputScope `json:"scope,omitempty"`
	Fields    []string             `json:"fields,omitempty"`
	Warnings  []string             `json:"warnings,omitempty"`
	Error     string               `json:"error,omitempty"`
	RequestID string               `json:"request_id,omitempty"`
}

type PlatformSourceConfigInput struct {
	Source string `json:"source" jsonschema:"Hosted source id or name"`
}

type PlatformSourceConfigOutput struct {
	PlatformSetupGuidance
	Source    *platformapi.Source              `json:"source,omitempty"`
	Config    platformapi.RedactedSourceConfig `json:"config"`
	Error     string                           `json:"error,omitempty"`
	RequestID string                           `json:"request_id,omitempty"`
}

type PlatformSourceConstraintsInput struct {
	Source string   `json:"source" jsonschema:"Hosted source id or name"`
	Ref    string   `json:"ref" jsonschema:"Object ref as kind:path, for example table:public.users"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformSourceContentInput struct {
	Source string   `json:"source" jsonschema:"Hosted source id or name"`
	Ref    string   `json:"ref" jsonschema:"Object ref as kind:path, for example file:notes/report.txt"`
	Fields []string `` /* 142-byte string literal not displayed */
}

type PlatformSourceCreateInput struct {
	SourceType string            `json:"source_type" jsonschema:"Hosted source type id"`
	Name       string            `json:"name" jsonschema:"Source display name"`
	Hostname   string            `json:"hostname,omitempty"`
	Port       string            `json:"port,omitempty"`
	Username   string            `json:"username,omitempty"`
	Password   string            `json:"password,omitempty"`
	Database   string            `json:"database,omitempty"`
	Advanced   map[string]string `json:"advanced,omitempty"`
}

type PlatformSourceDeleteInput struct {
	Source string `json:"source" jsonschema:"Hosted source id or name"`
}

type PlatformSourceFieldsInput struct {
	SourceType string   `json:"source_type" jsonschema:"Hosted source type id"`
	Fields     []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformSourceFieldsOutput struct {
	PlatformSetupGuidance
	SourceType     string                              `json:"source_type,omitempty"`
	Fields         []platformapi.SourceConnectionField `json:"fields"`
	Items          []map[string]any                    `json:"items,omitempty"`
	Count          int                                 `json:"count"`
	Scope          *PlatformOutputScope                `json:"scope,omitempty"`
	SelectedFields []string                            `json:"selected_fields,omitempty"`
	Warnings       []string                            `json:"warnings,omitempty"`
	Error          string                              `json:"error,omitempty"`
	RequestID      string                              `json:"request_id,omitempty"`
}

type PlatformSourceObjectsInput struct {
	Source     string   `json:"source" jsonschema:"Hosted source id or name"`
	Parent     string   `json:"parent,omitempty" jsonschema:"Parent object ref as kind:path, for example schema:public"`
	Kinds      []string `json:"kinds,omitempty" jsonschema:"Object kinds to include, for example Table or View"`
	PageSize   int      `json:"page_size,omitempty" jsonschema:"Maximum objects to return"`
	PageOffset int      `json:"page_offset,omitempty" jsonschema:"Object offset"`
	Fields     []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformSourceObjectsOutput struct {
	PlatformSetupGuidance
	Objects   []platformapi.SourceObject `json:"objects"`
	Items     []map[string]any           `json:"items,omitempty"`
	Count     int                        `json:"count"`
	Scope     *PlatformOutputScope       `json:"scope,omitempty"`
	Fields    []string                   `json:"fields,omitempty"`
	Warnings  []string                   `json:"warnings,omitempty"`
	Error     string                     `json:"error,omitempty"`
	RequestID string                     `json:"request_id,omitempty"`
}

type PlatformSourceRowsInput struct {
	Source string `json:"source" jsonschema:"Hosted source id or name"`
	Ref    string `json:"ref" jsonschema:"Object ref as kind:path, for example table:public.users"`
	Limit  int    `json:"limit,omitempty" jsonschema:"Maximum rows to return"`
	Offset int    `json:"offset,omitempty" jsonschema:"Row offset"`
}

type PlatformSourceRowsOutput struct {
	PlatformSetupGuidance
	Columns   []platformapi.Column `json:"columns"`
	Rows      [][]string           `json:"rows"`
	Total     int                  `json:"total"`
	Truncated bool                 `json:"truncated"`
	Error     string               `json:"error,omitempty"`
	RequestID string               `json:"request_id,omitempty"`
}

type PlatformSourceTestInput struct {
	Source     string            `` /* 131-byte string literal not displayed */
	SourceType string            `json:"source_type,omitempty" jsonschema:"Hosted source type id for draft connection tests"`
	Hostname   string            `json:"hostname,omitempty"`
	Port       string            `json:"port,omitempty"`
	Username   string            `json:"username,omitempty"`
	Password   string            `json:"password,omitempty"`
	Database   string            `json:"database,omitempty"`
	Advanced   map[string]string `json:"advanced,omitempty"`
}

type PlatformSourceTestOutput struct {
	PlatformSetupGuidance
	Status     string              `json:"status,omitempty"`
	Source     *platformapi.Source `json:"source,omitempty"`
	SourceType string              `json:"source_type,omitempty"`
	Error      string              `json:"error,omitempty"`
	RequestID  string              `json:"request_id,omitempty"`
}

type PlatformSourceTypesInput struct {
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformSourceTypesOutput struct {
	PlatformSetupGuidance
	SourceTypes []platformapi.SourceType `json:"source_types"`
	Items       []map[string]any         `json:"items,omitempty"`
	Count       int                      `json:"count"`
	Scope       *PlatformOutputScope     `json:"scope,omitempty"`
	Fields      []string                 `json:"fields,omitempty"`
	Warnings    []string                 `json:"warnings,omitempty"`
	Error       string                   `json:"error,omitempty"`
	RequestID   string                   `json:"request_id,omitempty"`
}

type PlatformSourceUpdateInput struct {
	Source   string            `json:"source" jsonschema:"Hosted source id or name"`
	Name     string            `json:"name,omitempty" jsonschema:"New source display name"`
	Hostname string            `json:"hostname,omitempty"`
	Port     string            `json:"port,omitempty"`
	Username string            `json:"username,omitempty"`
	Password string            `json:"password,omitempty"`
	Database string            `json:"database,omitempty"`
	Advanced map[string]string `json:"advanced,omitempty"`
}

type PlatformSourceWriteOutput struct {
	PlatformSetupGuidance
	ConfirmationRequired bool                   `json:"confirmation_required,omitempty"`
	ConfirmationToken    string                 `json:"confirmation_token,omitempty"`
	ConfirmationAction   string                 `json:"confirmation_action,omitempty"`
	ConfirmationPreview  *PlatformActionPreview `json:"confirmation_preview,omitempty"`
	ConfirmationExpiry   string                 `json:"confirmation_expiry,omitempty"`
	Warning              string                 `json:"warning,omitempty"`
	Source               *platformapi.Source    `json:"source,omitempty"`
	Status               string                 `json:"status,omitempty"`
	Error                string                 `json:"error,omitempty"`
	RequestID            string                 `json:"request_id,omitempty"`
}

type PlatformSourcesInput struct {
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include in items"`
}

type PlatformSourcesOutput struct {
	PlatformSetupGuidance
	Host      string               `json:"host,omitempty"`
	OrgID     string               `json:"org_id,omitempty"`
	ProjectID string               `json:"project_id,omitempty"`
	Sources   []platformapi.Source `json:"sources"`
	Items     []map[string]any     `json:"items,omitempty"`
	Count     int                  `json:"count"`
	Scope     *PlatformOutputScope `json:"scope,omitempty"`
	Fields    []string             `json:"fields,omitempty"`
	Warnings  []string             `json:"warnings,omitempty"`
	Error     string               `json:"error,omitempty"`
	RequestID string               `json:"request_id,omitempty"`
}

type PlatformStatusInput struct{}

type PlatformStatusOutput struct {
	PlatformSetupGuidance
	Host                    string   `json:"host,omitempty"`
	UserID                  string   `json:"user_id,omitempty"`
	Email                   string   `json:"email,omitempty"`
	DefaultOrgID            string   `json:"default_org_id,omitempty"`
	DefaultOrgName          string   `json:"default_org_name,omitempty"`
	DefaultProjectID        string   `json:"default_project_id,omitempty"`
	DefaultProjectName      string   `json:"default_project_name,omitempty"`
	WorkspaceSelected       bool     `json:"workspace_selected"`
	PlatformVersion         string   `json:"platform_version,omitempty"`
	ManifestProtocolVersion string   `json:"manifest_protocol_version,omitempty"`
	AutoSelected            []string `json:"auto_selected,omitempty"`
	Error                   string   `json:"error,omitempty"`
	RequestID               string   `json:"request_id,omitempty"`
}

type PlatformTransformRunsInput struct {
	TransformID string   `json:"transform_id" jsonschema:"Transform id"`
	Limit       int      `json:"limit,omitempty" jsonschema:"Maximum runs to return"`
	Fields      []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformTransformWaitInput struct {
	TransformID string   `json:"transform_id" jsonschema:"Hosted transform id"`
	RunID       string   `json:"run_id" jsonschema:"Transform run id returned by the run action or transform_runs tool"`
	TimeoutSecs int      `json:"timeout_seconds,omitempty" jsonschema:"Maximum wait time, default 60 seconds"`
	PollSecs    int      `json:"poll_seconds,omitempty" jsonschema:"Polling interval, default 2 seconds"`
	Fields      []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformVersionInput struct {
	ID         string   `json:"id" jsonschema:"Object id"`
	ObjectType string   `json:"object_type" jsonschema:"Versionable object type: app, function, transform, dataset, or ontology"`
	Fields     []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields"`
}

type PlatformWorkflowApplyInput struct {
	PlanID string `json:"plan_id" jsonschema:"Workflow plan id returned by whodb_platform_workflow_plan"`
}

type PlatformWorkflowCheck struct {
	Name     string `json:"name"`
	Status   string `json:"status"`
	Reason   string `json:"reason,omitempty"`
	ToolHint string `json:"tool_hint,omitempty"`
}

type PlatformWorkflowGap struct {
	Area           string   `json:"area"`
	Severity       string   `json:"severity"`
	Missing        string   `json:"missing"`
	Reason         string   `json:"reason"`
	SuggestedTools []string `json:"suggested_tools"`
}

type PlatformWorkflowGetInput struct {
	PlanID string `json:"plan_id" jsonschema:"Workflow plan id"`
}

type PlatformWorkflowListInput struct{}

type PlatformWorkflowOutput struct {
	PlatformSetupGuidance
	ConfirmationRequired bool                    `json:"confirmation_required,omitempty"`
	ConfirmationToken    string                  `json:"confirmation_token,omitempty"`
	ConfirmationExpiry   string                  `json:"confirmation_expiry,omitempty"`
	Plan                 map[string]any          `json:"plan,omitempty"`
	Plans                []map[string]any        `json:"plans,omitempty"`
	Status               string                  `json:"status,omitempty"`
	Message              string                  `json:"message,omitempty"`
	Error                string                  `json:"error,omitempty"`
	ErrorCode            string                  `json:"error_code,omitempty"`
	Retryable            bool                    `json:"retryable,omitempty"`
	SuggestedTools       []string                `json:"suggested_tools,omitempty"`
	Recovery             *PlatformRecoveryAdvice `json:"recovery,omitempty"`
	RequestID            string                  `json:"request_id,omitempty"`
}

type PlatformWorkflowPlanInput struct {
	Goal  string                      `json:"goal" jsonschema:"Desired end state for this hosted platform workflow"`
	Steps []PlatformWorkflowStepInput `json:"steps" jsonschema:"Ordered hosted platform writes to validate and execute"`
}

type PlatformWorkflowRecipeInput struct {
	Goal   string   `json:"goal" jsonschema:"Desired end-to-end platform outcome, for example set up ETL or create an ontology"`
	Fields []string `json:"fields,omitempty" jsonschema:"Optional top-level output fields to include"`
}

type PlatformWorkflowRecipeOutput struct {
	Goal        string               `json:"goal"`
	Recipe      string               `json:"recipe"`
	Description string               `json:"description"`
	Steps       []PlatformRecipeStep `json:"steps"`
	ReadFirst   []string             `json:"read_first"`
	VerifyWith  []string             `json:"verify_with"`
	Warnings    []string             `json:"warnings,omitempty"`
}

type PlatformWorkflowStepInput struct {
	ID        string         `json:"id" jsonschema:"Stable step id used for dependencies and retries."`
	Operation string         `json:"operation" jsonschema:"create, update, delete, or action"`
	Resource  string         `json:"resource" jsonschema:"Platform resource such as dataset, transform, function, or app"`
	Action    string         `json:"action,omitempty" jsonschema:"Action name when operation is action"`
	TargetID  string         `json:"target_id,omitempty" jsonschema:"Existing resource id for update, delete, or action"`
	Payload   map[string]any `json:"payload,omitempty" jsonschema:"Structured non-secret mutation payload"`
	DependsOn []string       `json:"depends_on,omitempty" jsonschema:"Step ids that must complete first"`
}

type PlatformWorkspaceItem struct {
	ID       string            `json:"id,omitempty"`
	Type     string            `json:"type"`
	Name     string            `json:"name,omitempty"`
	Status   string            `json:"status,omitempty"`
	Metadata map[string]string `json:"metadata,omitempty"`
}

type PlatformWorkspaceMap struct {
	Host        string                  `json:"host,omitempty"`
	OrgID       string                  `json:"org_id,omitempty"`
	OrgName     string                  `json:"org_name,omitempty"`
	ProjectID   string                  `json:"project_id,omitempty"`
	ProjectName string                  `json:"project_name,omitempty"`
	Counts      map[string]int          `json:"counts"`
	Sources     []PlatformWorkspaceItem `json:"sources"`
	Secrets     []PlatformWorkspaceItem `json:"secrets"`
	AIProviders []PlatformWorkspaceItem `json:"ai_providers"`
	Datasets    []PlatformWorkspaceItem `json:"datasets"`
	Ontologies  []PlatformWorkspaceItem `json:"ontologies"`
	Transforms  []PlatformWorkspaceItem `json:"transforms"`
	Functions   []PlatformWorkspaceItem `json:"functions"`
	Files       []PlatformWorkspaceItem `json:"files,omitempty"`
	Folders     []PlatformWorkspaceItem `json:"folders,omitempty"`
	StorageUsed int                     `json:"storage_used"`
	Lineage     *PlatformLineageSummary `json:"lineage,omitempty"`
	Warnings    []string                `json:"warnings"`
}

type PlatformWorkspaceMapInput struct {
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder summaries. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit project lineage summary. Defaults to false."`
	Fields      []string `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example counts, sources, datasets, warnings."`
}

type PlatformWorkspaceSummary struct {
	Goal             string                  `json:"goal,omitempty"`
	Scope            *PlatformOutputScope    `json:"scope,omitempty"`
	Counts           map[string]int          `json:"counts"`
	Highlights       []string                `json:"highlights"`
	Gaps             []PlatformWorkflowGap   `json:"gaps"`
	NextActions      []PlatformNextAction    `json:"next_actions"`
	RecommendedTools []string                `json:"recommended_tools"`
	Lineage          *PlatformLineageSummary `json:"lineage,omitempty"`
	Warnings         []string                `json:"warnings"`
}

type PlatformWorkspaceSummaryInput struct {
	Goal        string   `json:"goal,omitempty" jsonschema:"Optional user goal used to tailor highlights and recommended next tools."`
	OmitFiles   bool     `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder summaries. Defaults to false."`
	OmitLineage bool     `json:"omit_lineage,omitempty" jsonschema:"Omit project lineage summary. Defaults to false."`
	Fields      []string `` /* 131-byte string literal not displayed */
}

type PlatformWritePlan struct {
	Operation            string                      `json:"operation"`
	Resource             string                      `json:"resource"`
	Action               string                      `json:"action,omitempty"`
	Mutation             string                      `json:"mutation"`
	ConfirmationRequired bool                        `json:"confirmation_required"`
	Preview              *PlatformActionPreview      `json:"preview,omitempty"`
	PayloadKeys          []string                    `json:"payload_keys,omitempty"`
	SuggestedReads       []string                    `json:"suggested_reads"`
	Affected             []PlatformResourceGraphNode `json:"affected,omitempty"`
	Warnings             []string                    `json:"warnings"`
	Preflight            []PlatformWritePreflight    `json:"preflight"`
}

type PlatformWritePlanInput struct {
	Resource    string         `` /* 144-byte string literal not displayed */
	ID          string         `json:"id,omitempty" jsonschema:"Resource id for update, delete, or action operations"`
	Action      string         `` /* 132-byte string literal not displayed */
	Operation   string         `json:"operation" jsonschema:"Write operation: create, update, delete, or action"`
	Payload     map[string]any `json:"payload,omitempty" jsonschema:"Structured payload to validate and summarize. This tool never executes it."`
	PayloadJSON string         `json:"payload_json,omitempty" jsonschema:"Legacy JSON object payload. Prefer payload; this tool never executes it."`
	OmitFiles   bool           `json:"omit_files,omitempty" jsonschema:"Omit root folder file and folder nodes for impact lookup. Defaults to false."`
	OmitLineage bool           `json:"omit_lineage,omitempty" jsonschema:"Omit hosted lineage edges for impact lookup. Defaults to false."`
	Fields      []string       `json:"fields,omitempty" jsonschema:"Top-level output fields to include, for example preview, affected, warnings."`
}

type PlatformWritePreflight struct {
	Name   string `json:"name"`
	Status string `json:"status"`
	Reason string `json:"reason,omitempty"`
	Tool   string `json:"tool,omitempty"`
}

type QueryInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Query is the SQL query to execute
	Query string `json:"query" jsonschema:"SQL query to execute"`
	// Parameters for parameterized queries (optional).
	// Use placeholders in the query ($1, $2 for Postgres; ? for MySQL/SQLite).
	// Example: query="SELECT * FROM users WHERE id = $1", parameters=[42]
	Parameters []any `json:"parameters,omitempty" jsonschema:"Parameterized query values ($1/$2 for Postgres or ? for MySQL/SQLite)"`
}

type QueryOutput struct {
	Columns              []string `json:"columns"`
	ColumnTypes          []string `json:"column_types,omitempty"`
	Rows                 [][]any  `json:"rows"`
	Error                string   `json:"error,omitempty"`
	Warning              string   `json:"warning,omitempty"`
	ConfirmationRequired bool     `json:"confirmation_required,omitempty"`
	ConfirmationToken    string   `json:"confirmation_token,omitempty"`
	ConfirmationQuery    string   `json:"confirmation_query,omitempty"`
	ConfirmationExpiry   string   `json:"confirmation_expiry,omitempty"` // ISO 8601 timestamp when the token expires
	RequestID            string   `json:"request_id,omitempty"`          // Unique ID for request tracing
}

type SchemaDetail struct {
	Name   string      `json:"name"`
	Tables []TableInfo `json:"tables,omitempty"`
}

type SchemaDiffInput struct {
	// FromConnection is the base connection to compare from.
	FromConnection string `json:"from_connection" jsonschema:"Source connection name"`
	// ToConnection is the target connection to compare against.
	ToConnection string `json:"to_connection" jsonschema:"Target connection name"`
	// FromSchema optionally overrides the source schema/database name.
	FromSchema string `json:"from_schema,omitempty" jsonschema:"Source schema override"`
	// ToSchema optionally overrides the target schema/database name.
	ToSchema string `json:"to_schema,omitempty" jsonschema:"Target schema override"`
}

type SchemaDiffOutput struct {
	Result    *schemadiff.Result `json:"result,omitempty"`
	Error     string             `json:"error,omitempty"`
	RequestID string             `json:"request_id,omitempty"`
}

type SchemasInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// IncludeTables returns the tables within each schema in a single call.
	// Reduces round-trips when you need both schemas and tables.
	IncludeTables bool `json:"include_tables,omitempty" jsonschema:"Set true to also return tables within each schema in a single call"`
}

type SchemasOutput struct {
	Schemas   []string       `json:"schemas"`
	Details   []SchemaDetail `json:"details,omitempty"` // Populated when include_tables=true
	Error     string         `json:"error,omitempty"`
	RequestID string         `json:"request_id,omitempty"` // Unique ID for request tracing
}

type SecurityLevel string

type SecurityOptions struct {
	ReadOnly            bool
	ConfirmWrites       bool
	AllowWrite          bool
	SecurityLevel       SecurityLevel
	QueryTimeout        time.Duration
	MaxRows             int
	AllowMultiStatement bool
	AllowDrop           bool
	DefaultConnection   string   // Injected connection when not specified
	AllowedConnections  []string // If set, only these connections are accessible
}

type ServerOptions struct {
	// Logger for server messages (defaults to stderr).
	Logger *slog.Logger
	// Instructions provides guidance to LLMs on how to use this server.
	Instructions string
	// ReadOnly prevents INSERT, UPDATE, DELETE, DROP, CREATE, ALTER, TRUNCATE operations.
	// Default: true
	ReadOnly bool
	// ConfirmWrites enables human-in-the-loop confirmation for write operations.
	// When enabled, write operations return a confirmation token that must be approved.
	// Default: false
	ConfirmWrites bool
	// AllowWrite permits write operations without confirmation.
	// Default: false
	AllowWrite bool
	// SecurityLevel controls the strictness of query validation.
	// Options: "strict", "standard", "minimal". Default: "standard"
	SecurityLevel SecurityLevel
	// QueryTimeout is the maximum time a query can run before being cancelled.
	// Default: 30 seconds
	QueryTimeout time.Duration
	// MaxRows limits the number of rows returned by queries.
	// Default: 0 (unlimited). Set via --max-rows to enable truncation.
	MaxRows int
	// AllowMultiStatement permits multiple SQL statements in one query (separated by semicolons).
	// WARNING: Enabling this increases SQL injection risk.
	// Default: false
	AllowMultiStatement bool
	// AllowDrop permits DROP/TRUNCATE operations even in allow-write mode.
	// Without this, DROP is blocked unless --confirm-writes is used
	// Default: false
	AllowDrop bool
	// EnabledTools specifies which tools to enable. If empty, all tools are enabled.
	// Valid values: "query", "schemas", "tables", "columns", "connections", "confirm",
	// "pending", "explain", "diff", "erd", "audit", "suggestions"
	EnabledTools []string
	// DisabledTools specifies which tools to disable. Takes precedence over EnabledTools.
	// Valid values: "query", "schemas", "tables", "columns", "connections", "confirm",
	// "pending", "explain", "diff", "erd", "audit", "suggestions"
	DisabledTools []string
	// DefaultConnection is the connection to use when none is specified.
	// This simplifies AI interaction when working with a single database.
	DefaultConnection string
	// AllowedConnections restricts which connections can be used.
	// When set, only these connections are visible and accessible.
	// If DefaultConnection is not set, the first allowed connection becomes the default.
	AllowedConnections []string
	// PlatformEnabled runs hosted WhoDB platform mode.
	// When enabled, only hosted platform tools are registered.
	PlatformEnabled bool
}

type StatementType = sqlguard.StatementType

type SuggestionsInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Schema optionally overrides the schema/database to inspect.
	Schema string `json:"schema,omitempty" jsonschema:"Schema or database name override"`
}

type SuggestionsOutput struct {
	Suggestions []dbmgr.QuerySuggestion `json:"suggestions"`
	Error       string                  `json:"error,omitempty"`
	RequestID   string                  `json:"request_id,omitempty"`
}

type TableInfo struct {
	Name       string            `json:"name"`
	Attributes map[string]string `json:"attributes,omitempty"`
	Columns    []ColumnInfo      `json:"columns,omitempty"` // Populated when include_columns=true
}

type TablesInput struct {
	// Connection is the name of a saved connection or environment profile.
	Connection string `json:"connection" jsonschema:"Connection name (optional if only one exists)"`
	// Schema to list tables from (uses default if not specified)
	Schema string `json:"schema,omitempty" jsonschema:"Schema name (uses default if omitted)"`
	// IncludeColumns returns column details for each table in a single call.
	// Reduces round-trips when you need both tables and their columns.
	IncludeColumns bool `json:"include_columns,omitempty" jsonschema:"Set true to also return column details for each table in a single call"`
}

type TablesOutput struct {
	Tables    []TableInfo `json:"tables"`
	Schema    string      `json:"schema"`
	Error     string      `json:"error,omitempty"`
	RequestID string      `json:"request_id,omitempty"` // Unique ID for request tracing
}

type ToolEnablement struct {
	EnabledTools  []string
	DisabledTools []string
}

type TransportType string