Help us shape the future of Go! Take the 2026 Go Developer Survey

app

package
v1.1.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 25, 2026 License: Apache-2.0 Imports: 49 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Result 

type Result = toolcore.Result

type Runtime 

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

func NewRuntime 

func NewRuntime(cfg config.Config) (*Runtime, error)

func (*Runtime) AgentDockContext 

func (r *Runtime) AgentDockContext(ctx context.Context) (Result, error)

func (*Runtime) AgentDockLocalContext added in v0.8.0 

func (r *Runtime) AgentDockLocalContext(ctx context.Context) (Result, error)

AgentDockLocalContext 仅供 Nexus Bridge 使用。它不读取 Nexus 统一管理的 Workflow/Recall，避免 fleet 聚合时按节点重复回灌共享上下文。

func (*Runtime) Call 

func (r *Runtime) Call(ctx context.Context, name string, args map[string]any) (result Result, err error)

func (*Runtime) Close 

func (r *Runtime) Close() error

func (*Runtime) Config 

func (r *Runtime) Config() config.Config

func (*Runtime) RuntimeAnalytics added in v1.0.0 

func (r *Runtime) RuntimeAnalytics() Result

func (*Runtime) RuntimeCapabilities 

func (r *Runtime) RuntimeCapabilities(ctx context.Context, refresh bool) (Result, error)

func (*Runtime) RuntimeDiagnostics added in v1.0.0 

func (r *Runtime) RuntimeDiagnostics() Result

RuntimeDiagnostics 只暴露最近调用的零 Payload 投影，供 Nexus 按需远程排障。 本地 analytics 的进程指标与聚合统计不进入跨节点契约。

func (*Runtime) RuntimeEvolve added in v0.7.6 

func (r *Runtime) RuntimeEvolve(ctx context.Context, args map[string]any) (Result, error)

RuntimeEvolve 给 Nexus Stage 3 复用同一个 EvolutionService；不复制 lifecycle policy。 Stage 3 只有候选提案权：来源由 AgentDock 强制标记，不能借 Runtime API 投票或改生命周期。

func (*Runtime) RuntimeMCPManage 

func (r *Runtime) RuntimeMCPManage(ctx context.Context, args map[string]any) (Result, error)

func (*Runtime) RuntimeMCPOAuthCallback added in v0.9.1 

func (r *Runtime) RuntimeMCPOAuthCallback(_ context.Context, result oauthclient.CallbackResult) error

func (*Runtime) RuntimeMCPServer 

func (r *Runtime) RuntimeMCPServer(ctx context.Context, name string) (Result, error)

func (*Runtime) RuntimeMCPServers 

func (r *Runtime) RuntimeMCPServers(ctx context.Context) (Result, error)

func (*Runtime) RuntimeOverview added in v1.0.0 

func (r *Runtime) RuntimeOverview() (Result, error)

RuntimeOverview 是 Nexus/NexusDock Cloud 的轻量控制面投影。 这里直接统计本地索引，不能调用 RuntimeSkills 等明细接口，否则一个概览请求 会重新触发 Skill 包校验、digest 和文件遍历，远程链路仍会被本地扫描拖慢。

func (*Runtime) RuntimePlugin added in v0.9.0 

func (r *Runtime) RuntimePlugin(ctx context.Context, name string) (Result, error)

func (*Runtime) RuntimePlugins added in v0.9.0 

func (r *Runtime) RuntimePlugins(ctx context.Context) (Result, error)

func (*Runtime) RuntimeResourceLibrary added in v1.1.0 

func (r *Runtime) RuntimeResourceLibrary(ctx context.Context, method string, body []byte) (Result, error)

RuntimeResourceLibrary 是设备端资源库控制面。 它不接收压缩包正文。导出 ZIP 由 export_upload 流式 PUT 到已配对 Nexus；安装包从同一 HTTPS 原点下载，再交给现有 Skill/Plugin 安装器。

func (*Runtime) RuntimeSkill 

func (r *Runtime) RuntimeSkill(skill string) (Result, error)

