resolve

type BranchesContainingRequest struct {
	// Selector identifies the entity or snapshot to find.
	Selector ContainmentSelector `json:"selector"`
	// ContinuationToken resumes a compatible containment request.
	ContinuationToken string `json:"continuationToken,omitempty"`
	// Budget optionally narrows configured query limits.
	Budget QueryBudgetRequest `json:"budget"`
}

type BranchesContainingResult struct {
	// Budget is the effective query budget used by the tool adapter.
	Budget QueryBudget `json:"budget"`
	// Completion reports query completion and full-envelope byte accounting.
	Completion QueryCompletionMetadata `json:"completion"`
	// BranchContainmentResult retains the containment page and continuation token.
	repository.BranchContainmentResult
}

type ContainmentSelector = repository.ContainmentSelector

type ContextNode = contextual.ContextNode

type ContextRequest = SearchExpandRequest

type ContextResult = SearchExpandResult

type DiffRequest struct {
	// Base identifies the required branch and optional reachable base commit.
	Base SnapshotSelector `json:"base"`
	// Target identifies the required branch and optional reachable target commit.
	Target SnapshotSelector `json:"target"`
	// Filter optionally restricts returned changes.
	Filter repository.DiffFilter `json:"filter,omitempty"`
	// IncludeOneHop requests related unchanged context.
	IncludeOneHop bool `json:"includeOneHop,omitempty"`
	// ContinuationToken resumes a compatible diff request.
	ContinuationToken string `json:"continuationToken,omitempty"`
	// Budget optionally narrows configured query limits.
	Budget QueryBudgetRequest `json:"budget"`
}

type DiffResult struct {
	// Base identifies the pinned base snapshot.
	Base SnapshotMetadata `json:"base"`
	// Target identifies the pinned target snapshot.
	Target SnapshotMetadata `json:"target"`
	// Projection describes the target snapshot's projection provenance.
	Projection ProjectionMetadata `json:"projection"`
	// Budget is the effective query budget used by the tool adapter.
	Budget QueryBudget `json:"budget"`
	// Completion reports query completion and full-envelope byte accounting.
	Completion QueryCompletionMetadata `json:"completion"`
	// DiffResult retains the bounded diff payload and pagination fields.
	repository.DiffResult
}

type Direction = contextual.Direction

type Evidence = contextual.Evidence

type FilterRequest struct {
	Selector          SnapshotSelector    `json:"selector"`
	Labels            []string            `json:"labels,omitempty"`
	Predicates        []MetadataPredicate `json:"predicates,omitempty"`
	ContinuationToken string              `json:"continuationToken,omitempty"`
	Budget            QueryBudgetRequest  `json:"budget"`
}

type FilterResult struct {
	Snapshot          SnapshotMetadata        `json:"snapshot"`
	Projection        ProjectionMetadata      `json:"projection"`
	Budget            QueryBudget             `json:"budget"`
	Completion        QueryCompletionMetadata `json:"completion"`
	Nodes             []repository.Node       `json:"nodes"`
	ContinuationToken string                  `json:"continuationToken,omitempty"`
}

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

type HistoryRequest struct {
	// Selector identifies the required branch and optional reachable starting commit.
	Selector SnapshotSelector `json:"selector"`
	// EntityID identifies the node or edge whose changes are returned.
	EntityID string `json:"entityId"`
	// AllParents includes all parent links rather than only each commit's first parent.
	AllParents bool `json:"allParents,omitempty"`
	// ContinuationToken resumes a compatible history request.
	ContinuationToken string `json:"continuationToken,omitempty"`
	// Budget optionally narrows configured query limits.
	Budget QueryBudgetRequest `json:"budget"`
}

type HistoryResult struct {
	// Snapshot identifies the pinned snapshot from which history was traversed.
	Snapshot SnapshotMetadata `json:"snapshot"`
	// Projection describes the snapshot's projection provenance.
	Projection ProjectionMetadata `json:"projection"`
	// Budget is the effective query budget used by the tool adapter.
	Budget QueryBudget `json:"budget"`
	// Completion reports query completion and full-envelope byte accounting.
	Completion QueryCompletionMetadata `json:"completion"`
	// HistoryResult retains the entity history payload.
	repository.HistoryResult
}

