用途：在 Node.js 或 TypeScript 代码中以代码优先方式访问 Rozenite for Agents，用于编写或运行脚本、包装器。
主要能力与用法：默认流程为 createAgentClient() → client.withSession(...) → 检查或调用工具 → 退出。可用 session.domains.list() 获取实时内置域与运行时域；需要实时检查或确认参数时用 session.tools.list({ domain }) 和 session.tools.getSchema({ domain, tool })。优先使用官方插件 ./sdk 导出的类型化描述符，并以 session.tools.call(descriptor, args) 调用；仅在没有匹配的 ./sdk 描述符或工具为运行时动态发现时，才回退到 session.tools.call({ domain, tool, args })。通过 session.tools.list({ domain }) 发现的工具，应将其返回的 shortName 作为规范工具名回传，不要自行编造 camelCase 别名或规范化名称。优先使用稳定 SDK 域标识（如内置域 network、react、memory 及插件 ID @rozenite/storage-plugin、@rozenite/tanstack-query-plugin），而非 CLI 派生的域 token。分页工具应一次调用一个，并在下一次调用中显式传入返回的 page.nextCursor。若插件仅在导航后挂载，应先导航，再用 session.domains.list() 或 session.tools.list(...) 刷新实时视图。高级会话控制可参考 client.openSession() 或 client.attachSession(sessionId) 的参考模式。脚本遇运行时错误应让其清晰失败，不要用占位 JSON 掩盖。参考 references/code-patterns.md 获取可复制示例。若任务由 shell 驱动、需要可复用 CLI 会话、直接通过 rozenite agent ... 操作，或需先枚举目标再选 deviceId，则应改用 rozenite-agent。