rozenite-agent-sdk

Rozenite Agent SDK

ユーザーが Rozenite にコードファーストでアクセスしたい場合は、このスキルを使用してください。

コピーして使えるサンプルについては、references/code-patterns.md を読んでください。

ルール

• @rozenite/agent-sdk をインポートする、一時的な Node ESM スクリプトを優先してください。
• デフォルトのフローは、createAgentClient() -> client.withSession(...) -> ツールの確認または呼び出し -> 終了です。
• 実行時に利用可能な組み込みドメインとランタイムドメインの正しい情報源として、session.domains.list() を使用してください。
• 実行時の確認や引数の確認が必要な場合に限り、session.tools.list({ domain }) と session.tools.getSchema({ domain, tool }) を使用してください。
• 利用可能な公式プラグインの ./sdk エクスポートに型付きのプラグイン SDK ディスクリプターがある場合は、それを優先し、session.tools.call(descriptor, args) でツールを呼び出してください。
• 一致する ./sdk ディスクリプターがない場合、または実行時にツールが動的に検出される場合に限り、session.tools.call({ domain, tool, args }) にフォールバックしてください。
• session.tools.list({ domain }) でツールを検出した場合、返された shortName を、その後の名前指定による呼び出しに渡す正規のツール名として扱ってください。独自にキャメルケースの別名を作成したり、ツール名を正規化したりしないでください。
• 派生した CLI 向けドメイントークン（storage など）よりも、組み込みドメイン ID（network、react、memory）やプラグイン ID（@rozenite/storage-plugin、@rozenite/tanstack-query-plugin）などの安定した SDK ドメイン識別子を優先してください。
• ページ分割されたツールでは、一度に1回だけ呼び出し、返された page.nextCursor を明示的に次の呼び出しに渡してください。ページのエンベロープとカーソルはプラグインが管理します。
• プラグインがナビゲーション後にのみマウントされる場合は、先にナビゲーションしてから、プラグインのツールを呼び出す前に session.domains.list() または session.tools.list(...) で実行時のビューを更新してください。
• client.openSession() または client.attachSession(sessionId) を使った高度なセッション制御については、リファレンスのパターンを参照してください。
• スクリプトで予期しないランタイムエラーが発生した場合は、エラーが明確に分かる形でスクリプトを失敗させてください。プレースホルダーの JSON を出力してエラーを隠さないでください。

引き継ぎ

• タスクがシェル主導の場合、再利用可能な CLI セッションが必要な場合、rozenite agent ... を直接操作する場合、または deviceId を選択する前に対象の列挙が必要な場合は、代わりに rozenite-agent を使用してください。