debugv1

type ChangeEntry struct {

	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,1,opt,name=file,proto3" json:"file,omitempty"`
	// action is the strategy, file, or debug action that occurred.
	Action string `protobuf:"bytes,2,opt,name=action,proto3" json:"action,omitempty"`
	// what describes the changed artifact or behavior.
	What string `protobuf:"bytes,3,opt,name=what,proto3" json:"what,omitempty"`
	// contains filtered or unexported fields
}

type CheckEntry struct {

	// name is the check name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// type identifies the check mechanism, such as command, test, build, or lint.
	Type string `protobuf:"bytes,2,opt,name=type,proto3" json:"type,omitempty"`
	// passed is true when the check met its expected condition.
	Passed bool `protobuf:"varint,3,opt,name=passed,proto3" json:"passed,omitempty"`
	// has_result is true when a check produced a retained result payload.
	HasResult bool `protobuf:"varint,4,opt,name=has_result,json=hasResult,proto3" json:"has_result,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,5,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type CheckResult struct {

	// name is the check name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// passed is true when the check met its expected condition.
	Passed bool `protobuf:"varint,2,opt,name=passed,proto3" json:"passed,omitempty"`
	// error explains why the operation failed; empty means success at this layer.
	Error string `protobuf:"bytes,3,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

type ConventionEntry struct {

	// category groups a convention, rule, or finding.
	Category string `protobuf:"bytes,1,opt,name=category,proto3" json:"category,omitempty"`
	// package is the package, dependency, or artifact name.
	Package string `protobuf:"bytes,2,opt,name=package,proto3" json:"package,omitempty"`
	// pattern is the search expression or literal text to match.
	Pattern string `protobuf:"bytes,3,opt,name=pattern,proto3" json:"pattern,omitempty"`
	// usage is the command-line shape shown to users and agents.
	Usage string `protobuf:"bytes,4,opt,name=usage,proto3" json:"usage,omitempty"`
	// contains filtered or unexported fields
}

type CostEntry struct {

	// name labels the model, agent, objective, or phase being charged.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// calls is the number of model calls attributed to this row.
	Calls int32 `protobuf:"varint,2,opt,name=calls,proto3" json:"calls,omitempty"`
	// input_tokens is the total number of prompt/input tokens consumed.
	InputTokens int32 `protobuf:"varint,3,opt,name=input_tokens,json=inputTokens,proto3" json:"input_tokens,omitempty"`
	// output_tokens is the total number of completion/output tokens produced.
	OutputTokens int32 `protobuf:"varint,4,opt,name=output_tokens,json=outputTokens,proto3" json:"output_tokens,omitempty"`
	// cached_tokens is the number of input tokens served from provider cache.
	CachedTokens int32 `protobuf:"varint,5,opt,name=cached_tokens,json=cachedTokens,proto3" json:"cached_tokens,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,6,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// contains filtered or unexported fields
}

type DebugEvent struct {

	// timestamp is when the event, call, or record was produced.
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// kind categorizes the event for filtering and rendering.
	Kind string `protobuf:"bytes,2,opt,name=kind,proto3" json:"kind,omitempty"`
	// agent is the Codefly agent plugin responsible for this service type.
	Agent string `protobuf:"bytes,3,opt,name=agent,proto3" json:"agent,omitempty"`
	// message is the event text shown in the debug UI.
	Message string `protobuf:"bytes,4,opt,name=message,proto3" json:"message,omitempty"`
	// data is the raw bytes or JSON-shaped payload.
	Data map[string]string `` /* 135-byte string literal not displayed */
	// contains filtered or unexported fields
}

type DebugServiceClient interface {
	// Dashboard returns an overview KPI snapshot.
	GetDashboard(ctx context.Context, in *GetDashboardRequest, opts ...grpc.CallOption) (*GetDashboardResponse, error)
	// Context returns the 3-layer prompt state (System / State / Turn).
	GetContext(ctx context.Context, in *GetContextRequest, opts ...grpc.CallOption) (*GetContextResponse, error)
	// Memory returns the current working memory state.
	GetMemory(ctx context.Context, in *GetMemoryRequest, opts ...grpc.CallOption) (*GetMemoryResponse, error)
	// Session returns session timeline and events.
	GetSession(ctx context.Context, in *GetSessionRequest, opts ...grpc.CallOption) (*GetSessionResponse, error)
	// ObjectiveGraph returns the objective DAG.
	GetObjectiveGraph(ctx context.Context, in *GetObjectiveGraphRequest, opts ...grpc.CallOption) (*GetObjectiveGraphResponse, error)
	// Trace returns the agent execution trace tree.
	GetTrace(ctx context.Context, in *GetTraceRequest, opts ...grpc.CallOption) (*GetTraceResponse, error)
	// Metrics returns token and cost metrics.
	GetMetrics(ctx context.Context, in *GetMetricsRequest, opts ...grpc.CallOption) (*GetMetricsResponse, error)
	// CostBreakdown returns hierarchical cost attribution.
	GetCostBreakdown(ctx context.Context, in *GetCostBreakdownRequest, opts ...grpc.CallOption) (*GetCostBreakdownResponse, error)
	// SymbolMap returns the code symbol graph.
	GetSymbolMap(ctx context.Context, in *GetSymbolMapRequest, opts ...grpc.CallOption) (*GetSymbolMapResponse, error)
	// FileChanges returns file operations and diffs from the current run.
	GetFileChanges(ctx context.Context, in *GetFileChangesRequest, opts ...grpc.CallOption) (*GetFileChangesResponse, error)
	// LastSummary returns the post-run summary.
	GetLastSummary(ctx context.Context, in *GetLastSummaryRequest, opts ...grpc.CallOption) (*GetLastSummaryResponse, error)
	// Rules returns loaded rules with scope and match info.
	GetRules(ctx context.Context, in *GetRulesRequest, opts ...grpc.CallOption) (*GetRulesResponse, error)
	// LLMCalls returns the full call log.
	GetLLMCalls(ctx context.Context, in *GetLLMCallsRequest, opts ...grpc.CallOption) (*GetLLMCallsResponse, error)
	// MiddlewareState returns the middleware pipeline status.
	GetMiddlewareState(ctx context.Context, in *GetMiddlewareStateRequest, opts ...grpc.CallOption) (*GetMiddlewareStateResponse, error)
	// StreamEvents pushes real-time events to the client.
	StreamEvents(ctx context.Context, in *StreamEventsRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[DebugEvent], error)
}

type DebugServiceServer interface {
	// Dashboard returns an overview KPI snapshot.
	GetDashboard(context.Context, *GetDashboardRequest) (*GetDashboardResponse, error)
	// Context returns the 3-layer prompt state (System / State / Turn).
	GetContext(context.Context, *GetContextRequest) (*GetContextResponse, error)
	// Memory returns the current working memory state.
	GetMemory(context.Context, *GetMemoryRequest) (*GetMemoryResponse, error)
	// Session returns session timeline and events.
	GetSession(context.Context, *GetSessionRequest) (*GetSessionResponse, error)
	// ObjectiveGraph returns the objective DAG.
	GetObjectiveGraph(context.Context, *GetObjectiveGraphRequest) (*GetObjectiveGraphResponse, error)
	// Trace returns the agent execution trace tree.
	GetTrace(context.Context, *GetTraceRequest) (*GetTraceResponse, error)
	// Metrics returns token and cost metrics.
	GetMetrics(context.Context, *GetMetricsRequest) (*GetMetricsResponse, error)
	// CostBreakdown returns hierarchical cost attribution.
	GetCostBreakdown(context.Context, *GetCostBreakdownRequest) (*GetCostBreakdownResponse, error)
	// SymbolMap returns the code symbol graph.
	GetSymbolMap(context.Context, *GetSymbolMapRequest) (*GetSymbolMapResponse, error)
	// FileChanges returns file operations and diffs from the current run.
	GetFileChanges(context.Context, *GetFileChangesRequest) (*GetFileChangesResponse, error)
	// LastSummary returns the post-run summary.
	GetLastSummary(context.Context, *GetLastSummaryRequest) (*GetLastSummaryResponse, error)
	// Rules returns loaded rules with scope and match info.
	GetRules(context.Context, *GetRulesRequest) (*GetRulesResponse, error)
	// LLMCalls returns the full call log.
	GetLLMCalls(context.Context, *GetLLMCallsRequest) (*GetLLMCallsResponse, error)
	// MiddlewareState returns the middleware pipeline status.
	GetMiddlewareState(context.Context, *GetMiddlewareStateRequest) (*GetMiddlewareStateResponse, error)
	// StreamEvents pushes real-time events to the client.
	StreamEvents(*StreamEventsRequest, grpc.ServerStreamingServer[DebugEvent]) error
	// contains filtered or unexported methods
}

type DebugService_StreamEventsClient = grpc.ServerStreamingClient[DebugEvent]

type DebugService_StreamEventsServer = grpc.ServerStreamingServer[DebugEvent]

type EventEntry struct {

	// timestamp is when the event, call, or record was produced.
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// kind categorizes the event for filtering and rendering.
	Kind string `protobuf:"bytes,2,opt,name=kind,proto3" json:"kind,omitempty"`
	// agent is the Codefly agent plugin responsible for this service type.
	Agent string `protobuf:"bytes,3,opt,name=agent,proto3" json:"agent,omitempty"`
	// message is the event text shown in the debug timeline.
	Message string `protobuf:"bytes,4,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

type FileChange struct {

	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// op is the file operation such as create, update, delete, or rename.
	Op string `protobuf:"bytes,2,opt,name=op,proto3" json:"op,omitempty"`
	// reason explains why this change, state, or decision occurred.
	Reason string `protobuf:"bytes,3,opt,name=reason,proto3" json:"reason,omitempty"`
	// diff is the unified git diff text.
	Diff string `protobuf:"bytes,4,opt,name=diff,proto3" json:"diff,omitempty"`
	// contains filtered or unexported fields
}

type FileSymbols struct {

	// path is a workspace- or service-relative filesystem path.
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// symbols are code entities returned by language analysis.
	Symbols []*SymbolNode `protobuf:"bytes,2,rep,name=symbols,proto3" json:"symbols,omitempty"`
	// contains filtered or unexported fields
}

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

type GetContextResponse struct {

	// project_name is the stable name of the project.
	ProjectName string `protobuf:"bytes,1,opt,name=project_name,json=projectName,proto3" json:"project_name,omitempty"`
	// service_name is the stable name of the service.
	ServiceName string `protobuf:"bytes,2,opt,name=service_name,json=serviceName,proto3" json:"service_name,omitempty"`
	// has_conventions is true when convention context is loaded.
	HasConventions bool `protobuf:"varint,3,opt,name=has_conventions,json=hasConventions,proto3" json:"has_conventions,omitempty"`
	// has_rules is true when rule context is loaded.
	HasRules bool `protobuf:"varint,4,opt,name=has_rules,json=hasRules,proto3" json:"has_rules,omitempty"`
	// has_symbol_map is true when symbol context is loaded.
	HasSymbolMap bool `protobuf:"varint,5,opt,name=has_symbol_map,json=hasSymbolMap,proto3" json:"has_symbol_map,omitempty"`
	// has_memory is true when session memory is loaded.
	HasMemory bool `protobuf:"varint,6,opt,name=has_memory,json=hasMemory,proto3" json:"has_memory,omitempty"`
	// has_session is true when persistent session state is loaded.
	HasSession bool `protobuf:"varint,7,opt,name=has_session,json=hasSession,proto3" json:"has_session,omitempty"`
	// system_preview is a bounded excerpt of system context.
	SystemPreview string `protobuf:"bytes,8,opt,name=system_preview,json=systemPreview,proto3" json:"system_preview,omitempty"`
	// state_preview is a bounded excerpt of state context.
	StatePreview string `protobuf:"bytes,9,opt,name=state_preview,json=statePreview,proto3" json:"state_preview,omitempty"`
	// turn_preview is a bounded excerpt of current turn context.
	TurnPreview string `protobuf:"bytes,10,opt,name=turn_preview,json=turnPreview,proto3" json:"turn_preview,omitempty"`
	// metrics summarizes token usage for the context layers.
	Metrics *MetricsSummary `protobuf:"bytes,11,opt,name=metrics,proto3" json:"metrics,omitempty"`
	// conventions are conventions loaded into context for the current project.
	Conventions []*ConventionEntry `protobuf:"bytes,12,rep,name=conventions,proto3" json:"conventions,omitempty"`
	// contains filtered or unexported fields
}

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

type GetCostBreakdownResponse struct {

	// title is the display label for a cost breakdown row.
	Title string `protobuf:"bytes,1,opt,name=title,proto3" json:"title,omitempty"`
	// total is the aggregate number of cases represented.
	Total *CostEntry `protobuf:"bytes,2,opt,name=total,proto3" json:"total,omitempty"`
	// entries are child rows contributing to the total.
	Entries []*CostEntry `protobuf:"bytes,3,rep,name=entries,proto3" json:"entries,omitempty"`
	// contains filtered or unexported fields
}

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

type GetDashboardResponse struct {

	// active_objective is the objective currently being planned or executed.
	ActiveObjective string `protobuf:"bytes,1,opt,name=active_objective,json=activeObjective,proto3" json:"active_objective,omitempty"`
	// iteration is the execution loop number for this event.
	Iteration int32 `protobuf:"varint,2,opt,name=iteration,proto3" json:"iteration,omitempty"`
	// phase names the current initialization, planning, or execution phase.
	Phase string `protobuf:"bytes,3,opt,name=phase,proto3" json:"phase,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,4,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// tokens_used is the total model token count consumed by the session.
	TokensUsed int32 `protobuf:"varint,5,opt,name=tokens_used,json=tokensUsed,proto3" json:"tokens_used,omitempty"`
	// context_window is the maximum model context size currently available.
	ContextWindow int32 `protobuf:"varint,6,opt,name=context_window,json=contextWindow,proto3" json:"context_window,omitempty"`
	// budget_remaining is the remaining cost or token budget.
	BudgetRemaining float64 `protobuf:"fixed64,7,opt,name=budget_remaining,json=budgetRemaining,proto3" json:"budget_remaining,omitempty"`
	// uptime is how long the session or server has been running.
	Uptime *durationpb.Duration `protobuf:"bytes,8,opt,name=uptime,proto3" json:"uptime,omitempty"`
	// checks_passed is the number of verification checks that passed.
	ChecksPassed int32 `protobuf:"varint,9,opt,name=checks_passed,json=checksPassed,proto3" json:"checks_passed,omitempty"`
	// checks_total is the number of verification checks that ran.
	ChecksTotal int32 `protobuf:"varint,10,opt,name=checks_total,json=checksTotal,proto3" json:"checks_total,omitempty"`
	// llm_calls is the number of model calls made during the operation.
	LlmCalls int32 `protobuf:"varint,11,opt,name=llm_calls,json=llmCalls,proto3" json:"llm_calls,omitempty"`
	// input_tokens is the total number of prompt/input tokens consumed.
	InputTokens int32 `protobuf:"varint,12,opt,name=input_tokens,json=inputTokens,proto3" json:"input_tokens,omitempty"`
	// output_tokens is the total number of completion/output tokens produced.
	OutputTokens int32 `protobuf:"varint,13,opt,name=output_tokens,json=outputTokens,proto3" json:"output_tokens,omitempty"`
	// cached_tokens is the number of input tokens served from provider cache.
	CachedTokens int32 `protobuf:"varint,14,opt,name=cached_tokens,json=cachedTokens,proto3" json:"cached_tokens,omitempty"`
	// achieved is true when Mind believes the objective was satisfied.
	Achieved bool `protobuf:"varint,15,opt,name=achieved,proto3" json:"achieved,omitempty"`
	// contains filtered or unexported fields
}

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

type GetFileChangesResponse struct {

	// files are changed files and their diffs.
	Files []*FileChange `protobuf:"bytes,1,rep,name=files,proto3" json:"files,omitempty"`
	// contains filtered or unexported fields
}

type GetLLMCallsRequest struct {

	// limit caps the number of records returned.
	Limit int32 `protobuf:"varint,1,opt,name=limit,proto3" json:"limit,omitempty"`
	// offset skips records before returning a paged result.
	Offset int32 `protobuf:"varint,2,opt,name=offset,proto3" json:"offset,omitempty"`
	// contains filtered or unexported fields
}

type GetLLMCallsResponse struct {

	// calls are model calls retained in the debug log.
	Calls []*LLMCallEntry `protobuf:"bytes,1,rep,name=calls,proto3" json:"calls,omitempty"`
	// total is the total number of model calls available before paging.
	Total int32 `protobuf:"varint,2,opt,name=total,proto3" json:"total,omitempty"`
	// contains filtered or unexported fields
}

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

type GetLastSummaryResponse struct {

	// achieved is true when Mind believes the objective was satisfied.
	Achieved bool `protobuf:"varint,1,opt,name=achieved,proto3" json:"achieved,omitempty"`
	// iterations is the number of execution loops completed.
	Iterations int32 `protobuf:"varint,2,opt,name=iterations,proto3" json:"iterations,omitempty"`
	// duration is wall-clock time spent on the run, suite, case, or operation.
	Duration *durationpb.Duration `protobuf:"bytes,3,opt,name=duration,proto3" json:"duration,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,4,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// llm_calls is the number of model calls made during the operation.
	LlmCalls int32 `protobuf:"varint,5,opt,name=llm_calls,json=llmCalls,proto3" json:"llm_calls,omitempty"`
	// input_tokens is the total number of prompt/input tokens consumed.
	InputTokens int32 `protobuf:"varint,6,opt,name=input_tokens,json=inputTokens,proto3" json:"input_tokens,omitempty"`
	// output_tokens is the total number of completion/output tokens produced.
	OutputTokens int32 `protobuf:"varint,7,opt,name=output_tokens,json=outputTokens,proto3" json:"output_tokens,omitempty"`
	// cached_tokens is the number of input tokens served from provider cache.
	CachedTokens int32 `protobuf:"varint,8,opt,name=cached_tokens,json=cachedTokens,proto3" json:"cached_tokens,omitempty"`
	// files are file changes included in the summary.
	Files []*FileChange `protobuf:"bytes,9,rep,name=files,proto3" json:"files,omitempty"`
	// checks are verification results included in the summary.
	Checks []*CheckResult `protobuf:"bytes,10,rep,name=checks,proto3" json:"checks,omitempty"`
	// trace_compact is a bounded trace summary suitable for UI display or prompts.
	TraceCompact string `protobuf:"bytes,11,opt,name=trace_compact,json=traceCompact,proto3" json:"trace_compact,omitempty"`
	// contains filtered or unexported fields
}

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

type GetMemoryResponse struct {

	// objective is the user goal or execution target.
	Objective string `protobuf:"bytes,1,opt,name=objective,proto3" json:"objective,omitempty"`
	// approach summarizes the strategy used in prior work.
	Approach string `protobuf:"bytes,2,opt,name=approach,proto3" json:"approach,omitempty"`
	// files_modified lists files changed in prior work.
	FilesModified map[string]string `` /* 174-byte string literal not displayed */
	// files_read lists files inspected in prior work.
	FilesRead map[string]string `` /* 162-byte string literal not displayed */
	// symbols are code entities returned by language analysis.
	Symbols []*SymbolEntry `protobuf:"bytes,5,rep,name=symbols,proto3" json:"symbols,omitempty"`
	// hypotheses are candidate explanations or plans Mind is tracking.
	Hypotheses []string `protobuf:"bytes,6,rep,name=hypotheses,proto3" json:"hypotheses,omitempty"`
	// blockers are unresolved issues that may prevent completion.
	Blockers []string `protobuf:"bytes,7,rep,name=blockers,proto3" json:"blockers,omitempty"`
	// next_steps are the next actions Mind has identified.
	NextSteps []string `protobuf:"bytes,8,rep,name=next_steps,json=nextSteps,proto3" json:"next_steps,omitempty"`
	// iterations is the number of execution loops completed.
	Iterations []*IterationEntry `protobuf:"bytes,9,rep,name=iterations,proto3" json:"iterations,omitempty"`
	// thread_summary is a compact summary of the conversation so far.
	ThreadSummary string `protobuf:"bytes,10,opt,name=thread_summary,json=threadSummary,proto3" json:"thread_summary,omitempty"`
	// contains filtered or unexported fields
}

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

type GetMetricsResponse struct {

	// llm_calls is the number of model calls made during the operation.
	LlmCalls int32 `protobuf:"varint,1,opt,name=llm_calls,json=llmCalls,proto3" json:"llm_calls,omitempty"`
	// input_tokens is the total number of prompt/input tokens consumed.
	InputTokens int32 `protobuf:"varint,2,opt,name=input_tokens,json=inputTokens,proto3" json:"input_tokens,omitempty"`
	// output_tokens is the total number of completion/output tokens produced.
	OutputTokens int32 `protobuf:"varint,3,opt,name=output_tokens,json=outputTokens,proto3" json:"output_tokens,omitempty"`
	// cached_tokens is the number of input tokens served from provider cache.
	CachedTokens int32 `protobuf:"varint,4,opt,name=cached_tokens,json=cachedTokens,proto3" json:"cached_tokens,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,5,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// duration is wall-clock time spent on the run, suite, case, or operation.
	Duration *durationpb.Duration `protobuf:"bytes,6,opt,name=duration,proto3" json:"duration,omitempty"`
	// iterations is the number of execution loops completed.
	Iterations int32 `protobuf:"varint,7,opt,name=iterations,proto3" json:"iterations,omitempty"`
	// context is the measured context segment or prompt state.
	Context *MetricsSummary `protobuf:"bytes,8,opt,name=context,proto3" json:"context,omitempty"`
	// contains filtered or unexported fields
}

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

type GetMiddlewareStateResponse struct {

	// chain is the ordered middleware stack and its status.
	Chain []*MiddlewareEntry `protobuf:"bytes,1,rep,name=chain,proto3" json:"chain,omitempty"`
	// contains filtered or unexported fields
}

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

type GetObjectiveGraphResponse struct {

	// nodes are graph vertices returned by the objective or dependency graph.
	Nodes []*ObjectiveNode `protobuf:"bytes,1,rep,name=nodes,proto3" json:"nodes,omitempty"`
	// edges are graph relationships between returned nodes.
	Edges []*ObjectiveEdge `protobuf:"bytes,2,rep,name=edges,proto3" json:"edges,omitempty"`
	// contains filtered or unexported fields
}

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

type GetRulesResponse struct {

	// rules are loaded rules and their current match state.
	Rules []*RuleEntry `protobuf:"bytes,1,rep,name=rules,proto3" json:"rules,omitempty"`
	// contains filtered or unexported fields
}

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

type GetSessionResponse struct {

	// id is the stable identifier for this record.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// objective is the user goal or execution target.
	Objective string `protobuf:"bytes,2,opt,name=objective,proto3" json:"objective,omitempty"`
	// created_at is when the session or record was created.
	CreatedAt *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
	// duration is wall-clock time spent on the run, suite, case, or operation.
	Duration *durationpb.Duration `protobuf:"bytes,4,opt,name=duration,proto3" json:"duration,omitempty"`
	// iteration is the execution loop number for this event.
	Iteration int32 `protobuf:"varint,5,opt,name=iteration,proto3" json:"iteration,omitempty"`
	// achieved is true when Mind believes the objective was satisfied.
	Achieved bool `protobuf:"varint,6,opt,name=achieved,proto3" json:"achieved,omitempty"`
	// events are chronological debug events for this session.
	Events []*EventEntry `protobuf:"bytes,7,rep,name=events,proto3" json:"events,omitempty"`
	// contains filtered or unexported fields
}

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

type GetSymbolMapResponse struct {

	// total_symbols is the number of symbols available in the symbol map.
	TotalSymbols int32 `protobuf:"varint,1,opt,name=total_symbols,json=totalSymbols,proto3" json:"total_symbols,omitempty"`
	// total_files is the number of files included in the response.
	TotalFiles int32 `protobuf:"varint,2,opt,name=total_files,json=totalFiles,proto3" json:"total_files,omitempty"`
	// overlay_active is true when Mind has uncommitted overlay edits.
	OverlayActive bool `protobuf:"varint,3,opt,name=overlay_active,json=overlayActive,proto3" json:"overlay_active,omitempty"`
	// files are source files included in the symbol map.
	Files []*FileSymbols `protobuf:"bytes,4,rep,name=files,proto3" json:"files,omitempty"`
	// contains filtered or unexported fields
}

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

type GetTraceResponse struct {

	// root is the root trace node for the returned tree.
	Root *TraceNode `protobuf:"bytes,1,opt,name=root,proto3" json:"root,omitempty"`
	// contains filtered or unexported fields
}

type IterationEntry struct {

	// number is the 1-based iteration or sequence number.
	Number int32 `protobuf:"varint,1,opt,name=number,proto3" json:"number,omitempty"`
	// outcome summarizes the result of an iteration or memory entry.
	Outcome string `protobuf:"bytes,2,opt,name=outcome,proto3" json:"outcome,omitempty"`
	// insight captures what Mind learned during the iteration.
	Insight string `protobuf:"bytes,3,opt,name=insight,proto3" json:"insight,omitempty"`
	// files are workspace files touched or inspected during the iteration.
	Files []string `protobuf:"bytes,4,rep,name=files,proto3" json:"files,omitempty"`
	// contains filtered or unexported fields
}

type LLMCallEntry struct {

	// timestamp is when the event, call, or record was produced.
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// model is the provider model identifier used for the call.
	Model string `protobuf:"bytes,2,opt,name=model,proto3" json:"model,omitempty"`
	// agent is the Codefly agent plugin responsible for this service type.
	Agent string `protobuf:"bytes,3,opt,name=agent,proto3" json:"agent,omitempty"`
	// prompt_hash is a stable hash of the prompt payload.
	PromptHash string `protobuf:"bytes,4,opt,name=prompt_hash,json=promptHash,proto3" json:"prompt_hash,omitempty"`
	// prompt_preview is a bounded prompt excerpt for debugging.
	PromptPreview string `protobuf:"bytes,5,opt,name=prompt_preview,json=promptPreview,proto3" json:"prompt_preview,omitempty"`
	// response_preview is a bounded response excerpt for debugging.
	ResponsePreview string `protobuf:"bytes,6,opt,name=response_preview,json=responsePreview,proto3" json:"response_preview,omitempty"`
	// input_tokens is the total number of prompt/input tokens consumed.
	InputTokens int32 `protobuf:"varint,7,opt,name=input_tokens,json=inputTokens,proto3" json:"input_tokens,omitempty"`
	// output_tokens is the total number of completion/output tokens produced.
	OutputTokens int32 `protobuf:"varint,8,opt,name=output_tokens,json=outputTokens,proto3" json:"output_tokens,omitempty"`
	// cached_tokens is the number of input tokens served from provider cache.
	CachedTokens int32 `protobuf:"varint,9,opt,name=cached_tokens,json=cachedTokens,proto3" json:"cached_tokens,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,10,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// duration_ms is wall-clock time in milliseconds.
	DurationMs int64 `protobuf:"varint,11,opt,name=duration_ms,json=durationMs,proto3" json:"duration_ms,omitempty"`
	// cache_hit is true when the provider reported a cache hit.
	CacheHit bool `protobuf:"varint,12,opt,name=cache_hit,json=cacheHit,proto3" json:"cache_hit,omitempty"`
	// tool_call_count is the number of tool calls associated with the model call.
	ToolCallCount int32 `protobuf:"varint,13,opt,name=tool_call_count,json=toolCallCount,proto3" json:"tool_call_count,omitempty"`
	// full_prompt is the complete prompt text when trace retention permits it.
	FullPrompt string `protobuf:"bytes,14,opt,name=full_prompt,json=fullPrompt,proto3" json:"full_prompt,omitempty"`
	// full_response is the complete model response when trace retention permits it.
	FullResponse string `protobuf:"bytes,15,opt,name=full_response,json=fullResponse,proto3" json:"full_response,omitempty"`
	// contains filtered or unexported fields
}

type MetricsSummary struct {

	// system_tokens is the number of tokens used by system context.
	SystemTokens int32 `protobuf:"varint,1,opt,name=system_tokens,json=systemTokens,proto3" json:"system_tokens,omitempty"`
	// state_tokens is the number of tokens used by state context.
	StateTokens int32 `protobuf:"varint,2,opt,name=state_tokens,json=stateTokens,proto3" json:"state_tokens,omitempty"`
	// turn_tokens is the number of tokens used by the current turn.
	TurnTokens int32 `protobuf:"varint,3,opt,name=turn_tokens,json=turnTokens,proto3" json:"turn_tokens,omitempty"`
	// total_tokens is the total token count for the measured context.
	TotalTokens int32 `protobuf:"varint,4,opt,name=total_tokens,json=totalTokens,proto3" json:"total_tokens,omitempty"`
	// saved_tokens is the estimated token reduction from compaction or caching.
	SavedTokens int32 `protobuf:"varint,5,opt,name=saved_tokens,json=savedTokens,proto3" json:"saved_tokens,omitempty"`
	// cacheable_ratio is the fraction of context that can be provider-cached.
	CacheableRatio float64 `protobuf:"fixed64,6,opt,name=cacheable_ratio,json=cacheableRatio,proto3" json:"cacheable_ratio,omitempty"`
	// contains filtered or unexported fields
}

type MiddlewareEntry struct {

	// name is the middleware stage name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// status reports the lifecycle or operation status.
	Status string `protobuf:"bytes,2,opt,name=status,proto3" json:"status,omitempty"`
	// details contains expanded middleware or diagnostic metadata.
	Details map[string]string `` /* 141-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ObjectiveEdge struct {

	// from is the beginning timestamp or source endpoint of a relationship.
	From string `protobuf:"bytes,1,opt,name=from,proto3" json:"from,omitempty"`
	// to is the ending timestamp or destination endpoint of a relationship.
	To string `protobuf:"bytes,2,opt,name=to,proto3" json:"to,omitempty"`
	// kind describes the graph relationship, such as dependency or decomposition.
	Kind string `protobuf:"bytes,3,opt,name=kind,proto3" json:"kind,omitempty"`
	// contains filtered or unexported fields
}

type ObjectiveNode struct {

	// id is the stable identifier for this record.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// description is the human-readable objective or subtask text.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// status reports the lifecycle or operation status.
	Status string `protobuf:"bytes,3,opt,name=status,proto3" json:"status,omitempty"`
	// checks are verification steps requested by the caller.
	Checks []*CheckEntry `protobuf:"bytes,4,rep,name=checks,proto3" json:"checks,omitempty"`
	// changes are file or behavior changes associated with this node.
	Changes []*ChangeEntry `protobuf:"bytes,5,rep,name=changes,proto3" json:"changes,omitempty"`
	// children are nested objectives under this node.
	Children []*ObjectiveNode `protobuf:"bytes,6,rep,name=children,proto3" json:"children,omitempty"`
	// wall_clock_s is elapsed wall-clock time in seconds.
	WallClockS float64 `protobuf:"fixed64,7,opt,name=wall_clock_s,json=wallClockS,proto3" json:"wall_clock_s,omitempty"`
	// work_time_s is active work time in seconds.
	WorkTimeS float64 `protobuf:"fixed64,8,opt,name=work_time_s,json=workTimeS,proto3" json:"work_time_s,omitempty"`
	// cost_usd is the estimated model cost in US dollars.
	CostUsd float64 `protobuf:"fixed64,9,opt,name=cost_usd,json=costUsd,proto3" json:"cost_usd,omitempty"`
	// contains filtered or unexported fields
}

type RuleEntry struct {

	// id is the stable identifier for this record.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// scope describes where a rule applies.
	Scope *RuleScope `protobuf:"bytes,2,opt,name=scope,proto3" json:"scope,omitempty"`
	// text is the plain-text payload or human-readable description.
	Text string `protobuf:"bytes,3,opt,name=text,proto3" json:"text,omitempty"`
	// matched_current is true when the rule applies to the current request.
	MatchedCurrent bool `protobuf:"varint,4,opt,name=matched_current,json=matchedCurrent,proto3" json:"matched_current,omitempty"`
	// contains filtered or unexported fields
}

type RuleScope struct {

	// agents are Codefly plugin identities or filters relevant to this operation.
	Agents []string `protobuf:"bytes,1,rep,name=agents,proto3" json:"agents,omitempty"`
	// objectives are objective filters or graph nodes.
	Objectives []string `protobuf:"bytes,2,rep,name=objectives,proto3" json:"objectives,omitempty"`
	// code is the diagnostic or rule identifier from the producing tool.
	Code string `protobuf:"bytes,3,opt,name=code,proto3" json:"code,omitempty"`
	// contains filtered or unexported fields
}

type StreamEventsRequest struct {

	// kinds filters events to selected event types.
	Kinds []string `protobuf:"bytes,1,rep,name=kinds,proto3" json:"kinds,omitempty"`
	// agent_filter restricts events to a single agent name.
	AgentFilter string `protobuf:"bytes,2,opt,name=agent_filter,json=agentFilter,proto3" json:"agent_filter,omitempty"`
	// contains filtered or unexported fields
}

type SymbolEntry struct {

	// name is the symbol name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// file is a workspace- or service-relative source file path.
	File string `protobuf:"bytes,2,opt,name=file,proto3" json:"file,omitempty"`
	// relevance is a score or explanation for why the item matters.
	Relevance string `protobuf:"bytes,3,opt,name=relevance,proto3" json:"relevance,omitempty"`
	// contains filtered or unexported fields
}

type SymbolNode struct {

	// name is the symbol name.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// kind classifies the language construct.
	Kind string `protobuf:"bytes,2,opt,name=kind,proto3" json:"kind,omitempty"`
	// signature is the declaration text or callable shape for a symbol.
	Signature string `protobuf:"bytes,3,opt,name=signature,proto3" json:"signature,omitempty"`
	// overlay is true when the symbol or file comes from the active edit overlay.
	Overlay bool `protobuf:"varint,4,opt,name=overlay,proto3" json:"overlay,omitempty"`
	// contains filtered or unexported fields
}

type TraceEvent struct {

	// kind categorizes the trace event for filtering and rendering.
	Kind string `protobuf:"bytes,1,opt,name=kind,proto3" json:"kind,omitempty"`
	// agent is the Codefly agent plugin responsible for this service type.
	Agent string `protobuf:"bytes,2,opt,name=agent,proto3" json:"agent,omitempty"`
	// message is the event text shown in the trace view.
	Message string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
	// data is the raw bytes or JSON-shaped payload.
	Data map[string]string `` /* 135-byte string literal not displayed */
	// contains filtered or unexported fields
}

type TraceNode struct {

	// agent is the Codefly agent plugin responsible for this service type.
	Agent string `protobuf:"bytes,1,opt,name=agent,proto3" json:"agent,omitempty"`
	// duration is wall-clock time spent on the run, suite, case, or operation.
	Duration *durationpb.Duration `protobuf:"bytes,2,opt,name=duration,proto3" json:"duration,omitempty"`
	// events are trace events emitted within this node.
	Events []*TraceEvent `protobuf:"bytes,3,rep,name=events,proto3" json:"events,omitempty"`
	// children are nested trace spans.
	Children []*TraceNode `protobuf:"bytes,4,rep,name=children,proto3" json:"children,omitempty"`
	// stats aggregates trace node counts, timings, and error totals.
	Stats *TraceStats `protobuf:"bytes,5,opt,name=stats,proto3" json:"stats,omitempty"`
	// contains filtered or unexported fields
}

type TraceStats struct {

	// llm_calls is the number of model calls made during the operation.
	LlmCalls int32 `protobuf:"varint,1,opt,name=llm_calls,json=llmCalls,proto3" json:"llm_calls,omitempty"`
	// tool_calls is the number of tool calls made in this turn or iteration.
	ToolCalls int32 `protobuf:"varint,2,opt,name=tool_calls,json=toolCalls,proto3" json:"tool_calls,omitempty"`
	// errors is the number of failed trace nodes or operations.
	Errors int32 `protobuf:"varint,3,opt,name=errors,proto3" json:"errors,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedDebugServiceServer struct{}

type UnsafeDebugServiceServer interface {
	// contains filtered or unexported methods
}