@contraagent/ui 0.6.2 → 0.7.0

package/src/locales/ja.ts

@@ -11,6 +11,10 @@
     export const templates = {
       'col-runs': `実行`,
 'definition-output': `出力`,
+'edge-after': `完了を待つ`,
+'edge-created': `結果を受けて作成`,
+'edge-given': `出力を受け取る`,
+'flow-call-stopped': `停止`,
 'h0ddbe8131d040868': html`JSON Lines（1 行ごとに JSON オブジェクト、スキーマ ${0}）`,
 'h5665d16ae525ca0b': html`${0} の出力`,
 'h612ee972e5585763': html`JSON オブジェクト（スキーマ ${0}）`,
@@ -19,10 +23,15 @@
 'had57861b5eb1998e': html`ファイルなし | Python コードで定義（<code>TaskAdapter</code>）`,
 'hca6c01d40814d5b0': html`実行中 ${0}${1}`,
 'hf139a496c0f9b763': html`${0} の出力から`,
+'input-file-not-checked': `未確認`,
 'no-runs-yet': `実行はまだありません`,
 'none': `なし`,
+'outcome-cancelled': `取り消し`,
 'outcome-done': `完了`,
 'outcome-partial': `一部のみ完了`,
+'part-definition': `定義`,
+'part-input-files': `入力ファイル`,
+'part-params': `パラメータ`,
 's0007e74d64dabdbc': `実行履歴の未実行のタスク`,
 's00cfc1e282ce46d7': str`HTTP ステータス ${0}`,
 's02f7b7c4ece3e097': `実行されず`,
@@ -37,6 +46,7 @@
 's041489fa7f9e6fe6': str`ほか ${0} 件`,
 's04286bec7654cf3f': `タスクが宣言したパターンの下で、試行が作成・変更・削除したファイル（changes）`,
 's044f7ee7915b22a3': str`一部のみ完了 ${0} 件`,
+'s048f821b3dc73ec2': `再開後に再実行`,
 's04f1babead09ec6b': `停止した部分`,
 's051e95917479e3a4': `実行中のエージェントのセッション`,
 's05548eaadd7b3e53': `選択中の項目`,
@@ -46,7 +56,6 @@
 's0668067982f84dcb': `ユニットごとのステージとステップ（CursorStore）`,
 's066d70cf9d5e2915': `出力`,
 's06a59d9f860b0c38': `Esc: 1 つ上の階層`,
-'s06ac9901d5ec124e': `依存先`,
 's06b0f7bc0e6f72bd': `実行中ではありません`,
 's06bff69a662d11b0': `中を表示`,
 's07760df6abc2f6a0': `テキストフィルター（/）`,
@@ -57,11 +66,11 @@
 's08b1e44d0f35109e': str`${0}（認証情報が休止中）`,
 's08b35907b5589afa': `いいえ`,
 's08c43a07b566d980': `稼働中`,
-'s08f830c89607bf9e': str`依存先: ${0}`,
 's09323b2ac0a8afed': `出力の検証: OK`,
 's09353907b5c79284': `終了日`,
 's09459a62b70ff1a2': `最初のエージェントのセッションの前に終了`,
 's09bb59cd137c1af4': `プロンプトなし`,
+'s0a99b40429080168': str`入力元: ${0}`,
 's0b05cbe8c9314a2b': str`作成元: ${0}`,
 's0b237aba4a56eb22': `エージェントのセッション開始時のサブスクリプション利用率（アカウント全体）`,
 's0b355fde970b0df9': `OK`,
@@ -88,6 +97,7 @@
 's12c35dcdc5890192': `型の不一致`,
 's13843960cf657713': str`最終報告 ${0}`,
 's14bd607323778cb3': `コーディングエージェントが報告した値`,
+'s14c898307fc12ee3': str`この失敗で ${0} が ${1} で停止`,
 's150f53f8651b4384': `出力`,
 's156d30b96fb26c7f': `なし（任意）`,
 's158eba9bc2227ce3': str`週の利用率 ${0}`,
@@ -96,6 +106,7 @@
 's165ee7508f443a3e': str`${0} 回目で完了 | 失敗 1 回`,
 's168ae294e3e72ce4': `検証のタイミング`,
 's1703f5cfa8ed0cc9': str`実行されず ${0} 件`,
+'s1725258e65a9f38f': str`同じフローの実行 ${0} から見込んだ、この実行がまだ作成していないタスク（forecast）`,
 's179ba9809bdf35c7': `アカウントごと、最初の値 → 最後の値`,
 's17d7937260be87a6': `利用率のルール`,
 's17ee023c53dcd83c': `書き込み待ち（タスクが待機中）`,
@@ -115,6 +126,7 @@
 's1c4244f27dc0a0ad': str`セッション開始時の利用率（アカウント全体）: ${0}`,
 's1c76dcdfd0d3326d': `実行に登録されたすべてのタスク（種別ごと、plan.jsonl）`,
 's1cc744978f1e1e36': `実行中の Python タスク`,
+'s1d4bd752f1174aaf': `どのフローも結果を待たず、after= にも渡さず、戻り値にも含めなかったタスク（unawaited）。出力ファイルと変更のために実行された`,
 's1db2936d905dfc71': `API エラー`,
 's1dc338639fe7aae9': str`試行 ${0} 回`,
 's1dd7ab260efc97bf': `実行中のタスクなし`,
@@ -137,6 +149,7 @@
 's23f40d3ffdd352a6': `定義はまだありません`,
 's2413de2aeb2cad27': str`完了 ${0}`,
 's2575361362fcf642': `OutputContract・InputContract を宣言したタスクはありません`,
+'s25f66969239538c1': str`まだ登録されていない種別: ${0}`,
 's26012de2ae38a284': `API 呼び出し 1 回`,
 's26bae2d058ab07f8': `ユニットなし`,
 's26bb7d0992115fe1': `実行した試行の回数（リトライを含む、journal.jsonl）`,
@@ -149,10 +162,12 @@
 's28f91da403800c05': `InputContract`,
 's29b6d46649a71377': str`最大コンテキスト: ${0}`,
 's2a2e8a5afcc8d89a': `現在`,
+'s2c0c7686db4c5c18': str`パラメータ ${0}`,
 's2c8189544e3ea679': `リトライ`,
 's2cd5d653677e6881': `モデルの利用可否`,
 's2dd7dfcce562730a': `試行の結果（stop）`,
 's2df075aface0dab8': `割合`,
+'s2df66a4e587b3718': `開始時も同じ内容`,
 's2e3f7c747d87ba60': str`ほかの出力 ${0} 件`,
 's2e422519ed38f7d8': `周`,
 's2f3435308f48080e': str`${0} 周`,
@@ -163,10 +178,12 @@
 's2fe3f0ef38a252c7': `ツール`,
 's2fea0e9e542e5b47': str`修正依頼 ${0}`,
 's31377c5b29515e8b': `終了（未実行のタスク 1 件）`,
+'s31ad37e9f51902fd': str`待たれなかったタスク ${0} 件`,
 's321b04e2b2f863d5': `余分なフィールド`,
 's326385425f7ff3c5': str`キャッシュ読み込み ${0}`,
 's32d229c81273f461': `最大コンテキスト`,
 's33b572e03cbb49a2': `パイプラインの階層`,
+'s33fc35415f8b1c49': str`${0} で停止`,
 's343dead26eec35c9': `新しいイベント 1 件を表示`,
 's34bb12befe88eb1b': `終了`,
 's34e46e4e30ae57bd': `降順に並べ替え`,
@@ -205,6 +222,7 @@
 's3f18b1a78ce1a960': `各タスクが書き込むファイル`,
 's3f7074a6bbbd7726': `修正依頼`,
 's3fd6bd99e3f6a5be': `開始`,
+'s3fda7269dc9d47ba': `このタスクの出力が後続タスクのパラメータに含まれる（given_from）`,
 's40750d44c5ea3271': str`${0}: 入力`,
 's4085b471de2e2215': `週の利用率`,
 's4134711b0b981089': `Tab: 次のノード`,
@@ -230,14 +248,15 @@
 's49098dfd8a30a9b7': `モニターのサーバーに接続済み`,
 's491765412b82838e': str`${0} のループ`,
 's4abcddbf0c24a4e2': str`${0} 日前`,
+'s4cd75aa2c080e64a': `あと 1 件の見込み（forecast）`,
 's4d613d768e2faa0d': `検索結果 1 件`,
 's4d890c06c9c42dee': `モデル切り替え`,
 's4e7c49654e9033f5': str`修正依頼 ${0} 回で完了 | 最初の検証エラー: ${1}`,
 's4efee5b48a4593cb': `ループ`,
 's4f0af1e75e3f4e0d': `スキーマにない`,
-'s4f0b2143a5fc9bf2': str`再開後に再実行: ${0}`,
 's4f901d8830793b99': str`ホスト ${0}`,
 's4fed3c544c5791df': `エージェントタスク`,
+'s5013070506ff1eda': str`取り消し ${0} 件`,
 's50182c197f93c873': str`${0}: ${1} → ${2}`,
 's504d83b92c9ed51e': `日付指定`,
 's51316118c75cbced': `そのモデルで始めたエージェントのセッションの数`,
@@ -258,6 +277,7 @@
 's5410888308ba73df': `開始できず`,
 's54393bfa280ea55b': `プロンプト`,
 's552240946fb80e49': str`フロー呼び出し ${0}`,
+'s552a2945ecbbf679': str`${0} の失敗により停止`,
 's5552cf25dfb16715': `プラグインディレクトリ`,
 's558d71789938dd8d': `認証情報の不一致`,
 's5590dbf7e425789d': `項目`,
@@ -281,6 +301,7 @@
 's5b91c14a6a040e1e': `種別ごとのトークンと料金`,
 's5bd56661dc3d893f': `フロー呼び出しごとの締め切り（time_box）`,
 's5c7b236b3fa997c2': `サービスなし`,
+'s5cb32dedd20156b7': `分岐`,
 's5cd51fca94ab558d': str`エージェントのセッション ${0} 回`,
 's5cfa1889ee16f534': `値なし`,
 's5d0bd939d106436c': `実行中にこのタスクが占有する名前（claims）`,
@@ -303,6 +324,7 @@
 's629576c6b305d539': `任意`,
 's647582a62a567663': `応答が JSON ではなく HTML`,
 's649816288746372b': `後続タスク`,
+'s64a9094d5926ab69': `前のタスクの出力は同じなのに、フローが別のパラメータを渡した（divergence）。時刻、乱数、外部の状態、フローのコードの変更による`,
 's64f4ede4c120d468': `変更禁止の箇所`,
 's652e7d36f0a948dd': str`ロック ${0} 件`,
 's65387e16091fbf16': `締め切りを過ぎた`,
@@ -333,6 +355,7 @@
 's6ebc9bd6feae62a3': `読み込み中…`,
 's6f145ecab7e01aae': `API 呼び出し`,
 's6f2d39e45dc290b5': `出力ファイル 1 件`,
+'s6f5367f58dce0037': str`見込み: あと ${0} タスク`,
 's6fa4fa0db6637ca7': `フロー呼び出しがエラーで終了`,
 's7009515e0b51ee67': `書き出しに含まれない`,
 's70348dd289d771d5': str`${0} まで休止`,
@@ -356,6 +379,7 @@
 's76f396a17f89a5e0': `原因`,
 's7718ef97e5fb3426': str`入力 ${0} は失敗したタスク ${1} の出力`,
 's77ec32fb8248c021': str`未実行 ${0} 件`,
+'s782db3652547623c': `書き足す対象のファイル`,
 's786837e1e48f17c8': `トランスクリプト`,
 's78fd8c03f8c967f3': `トークン`,
 's7975cad0458a3b12': `すべての中を隠す`,
@@ -417,6 +441,7 @@
 's8b41b9223ed7838d': `同じロックを持つタスクが共有する常駐の補助プロセス（services.jsonl）`,
 's8bbe7f1c618318b1': `終了したすべての試行から集計（journal.jsonl）`,
 's8c1837e74a81ad0d': str`${0} 分前`,
+'s8c563da286fe5cb7': `このタスクの結果を受け取った直後に、フロー呼び出しが後続タスクを作成した（created_from）`,
 's8d3d06c785c3c433': `コーディングエージェントが使ったアカウントまたは API キー（credential）`,
 's8d4bb019f3bc7202': `PID`,
 's8dd1924ee42c1f45': str`キャッシュ読み込み ${0}`,
@@ -441,6 +466,7 @@
 's9147091d090a92d4': str`最大 ${0} 周`,
 's915525f01e5ebdb9': str`モデル ${0} 種類`,
 's919d209719302bd3': str`${0}d ${1}h`,
+'s91d2138e1db80125': `順序のみの依存先`,
 's9246c889a0392130': str`モデル ${0}`,
 's92a32f8361a3a3b0': str`依存先タスク ${0} 件の出力待ち`,
 's92b7e489ad4779c7': str`5 時間枠 ${0}`,
@@ -489,7 +515,6 @@
 's9fbbc819fe7e66aa': `実行`,
 's9fd13600c5948a5d': `タスクの開始前からあるファイルも有効`,
 's9ff6bfdb36b47dd6': `モデル切り替え`,
-'sa0a6e71350fd953b': `出力を待つ`,
 'sa116cd3e2e650be3': `リプレイした試行`,
 'sa23567d1be73e6a7': `ターン数の上限`,
 'sa24de5df07476150': str`${0} の締め切りまでに終わらない`,
@@ -509,6 +534,7 @@
 'sa4f4addc6a836fcf': str`最大 ${0} 回`,
 'sa508a8fb4e60520e': `安全分類器による停止 1 件`,
 'sa50a6326530d8a0d': `折りたたむ`,
+'sa5441ff1c4c71a32': `API 呼び出しごとのトークンは不明`,
 'sa57b5e86ecb7d735': `権限エラーになったツール呼び出し`,
 'sa58fd816ed43f98e': `周回数`,
 'sa6295f265bf36f55': str`${0}: トランスクリプト`,
@@ -534,10 +560,12 @@
 'sac1ead3bc64c3402': `モニターのサーバーに未接続`,
 'sac76f55d909ff9fd': str`${0} に利用できるモデルなし`,
 'sacaf895f9cac7377': `期間内の実行の合計`,
+'sacbf23fb29caa9f9': `分かっているのはコーディングエージェントが出力したトークンの合計だけ。API 呼び出しごとのトークンは不明（usage_unknown）`,
 'sacc7621b51cc2743': `可`,
 'sad131e152d238fb4': str`ほかに休止中の認証情報 ${0} 件`,
 'sad3e3c8146fc920f': `状態`,
 'sad951affb16c18e8': `API リクエストを再送`,
+'sadb0119c6d963645': `トークンは不明`,
 'sae5d87e99fe081e0': `必須`,
 'sae675aed0baadfc5': `実行履歴のリトライしたタスク`,
 'saee49dc66c73b95a': `プロセス`,
@@ -554,6 +582,7 @@
 'sb1454106d9fa9d78': str`報告なし ${0} 台`,
 'sb16ea30b732565de': str`${0} 行`,
 'sb1ffef0fea624d13': `前の 1 行を表示`,
+'sb24e2c9c9f983470': str`この失敗で ${0} が停止`,
 'sb26a93fd31e2f700': `登録順`,
 'sb26f6e41558f71ed': `表示中の階層の外`,
 'sb271968591691cd3': `Enter: 開く`,
@@ -570,6 +599,7 @@
 'sb5ae7a6b849639af': `未実行`,
 'sb6bb16aa7550533d': `タスク実行中の書き込みが必須`,
 'sb76f9199c15fe03c': str`${0} に停止`,
+'sb8127ffb12a5fb54': `実行したエージェントのセッションのトークンは不明（usage_unknown）`,
 'sb89b16909f010061': `エージェントのセッション 1 回`,
 'sb945184259a5d73c': str`5 時間枠（${0}）`,
 'sb9724d1e7908c74c': `コンテキストの上限に接近`,
@@ -584,6 +614,7 @@
 'sbb202211084591ed': `開始時の利用率`,
 'sbb77dd1d4c08e701': str`${1} タスク中 ${0} 件が未完了`,
 'sbb99d4ec27fbb263': `終了`,
+'sbbe1ac88d71c2fec': `入力元`,
 'sbc65d1b9648966de': str`${0} 周: ${1}`,
 'sbc95529382a8202f': str`以前の試行のモデル: ${0}`,
 'sbca0391cb2c7c054': `タスクの開始時`,
@@ -628,6 +659,7 @@
 'sc9474bf7a0668d73': `全体`,
 'sc9757b387904aaba': `タイムゾーン`,
 'sc9e494c8346b7cb5': `その他`,
+'sca175b60e0f8cc35': `開始前に変更された`,
 'sca4ca1724004c913': `プロセスなし`,
 'sca68313fa6851125': `プレビューを表示`,
 'sca7fed2bef53cb99': `ロール`,
@@ -650,14 +682,17 @@
 'sd0ea7366ebc403ff': `出来事`,
 'sd173bb96eb4d2577': `入力 / 出力 | キャッシュ読み込み / キャッシュ書き込み`,
 'sd1f67ae2a58049b0': `ファイルの検証に使うスキーマ`,
+'sd201d977e9a204cb': str`順序のみの依存先: ${0}`,
 'sd26f6fb3acfd5ca0': str`${0} 件を同時実行`,
 'sd3458f28f628e82d': str`${0} に開始（${1}）`,
 'sd381b19c7fd35852': `変更`,
 'sd3c028fcc08b18ab': `登録済みのタスクなし`,
 'sd3ec6686aaaf1324': str`終了（未完了のタスク ${0} 件）`,
+'sd406591b0914aab7': `読み込むファイル（検証あり）`,
 'sd47e3a005069edb9': `ローカルの認証情報（ambient）`,
 'sd58f7e67529b30b0': `終了（失敗したタスク 1 件）`,
 'sd5a1f34cfcac265f': `実行がシグナルで停止された`,
+'sd5c13f0d5d88c035': str`変更: ${0}`,
 'sd5da7ee4a43a6b2d': str`トークン: 入力 ${0}、出力 ${1}、キャッシュ読み込み ${2}、キャッシュ書き込み ${3}`,
 'sd5e28ee1c3ede3b6': `所要時間の合計`,
 'sd7338946b42394f4': `失敗`,
@@ -666,7 +701,6 @@
 'sd757815e3da2dde5': `検証エラー`,
 'sd7768c230e48ac70': str`全体の ${0}%`,
 'sd77d82bf43357ecd': `実行中のエージェントのセッションの新しいイベント 1 件を表示`,
-'sd798aaccd0308806': `結果を受けて作成`,
 'sd7d77bef673bd45f': str`入力 ${0}（${1} の出力）に検証エラー`,
 'sd8284849892c5c5a': `タスクの開始前からあるファイルは無効`,
 'sd8a0d0cc52fdaf39': str`${0} まで`,
@@ -707,9 +741,11 @@
 'se60a4867465d5d31': `ハイコントラスト`,
 'se61f0dc09b51fd35': `パイプラインのプロセス内の関数`,
 'se66872955dc59191': `1 タスク`,
+'se6982e1c5d0986ac': `後続タスクはこのタスクの完了を待つが、出力は受け取らない（after）`,
 'se6de387a56331077': `下の階層あり`,
 'se7102b7d5942a59c': str`${0} 回目`,
 'se751edc73f4d0062': `リプレイと新しいセッション`,
+'se7bc5096d48d4c1c': str`タスクの所要時間 ${0}`,
 'se8d06d5375424a9c': str`安全分類器による停止 ${0} 件`,
 'se90f184c6aa3ffbb': `認証情報`,
 'se99de5c72fecbbc3': `ロック`,
@@ -767,7 +803,9 @@
 'sf93c7009f950942a': `合計`,
 'sf9bbecb9ed98e966': `エージェントのセッションが始まらなかった`,
 'sfa04f4ef1995407e': `テキスト`,
+'sfa069139277176df': `待たれなかったタスク 1 件`,
 'sfa251e3af0f9c14c': str`${0} 〜 ${1}`,
+'sfa29dd1ad553ce38': str`あと ${0} 件の見込み（forecast）`,
 'sfa6a5b4597c720bc': `フィルターに一致するタスクなし`,
 'sfa82224480602f92': `ツールのリクエスト`,
 'sfadf0e9dfc4b3030': `修正依頼 1 回で完了`,
@@ -775,6 +813,8 @@
 'sfb33dc608ac218c4': `実行を切り替え`,
 'sfb65f5d860c9a106': str`実行中のエージェントのセッション ${0} 件`,
 'sfbb1f6b888aed522': `失敗した試行`,
+'sfbb84dc71ed5b92e': str`${1} の失敗により ${0} で停止`,
+'sfc4c7372f2d13e91': `外部の状態`,
 'sfc7ed987d0fe9679': `再開カーソルなし`,
 'sfd313341ca75a38d': str`リトライ後に完了 ${0} 件`,
 'sfd5b8cae918b42cb': str`要素 ${0} 個: ${1}`,
@@ -785,12 +825,14 @@
 'sfde497acd6a6a561': `ファイルにない必須フィールド`,
 'sfe771bfc3355dd51': str`${0}: 入力と出力`,
 'sfe9c9abcded61e50': str`プロセス ${0}`,
+'sfefeb008c3ce14ef': `見込み: あと 1 タスク`,
 'sff660af26c203189': `登録済みのタスクはまだありません`,
 'sff83af1548f682c0': str`${0} のタスク`,
 'sffa12312d4ff4b9c': `定義なし`,
 'sfff7f6b9ec291984': str`Python タスク ${0} 回`,
 'stage-done': `完了`,
 'status': `状態`,
+'stop-cancelled': `取り消し`,
 'stop-completed': `完了`,
 'stop-invalid-input': `未実行`,
 'stop-partial': `一部のみ完了`,

package/src/words/flow-calls.ts

@@ -0,0 +1,36 @@
+// Where a flow call stopped (`FlowCallNode.raised_at`, `raised_by`), and the tasks it
+// created that no flow awaited (`FlowCallNode.unawaited`).
+import { runRelative, type FlowCallNode } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+
+/** `module.qualname` as the graph names a function: its last part. */
+const shortFn = (fn: string): string => fn.slice(fn.lastIndexOf('.') + 1) || fn;
+
+/** Where an exception left a flow call's own code: `flow.py:42`; '' when not recorded. */
+export function raisedWhere(f: Pick<FlowCallNode, 'raised_at'>, run = ''): string {
+  const at = f.raised_at;
+  return at ? `${runRelative(at.file, run)}:${at.line}` : '';
+}
+
+/** On the failed task: "This failure stopped review_loop at flow.py:42" (without a place: "This failure stopped review_loop"). */
+export function stoppedAt(f: FlowCallNode, run = ''): string {
+  const fn = shortFn(f.function);
+  const where = raisedWhere(f, run);
+  return where ? msg(str`This failure stopped ${fn} at ${where}`) : msg(str`This failure stopped ${fn}`);
+}
+
+/** On a flow call that raised: "Stopped at flow.py:42" with the failed task's name, or its own error. */
+export function stoppedHere(f: FlowCallNode, by: string, run = ''): string {
+  const where = raisedWhere(f, run);
+  if (by) return where ? msg(str`Stopped at ${where} by the failure of ${by}`) : msg(str`Stopped by the failure of ${by}`);
+  return where ? msg(str`Stopped at ${where}`) : '';
+}
+
+/** A count of a top flow call's unawaited tasks: "2 tasks not awaited". */
+export function unawaitedCount(n: number): string {
+  return n === 1 ? msg('1 task not awaited') : msg(str`${n} tasks not awaited`);
+}
+
+/** The tooltip of unawaited tasks. */
+export const unawaitedTip = (): string =>
+  msg('Tasks whose result no flow awaited, ordered a task after or returned (unawaited); they ran for their output files and changes');

package/src/words/forecast.ts

@@ -0,0 +1,28 @@
+// The forecast (`Forecast`): the tasks a run is expected to create and has not yet,
+// from the run of its flow that finished last before it.
+import type { Forecast } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { facts, fmtDur, listText, usd } from './format.js';
+
+/** A kind node's expected tasks: "+3", and its words. */
+export function expectedPill(n: number): { text: string; label: string } {
+  return { text: msg(str`+${n}`), label: n === 1 ? msg('1 more task expected (forecast)') : msg(str`${n} more tasks expected (forecast)`) };
+}
+
+/** The forecast in one line: "Forecast: 7 more tasks | 46s of task time | $0.60". */
+export function forecastLine(f: Forecast): string {
+  return facts(
+    f.remaining === 1 ? msg('Forecast: 1 more task') : msg(str`Forecast: ${f.remaining} more tasks`),
+    f.wall_s ? msg(str`${fmtDur(f.wall_s)} of task time`) : '',
+    f.cost_usd !== null && f.cost_usd !== undefined ? usd(f.cost_usd) : '',
+  );
+}
+
+/** Where the forecast comes from, as its tooltip. */
+export const forecastTip = (f: Forecast): string =>
+  msg(str`Tasks this run is expected to create and has not yet, from the run ${f.earlier_run} of the same flow (forecast)`);
+
+/** The groups the plan has no task of yet, with how many each is expected to have: "Not in the plan yet: review +3, report +1". */
+export function notInPlanLine(items: readonly { group: string; remaining: number }[]): string {
+  return items.length ? msg(str`Not in the plan yet: ${listText(items.map((x) => `${x.group} +${x.remaining}`))}`) : '';
+}

package/src/words/format.ts

@@ -99,6 +99,25 @@ export function usd(v: number | null | undefined): string {
   return `$${v.toFixed(2)}`;
 }
 
+/** What of the rows' tokens could not be read (`usage_unknown`): `tokens` when any row's,
+ * else `calls` when any row's, else ''. */
+export function usageUnknown(rows: readonly { usage_unknown?: string | null }[]): '' | 'calls' | 'tokens' {
+  const all = new Set(rows.map((r) => r.usage_unknown ?? ''));
+  return all.has('tokens') ? 'tokens' : all.has('calls') ? 'calls' : '';
+}
+
+/** The words for `usage_unknown` (`usageUnknown`): a short label and its tooltip; null when nothing is unknown. */
+export function usageUnknownWords(unknown: '' | 'calls' | 'tokens'): { label: string; tip: string } | null {
+  if (unknown === 'calls')
+    return {
+      label: msg('Tokens per API call unknown'),
+      tip: msg('Only the token totals that the coding agent printed are known, not the tokens of each API call (usage_unknown)'),
+    };
+  if (unknown === 'tokens')
+    return { label: msg('Tokens unknown'), tip: msg('The tokens of an agent session that ran are not known (usage_unknown)') };
+  return null;
+}
+
 /** A row's unread event types with their counts (`session_settled ×2, x ×1`); '' when none. */
 export function unreadEvents(rows: readonly { unread_events?: Record<string, number> | null }[]): string {
   const total = new Map<string, number>();

package/src/words/index.ts

@@ -30,3 +30,7 @@ export * from './context.js';
 export * from './preflight.js';
 export * from './task-definition.js';
 export * from './safety.js';
+export * from './lineage.js';
+export * from './rerun.js';
+export * from './flow-calls.js';
+export * from './forecast.js';

package/src/words/lineage.ts

@@ -0,0 +1,41 @@
+// How a task is joined to an earlier one (`Lineage`), in the words of the graph's
+// edges: each word names the edge from the earlier task to the later one, in the
+// task's earlier and later tasks alike. And an input file's check at the start.
+import type { InputFileCheck, Lineage } from '@contraagent/api';
+import { msg } from '@lit/localize';
+
+/** A lineage as the graph's legend names its edge: given output (solid), runs after (dotted), created after result (dashed). */
+export function lineageWord(l: Lineage): string {
+  switch (l) {
+    case 'given_from':
+      return msg('given output', { id: 'edge-given', desc: 'An edge of the pipeline graph: the later task was given the earlier task\'s output (given_from)' });
+    case 'after':
+      return msg('runs after', { id: 'edge-after', desc: 'An edge of the pipeline graph: the later task waits for the earlier task and is not given its output (order only)' });
+    case 'created_from':
+      return msg('created after result', { id: 'edge-created', desc: 'An edge of the pipeline graph: the later task was created after the earlier task\'s result (created_from)' });
+  }
+}
+
+/** A lineage's tooltip: the field of the plan it comes from. */
+export function lineageTip(l: Lineage): string {
+  switch (l) {
+    case 'given_from':
+      return msg('Its output is in the params of the later task (given_from)');
+    case 'after':
+      return msg('The later task waits for it and is not given its output (after)');
+    case 'created_from':
+      return msg('Its result reached the flow call just before the flow call created the later task (created_from)');
+  }
+}
+
+/** An input file's check as its task was about to start. */
+export function inputFileCheckWord(c: InputFileCheck): string {
+  switch (c) {
+    case 'passed':
+      return msg('same content at the start');
+    case 'refused':
+      return msg('changed before the start');
+    case 'not_checked':
+      return msg('not checked', { id: 'input-file-not-checked', desc: 'An input file whose task has not started: its content was not compared yet' });
+  }
+}

package/src/words/outcome.ts

@@ -23,6 +23,8 @@ export function outcomeLabel(o: Outcome): string {
       return msg('waiting');
     case 'skipped':
       return msg('skipped');
+    case 'cancelled':
+      return msg('cancelled', { id: 'outcome-cancelled', desc: 'The status of a task that was stopped, or never started, because no part of the pipeline waited for its result any longer (cancelled)' });
   }
 }
 
@@ -55,6 +57,8 @@ export function stateCount(s: Outcome | 'not_run', n: number): string {
       return msg(str`${n} waiting`);
     case 'skipped':
       return msg(str`${n} skipped`);
+    case 'cancelled':
+      return msg(str`${n} cancelled`);
     case 'not_run':
       return msg(str`${n} not run`);
   }

package/src/words/rerun.ts

@@ -0,0 +1,61 @@
+// Why a resume ran a task again (`JournalRow.rerun`): the parts of its fingerprint that
+// changed, read from `fingerprint_parts`, and a divergence.
+import type { JournalRow } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { facts, listText } from './format.js';
+
+/** What a journal row says about a rerun: the parts of the fingerprint that changed since the row before, and whether it is a divergence. */
+export interface Rerun {
+  /** The reason as the journal records it. */
+  text: string;
+  /** The fingerprint's parts whose digest differs from the earlier row's (`definition`, `params`, ...), in the row's order. */
+  changed: string[];
+  /** The flow gave other params for the same outputs (`divergence: ...`). */
+  divergence: boolean;
+}
+
+/**
+ * The rerun of `rows[i]` (one task's journal rows, in journal order), or null when the
+ * row is no rerun: its `rerun`, the parts of `fingerprint_parts` that differ from the
+ * latest earlier row that has them, and whether the reason is a divergence.
+ */
+export function rerunOf(rows: readonly JournalRow[], i: number): Rerun | null {
+  const row = rows[i];
+  if (!row?.rerun) return null;
+  const now = row.fingerprint_parts ?? {};
+  const before = rows.slice(0, i).reverse().find((r) => Object.keys(r.fingerprint_parts ?? {}).length)?.fingerprint_parts ?? {};
+  const changed = Object.keys(now).length && Object.keys(before).length ? [...new Set([...Object.keys(now), ...Object.keys(before)])].filter((k) => now[k] !== before[k]) : [];
+  return { text: row.rerun, changed, divergence: row.rerun.startsWith('divergence') };
+}
+
+/** A part of a fingerprint (`fingerprint_parts`) in words; one these words do not know, as it is recorded. */
+export function fingerprintPartWord(part: string): string {
+  switch (part) {
+    case 'definition':
+      return msg('definition', { id: 'part-definition', desc: 'A part of what defines a task: its instructions, role, schemas, validators or source' });
+    case 'params':
+      return msg('params', { id: 'part-params', desc: 'A part of what defines a task: what it was given (params)' });
+    case 'outside':
+      return msg('outside state');
+    case 'output_of':
+      return msg('the file it fills in');
+    case 'input_files':
+      return msg('input files', { id: 'part-input-files', desc: 'A part of what defines a task: the files given to it by path and hash' });
+    default:
+      return part;
+  }
+}
+
+/** The word for a divergence, and its tooltip. */
+export const divergenceWord = (): string => msg('divergence');
+export const divergenceTip = (): string =>
+  msg('The flow gave other params for the same outputs of the tasks before it (divergence): a clock, randomness, outside state or changed flow code');
+
+/** A rerun in one line: "Ran again after a resume | divergence | Changed: params"; the recorded reason when no part is known to have changed. */
+export function rerunLine(r: Rerun): string {
+  return facts(
+    msg('Ran again after a resume'),
+    r.divergence ? divergenceWord() : '',
+    r.changed.length ? msg(str`Changed: ${listText(r.changed.map(fingerprintPartWord))}`) : r.divergence ? '' : r.text,
+  );
+}

package/src/words/stop.ts

@@ -19,6 +19,8 @@ function knownStopLabel(stop: Stop, reason?: string | null): string {
       return msg('done', { id: 'stop-completed', desc: 'How an attempt ended: completed' });
     case 'skipped':
       return msg('skipped');
+    case 'cancelled':
+      return msg('cancelled', { id: 'stop-cancelled', desc: 'How an attempt ended: cancelled, because no part of the pipeline waited for its result any longer' });
     case 'partial':
       return msg('partly done', { id: 'stop-partial', desc: 'How an attempt ended: partial, its output a placeholder' });
     case 'invalid_input': {