permission

type Approver func(ctx context.Context, prompt Prompt) (Choice, error)

type AuditEntry struct {
	Time       time.Time  `json:"time"`
	Mode       Mode       `json:"mode"`
	PlanMode   bool       `json:"plan_mode"`
	Tool       string     `json:"tool"`
	Capability Capability `json:"capability"`
	Summary    string     `json:"summary"`
	Decision   string     `json:"decision"`
	Reason     string     `json:"reason,omitempty"`
	Allow      bool       `json:"allow"`
}

type Capability string

type Checker interface {
	CheckPermission(ctx context.Context, req Request) (*Decision, error)
}

type Choice string

type Decision struct {
	Kind         DecisionKind    `json:"kind"`
	Source       DecisionSource  `json:"source,omitempty"`
	Reason       string          `json:"reason,omitempty"`
	Capability   Capability      `json:"capability,omitempty"`
	Summary      string          `json:"summary,omitempty"`
	Key          string          `json:"key,omitempty"`
	OutsideRoots bool            `json:"outside_roots,omitempty"`
	Prompted     bool            `json:"prompted,omitempty"`
	Preview      string          `json:"preview,omitempty"`
	UpdatedArgs  json.RawMessage `json:"updated_args,omitempty"`
	Suggestions  []string        `json:"suggestions,omitempty"`
}

type DecisionEngine interface {
	Decide(ctx context.Context, req Request) (*Decision, error)
}

type DecisionKind string

type DecisionSource string

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

type EngineConfig struct {
	Workspace string
	Mode      Mode
	Rules     *RuleSet
	Roots     FilesystemRoots
	Store     *Store
	Approver  Approver
	OnAudit   func(AuditEntry)
}

type FilesystemRoots struct {
	ReadRoots  []string
	WriteRoots []string
}

type Metadata struct {
	Capability  Capability `json:"capability,omitempty"`
	SummaryHint string     `json:"summary_hint,omitempty"`
	Reason      string     `json:"reason,omitempty"`
	Key         string     `json:"key,omitempty"`
	KeyPrefix   string     `json:"key_prefix,omitempty"`
}

type Mode string

type Prompt struct {
	Tool         string
	Summary      string
	Reason       string
	Capability   Capability
	Preview      string
	OutsideRoots bool
}

type Request struct {
	ToolID    string          `json:"tool_id,omitempty"`
	ToolName  string          `json:"tool_name"`
	ToolLabel string          `json:"tool_label,omitempty"`
	Summary   string          `json:"summary,omitempty"`
	Reason    string          `json:"reason,omitempty"`
	Args      json.RawMessage `json:"args,omitempty"`
	Preview   json.RawMessage `json:"preview,omitempty"`
	Metadata  Metadata        `json:"metadata,omitempty"`
}

type Rule struct {
	Raw     string
	Kind    string
	Pattern string
}

type RuleSet struct {
	Allow []Rule
	Deny  []Rule
}

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

type StoreEntry struct {
	Key        string     `json:"key"`
	Tool       string     `json:"tool"`
	Capability Capability `json:"capability"`
	Summary    string     `json:"summary"`
	AddedAt    time.Time  `json:"added_at"`
}