jinn

type Classification string

type CompressionMeta struct {
	Strategies  []string `json:"strategies,omitempty"`
	OriginalLen int      `json:"original_len,omitempty"`
	FinalLen    int      `json:"final_len,omitempty"`
}

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

type Condition struct {
	Kind    string `json:"kind"` // exitCode|fileExists|jsonPath|numeric|match|always
	Op      string `json:"op,omitempty"`
	Value   any    `json:"value,omitempty"`
	Path    string `json:"path,omitempty"`
	Extract string `json:"extract,omitempty"`
	Regex   string `json:"regex,omitempty"`
	Stream  string `json:"stream,omitempty"` // match only: stdout|stderr
	Negate  bool   `json:"negate,omitempty"`
}

type ContentBlock struct {
	Type     string `json:"type"`               // "text" or "image"
	Text     string `json:"text,omitempty"`     // for type="text"
	Data     string `json:"data,omitempty"`     // base64-encoded, for type="image"
	MimeType string `json:"mimeType,omitempty"` // e.g. "image/png", for type="image"
}

type DiffResult struct {
	Diff             string `json:"diff"`
	FirstChangedLine int    `json:"firstChangedLine,omitempty"`
}

type Engine struct {
	LSPTimeoutSec int // per-query LSP timeout; 0 uses default (10s)
	// contains filtered or unexported fields
}

type EngineConfig struct {
	Version   string
	ShellMode ShellMode
	// Web is the explicit configuration for opt-in network tools. It is
	// intentionally supplied by the process entry point, which owns env reads.
	Web webfetch.Config
	// UnsafeAllowMutationWithoutPreconditions is an explicit compatibility
	// escape hatch for trusted embedders and tests. Production callers should
	// leave it false so every mutation supplies a current assertion.
	UnsafeAllowMutationWithoutPreconditions bool
}

type ErrWithSuggestion struct {
	Err        error
	Suggestion string
	Code       string
}

type Memory struct {
	ID        int64     `json:"id"`
	Scope     string    `json:"scope"`
	ScopeID   string    `json:"scope_id,omitempty"`
	Key       string    `json:"key"`
	Value     string    `json:"value"`
	ValueType string    `json:"value_type"`
	Kind      string    `json:"kind"`
	Pinned    bool      `json:"pinned"`
	ExpiresAt time.Time `json:"expires_at,omitempty"`
	UpdatedAt time.Time `json:"updated_at"`
	CreatedAt time.Time `json:"created_at"`
}

type NextCall struct {
	Tool      string         `json:"tool"`
	Arguments map[string]any `json:"arguments"`
}

type PlanEdge struct {
	When Condition `json:"when"`
	To   string    `json:"to"`
}

type PlanNode struct {
	ID       string     `json:"id"`
	Commands []PlanOp   `json:"commands"`
	Parallel bool       `json:"parallel,omitempty"`
	Mutates  bool       `json:"mutates,omitempty"`
	Force    bool       `json:"force,omitempty"` // node-level dangerous-mutation gate, Phase 2 only
	Edges    []PlanEdge `json:"edges,omitempty"`
}

type PlanNodeResult struct {
	NodeID string         `json:"node_id"`
	Depth  int            `json:"depth"`
	Ops    []PlanOpResult `json:"ops"`
}

type PlanOp struct {
	Shell string         `json:"shell,omitempty"`
	Tool  string         `json:"tool,omitempty"`
	Args  map[string]any `json:"args,omitempty"`
}

type PlanOpResult struct {
	OK             bool   `json:"ok"`
	Result         string `json:"result,omitempty"`
	Stdout         string `json:"stdout,omitempty"`
	Stderr         string `json:"stderr,omitempty"`
	Error          string `json:"error,omitempty"`
	Classification string `json:"classification,omitempty"`
	Risk           string `json:"risk,omitempty"`
	ExitCode       int    `json:"exit_code,omitempty"` // shell exit code, or nonzero for failed/blocked tool ops
}

type PlanRunResult struct {
	Transcript     []PlanNodeResult `json:"transcript"`
	PathTaken      []string         `json:"path_taken"`
	DepthReached   int              `json:"depth_reached"`
	StoppedReason  StopReason       `json:"stopped_reason"`
	EdgesEvaluated int              `json:"edges_evaluated"`
	EdgesMatched   int              `json:"edges_matched"`
	// contains filtered or unexported fields
}

type PlanStatsRecord struct {
	V              int    `json:"v"`
	Ts             string `json:"ts"`
	StoppedReason  string `json:"stopped_reason"`
	DepthReached   int    `json:"depth_reached"`
	Nodes          int    `json:"nodes"`
	Ops            int    `json:"ops"`
	EdgesEvaluated int    `json:"edges_evaluated"`
	EdgesMatched   int    `json:"edges_matched"`
	RequestsSaved  int    `json:"requests_saved"`
}

