web

type CommandProfile ¶

type CommandProfile struct {
	ID               string `json:"id"`
	ToolName         string `json:"tool_name"`
	CommandField     string `json:"command_field"`
	DescriptionField string `json:"description_field,omitempty"`
}

CommandProfile describes the safe subset needed by the reference Web command editor. It only constructs a caller-side tool call; Human never executes the command in the worker or browser environment.

func (profile CommandProfile) Validate() error

type CommandProfileResolver ¶

type CommandProfileResolver interface {
	ResolveCommandProfile(llm.TaskContext, llm.Request) (profile CommandProfile, ok bool)
}

CommandProfileResolver maps an exact authenticated harness request onto the reference Web command editor. It has the same borrowing/concurrency contract as PlanProfileResolver and fails closed by returning ok=false.

func OfficialCommandProfiles() CommandProfileResolver

type CommandProfileResolverFunc ¶

type CommandProfileResolverFunc func(llm.TaskContext, llm.Request) (CommandProfile, bool)

func (function CommandProfileResolverFunc) ResolveCommandProfile(
	task llm.TaskContext,
	request llm.Request,
) (CommandProfile, bool)

type Config ¶

type Config struct {
	Worker       *workerkit.Worker
	SessionToken string
	// Heartbeat bounds SSE keep-alive comments. Zero selects 25 seconds.
	Heartbeat time.Duration
	// PlanProfiles selects the normalized Tasks/Plan panel from an exact harness
	// request. Nil installs OfficialPlanProfiles. A typed nil is rejected.
	PlanProfiles PlanProfileResolver
	// CommandProfiles selects the normalized command editor from an exact
	// harness request. Nil installs OfficialCommandProfiles. A typed nil is
	// rejected.
	CommandProfiles CommandProfileResolver
}

Config composes one Server. Worker is required and borrowed: the host shuts the Server down before the Worker. SessionToken is required and compared in constant time; generate it per daemon start and hand it to the operator as a login URL (http://host/?token=...).

type PlanKind ¶

type PlanKind string

PlanKind identifies the interaction model rendered by the reference Web UI. List profiles replace the caller's complete plan in one tool call. Task lifecycle profiles create and update individually identified caller tasks.

const (
	PlanKindList          PlanKind = "list"
	PlanKindTaskLifecycle PlanKind = "task_lifecycle"
)

type PlanProfile ¶

type PlanProfile struct {
	ID              string   `json:"id"`
	Kind            PlanKind `json:"kind"`
	ToolName        string   `json:"tool_name,omitempty"`
	ItemsField      string   `json:"items_field,omitempty"`
	ContentField    string   `json:"content_field,omitempty"`
	StatusField     string   `json:"status_field,omitempty"`
	PriorityField   string   `json:"priority_field,omitempty"`
	DefaultPriority string   `json:"default_priority,omitempty"`
	CreateTool      string   `json:"create_tool,omitempty"`
	UpdateTool      string   `json:"update_tool,omitempty"`
	ListTool        string   `json:"list_tool,omitempty"`
}

PlanProfile is the normalized browser contract selected from one exact harness request. It contains no authority: the HumanLLM core still checks the submitted call against the caller's declaration and ToolAuthorizer.

func (profile PlanProfile) Validate() error

type PlanProfileResolver ¶

type PlanProfileResolver interface {
	ResolvePlanProfile(llm.TaskContext, llm.Request) (profile PlanProfile, ok bool)
}

PlanProfileResolver maps an exact authenticated harness task plus its current caller-declared tools onto a normalized Web plan surface. Implementations are borrowed for the Server lifetime, called concurrently, and must not mutate or retain the input values. Returning ok=false makes the dedicated panel fail closed while leaving the generic declared-tool editor available.

func OfficialPlanProfiles() PlanProfileResolver

type PlanProfileResolverFunc ¶

type PlanProfileResolverFunc func(llm.TaskContext, llm.Request) (PlanProfile, bool)

func (function PlanProfileResolverFunc) ResolvePlanProfile(
	task llm.TaskContext,
	request llm.Request,
) (PlanProfile, bool)

type Server ¶

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

Server is an http.Handler serving the embedded UI, the JSON command API, and the SSE state stream. Construct with New; Shutdown stops the broadcast pump and closes every SSE session.

func New(config Config) (*Server, error)

func (server *Server) ServeHTTP(response http.ResponseWriter, request *http.Request)

func (server *Server) Shutdown(ctx context.Context) error