service

type AcceptResult struct {
	Action      InteractionAction
	Payload     json.RawMessage
	RedirectURL string
}

type ChatRequest struct {
	ConversationID string
	AgentPath      string
	Query          string
	UserId         string

	// Optional context object forwarded to QueryInput so that the agent can
	// incorporate caller supplied metadata (e.g. project, user location, etc.).
	Context map[string]interface{}

	Policy  *tool.Policy
	Timeout time.Duration

	// Attachments are optional assets to include in this turn (e.g. images).
	// They are forwarded to the underlying LLM request as user content items.
	Attachments []*promptpkg.Attachment
}

type ChatResponse struct {
	ConversationID string
	Content        string
	Elicitation    *plan.Elicitation
	Plan           *plan.Plan
}

type InteractionAction string

type InteractionHandler interface {
	Accept(ctx context.Context, el *plan.Elicitation) (AcceptResult, error)
}

type Options struct {
	Interaction InteractionHandler // optional
}

type RunRequest struct {
	Input *agentpkg.QueryInput // required

	Policy  *tool.Policy
	Timeout time.Duration
}

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

type ToolRequest struct {
	Name    string                 // fully qualified tool name
	Args    map[string]interface{} // JSON-compatible arguments
	Timeout time.Duration          // optional per call timeout
}

type ToolResponse struct {
	Result interface{}
}

type WorkflowRequest struct {
	// Location points to a YAML/JSON workflow definition. It can be an
	// absolute URL, a filesystem path or a relative path resolved by the
	// executor's meta service.
	Location string

	// TaskID optionally limits execution to a single task inside the
	// workflow (via Runtime.RunTaskOnce). Leave empty to run the whole
	// process from the workflow's root node(s).
	TaskID string

	// Input passed as the execution input or initial state.
	Input interface{}

	// Timeout caps the total execution time. Zero means no timeout.
	Timeout time.Duration
}

type WorkflowResponse struct {
	Output interface{}
	Usage  *usage.Aggregator
}