base

type AuthorizeResult ¶

type AuthorizeResult struct {
	Allowed bool
	Reason  string
}

AuthorizeResult is the outcome of a programmatic tool authorization check. When Allowed is false, Reason carries the denial message for logging/events.

type ExecuteLLMInput ¶ added in v0.2.2

type ExecuteLLMInput struct {
	Logger           logger.Logger
	AgentName        string
	MessageID        string
	RunID            string
	Iteration        int
	Messages         []interfaces.Message
	SkipTools        bool
	MemoryContext    string
	RetrieverContext string
	Tools            []interfaces.Tool
	Emit             func(events.AgentEvent)
}

type ExecuteMemoryRecallInput ¶ added in v0.2.3

type ExecuteMemoryRecallInput struct {
	Logger    logger.Logger
	RunID     string
	Iteration int
	Scope     interfaces.MemoryScope
	Query     string
}

ExecuteMemoryRecallInput holds per-invocation inputs for Runtime.ExecuteMemoryRecall. RunID and Iteration populate hooks.RunMeta for memory load middleware hooks.

type ExecuteMemoryStoreInput ¶ added in v0.2.3

type ExecuteMemoryStoreInput struct {
	Logger    logger.Logger
	RunID     string
	Iteration int
	Scope     interfaces.MemoryScope
	Messages  []interfaces.Message
}

ExecuteMemoryStoreInput holds per-invocation inputs for Runtime.ExecuteMemoryStore. RunID and Iteration populate hooks.RunMeta for memory store middleware hooks.

type ExecuteRetrieversInput ¶ added in v0.2.3

type ExecuteRetrieversInput struct {
	Logger    logger.Logger
	RunID     string
	Iteration int
	Query     string
}

ExecuteRetrieversInput holds per-invocation inputs for Runtime.ExecuteRetrievers. RunID and Iteration populate hooks.RunMeta for retrieve middleware hooks.

type ExecuteToolInput ¶ added in v0.2.3

type ExecuteToolInput struct {
	Logger     logger.Logger
	Tools      []interfaces.Tool
	ToolName   string
	Args       map[string]any
	ToolCallID string
	RunID      string
	Iteration  int
}

ExecuteToolInput holds per-invocation inputs for Runtime.ExecuteTool. RunID and Iteration populate hooks.RunMeta for tool middleware hooks.

type LLMResult ¶

type LLMResult struct {
	Content   string
	ToolCalls []ToolCallRequest
	Usage     *interfaces.LLMUsage
}

LLMResult is the result of a successful LLM call. Content holds the assistant text; ToolCalls holds any tool invocations resolved against the registered tools list (NeedsApproval pre-computed from the approval policy).

type MemoryResult ¶ added in v0.2.2

type MemoryResult struct {
	Context       string
	TotalRecalls  int64
	FailedRecalls int64
}

MemoryResult is the outcome of ExecuteMemoryRecall.

type RetrieverResult ¶ added in v0.2.2

type RetrieverResult struct {
	Context        string
	TotalSearches  int64
	FailedSearches int64
}

RetrieverResult is the outcome of ExecuteRetrievers (prefetch / hybrid pre-loop).

type Runtime ¶

type Runtime struct {
	AgentSpec   runtime.AgentSpec
	AgentConfig runtime.AgentConfig
	Tracer      interfaces.Tracer
	Metrics     interfaces.Metrics
	// ToolExecutionMode controls whether tool calls in one LLM round are executed
	// in parallel or sequentially. Defaults to parallel when empty.
	ToolExecutionMode types.AgentToolExecutionMode
}

Runtime holds the execution inputs shared by all runtime backends. Local and Temporal runtimes embed this struct and call its methods directly.

func (rt *Runtime) AuthorizeTool(ctx context.Context, log logger.Logger, tools []interfaces.Tool, toolName string, args map[string]any) (AuthorizeResult, error)

func (rt *Runtime) BuildLLMRequest(messages []interfaces.Message, skipTools bool, memoryContext, retrieverContext string, tools []interfaces.Tool) *interfaces.LLMRequest

func (rt *Runtime) ExecuteLLM(ctx context.Context, input ExecuteLLMInput) (*LLMResult, error)

func (rt *Runtime) ExecuteLLMStream(ctx context.Context, input ExecuteLLMInput) (*LLMResult, error)

func (rt *Runtime) ExecuteMemoryRecall(ctx context.Context, input ExecuteMemoryRecallInput) (*MemoryResult, error)

func (rt *Runtime) ExecuteMemoryStore(ctx context.Context, input ExecuteMemoryStoreInput) error

func (rt *Runtime) ExecuteRetrievers(ctx context.Context, input ExecuteRetrieversInput) (*RetrieverResult, error)

func (rt *Runtime) ExecuteTool(ctx context.Context, input ExecuteToolInput, memScope interfaces.MemoryScope) (string, error)

func (rt *Runtime) FetchConversationMessages(ctx context.Context, log logger.Logger, conversationID string) ([]interfaces.Message, error)

func (rt *Runtime) MemoryConfigured() bool

func (rt *Runtime) MemoryStoreOnDemand() bool

func (rt *Runtime) RecallEnabled() bool

func (rt *Runtime) RequiresApproval(t interfaces.Tool) bool

func (rt *Runtime) ResolveMemoryScope(ctx context.Context) (interfaces.MemoryScope, error)

func (rt *Runtime) RunEndMemoryStoreEnabled() bool

func (rt *Runtime) StoreMemoryRecords(ctx context.Context, input StoreMemoryRecordsInput) error

type StoreMemoryRecordsInput ¶ added in v0.2.3

type StoreMemoryRecordsInput struct {
	Logger    logger.Logger
	RunID     string
	Iteration int
	Scope     interfaces.MemoryScope
	Records   []interfaces.MemoryRecord
}

StoreMemoryRecordsInput holds per-invocation inputs for Runtime.StoreMemoryRecords. RunID and Iteration populate hooks.RunMeta for memory store middleware hooks.

type ToolCallRequest ¶

type ToolCallRequest struct {
	ToolCallID      string
	ToolName        string
	ToolDisplayName string
	ToolKind        types.ToolKind
	Args            map[string]any
	NeedsApproval   bool
}

ToolCallRequest describes one tool call returned by the LLM. NeedsApproval is pre-computed from the tool approval policy so orchestration loops (local agent loop, temporal workflow) do not need to re-evaluate the policy.