type ImpactRequest struct {
	// Selector identifies the required branch and optional reachable commit to analyze.
	Selector SnapshotSelector `json:"selector"`
	// Request contains the hypothetical repository impact operation.
	Request repository.ImpactRequest `json:"request"`
	// Budget optionally narrows configured query limits.
	Budget QueryBudgetRequest `json:"budget"`
}

type ImpactResult struct {
	// Snapshot identifies the pinned snapshot analyzed.
	Snapshot SnapshotMetadata `json:"snapshot"`
	// Projection describes the snapshot's projection provenance.
	Projection ProjectionMetadata `json:"projection"`
	// Budget is the effective query budget used by the tool adapter.
	Budget QueryBudget `json:"budget"`
	// Completion reports query completion and full-envelope byte accounting.
	Completion QueryCompletionMetadata `json:"completion"`
	// ImpactResult retains the bounded impact payload.
	repository.ImpactResult
}

type MergeApplyRequest struct {
	SourceBranch  string              `json:"sourceBranch"`
	TargetBranch  string              `json:"targetBranch"`
	TransactionID string              `json:"transactionId"`
	PreviewID     repository.ObjectID `json:"previewId"`
	Author        string              `json:"author,omitempty"`
	Message       string              `json:"message,omitempty"`
}

type MergeConflictsRequest struct {
	TargetBranch  string `json:"targetBranch"`
	TransactionID string `json:"transactionId"`
}

type MergeResolveRequest = repository.ResolveConflictedMergeRequest

type MergeTransactionRequest = MergeConflictsRequest

type MetadataPredicate = repository.MetadataPredicate

type Node = repository.Node

type Options struct {
	// AllowDetachedCommit permits explicit commits not reachable from the selected branch.
	AllowDetachedCommit bool
	// QueryBudget provides configured upper bounds for tool queries.
	QueryBudget *QueryBudget
}

type ProjectionMetadata struct {
	// NodeRoot identifies the projection watermark when it matches Snapshot.
	NodeRoot string `json:"nodeRoot"`
	// State describes availability for Snapshot. A nonmatching or absent
	// branch-head projection is unavailable.
	State string `json:"state"`
	// SchemaVersion identifies the projection schema version.
	SchemaVersion string `json:"schemaVersion"`
}

type QueryBudget struct {
	// MaxRows limits diff changes and context entries.
	MaxRows int `json:"maxRows"`
	// MaxResponseBytes limits JSON-encoded diff responses.
	MaxResponseBytes int `json:"maxResponseBytes"`
	// MaxDepth limits impact traversal edge distance.
	MaxDepth int `json:"maxDepth"`
	// MaxVisited limits impact traversal nodes.
	MaxVisited int `json:"maxVisited"`
	// Timeout is the maximum caller-supplied operation duration.
	Timeout time.Duration `json:"timeout"`
}

type QueryBudgetRequest struct {
	// MaxRows narrows the maximum diff rows.
	MaxRows *int `json:"maxRows,omitempty"`
	// MaxResponseBytes narrows the maximum diff response size.
	MaxResponseBytes *int `json:"maxResponseBytes,omitempty"`
	// MaxDepth narrows the maximum impact depth.
	MaxDepth *int `json:"maxDepth,omitempty"`
	// MaxVisited narrows the maximum impact traversal size.
	MaxVisited *int `json:"maxVisited,omitempty"`
	// Timeout narrows the maximum operation duration.
	Timeout *time.Duration `json:"timeout,omitempty"`
}

type QueryCompletionMetadata struct {
	// Complete reports whether every matching result was returned.
	Complete bool `json:"complete"`
	// Truncated reports whether a query budget omitted matching results.
	Truncated bool `json:"truncated"`
	// TimedOut reports whether the effective query deadline ended a paged query.
	TimedOut bool `json:"timedOut"`
	// Visited reports the number of entries returned in this response page.
	Visited int `json:"visited"`
	// ElapsedMs is the non-negative elapsed execution duration in milliseconds.
	ElapsedMs int64 `json:"elapsedMs"`
	// CompletedAt is when query execution completed.
	CompletedAt time.Time `json:"-"`
	// Duration is the non-negative elapsed execution duration.
	Duration time.Duration `json:"-"`
	// ResponseBytes is the exact size of the JSON response envelope.
	ResponseBytes int `json:"responseBytes"`
}

type QueryExecutionMetadata struct {
	// Budget is the normalized limit set enforced for the query.
	Budget QueryBudget `json:"budget"`
	// StartedAt is when execution began.
	StartedAt time.Time `json:"startedAt"`
	// Deadline is the earlier of the caller and budget deadlines.
	Deadline time.Time `json:"deadline"`
}

