> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# submitPlanTool

実装計画をユーザーのレビューに提出する、Agentに依存しない組み込みToolです。AgentはMarkdownファイルに計画を書き込み、そのファイルパスをこのToolへ渡します。ユーザーが計画を承認または拒否するまで、Toolは実行を一時停止します。

Toolはネイティブの[Tool一時停止](https://mastra.zisheng.pro/ja/docs/agents/agent-approval)機構を使用して一時停止します。`suspend({ path })` を呼び出すと、Agentは `tool-call-suspended` イベントを発行します。ホストは計画ファイルを読み取ってユーザーに提示し、その後、承認または拒否の結果とともに実行を再開します。

Agentの実行外（`suspend` が利用できない場合）で実行すると、Toolはファイルパスを含む読みやすいフォールバック文字列を返します。

## 使用例

AgentのToolセットに `submitPlanTool` を追加します。

```typescript
import { Agent } from '@mastra/core/agent'
import { submitPlanTool } from '@mastra/core/tools'

const agent = new Agent({
  id: 'planner',
  name: 'Planner',
  instructions: 'Write a plan to a file before starting work, then submit it for approval.',
  model,
  tools: { submitPlanTool },
})
```

一時停止を処理して再開します。

```typescript
import fs from 'node:fs'

const stream = await agent.stream('Refactor the auth module')

for await (const chunk of stream.fullStream) {
  if (chunk.type === 'tool-call-suspended' && chunk.payload.toolName === 'submit_plan') {
    const { path } = chunk.payload.suspendPayload
    const plan = fs.readFileSync(path, 'utf-8')
    console.log(plan)

    // Approve:
    const resumed = await agent.resumeStream({ action: 'approved' }, { runId: stream.runId })
    for await (const c of resumed.textStream) process.stdout.write(c)
  }
}
```

フィードバックを付けて拒否するには、次のようにします。

```typescript
await agent.resumeStream(
  { action: 'rejected', feedback: 'Add error handling steps' },
  { runId: stream.runId },
)
```

## 入力スキーマ

モデルは次のパラメーターでこのToolを呼び出します。

**path** (`string`): ディスク上にある計画のMarkdownファイルへのパス（例: '.mastracode/plans/add-dark-mode.md'）。

## 一時停止ペイロード

`tool-call-suspended` イベントには `suspendPayload` が含まれます。

**path** (`string`): Agentが書き込んだ計画ファイルへのパス。

**title** (`string`): ファイルの読み取り後にホストが設定する計画のタイトル。

**plan** (`string`): ファイルの読み取り後にホストが設定する計画の本文。

## 再開データ

`agent.resumeStream()` にオブジェクトを渡します。

**action** (`'approved' | 'rejected'`): ユーザーが計画を承認したか、拒否したか。

**feedback** (`string`): 計画が拒否された場合の修正指示。モデルに提示され、計画を修正して再提出できるようにします。

**path** (`string`): 履歴の再生用に返される計画ファイルのパス。

**title** (`string`): 履歴の再生用に返される計画のタイトル。

**plan** (`string`): 履歴の再生用に返される計画の本文。

## 承認時の動作

- **承認:** Toolはモデルに `"Plan approved. Proceed with implementation following the approved plan."` を返します。
- **フィードバック付きで拒否:** Toolはフィードバックを返し、計画を修正して再提出するようモデルに求めます。
- **フィードバックなしで拒否:** Toolは、計画を修正する前にユーザーの次のメッセージを待つようモデルに伝えます。

[AgentController](https://mastra.zisheng.pro/ja/docs/harness/agent-controller)内で使用する場合、計画が承認されると、現在のモードから `transitionsTo` で設定されたモードへ切り替わります。`transitionsTo` が設定されていない場合、Controllerは解決済みのデフォルトモードへ切り替わります。詳細については、[モード](https://mastra.zisheng.pro/ja/docs/harness/agent-controller)を参照してください。