prompt

type AgentData struct {
	AgentDashboardURL   string
	AgentRouteURL       string
	CallerAccess        Caller
	Capabilities        Capabilities
	SupportedModalities Modalities
	Tools               []ToolInfo
	Connections         []ConnInfo
	Topics              []TopicInfo
	Webhooks            []WebhookInfo
	Routes              []RouteInfo
	MCPServers          []MCPServerStatus
	Siblings            []SiblingInfo
	Directories         []DirInfo

	// Per-turn environment, rendered into the <env> block. Each is set
	// explicitly by the dispatch path (never inferred) and omitted from
	// the block when empty.
	Date         string
	Platform     string // web | telegram | discord | a2a
	UserName     string
	UserEmail    string
	Conversation string

	// DirectTools is true when the run exposes each capability as its
	// own typed LLM tool instead of one `run_js` binding. The template
	// branches on this to skip JS-flavoured sections (the TypeScript
	// manifest, `## JavaScript environment`, `var` / `let` guidance, the
	// namespaced binding docs) and emit a short tool-listing block
	// instead. Schemas reach the model via the tool-calling protocol,
	// not the system prompt.
	DirectTools bool
}

type Caller string

type Capabilities struct {
	Vision        bool
	Transcription bool
	Speech        bool
	Embedding     bool
	Image         bool
	Search        bool
}

type ConnInfo struct {
	Slug        string
	Name        string
	Description string
	LLMHint     string
	BaseURL     string
	Access      string
}

type DirInfo struct {
	Path        string
	Description string
	LLMHint     string
	Read        string
	Write       string
	List        string
	// Scope, when non-empty, indicates the directory is per-context.
	// Values: "user", "conv", "run". The template renders an extra
	// note so the LLM understands paths it returns will include a
	// scope key segment (e.g. `<dir>/user-<id>/...`).
	Scope string
}

type MCPServerStatus struct {
	Slug   string
	Name   string
	Status string // "connected, 5 tools" or "requires authentication"
	Access string
	// Description is the server-level usage hint the remote MCP server
	// advertised via initialize `instructions`. Empty when unset.
	Description string
	Tools       []ToolInfo
}

type Modalities []string

type RouteInfo struct {
	Method      string
	Path        string
	Access      string
	Description string
}

type SiblingInfo struct {
	ID          uuid.UUID
	Slug        string
	Name        string
	Description string
	Tools       []ToolInfo
}

type ToolInfo struct {
	Name         string
	Description  string
	LLMHint      string
	Access       string
	InputSchema  json.RawMessage
	OutputSchema json.RawMessage
}

type TopicInfo struct {
	Slug        string
	Description string
	LLMHint     string
	Access      string
}

type WebhookInfo struct {
	Path        string
	Description string
}