core

type ExecProvider interface {
	// ExecConfig returns workspace root and ExecutionEnv (typically Docker sandbox).
	ExecConfig(ctx context.Context) (pkgexec.Config, error)
}

type KVStore interface {
	Get(ctx context.Context, uid types.Uid, namespace, key string) (types.KV, error)
	Set(ctx context.Context, uid types.Uid, namespace, key string, value types.KV) error
	Delete(ctx context.Context, uid types.Uid, namespace, key string) error
}

type Meta struct {
	Title       string `json:"title"`
	Description string `json:"description"`
}

type Notifier interface {
	Send(ctx context.Context, uid types.Uid, templateID string, channels []string, payload map[string]any) error
}

type Persister interface {
	// CreateClip inserts a clip row keyed by slug.
	CreateClip(ctx context.Context, slug, title, description, content, createdBy string) error
	// GetClipBySlug returns a clip by slug, or nil when not found.
	GetClipBySlug(ctx context.Context, slug string) (*Record, error)
}

type Record struct {
	// Slug is the public short identifier.
	Slug string
	// Title is the clip title.
	Title string
	// Description is the short preview text.
	Description string
	// Content is the markdown body.
	Content string
	// CreatedBy is the optional creator identifier.
	CreatedBy string
	// CreatedAt is when the clip was created.
	CreatedAt time.Time
}

type RunParams struct {
	Prompt      string
	UID         types.Uid
	Tools       []string
	Skills      []string
	MemoryScope string
}

type RunResult struct {
	Reply     string
	SessionID string
}

type Runner interface {
	Run(ctx context.Context, params RunParams) (*RunResult, error)
}