mcpserver

type CaptureArgs struct {
	SessionToken string   `json:"session_token" jsonschema:"token from sdd_open_session"`
	Type         string   `json:"type" jsonschema:"entry type: s (signal = something noticed) or d (decision = something committed to)"`
	Layer        string   `` /* 137-byte string literal not displayed */
	Kind         string   `` /* 200-byte string literal not displayed */
	Description  string   `json:"description" jsonschema:"the entry body; first sentence must work as a standalone summary; fold dialogue reasoning in"`
	Refs         []RefArg `json:"refs,omitempty" jsonschema:"references connecting this entry's reasoning to existing entries"`
	Closes       []string `json:"closes,omitempty" jsonschema:"entry IDs this entry resolves or fulfills"`
	Supersedes   []string `json:"supersedes,omitempty" jsonschema:"entry IDs this entry replaces"`
	Topics       []string `json:"topics,omitempty" jsonschema:"topic labels; reuse labels from sdd_ground's topics_in_use when one fits"`
	Confidence   string   `json:"confidence,omitempty" jsonschema:"high (strong conviction), medium (reasonable but unvalidated), or low (hypothesis)"`
	Participants []string `json:"participants,omitempty" jsonschema:"canonical participant names; omit to default to the configured local participant"`
	// SkipPreflight bypasses the validation gate. The instructions tell the
	// agent to only set it on explicit human direction; exposing it at all is
	// part of the experiment (does the agent reach for it under pushback?).
	SkipPreflight bool `json:"skip_preflight,omitempty" jsonschema:"bypass validation; only on explicit user direction after seeing the findings"`
}

type CaptureResult struct {
	Created      bool      `json:"created"`
	Blocked      bool      `json:"blocked"`
	ID           string    `json:"id,omitempty"`
	Path         string    `json:"path,omitempty"`
	Summary      string    `json:"summary,omitempty" jsonschema:"generated summary; verify it against what the user confirmed"`
	Findings     []Finding `json:"findings,omitempty"`
	Instructions string    `json:"instructions"`
}

type Finding struct {
	Severity    string `json:"severity"`
	Category    string `json:"category"`
	Observation string `json:"observation"`
}

type GroundArgs struct {
	SessionToken string `json:"session_token" jsonschema:"token from sdd_open_session"`
	Topic        string `json:"topic" jsonschema:"short phrase naming what the dialogue is about, e.g. 'pre-flight verdict oscillation'"`
}

type GroundResult struct {
	RelatedEntries string `json:"related_entries" jsonschema:"entries related to the topic, with match citations"`
	TopicsInUse    string `json:"topics_in_use" jsonschema:"topic labels already in use across active entries, with entry counts"`
	Instructions   string `json:"instructions"`
}

type OpenSessionArgs struct{}

type OpenSessionResult struct {
	SessionToken string `json:"session_token" jsonschema:"token identifying this dialogue session; pass it to sdd_ground and sdd_capture"`
	Participant  string `json:"participant,omitempty" jsonschema:"the local human participant configured for this graph"`
	Language     string `json:"language,omitempty" jsonschema:"configured graph language; entries are authored in it"`
	Briefing     string `json:"briefing" jsonschema:"current graph state: aspirations, focus, recent completions, active work, open signals"`
	Instructions string `json:"instructions"`
}

type Options struct {
	Handler  *handlers.Handler // write path: capture dispatches NewEntryCmd here
	Finder   *finders.Finder   // read path: graph load, info, view, show
	Searcher Searcher          // ground retrieval; nil degrades ground to topics-only
	// VectorSearch selects phrase (vector/semantic) retrieval for ground
	// calls. False falls back to text-term matching on the topic words.
	VectorSearch bool
	GraphDir     string
	Version      string
}

type RefArg struct {
	ID   string `json:"id" jsonschema:"full ID of the referenced entry"`
	Kind string `` /* 153-byte string literal not displayed */
	Desc string `json:"desc,omitempty" jsonschema:"optional one-line why for this reference"`
}

type Searcher interface {
	Search(ctx context.Context, q query.SearchQuery) (*query.SearchResult, error)
}

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

type ShowEntryArgs struct {
	IDs       []string `json:"ids" jsonschema:"entry IDs to show (full IDs preferred)"`
	UpDepth   int      `json:"up_depth,omitempty" jsonschema:"upstream (grounding) expansion depth; default 2"`
	DownDepth int      `json:"down_depth,omitempty" jsonschema:"downstream (consumers) expansion depth; default 1"`
}

type ShowEntryResult struct {
	Entries      string `json:"entries" jsonschema:"full entry content with upstream and downstream reference trees"`
	Instructions string `json:"instructions"`
}