Host Token 总览（运行时 API）

Plugin Runtime 里，插件通过 context.use(token)（setup 期）或命令/工具的 use(token)（运行期）按 token 取用 Host 能力。本页是全量索引；各 token 的方法面以对应包的类型定义为准（链接到源码）。

消息与投递

Token	注入后得到	关键方法
outboundMessageToken（@zhin.js/core/runtime）	OutboundMessageService	receive / send(request) → DeliveryReceipt / sendEndpointMessage / onMessage / registerInteractiveHandler
outboundHostToken（zhin.js）	OutboundHost	send({ adapter, endpointId, conversation, content }) —— 跨平台出站，寻址用 ConversationRef
runtimeEventPublisherToken（zhin.js）	RuntimeEventPublisher	广播 runtime 事件（inbox/Console 消息流的来源）

持久化

Token	注入后得到	关键方法
databaseHostToken（zhin.js）	PluginDatabaseHost（按 owner 隔离表名）	define(name, def) / models.get(name) → select / insert / update / delete / count；select() 须显式列名（不支持 '*'）
databaseRootHostToken（zhin.js，仅 root）	DatabaseHost	进程级宿主：Console 管理面、自定义 composition root 用

定时与日程

Token	注入后得到	关键方法
scheduleHostToken（zhin.js）	PluginScheduleHost（按 owner 隔离）	注册/取消 cron 任务；与 outboundMessageToken 组合即可做定时推送
scheduleRootHostToken（zhin.js，仅 root）	ScheduleHost	进程级日程宿主

Agent

Token	注入后得到	关键方法
agentHostToken（@zhin.js/agent/runtime）	Agent Host 端口	列举 Agent binding、提交 canonical TurnRequest，以及读取 Console/诊断投影；不暴露 ZhinAgent / AIService 实例
turnIntentResolverToken（@zhin.js/agent/runtime）	Endpoint owner 提供的可信 intent resolver	按 adapter / scene 将消息解析为 supersede、new、steer、follow_up 或 observe；只有该 resolver 能为跨参与者控制签发 authorizedBy: 'product_policy'

渲染与 HTTP

Token	注入后得到	关键方法
htmlRendererToken（zhin.js）	HtmlRendererHost	render(html, opts) → png（装了 @zhin.js/html-renderer 时可用；未装时出站 html 段降级文本）
httpHostToken（@zhin.js/host-http）	HttpHost	route(method, path, handler, meta?) 注册 HTTP 路由（Console/MCP/A2A/适配器 webhook 共用）

用法示例

export default definePlugin({
  name: 'reminder',
  setup({ use }) {
    const schedule = use(scheduleHostToken);
    const gateway = use(outboundMessageToken);
    schedule.register('0 9 * * *', async () => {
      await gateway.send({ conversation, requester, content: '早安' });
    });
  },
});

规则：use() 在 setup 期调用；token 未安装对应 Host 时 use() 抛错（如未装 @zhin.js/agent 取 agentHostToken）。Scope 化 token（database/schedule）按插件 owner 自动隔离，root 进程级 token 仅在 composition root（basic/cli）或显式 root 场景使用。

AI fallback 不是 OutboundMessageService 的可变插件 API。composition root 在 generation setup 中向 root resources 提供内部 ingressRouteToken；ImRuntime.receive 只从当前消息所持 snapshot 解析该 route。普通插件不应注册或替换此 token。