type ResolveRequest struct {
	// Selector identifies the snapshot to resolve.
	Selector SnapshotSelector `json:"selector"`
	// NodeID identifies the requested node.
	NodeID string `json:"nodeId"`
	// Budget optionally narrows configured query limits.
	Budget QueryBudgetRequest `json:"budget"`
}

type ResolveResult struct {
	// Node is the resolved immutable node.
	Node Node `json:"node"`
	// Snapshot identifies the commit and graph snapshot read.
	Snapshot SnapshotMetadata `json:"snapshot"`
	// Projection describes the returned node projection.
	Projection ProjectionMetadata `json:"projection"`
	// Budget is the effective query budget used by the tool adapter.
	Budget QueryBudget `json:"budget"`
	// Completion reports query completion and full-envelope byte accounting.
	Completion QueryCompletionMetadata `json:"completion"`
}

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

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

type SchemaMetadata struct {
	// Root identifies the durable schema object.
	Root string `json:"root"`
	// Version identifies the schema version.
	Version uint16 `json:"version"`
	// Permissive reports whether the schema only enforces graph integrity and
	// global invariants.
	Permissive bool `json:"permissive"`
}

type SchemaValidationRequest struct {
	// Selector identifies the branch and optional reachable commit.
	Selector SnapshotSelector `json:"selector"`
}

type SchemaValidationResult struct {
	// Snapshot identifies the commit and graph snapshot validated.
	Snapshot SnapshotMetadata `json:"snapshot"`
	// Projection describes the projection provenance for Snapshot.
	Projection ProjectionMetadata `json:"projection"`
	// Schema identifies the schema applied to Snapshot.
	Schema SchemaMetadata `json:"schema"`
	// Valid reports whether the snapshot conforms to Schema.
	Valid bool `json:"valid"`
	// Violations contains every failed schema constraint when Valid is false.
	Violations []repository.SchemaViolation `json:"violations"`
}

type SearchExpandRequest struct {
	Selector SnapshotSelector `json:"selector"`
	Seeds    SeedSelector     `json:"seeds"`
	// SeedLimit limits evidence before expansion. Zero uses the effective row budget.
	SeedLimit int                `json:"seedLimit,omitempty"`
	Direction Direction          `json:"direction"`
	EdgeTypes []string           `json:"edgeTypes,omitempty"`
	Budget    QueryBudgetRequest `json:"budget"`
}

type SearchExpandResult struct {
	Snapshot          SnapshotMetadata        `json:"snapshot"`
	Projection        ProjectionMetadata      `json:"projection"`
	Budget            QueryBudget             `json:"budget"`
	Completion        QueryCompletionMetadata `json:"completion"`
	Evidence          []Evidence              `json:"evidence"`
	Nodes             []ContextNode           `json:"nodes"`
	Edges             []repository.Edge       `json:"edges"`
	Paths             []SupportingPath        `json:"paths"`
	CapacityExhausted bool                    `json:"capacityExhausted,omitempty"`
}

type SearchRequest struct {
	Selector          SnapshotSelector   `json:"selector"`
	Query             string             `json:"query"`
	ContinuationToken string             `json:"continuationToken,omitempty"`
	Budget            QueryBudgetRequest `json:"budget"`
}

type SearchResult struct {
	Snapshot          SnapshotMetadata             `json:"snapshot"`
	Projection        ProjectionMetadata           `json:"projection"`
	Budget            QueryBudget                  `json:"budget"`
	Completion        QueryCompletionMetadata      `json:"completion"`
	Matches           []repository.SearchNodeMatch `json:"matches"`
	ContinuationToken string                       `json:"continuationToken,omitempty"`
}

type SeedSelector = contextual.SeedSelector

type SnapshotMetadata struct {
	// Repository identifies the repository that resolved the snapshot.
	Repository string `json:"repository"`
	// Branch identifies the requested branch.
	Branch string `json:"branch"`
	// Commit identifies the selected commit.
	Commit string `json:"commit"`
	// Root identifies the selected graph snapshot.
	Root string `json:"root"`
}

type SnapshotSelector struct {
	// Branch identifies the required branch.
	Branch string `json:"branch"`
	// Commit optionally identifies a commit constrained by resolver policy.
	Commit *string `json:"commit,omitempty"`
}

type SupportingPath = contextual.SupportingPath