Domain 5: Context Management & Reliability

// ✅ 構造化引き継ぎペイロードの最小一式
type EscalationHandoff = {
  escalation_type: 'immediate' | 'after_attempt' | 'progressive' | 'policy_gap'
  reason: string                              // なぜエスカレーションが必要か（1 文）
  case_facts: {                               // transactional facts（圧縮しない）
    customer_id: string
    case_id: string
    amounts?: { currency: string; value: number }[]
    dates?: { kind: string; iso: string }[]
  }
  conversation_summary: string                // 直前 N ターンの要約（人間が読む用）
  attempted_actions: {                        // 試したアクションと結果
    action: string
    result: 'success' | 'failure' | 'partial'
    error?: { errorCategory: string; message: string }
  }[]
  policy_references: string[]                 // 関連ポリシー条項の ID
  open_questions: string[]                    // 解決していない論点
  suggested_next_action?: string              // エージェントの推奨（人間が override 可能）
}
 
// 即時エスカレーション例
const immediate: EscalationHandoff = {
  escalation_type: 'immediate',
  reason: '顧客が "人間と話したい" と明示的に要求',
  case_facts: { customer_id: 'cust_123', case_id: 'case_456' },
  conversation_summary: '...',
  attempted_actions: [],   // 即時は試行なし
  policy_references: [],
  open_questions: ['顧客の元の問い合わせ内容']
}

// 部分的成功を活用するコーディネーターの実装例
const results = await Promise.allSettled(subagentTasks);
 
const successful = results.filter(r => r.status === "fulfilled");
const failed = results.filter(r => r.status === "rejected");
 
// ✅ 部分結果を採用しつつ、失敗を明示
return {
  partial_results: successful.map(r => r.value),
  coverage_gaps: failed.map(r => ({
    attempted_query: r.reason.query,
    error_type: r.reason.errorType,
    suggested_alternatives: r.reason.alternatives
  })),
  is_complete: failed.length === 0
};
// ❌ Anti-pattern: if (failed.length > 0) throw new Error("全体失敗");