eve-compat

Zavu で eve プロジェクトをデプロイする

Zavu は eve-layout プロジェクトを、Zavu の一流のエージェントにコンパイルします。ユーザーの ファイルは一切編集されません。agent/instructions.md はシステムプロンプトになり、 各 agent/tools/<name>.ts は <name> という名前のツールになり、Zod の inputSchema オブジェクトは JSON Schema に自動変換されます。

コマンド

# Import from GitHub and deploy in one step (also works for Zavu-native repos):
npx zavudev import owner/repo --sender sndr_123
npx zavudev import owner/repo#branch --root apps/agent   # monorepo / branch
# Private repos: set GITHUB_TOKEN in the environment (sent only to GitHub).

# Deploy a local eve project (detected by agent/instructions.md):
cd my-eve-agent && npx zavudev deploy --sender sndr_123

送信者は --sender（コンパイル時にインライン化）または SENDER_ID 関数シークレット（npx zavudev fn secrets set SENDER_ID sndr_123）で指定できます。 どちらも指定しない場合、エージェントはデプロイされますが、ダッシュボードで送信者を割り当てるまで接続されません。

マッピング内容

eve	Zavu
agent/instructions.md	システムプロンプト（必須）
agent/agent.ts の文字列 model	エージェントモデル。文字列以外の設定（プロバイダーインスタンス、defineDynamic）は、警告を出してデフォルトにフォールバックします
agent/tools/*.ts（defineTool のデフォルトエクスポート）	ファイル名の拡張子を除いた部分を名前とするツール
Zod / JSON Schema の inputSchema	JSON Schema の parameters
package.json の依存関係	サーバー側にインストールされます。eve パッケージ自体はコンパイル時に除去されます

Zavu で実行されないもの（必ずユーザーに伝えてください）

デプロイ時に互換性レポートが出力され、以下について明示的な警告が表示されます。

• agent/channels/ — 不要です。Zavu の送信者がチャネルです。
• agent/schedules/ — cron は、現時点では Zavu Functions で利用できません。
• agent/skills/ — 実行時には読み込まれません。内容を instructions.md またはナレッジベースにまとめてください。
• agent/subagents/、agent/sandbox/、agent/connections/、evals/ — サポートされていません。これらに依存するエージェントは、eve 独自のランタイムで実行してください。
• ツールの approval ゲートと toModelOutput — ツールごとに無視され、警告が表示されます。
• agent.ts のオプション reasoning、compaction、limits、modelOptions、 outputSchema — 無視され、警告が表示されます。

ツールはあらゆるチャネルで実行されます。プレーンテキスト（SMS／WhatsApp／Telegram）、音声、 フローの tool ステップに対応し、返信ごとに最大 5 回のツール実行ラウンドが可能です。例外は agents test です。ドライランではツールは実行されません（実際の Webhook が発火してしまうため）。 その旨は警告に表示されます。

要件とトラブルシューティング

• eve レイアウトのコンパイルには、プロジェクト内で esbuild を解決できる必要があります （npm install -D esbuild）。npx zavudev import は自動で追加・インストールします。これを省略するのは --no-install を指定した場合だけです。
• inputSchema はオブジェクトスキーマである必要があります。z.object({...}) または type: "object" を指定した JSON Schema が該当します。特殊な Zod 型は、ビルドログに警告を出して制限の緩いスキーマにフォールバックします。
• デプロイ後は、エージェント ID の確認に npx zavudev agents list を実行し、続いて npx zavudev agents test <agentId> --message "hi" を実行すると、配信も課金も発生しないドライランを行えます。
• 変更後は npx zavudev deploy で再デプロイしてください。調整サマリー （+／~／=／-）が、変更内容を確認するための信頼できる情報源です。