type PlanTree struct {
	Root     string     `json:"root"`
	Nodes    []PlanNode `json:"nodes"`
	Cwd      string     `json:"cwd,omitempty"`       // existing directory within the Engine sandbox; empty keeps Engine workDir
	MaxDepth int        `json:"max_depth,omitempty"` // 0 => DefaultMaxDepth at the outermost plan; nested 0 inherits, positive values can only lower the inherited ceiling
	Force    bool       `json:"force,omitempty"`     // plan-level dangerous-mutation gate, Phase 2 only
}

type Request struct {
	Tool      string                 `json:"tool"`
	Args      map[string]interface{} `json:"args"`
	Client    string                 `json:"client,omitempty"`
	Compress  bool                   `json:"compress,omitempty"`
	RequestID string                 `json:"request_id,omitempty"`
}

type Response struct {
	OK             bool           `json:"ok"`
	Result         string         `json:"result,omitempty"`  // legacy text result (backwards compat)
	Content        []ContentBlock `json:"content,omitempty"` // structured content blocks (images, etc.)
	Meta           map[string]any `json:"meta,omitempty"`    // structured metadata (truncation, etc.)
	Error          string         `json:"error,omitempty"`
	Suggestion     string         `json:"suggestion,omitempty"`
	Classification string         `json:"classification,omitempty"` // exit-code class: "success", "expected_nonzero", "error", "timeout", "signal"
	Risk           string         `json:"risk,omitempty"`           // pre-execution risk: "safe", "caution", "dangerous" — only set by run_shell
	ErrorCode      string         `json:"error_code,omitempty"`
	RequestID      string         `json:"request_id,omitempty"`
}

type RiskLevel int

type RouteCallTemplate struct {
	Tool      string         `json:"tool"`
	Arguments map[string]any `json:"arguments"`
	Replace   []string       `json:"replace,omitempty"`
}

type RouteMatch struct {
	Name        string             `json:"name"`
	Description string             `json:"description"`
	Reason      string             `json:"reason"`
	Mutating    bool               `json:"mutating"`
	Risk        string             `json:"risk"`
	Features    []string           `json:"features,omitempty"`
	Schema      any                `json:"schema,omitempty"`
	Signature   string             `json:"signature,omitempty"`
	Call        *RouteCallTemplate `json:"call,omitempty"`
}

type RouteRequest struct {
	Need             string `json:"need"`
	MaxTools         int    `json:"max_tools,omitempty"`
	IncludeSchema    bool   `json:"include_schema,omitempty"`
	IncludeSignature bool   `json:"include_signature,omitempty"`
	IncludeCall      bool   `json:"include_call,omitempty"`
	IncludeMutating  *bool  `json:"include_mutating,omitempty"`
	IncludeNetwork   *bool  `json:"include_network,omitempty"`
}

type RouteResponse struct {
	RouteID     string       `json:"route_id,omitempty"`
	Query       string       `json:"query"`
	Confidence  string       `json:"confidence"`
	ScoreMargin *int         `json:"score_margin,omitempty"`
	Adaptive    bool         `json:"adaptive"`
	Matches     []RouteMatch `json:"matches"`
	Notes       []string     `json:"notes"`
}

type ShellMode string

type StopReason string

type Strategy interface {
	// Name returns a unique identifier for this strategy (used in metadata).
	Name() string
	// AppliesTo returns true if this strategy should run on the given output.
	// The tool name is provided so strategies can be tool-specific.
	AppliesTo(output string, tool string) bool
	// Compress applies the strategy to the output and returns the compressed version.
	// Must be deterministic: same input always produces same output.
	// Must be lossless for signal: never drop error messages, test failures, or diff hunks.
	Compress(output string) string
}

type ToolCapabilities struct {
	JinnVersion string              `json:"jinn_version"`
	Tools       []string            `json:"tools"`
	Features    map[string][]string `json:"features"`
	Schema      any                 `json:"schema,omitempty"`
}

type ToolResult struct {
	Text    string         // human/LLM-readable text result
	Content []ContentBlock // structured content blocks (images, etc.)
	Meta    map[string]any // structured metadata for callers (truncation, etc.)
}

type TruncationResult struct {
	Truncated   bool   `json:"truncated"`
	TruncatedBy string `json:"truncatedBy,omitempty"` // "lines", "bytes", or ""
	TotalLines  int    `json:"totalLines"`
	TotalBytes  int    `json:"totalBytes"`
	OutputLines int    `json:"outputLines"`
	OutputBytes int    `json:"outputBytes"`
	MaxLines    int    `json:"maxLines"`
	MaxBytes    int    `json:"maxBytes"`
}