pithsdk

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

type AgentConfig struct {
	// Name is an optional display name for the agent.
	Name string
	// Instructions is the system prompt sent to the model.
	Instructions string
	// Model is a bare ID (e.g. "gpt-4o-mini") or provider/model (e.g. "anthropic/claude-...").
	Model string
	// Tools are custom tools available during runs.
	Tools []Tool
	// Settings overrides client-level generation defaults for this agent.
	Settings *ModelSettings
}

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

type ClientConfig struct {
	// APIKey is the OpenAI-compatible API key. When empty, OPENAI_API_KEY is used at run time.
	APIKey string
	// DefaultProvider is the provider ID for bare model strings (default "openai").
	DefaultProvider string
	// DefaultModel is used when an Agent has no Model set (default "gpt-4o-mini").
	DefaultModel string
	// DefaultSettings applies generation defaults to all agents unless overridden.
	DefaultSettings *ModelSettings
}

type MessageSummary struct {
	// Role is the message role (e.g. "user", "assistant", "toolResult").
	Role string
	// Text is the message text content.
	Text string
}

type ModelPreset struct {
	// ID is the model identifier used in provider/model strings.
	ID string
	// Name is an optional display name; defaults to ID.
	Name string
	// BaseURL is an optional API base URL; the provider may use its own default.
	BaseURL string
	// ContextWindow is the model context size; zero uses the SDK default.
	ContextWindow int
	// MaxTokens is the default max output tokens; zero uses the SDK default.
	MaxTokens int
}

type ModelSettings struct {
	// Temperature controls randomness. Nil leaves the provider default.
	Temperature *float64
	// MaxTokens caps output tokens. Nil leaves the provider default.
	MaxTokens *int
}

type ProviderRegistration struct {
	// Provider implements gateway.ProviderPort for the custom API.
	Provider gateway.ProviderPort

	// Credentials — set exactly one of the following:
	// APIKey is a static API key string.
	APIKey string
	// APIKeyEnv names an environment variable holding the API key (e.g. "ANTHROPIC_API_KEY").
	APIKeyEnv string
	// Credential is a custom resolver returning the API key for the provider ID.
	Credential func(providerID string) (string, error)

	// Models lists model presets to register in the gateway catalog.
	Models []ModelPreset
}

type RunOption func(*RunOptions)

type RunOptions struct {
	// Context holds run-scoped local dependencies exposed as ToolContext.Local.
	Context any
	// Instructions overrides the agent system prompt for this run only.
	Instructions string
	// Stream receives assistant text deltas during the run; nil blocks until complete.
	Stream func(chunk TextChunk)
	// MaxTurns limits tool-calling loop iterations for this run. Zero uses defaultMaxTurns (10).
	MaxTurns int
}

type RunResult struct {
	// Text is the final assistant response text.
	Text string
	// Messages is the session transcript after this run, as simplified summaries.
	Messages []MessageSummary
	// Usage reports token usage from the last assistant response, if available.
	Usage *UsageSummary
}

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

type TextChunk struct {
	// Delta is the incremental text from the latest EventTextDelta.
	Delta string
	// Text is the accumulated assistant text so far.
	Text string
}

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

type ToolContext struct {
	// Run is the context for the current Session.Run call.
	Run context.Context
	// Local holds run-scoped dependencies from WithContext; not sent to the model.
	Local any
	// CallID is the provider-assigned tool call identifier.
	CallID string
}

type UsageSummary struct {
	// Input is the number of input/prompt tokens.
	Input int
	// Output is the number of output/completion tokens.
	Output int
	// Total is the combined token count when reported by the provider.
	Total int
}