use super::*;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
#[serde(rename_all = "snake_case")]
pub enum QueryMode {
#[default]
Generic,
BriefProject,
ResumeTask,
FindFailures,
FindDecisions,
FindEvidence,
FindHighlights,
}
#[derive(Debug, Deserialize)]
pub struct SearchParams {
#[serde(default)]
pub tenant_id: String,
pub query: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default = "default_k")]
pub k: usize,
#[serde(default)]
pub filters: Option<SearchFilters>,
#[serde(default)]
pub debug_tiers: Option<bool>,
#[serde(default)]
pub mode: Option<QueryMode>,
#[serde(default)]
pub include_superseded: Option<bool>,
#[serde(default)]
pub include_expired: Option<bool>,
#[serde(default)]
pub include_history: Option<bool>,
#[serde(default)]
pub oversample_factor: Option<usize>,
#[serde(default)]
pub expand_event_siblings: bool,
#[serde(default)]
pub render_event_time: bool,
#[serde(default)]
pub ranking_time_ms: Option<i64>,
#[serde(default)]
pub dedupe_by_source: bool,
#[serde(default)]
pub compact: bool,
#[serde(default)]
pub token_budget: Option<usize>,
#[serde(default)]
pub include_text: Option<bool>,
#[serde(default)]
pub include_artifact: Option<bool>,
#[serde(default)]
pub task_id: Option<String>,
#[serde(default)]
pub thread_id: Option<String>,
#[serde(default)]
pub ranking_policy: Option<RankingPolicyMode>,
#[serde(default)]
pub candidate_multiplier: Option<usize>,
#[serde(skip)]
pub suppress_usage_event: bool,
#[serde(skip)]
pub suppress_retrieval_episode: bool,
}
fn default_k() -> usize {
20
}
impl Default for SearchParams {
fn default() -> Self {
Self {
tenant_id: String::new(),
query: String::new(),
project_id: None,
k: default_k(),
filters: None,
debug_tiers: None,
mode: None,
include_superseded: None,
include_expired: None,
include_history: None,
oversample_factor: None,
expand_event_siblings: false,
render_event_time: false,
ranking_time_ms: None,
dedupe_by_source: false,
compact: false,
token_budget: None,
include_text: None,
include_artifact: None,
task_id: None,
thread_id: None,
ranking_policy: None,
candidate_multiplier: None,
suppress_usage_event: false,
suppress_retrieval_episode: false,
}
}
}
#[derive(Debug, Deserialize, Default)]
pub struct SearchFilters {
#[serde(default)]
pub types: Option<Vec<String>>,
#[serde(default)]
pub episode_id: Option<String>,
#[serde(default)]
pub time_range: Option<TimeRange>,
}
#[derive(Debug, Deserialize)]
pub struct TimeRange {
pub from: Option<String>,
pub to: Option<String>,
}
#[derive(Debug, Deserialize, Default)]
pub struct AddParams {
#[serde(default)]
pub tenant_id: String,
pub text: String,
#[serde(rename = "type")]
pub chunk_type: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub episode_id: Option<String>,
#[serde(default)]
pub source: Option<SourceParams>,
#[serde(default)]
pub tags: Vec<String>,
#[serde(default)]
pub expires_at_ms: Option<i64>,
#[serde(default)]
pub review_after_ms: Option<i64>,
#[serde(default)]
pub event_time_ms: Option<i64>,
#[serde(default)]
pub mode: Option<String>,
#[serde(default)]
pub supersede_near_duplicates: Option<DedupSpec>,
}
#[derive(Debug, Deserialize, Clone)]
#[serde(untagged)]
pub enum DedupSpec {
Bool(bool),
Config(DedupConfig),
}
#[derive(Debug, Deserialize, Clone, Default)]
pub struct DedupConfig {
#[serde(default)]
pub mode: Option<String>,
#[serde(default)]
pub threshold: Option<f32>,
#[serde(default)]
pub scope: Option<String>,
}
#[derive(Debug, Deserialize, Default)]
pub struct SourceParams {
pub uri: Option<String>,
pub repo: Option<String>,
pub commit: Option<String>,
pub path: Option<String>,
pub tool_name: Option<String>,
pub tool_call_id: Option<String>,
}
#[derive(Debug, Deserialize, Default)]
pub struct BatchChunkParams {
pub text: String,
#[serde(rename = "type")]
pub chunk_type: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub episode_id: Option<String>,
#[serde(default)]
pub source: Option<SourceParams>,
#[serde(default)]
pub tags: Vec<String>,
#[serde(default)]
pub expires_at_ms: Option<i64>,
#[serde(default)]
pub review_after_ms: Option<i64>,
#[serde(default)]
pub event_time_ms: Option<i64>,
#[serde(default)]
pub mode: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct AddBatchParams {
#[serde(default)]
pub tenant_id: String,
pub chunks: Vec<BatchChunkParams>,
#[serde(default)]
pub supersede_near_duplicates: Option<DedupSpec>,
}
#[derive(Debug, Clone, Deserialize)]
pub struct TaskDatasetRefParams {
pub name: String,
#[serde(default)]
pub version: Option<String>,
#[serde(default)]
pub description: Option<String>,
}
#[derive(Debug, Clone, Deserialize)]
pub struct TaskEntityRefParams {
pub name: String,
pub entity_type: String,
#[serde(default)]
pub role: Option<String>,
}
#[derive(Debug, Clone, Deserialize)]
pub struct TaskContributorParams {
pub contributor_id: String,
#[serde(default)]
pub display_name: Option<String>,
#[serde(default)]
pub role: Option<String>,
#[serde(default)]
pub contribution: Option<String>,
}
#[derive(Debug, Clone, Deserialize, Default)]
pub struct TaskProvenanceParams {
#[serde(default)]
pub uri: Option<String>,
#[serde(default)]
pub repo: Option<String>,
#[serde(default)]
pub commit: Option<String>,
#[serde(default)]
pub path: Option<String>,
#[serde(default)]
pub tool_name: Option<String>,
#[serde(default)]
pub tool_version: Option<String>,
#[serde(default)]
pub tool_call_id: Option<String>,
#[serde(default)]
pub execution: Option<ExecutionContext>,
}
#[derive(Debug, Deserialize)]
pub struct TaskStartParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub parent_task_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
pub goal: String,
#[serde(default)]
pub motivation: String,
#[serde(default)]
pub hypothesis: String,
#[serde(default)]
pub scientific_question: String,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub expected_outputs: Vec<String>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskFinishParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
#[serde(default)]
pub status: Option<String>,
#[serde(default)]
pub goal: Option<String>,
#[serde(default)]
pub scientific_question: Option<String>,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub what_worked: Vec<String>,
#[serde(default)]
pub what_failed: Vec<String>,
#[serde(default)]
pub validation: Vec<String>,
#[serde(default)]
pub uncertainty: Vec<String>,
#[serde(default)]
pub followups: Vec<String>,
#[serde(default)]
pub confidence: Option<f32>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskProgressParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
pub summary: String,
#[serde(default)]
pub blockers: Vec<String>,
#[serde(default)]
pub failed_attempts: Vec<String>,
#[serde(default)]
pub next_step: String,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskRunStartParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
pub tool_name: String,
#[serde(default)]
pub tool_version: Option<String>,
#[serde(default)]
pub command: String,
#[serde(default)]
pub why_chosen: String,
#[serde(default)]
pub parameters: Value,
#[serde(default)]
pub inputs: Vec<String>,
#[serde(default)]
pub summary: Option<String>,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskRunFinishParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
pub status: String,
#[serde(default)]
pub tool_name: Option<String>,
#[serde(default)]
pub tool_version: Option<String>,
#[serde(default)]
pub command: Option<String>,
#[serde(default)]
pub outputs: Vec<String>,
#[serde(default)]
pub metrics: Option<Value>,
#[serde(default)]
pub notes: String,
#[serde(default)]
pub validation: Vec<String>,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskAddEvidenceParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
#[serde(default)]
pub summary: String,
pub evidence_kind: String,
#[serde(default)]
pub supports_claim: Option<bool>,
#[serde(default)]
pub metric_name: Option<String>,
#[serde(default)]
pub metric_value: Option<Value>,
#[serde(default)]
pub metrics: Option<Value>,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct TaskGetParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
}
#[derive(Debug, Deserialize, Default)]
pub struct TaskSearchFiltersParams {
#[serde(default)]
pub task_id: Option<String>,
#[serde(default)]
pub artifact_kind: Option<String>,
#[serde(default)]
pub status: Option<String>,
#[serde(default)]
pub challenge_id: Option<String>,
#[serde(default)]
pub thread_id: Option<String>,
#[serde(default)]
pub reply_to_artifact_id: Option<String>,
#[serde(default)]
pub artifact_role: Option<String>,
#[serde(default)]
pub dataset_name: Option<String>,
#[serde(default)]
pub dataset_version: Option<String>,
#[serde(default)]
pub entity_name: Option<String>,
#[serde(default)]
pub entity_type: Option<String>,
#[serde(default)]
pub tool_name: Option<String>,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
#[serde(default)]
pub requested_action: Option<String>,
#[serde(default)]
pub verification_status: Option<String>,
#[serde(default)]
pub relation_kind: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct TaskSearchParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub query: String,
#[serde(default = "default_k")]
pub k: usize,
#[serde(default)]
pub filters: Option<TaskSearchFiltersParams>,
#[serde(default)]
pub mode: Option<QueryMode>,
#[serde(default)]
pub compact: bool,
#[serde(default)]
pub token_budget: Option<usize>,
#[serde(default)]
pub include_artifact: Option<bool>,
#[serde(default)]
pub include_matched_text: Option<bool>,
}
#[derive(Debug, Deserialize)]
pub struct ProjectBriefParams {
#[serde(default)]
pub tenant_id: String,
pub project_id: String,
#[serde(default)]
pub query: String,
#[serde(default = "default_k")]
pub k: usize,
#[serde(default = "default_true")]
pub include_related_projects: bool,
}
#[derive(Debug, Deserialize)]
pub struct TaskResumeParams {
#[serde(default)]
pub tenant_id: String,
pub task_id: String,
#[serde(default)]
pub query: String,
#[serde(default = "default_k")]
pub k: usize,
}
#[derive(Debug, Deserialize)]
pub struct ArtifactLibraryParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub query: String,
#[serde(default = "default_k")]
pub k: usize,
}
#[derive(Debug, Deserialize)]
pub struct ArtifactCreateParams {
#[serde(default)]
pub tenant_id: String,
pub artifact_kind: String,
#[serde(default)]
pub task_id: Option<String>,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub parent_task_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
#[serde(default)]
pub status: Option<String>,
#[serde(default)]
pub artifact_role: Option<String>,
#[serde(default)]
pub challenge_id: Option<String>,
#[serde(default)]
pub thread_id: Option<String>,
#[serde(default)]
pub reply_to_artifact_id: Option<String>,
#[serde(default)]
pub relation_kind: Option<String>,
#[serde(default)]
pub goal: Option<String>,
#[serde(default)]
pub motivation: Option<String>,
#[serde(default)]
pub hypothesis: Option<String>,
#[serde(default)]
pub scientific_question: Option<String>,
#[serde(default)]
pub method_summary: Option<String>,
#[serde(default)]
pub summary: Option<String>,
#[serde(default)]
pub content: Option<String>,
#[serde(default)]
pub evidence_kind: Option<String>,
#[serde(default)]
pub supports_claim: Option<bool>,
#[serde(default)]
pub blockers: Vec<String>,
#[serde(default)]
pub what_worked: Vec<String>,
#[serde(default)]
pub what_failed: Vec<String>,
#[serde(default)]
pub validation: Vec<String>,
#[serde(default)]
pub uncertainty: Vec<String>,
#[serde(default)]
pub followups: Vec<String>,
#[serde(default)]
pub expected_outputs: Vec<String>,
#[serde(default)]
pub related_artifact_ids: Vec<String>,
#[serde(default)]
pub contributors: Vec<TaskContributorParams>,
#[serde(default)]
pub dataset_refs: Vec<TaskDatasetRefParams>,
#[serde(default)]
pub entity_refs: Vec<TaskEntityRefParams>,
#[serde(default)]
pub tool_name: Option<String>,
#[serde(default)]
pub tool_version: Option<String>,
#[serde(default)]
pub command: Option<String>,
#[serde(default)]
pub parameters: Option<Value>,
#[serde(default)]
pub inputs: Vec<String>,
#[serde(default)]
pub outputs: Vec<String>,
#[serde(default)]
pub metrics: Option<Value>,
#[serde(default)]
pub why_chosen: Option<String>,
#[serde(default)]
pub confidence: Option<f32>,
#[serde(default)]
pub requested_action: Option<String>,
#[serde(default)]
pub verification_status: Option<String>,
#[serde(default)]
pub compute_budget: Option<Value>,
#[serde(default)]
pub cost_actual: Option<Value>,
#[serde(default)]
pub data_access_level: Option<String>,
#[serde(default)]
pub policy_tags: Vec<String>,
#[serde(default)]
pub allowed_tools: Vec<String>,
#[serde(default)]
pub approval_state: Option<String>,
#[serde(default)]
pub provenance: Option<TaskProvenanceParams>,
}
#[derive(Debug, Deserialize)]
pub struct ArtifactGetParams {
#[serde(default)]
pub tenant_id: String,
pub artifact_id: String,
}
#[derive(Debug, Deserialize)]
pub struct ArtifactListThreadParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub thread_id: Option<String>,
#[serde(default)]
pub artifact_id: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct ArtifactVerifyParams {
#[serde(default)]
pub tenant_id: String,
pub claim: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub task_id: Option<String>,
#[serde(default)]
pub thread_id: Option<String>,
#[serde(default)]
pub candidate_artifact_ids: Vec<String>,
#[serde(default = "default_verify_k")]
pub k: usize,
#[serde(default)]
pub include_digests: bool,
#[serde(default)]
pub create_artifact: bool,
#[serde(default)]
pub record_task_id: Option<String>,
#[serde(default)]
pub agent_id: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct GetParams {
#[serde(default)]
pub tenant_id: String,
pub chunk_id: String,
#[serde(default)]
pub include_superseded: Option<bool>,
#[serde(default)]
pub include_expired: Option<bool>,
#[serde(default)]
pub include_history: Option<bool>,
}
#[derive(Debug, Deserialize)]
pub struct DeleteParams {
#[serde(default)]
pub tenant_id: String,
pub chunk_id: String,
}
#[derive(Debug, Deserialize)]
pub struct StatsParams {
#[serde(default)]
pub tenant_id: String,
}
fn default_duplicate_limit() -> usize {
10
}
#[derive(Debug, Deserialize)]
pub struct HealthParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub include_examples: bool,
#[serde(default = "default_duplicate_limit")]
pub duplicate_limit: usize,
#[serde(default = "default_true")]
pub include_recent: bool,
}
#[derive(Debug, Deserialize, Default)]
pub struct MetricsParams {
#[serde(default)]
pub tenant_id: Option<String>,
#[serde(default = "default_true")]
pub include_recent: bool,
#[serde(default = "default_true")]
pub include_tiered: bool,
}
fn default_verify_k() -> usize {
8
}
#[derive(Debug, Deserialize)]
pub struct CompactParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub force: bool,
#[serde(default)]
pub project_id: Option<String>,
#[serde(default)]
pub digest_modes: Option<Vec<QueryMode>>,
#[serde(default)]
pub force_digest_rebuild: bool,
}
#[derive(Debug, Deserialize)]
pub struct FeedbackParams {
#[serde(default)]
pub tenant_id: String,
pub query: String,
pub chunk_id: String,
pub relevance: String,
}
#[derive(Debug, Deserialize)]
pub struct RecordOutcomeParams {
#[serde(default)]
pub tenant_id: String,
pub episode_id: String,
pub outcome: String,
pub verifier_type: String,
#[serde(default)]
pub used_chunk_ids: Vec<String>,
#[serde(default)]
pub harmful_chunk_ids: Vec<String>,
#[serde(default)]
pub evidence_reference: Option<String>,
#[serde(default)]
pub event_time_ms: Option<i64>,
}
#[derive(Debug, Deserialize)]
pub struct ConsolidateEpisodeParams {
#[serde(default)]
pub tenant_id: String,
pub episode_id: String,
#[serde(default = "default_episode_limit")]
pub max_chunks: usize,
#[serde(default = "default_true")]
pub retain_source_chunks: bool,
}
#[derive(Debug, Deserialize)]
pub struct ContextListSubsystemsParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub prefix: Option<String>,
#[serde(default = "default_limit")]
pub limit: usize,
}
#[derive(Debug, Deserialize)]
pub struct ContextGetFilesForSubsystemParams {
#[serde(default)]
pub tenant_id: String,
pub subsystem_key: String,
#[serde(default = "default_limit")]
pub limit: usize,
}
#[derive(Debug, Deserialize)]
pub struct ContextSearchDocumentsParams {
#[serde(default)]
pub tenant_id: String,
pub query: String,
#[serde(default = "default_context_limit")]
pub k: usize,
#[serde(default)]
pub subsystem_key: Option<String>,
#[serde(default)]
pub tier: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct ContextFindRelevantContextParams {
#[serde(default)]
pub tenant_id: String,
pub task: String,
#[serde(default = "default_context_limit")]
pub k: usize,
#[serde(default)]
pub subsystem_keys: Option<Vec<String>>,
#[serde(default = "default_true")]
pub include_hot: bool,
}
#[derive(Debug, Deserialize)]
pub struct ContextSuggestAgentParams {
#[serde(default)]
pub tenant_id: String,
pub task: String,
#[serde(default)]
pub changed_files: Option<Vec<String>>,
#[serde(default = "default_context_agent_limit")]
pub k: usize,
}
#[derive(Debug, Deserialize)]
pub struct ContextGetHotContextParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default = "default_context_limit")]
pub k: usize,
}
fn default_episode_limit() -> usize {
50
}
fn default_context_limit() -> usize {
20
}
fn default_context_agent_limit() -> usize {
3
}
fn default_true() -> bool {
true
}
fn default_depth() -> u32 {
1
}
#[derive(Debug, Deserialize)]
pub struct FindDefinitionParams {
#[serde(default)]
pub tenant_id: String,
pub name: String,
#[serde(default)]
pub project_id: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct FindReferencesParams {
#[serde(default)]
pub tenant_id: String,
pub name: String,
#[serde(default)]
pub project_id: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct FindCallersParams {
#[serde(default)]
pub tenant_id: String,
pub name: String,
#[serde(default = "default_depth")]
pub depth: u32,
#[serde(default)]
pub project_id: Option<String>,
}
#[derive(Debug, Deserialize)]
pub struct FindImportsParams {
#[serde(default)]
pub tenant_id: String,
pub module: String,
#[serde(default)]
pub project_id: Option<String>,
}
fn default_limit() -> usize {
50
}
#[derive(Debug, Deserialize)]
pub struct FindToolCallsParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub tool_name: Option<String>,
#[serde(default)]
pub session_id: Option<String>,
#[serde(default)]
pub time_from: Option<String>,
#[serde(default)]
pub time_to: Option<String>,
#[serde(default)]
pub errors_only: bool,
#[serde(default = "default_limit")]
pub limit: usize,
}
#[derive(Debug, Deserialize)]
pub struct FindErrorsParams {
#[serde(default)]
pub tenant_id: String,
#[serde(default)]
pub error_signature: Option<String>,
#[serde(default)]
pub function_name: Option<String>,
#[serde(default)]
pub file_path: Option<String>,
#[serde(default)]
pub time_from: Option<String>,
#[serde(default)]
pub time_to: Option<String>,
#[serde(default = "default_limit")]
pub limit: usize,
#[serde(default = "default_true")]
pub include_frames: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct SearchResult {
pub results: Vec<ChunkResult>,
#[serde(default)]
pub retrieval_episode_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub ranking_policy: Option<RankingPolicyInfo>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub budget_info: Option<BudgetInfo>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub scope_expansion: Option<ScopeExpansion>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub tier_info: Option<TierDebugInfo>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub repair_info: Option<RepairInfo>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub scope_status: Option<ScopeStatus>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RankingPolicyInfo {
pub version: String,
pub mode: RankingPolicyMode,
pub candidate_count: usize,
pub shadow_order_changed: bool,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TierDebugInfo {
pub source_tier: String,
pub cache_hit: bool,
pub hot_tier_hit: bool,
pub cache_lookup_ms: u64,
pub hot_tier_ms: u64,
pub warm_tier_ms: u64,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RepairInfo {
pub attempted: bool,
pub repaired: bool,
pub original_query: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub repaired_query: Option<String>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BudgetInfo {
#[serde(skip_serializing_if = "Option::is_none", default)]
pub requested_budget: Option<usize>,
pub estimated_output_tokens: usize,
pub truncated: bool,
#[serde(default)]
pub omitted_fields: Vec<String>,
pub dropped_result_count: usize,
pub duplicate_drop_count: usize,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct OriginScope {
pub requested_tenant_id: String,
pub origin_tenant_id: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub origin_project_id: Option<String>,
#[serde(default)]
pub alias_reason: String,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ScopeExpansion {
pub requested_tenant_id: String,
pub requested_project_id: String,
#[serde(default)]
pub aliases: Vec<OriginScope>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ScopeStatus {
pub tenant_id: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub project_id: Option<String>,
pub retrieval_mode: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub wider_scope_hits: Option<usize>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub widen_hint: Option<String>,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub warnings: Vec<String>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ChunkResult {
pub chunk_id: String,
pub tenant_id: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub project_id: Option<String>,
#[serde(skip_serializing_if = "String::is_empty", default)]
pub text: String,
pub score: f32, pub chunk_type: String,
pub promotion_state: String,
pub source: SourceResult,
pub timestamp_created: i64,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub tags: Vec<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub episode_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub citation: Option<CitationResult>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_tier: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub artifact: Option<TaskArtifact>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub origin: Option<OriginScope>,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub expanded_siblings: Vec<ChunkResult>,
}
#[derive(Debug, Serialize, Deserialize, Default)]
pub struct SourceResult {
#[serde(skip_serializing_if = "Option::is_none", default)]
pub uri: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub repo: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub commit: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub path: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub tool_name: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub tool_call_id: Option<String>,
}
impl From<&Source> for SourceResult {
fn from(s: &Source) -> Self {
Self {
uri: s.uri.clone(),
repo: s.repo.clone(),
commit: s.commit.clone(),
path: s.path.clone(),
tool_name: s.tool_name.clone(),
tool_call_id: s.tool_call_id.clone(),
}
}
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CitationResult {
pub citation_id: String,
pub content_hash: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_uri: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_repo: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_commit: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_path: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_tool_name: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub source_tool_call_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub chunk_index: Option<usize>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub total_chunks: Option<usize>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub char_start: Option<usize>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub char_end: Option<usize>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GroundingRef {
pub artifact_id: String,
pub task_id: String,
pub thread_id: String,
pub artifact_kind: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub artifact_role: Option<String>,
pub promotion_state: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub citation: Option<CitationResult>,
}
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct VerificationHint {
pub requires_verification: bool,
#[serde(default)]
pub reason: String,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct AddResult {
pub chunk_id: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub stored_chunk_ids: Option<Vec<String>>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub dedupe_decision: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub deduped_existing_id: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub admission_decision: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub admission_reason: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub admission_warning: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub lifecycle_tier: Option<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub expires_at_ms: Option<i64>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub review_after_ms: Option<i64>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub created_tenant: Option<bool>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct AddBatchResult {
pub chunk_ids: Vec<String>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub dedupe_decisions: Option<Vec<String>>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub deduped_existing_ids: Option<Vec<Option<String>>>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub admission_decisions: Option<Vec<String>>,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub admission_reasons: Option<Vec<String>>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct TaskArtifactResult {
pub task_id: String,
pub artifact_id: String,
pub projection_chunk_ids: Vec<String>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct TaskGetResult {
pub task_id: String,
pub artifacts: Vec<TaskArtifact>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ArtifactGetResult {
pub artifact: Option<TaskArtifact>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ArtifactSearchHit {
pub artifact_id: String,
pub task_id: String,
pub artifact_kind: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub artifact_role: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub project_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub thread_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub summary: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub artifact: Option<TaskArtifact>,
pub score: f32,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub matched_chunk_id: Option<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub matched_text: Option<String>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub origin: Option<OriginScope>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ArtifactSearchResult {
pub results: Vec<ArtifactSearchHit>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub budget_info: Option<BudgetInfo>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub scope_expansion: Option<ScopeExpansion>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ArtifactThreadResult {
pub thread_id: String,
pub artifacts: Vec<TaskArtifact>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ProjectBriefResult {
pub artifact: TaskArtifact,
pub brief: ProjectBriefView,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct TaskResumeResult {
pub artifact: TaskArtifact,
pub resume: TaskResumeView,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FailureSearchResult {
pub artifact: TaskArtifact,
pub results: Vec<FailureViewItem>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct DecisionSearchViewResult {
pub artifact: TaskArtifact,
pub results: Vec<DecisionViewItem>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct EvidenceSearchViewResult {
pub artifact: TaskArtifact,
pub results: Vec<EvidenceViewItem>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct HighlightSearchViewResult {
pub artifact: TaskArtifact,
pub results: Vec<HighlightViewItem>,
#[serde(default)]
pub trust_tier: TrustTier,
#[serde(skip_serializing_if = "Vec::is_empty", default)]
pub grounding_refs: Vec<GroundingRef>,
#[serde(default)]
pub verification_hint: VerificationHint,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum GroundingStatus {
VerifiedRecord,
CanonicallyGrounded,
DigestOnly,
InsufficientGrounding,
Conflicted,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ArtifactVerifyResult {
pub claim: String,
pub grounding_status: GroundingStatus,
pub confidence: f32,
pub supporting_artifacts: Vec<GroundingRef>,
pub conflicting_artifacts: Vec<GroundingRef>,
pub consulted_digests: Vec<GroundingRef>,
pub notes: Vec<String>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub verification_artifact: Option<TaskArtifact>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct DeleteResult {
pub deleted: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FeedbackResult {
pub stored: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct RecordOutcomeResult {
pub event_id: String,
pub episode_id: String,
pub stored: bool,
pub ranking_eligible: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ConsolidateEpisodeResult {
pub summary_chunk_id: String,
pub source_chunk_count: usize,
pub retained_source_chunks: bool,
pub run_id: String,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextListSubsystemsResult {
pub subsystems: Vec<SubsystemSummary>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct SubsystemSummary {
pub key: String,
pub chunk_count: usize,
pub file_count: usize,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextGetFilesForSubsystemResult {
pub subsystem_key: String,
pub files: Vec<String>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextSearchDocumentsResult {
pub results: Vec<ChunkResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextFindRelevantContextResult {
pub results: Vec<ChunkResult>,
pub hot_included: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct AgentSuggestion {
pub agent_name: String,
pub score: f32,
#[serde(default)]
pub reasons: Vec<String>,
#[serde(default)]
pub matched_triggers: Vec<String>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextSuggestAgentResult {
pub recommendations: Vec<AgentSuggestion>,
pub considered_agents: usize,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ContextGetHotContextResult {
pub results: Vec<ChunkResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct StatsResult {
pub total_chunks: usize,
#[serde(default)]
pub active_chunks: usize,
#[serde(default)]
pub candidate_chunks: usize,
pub deleted_chunks: usize,
pub chunk_types: HashMap<String, usize>,
#[serde(default)]
pub chunk_types_active: HashMap<String, usize>,
#[serde(default)]
pub chunk_types_deleted: HashMap<String, usize>,
#[serde(default)]
pub chunk_types_all: HashMap<String, usize>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub disk_stats: Option<DiskStatsResult>,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub compaction: Option<CompactionStatsResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct HealthScopeResult {
pub tenant_id: String,
#[serde(skip_serializing_if = "Option::is_none", default)]
pub project_id: Option<String>,
#[serde(default)]
pub aliases: Vec<OriginScope>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ChunkTypeHealthResult {
pub active: HashMap<String, usize>,
pub all: HashMap<String, usize>,
}
#[derive(Debug, Serialize, Deserialize, Default)]
pub struct LatencyHealthResult {
pub recent_search_count: usize,
pub p50_total_ms: u64,
pub p95_total_ms: u64,
pub p99_total_ms: u64,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct MemoryHealthResult {
pub scope: HealthScopeResult,
pub counts: HealthCounts,
pub chunk_types: ChunkTypeHealthResult,
pub duplicates: DuplicateHealth,
pub index_coverage: IndexCoverageHealth,
pub payload: PayloadHealth,
pub latency: LatencyHealthResult,
#[serde(default)]
pub warnings: Vec<String>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct DiskStatsResult {
pub total_bytes: u64,
pub segment_count: usize,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct CompactionStatsResult {
pub tombstone_ratio: f32,
pub active_chunks: usize,
pub deleted_chunks: usize,
pub segment_count: usize,
pub hnsw_staleness: f32,
pub hnsw_cache_size: usize,
pub hnsw_index_size: usize,
pub needs_compaction: bool,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct TieredStatsResult {
pub cache_stats: CacheStatsResult,
pub hot_tier_stats: HotTierStatsResult,
pub metrics: TieredMetricsResult,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct CacheStatsResult {
pub total_lookups: u64,
pub hits: u64,
pub misses: u64,
pub hit_rate: f32,
pub entry_count: usize,
pub avg_confidence: f32,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct HotTierStatsResult {
pub chunk_count: usize,
pub capacity_used: f32,
pub version: u64,
pub avg_promotion_score: f32,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct TieredMetricsResult {
pub promotions: u64,
pub demotions: u64,
pub avg_cache_ms: f64,
pub avg_hot_tier_ms: f64,
pub avg_warm_tier_ms: f64,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FindDefinitionResult {
pub definitions: Vec<SymbolLocationResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct SymbolLocationResult {
pub file_path: String,
pub name: String,
pub kind: String,
pub line_start: u32,
pub line_end: u32,
pub col_start: u32,
pub col_end: u32,
#[serde(skip_serializing_if = "Option::is_none")]
pub signature: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub docstring: Option<String>,
#[serde(skip_serializing_if = "Option::is_none")]
pub visibility: Option<String>,
pub language: String,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FindReferencesResult {
pub references: Vec<SymbolLocationResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FindCallersResult {
pub callers: Vec<CallerInfoResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct CallerInfoResult {
pub caller_name: String,
pub caller_file: String,
pub call_line: u32,
pub call_col: u32,
pub caller_kind: String,
pub depth: u32,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct FindImportsResult {
pub imports: Vec<ImportInfoResult>,
}
#[derive(Debug, Serialize, Deserialize)]
pub struct ImportInfoResult {
pub importing_file: String,
pub import_line: u32,
#[serde(skip_serializing_if = "Option::is_none")]
pub alias: Option<String>,
}