provider

package

v0.1.2 Latest Latest Go to latest Published: Jun 21, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ParadoxInfinite/oriel

Links

Open Source Insights

Documentation ¶

Overview ¶

Package provider is the dormant extension seam for natural-language actions. The base ships NO model. If ORIEL_PROVIDER_URL is set, the base POSTs the user's text plus the available tools and live entities to that URL, and the provider (a separate process — rules, embeddings, or an LLM) returns a tool call. The returned call is always re-validated through the tool Registry before it executes, so a provider can never invoke an unknown tool or entity.

Constants ¶

View Source

const EnvURL = "ORIEL_PROVIDER_URL"

EnvURL configures the provider endpoint. Unset means the seam is dormant.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Provider ¶

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

Provider is an HTTP client for a configured resolver. The URL can be set from the environment at startup or swapped at runtime (Settings → AI), so the mutex guards it against concurrent request and config goroutines.

func New ¶

func New() *Provider

New reads the endpoint from the environment. Resolve fails until configured.

func (*Provider) Enabled ¶

func (p *Provider) Enabled() bool

Enabled reports whether a provider URL is configured.

func (*Provider) Resolve ¶

func (p *Provider) Resolve(ctx context.Context, req Request) (ToolCall, error)

Resolve asks the provider to map req.Text to a tool call.

func (*Provider) SetURL ¶

func (p *Provider) SetURL(u string)

SetURL swaps the endpoint at runtime; an empty string returns to dormant.

func (*Provider) URL ¶

func (p *Provider) URL() string

URL returns the configured endpoint, empty when dormant.

type Request ¶

type Request struct {
	Text     string              `json:"text"`
	Tools    any                 `json:"tools"`
	Entities map[string][]string `json:"entities"`
}

Request is the body POSTed to <url>/resolve.

type ToolCall ¶

type ToolCall struct {
	Tool       string         `json:"tool"`
	Args       map[string]any `json:"args"`
	Confidence float64        `json:"confidence"`
}

ToolCall is what a provider must return: which tool to run with what args.

Source Files ¶

View all Source files

provider.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL