agents

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

type AgentSession struct {
	// The prompt that tells the agent how to interact with the agent loop and react loop,
	// usually does not need to be changed.
	AgentPrompt string
	// The prompt telling the agent specifically about its task,
	// if not specified will tell the agent to be a generalist.
	TaskPrompt string
	// The prompt telling the agent how to act / speak,
	// if not specified will speak neutrally and refer to itself as AI Assistant.
	PersonalityPrompt string
	// The messages, excluding system and other special messages.
	CoreMessages []jpf.Message
	// The current tool calls that have been deferred, with their validated args.
	CurrentDeferredToolCalls []DeferredToolCall
	// The names of the skills that should currently be active.
	ActiveSkillNames []string
}

type AgentSessionDTO struct {
	AgentPrompt              string                `json:"agent_prompt"`
	TaskPrompt               string                `json:"task_prompt"`
	PersonalityPrompt        string                `json:"personality_prompt"`
	CoreMessages             []jpf.MessageDTO      `json:"core_messages,omitempty"`
	CurrentDeferredToolCalls []DeferredToolCallDTO `json:"current_deferred_tool_calls,omitempty"`
	ActiveSkillNames         []string              `json:"active_skill_names,omitempty"`
}

type DeferredCallResponse struct {
	CallID string
	Result string
	Err    error
}

type DeferredToolCall struct {
	ToolName string
	CallID   string
	Args     map[string]any
}

type DeferredToolCallDTO struct {
	ToolName string         `json:"tool_name"`
	CallID   string         `json:"call_id"`
	Args     map[string]any `json:"args,omitempty"`
}

type Skill struct {
	Name        string
	Description string
	Content     string
}

type Tool struct {
	// How and when can the agent call the tool, and what it should expect it to do.
	Schema jpf.ToolSchema
	// How should the agent framework run the tool.
	// If not specified, the agent framework will break the loop and defer.
	Call func(context.Context, map[string]any) (string, error)
}