func (*Runtime) RuntimeSkillFile 

func (r *Runtime) RuntimeSkillFile(skill, relativePath string) (Result, error)

func (*Runtime) RuntimeSkillFiles 

func (r *Runtime) RuntimeSkillFiles(skill string) (Result, error)

func (*Runtime) RuntimeSkills 

func (r *Runtime) RuntimeSkills() (Result, error)

func (*Runtime) RuntimeStatus 

func (r *Runtime) RuntimeStatus() Result

func (*Runtime) RuntimeTask 

func (r *Runtime) RuntimeTask(id string) (Result, error)

func (*Runtime) RuntimeTaskDelete 

func (r *Runtime) RuntimeTaskDelete(id string) (Result, error)

func (*Runtime) RuntimeTasks 

func (r *Runtime) RuntimeTasks(status string, limit int) (Result, error)

func (*Runtime) SetNexusOAuthCallback added in v0.9.1 

func (r *Runtime) SetNexusOAuthCallback(publicURL, nodeID string) error

SetNexusOAuthCallback 只接收 Nexus 握手声明的公网 Origin。配对 endpoint 可能是 内网地址或反代内部地址，不能推导成第三方 OAuth Provider 可访问的 redirect URI。

func (*Runtime) ToolDefinition added in v0.8.2 

func (r *Runtime) ToolDefinition(name string) (ToolDefinition, bool)

func (*Runtime) ToolDefinitions added in v0.8.2 

func (r *Runtime) ToolDefinitions() []ToolDefinition

func (*Runtime) ToolNames 

func (r *Runtime) ToolNames() []string

func (*Runtime) Workspace 

func (r *Runtime) Workspace() *workspace.Workspace

type ToolAnnotations added in v0.7.0 

type ToolAnnotations struct {
	Title           string
	ReadOnlyHint    bool
	DestructiveHint *bool
	IdempotentHint  bool
	OpenWorldHint   *bool
}

type ToolContract added in v0.8.2 

type ToolContract struct {
	InputSchema  map[string]any
	OutputSchema map[string]any
}

type ToolContractProvider added in v0.8.2 

type ToolContractProvider func(string, config.Config) (ToolContract, bool)

type ToolDefinition 

type ToolDefinition struct {
	Name                   string
	Title                  string
	Description            string
	UIBinding              *UIBinding
	FileArgRewritePaths    []string
	FileResultRewritePaths []string
	InputSchema            map[string]any
	OutputSchema           map[string]any
	Annotations            *ToolAnnotations
}

func ToolDefinitions 

func ToolDefinitions() []ToolDefinition

ToolDefinitions 返回无外部能力配置时的完整注册表定义，供静态检查与测试使用。

type ToolError 

type ToolError = toolcore.ToolError

type ToolHandler 

type ToolHandler func(context.Context, *Runtime, map[string]any) (Result, error)

type ToolSpec 

type ToolSpec struct {
	Name                   string
	Title                  string
	Description            string
	FileArgRewritePaths    []string
	FileResultRewritePaths []string
	Contract               ToolContractProvider
	Annotations            *ToolAnnotations
	Availability           func(config.Config) bool
	Handler                ToolHandler
}

ToolSpec 是工具公开注册的单一入口：描述、契约所有者、配置开关和 handler 在这里显式绑定。 Schema 字段细节由对应 capability package 或共享 mcpcontract 拥有，app 不再按名字二次寻找 owner。

type UIBinding added in v0.8.0 

type UIBinding struct {
	ResourceURI string
	Action      string
	Compact     *UITrigger
}

UIBinding describes when a tool should attach an MCP App resource to its descriptor or result. Full preserves today's behavior. Compact is opt-in per binding so new high-frequency views do not silently enter compact mode.

func (UIBinding) Trigger added in v0.9.1 

func (binding UIBinding) Trigger(mode config.MCPAppsMode) (UITrigger, bool)

type UITrigger added in v0.9.1 

type UITrigger struct {
	Action string
}

UITrigger describes whether a binding is descriptor-level or scoped to one tool action.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.