skill

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

type GenerateOptions struct {
	Since *time.Time // only include turns starting on or after this time
	Until *time.Time // only include turns starting on or before this time
}

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

type LLMCallFunc func(ctx context.Context, prompt string) (string, error)

type LLMCallerConfig struct {
	Provider string               // "openai", "anthropic", or "ollama"
	Model    string               // e.g. "gpt-4o-mini", "claude-haiku-4-5-20251001"
	APIKey   string               // explicit API key (highest priority)
	BaseURL  string               // override base URL
	CredMgr  *credentials.Manager // credentials from tapes auth
}

type Querier interface {
	// TraceSummaries returns the user-visible turns of a session
	// (GET /v1/traces?session_id=), newest derive's projection.
	TraceSummaries(ctx context.Context, sessionID string) ([]TraceSummary, error)

	// Trace returns one turn's spans with full payloads
	// (GET /v1/traces/{trace_id}).
	Trace(ctx context.Context, traceID string) (*Trace, error)
}

type Skill struct {
	Name        string    `json:"name"`        // kebab-case identifier
	Description string    `json:"description"` // trigger description for Claude
	Version     string    `json:"version"`     // semver, default "0.1.0"
	Tags        []string  `json:"tags"`        // e.g. ["debugging", "react"]
	Type        string    `json:"type"`        // "workflow", "domain-knowledge", "prompt-template"
	Content     string    `json:"content"`     // markdown body (instructions)
	Sessions    []string  `json:"sessions"`    // source session IDs
	CreatedAt   time.Time `json:"created_at"`
}

type Span struct {
	SpanID       string
	ParentSpanID string
	Kind         string // "llm", "tool", "agent", "event"
	Name         string // tool name for tool spans
	Seq          int64
	// CallKind is the derive-time taxonomy ("main", "offshoot:…",
	// "injected:…") carried in span metadata; empty for tool spans.
	CallKind string
	// ThreadID is the harness sub-thread ("" = the main conversation).
	ThreadID string
	// Output is the decoded output content for llm spans (nil for
	// tool spans — the builder only needs their Name).
	Output []llm.ContentBlock
}

type Trace struct {
	TraceID string
	Spans   []Span
}

type TraceSummary struct {
	TraceID         string
	UserPrompt      string
	ResponsePreview string
	// Synthetic is non-empty for turns the harness manufactured
	// (compaction, resume replay); they carry no user intent and are
	// excluded from skill transcripts.
	Synthetic string
	StartedAt time.Time
	// Token counts folded by the deriver for the turn. Total* spans the
	// whole turn (spine + harness shadow calls); Main* counts only the
	// conversation-spine calls. Surfaced by the checkout export.
	TotalInputTokens  int64
	TotalOutputTokens int64
	MainInputTokens   int64
	MainOutputTokens  int64
}

type TranscriptOption func(*transcriptConfig)