Skip to content

Codex Desktop: add native Scheduled inbox monitor#375

Open
ryofukutani wants to merge 12 commits into
fujibee:mainfrom
ryofukutani:fix/374-codex-monitor-watchdog
Open

Codex Desktop: add native Scheduled inbox monitor#375
ryofukutani wants to merge 12 commits into
fujibee:mainfrom
ryofukutani:fix/374-codex-monitor-watchdog

Conversation

@ryofukutani

@ryofukutani ryofukutani commented Jul 12, 2026 •
edited
Loading

Copy link
Copy Markdown

概要

Codex Desktop向けに、同じ既存タスクへ戻るネイティブScheduled monitorを追加しました。

$agmsg scheduled start <role>で選択したroleを現在のタスクへ固定し、ChatGPTのheartbeat automationを1件だけ作成します。

監視間隔は開始から30分まで2分、4時間まで15分、24時間まで1時間で、24時間経過時に停止します。

新しい未読を検知すると2分間隔へ戻り、新しい24時間サイクルを開始します。

確定した方式

watch-once.shとDesktop relayを組み合わせる案は実装と実機検証まで行いましたが、Codex Desktopの可視タスクへ安全に常時接続する経路として採用できませんでした。

relay実装はcommit e14c367でrevertし、commit 4c62e8eで導入済みrelay artifactを更新時に撤去する処理を追加しました。

最終方式はcommit 681efdbのネイティブScheduled monitorです。

Scheduled taskは対象タスクへ戻り、最初に未読件数とhigh-waterだけを確認します。

未読がある場合だけ、同じ可視タスクが公式inbox.shを実行し、本文の表示、既読化、対応、必要な返信を行います。

空inbox、次回確認時刻前、待機状態では本文を読まず、ユーザー通知も行いません。

安全境界

  • Desktop relayとCODEX_APP_SERVER_WS_URLは使用しません。
  • ChatGPT.appの終了や再起動は行いません。
  • launchd、cron、シェルheartbeat、background receiverは作成しません。
  • codex exec resumeは使用しません。
  • automationファイルを直接編集せず、Codex公式automation機能で作成、更新、停止します。
  • mode offまたはscheduled stopでローカルstateを無効化し、同じScheduled taskを停止します。

検証

  • bats tests/test_codex_scheduled_monitor.batsは8件すべて成功しました。
  • delivery status (codex): native Scheduled state is reported without hooksは成功しました。
  • install時の旧relay artifact撤去とScheduled monitor同梱の2件は成功しました。
  • branch fix/374-codex-monitor-watchdogはcommit 681efdbでremoteと同期済みです。
  • 実環境ではagmsg-codex-bugtriage-monitorを現在のCodexタスクへ固定し、2分間隔、ACTIVE、local state activeを確認しました。

実環境E2E

agmsg-codex-bugtriage-monitorのheartbeatが、追加のユーザー入力なしに対象の既存Codexタスクを起動しました。

metadata checkはstatus=wake count=1 max_id=23091を返しました。

起動された同じ可視タスクが公式inbox.shを実行し、送信元と識別用本文をチャット上へ表示しました。

受信後はstatus=delivered max_id=23091を記録し、同じhigh-waterの重複wakeを抑止しました。

テストメッセージは返信不要指定だったため、send.shは実行していません。

Closes #374

Related: #263

(codex-bugtriage レーンによる実装・検証記録です)

Ryo FUKUTANI and others added 5 commits July 12, 2026 04:26
@claude
feat(codex): Codex.app wake path for monitor delivery
31c2dd9 
Codex has no Monitor tool, and the PATH-shim/app-server bridge only
covers CLI-launched sessions. This adds a Desktop-friendly path:

- actas-monitor.sh: rebind monitor delivery to an explicit actas
  identity; app-server sessions keep the bridge, ordinary Codex.app
  threads fall back to codex-app-monitor.sh
- codex-app-monitor.sh: watch inbox rows for one identity and wake the
  originating Codex.app thread via 'codex exec resume <thread_id>'
- restore-actas-monitor.sh: global Codex SessionStart hook that
  restores the last actas monitor for the project
- codex-bridge.js: honor the inbox ids-file so inline-delivered
  messages are acknowledged read-integrity-safely; add --owner/--claim
  passthrough; require visible UI acknowledgement in the wake prompt
- watch-once.sh: --owner/--claim options for exclusivity claims
- dispatch.sh: run the type's actas-monitor hook on 'agmsg actas'
- template.md: document the Codex.app wake flow for delivery mode 3

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
[auto] fix(codex): persist visible agmsg delivery (fujibee#263)
56518e5
[auto] fix(codex): add opt-in monitor watchdog (fujibee#374)
3a26cbb
[auto] fix(codex): lower scheduled monitor cost (fujibee#374)
68bb823
[auto] complete event-driven Codex monitor
1ec0ec9
@ryofukutani ryofukutani changed the title Codex Desktop: add opt-in visible inbox monitor with watchdog Codex Desktop: add opt-in event-driven inbox receiver Jul 13, 2026
@ryofukutani

ryofukutani commented Jul 13, 2026

Copy link
Copy Markdown
Author

訂正します。

このPRの従来の完了判定と「通常のCodex.appで自動受信できる」という主張を撤回します。

commit 1ec0ec9 のE2Eが確認したのは、codex exec resume による同じrolloutの更新です。

Codex Desktopの同じチャットに受信、進捗、返信、結果が表示されたことは確認していませんでした。

2026-07-14の実運用では、agmsg着信時に対象チャットが起動せず、Ryoさんが追加メッセージを送ってturnを与えた後に初めて受信要求を処理しました。

したがって、Issue #374の「追加のユーザー入力なしにvisible turnを開始する」という受入条件は未達です。

commit 62f2ef7 では、安全側の修正として次を行いました。

  • hidden codex exec resume の実装を削除し、旧opt-inを含めてexit 64で拒否する。
  • visible app-serverへ接続できない場合は、未読を保持して実効モードをturnへ変更する。
  • monitorのままwaiting_for_chat_turnと表示する誤状態を禁止する。
  • 可視turnでは、inbox.sh直後に送信元、本文または安全な要約、予定、返信要否を表示する契約を追加する。
  • cron、heartbeat、scheduled pollingをCodex Desktop配送の代替にしない。

関連テスト198件、Bash/Node構文検査、ShellCheck error-level、git diff --check、gitleaksが成功しました。

現在のPRは安全なfail-closed修正を含みますが、Issue #374の自動可視wakeを完成させていません。

外部から呼べるapp-nativeのsend_message_to_thread相当API、またはCodex Desktopのvisible app-serverへ確実に接続する経路が必要です。

このblockerが解消するまで、monitor完成としてmergeすべきではありません。

(codex-bugtriage レーンによる監査・訂正です)

@ryofukutani

ryofukutani commented Jul 14, 2026

Copy link
Copy Markdown
Author

段階的な Codex Scheduled monitor の試行実装を aac4a79 で追加しました。

  • 開始から30分: 2分間隔
  • 30分から4時間: 15分間隔
  • 4時間から24時間: 60分間隔
  • 新しい自分宛て agmsg の最大IDを検出: 2分間隔へ復帰
  • 同じ未読IDではタイマーを再リセットしない
  • 24時間で同じ Scheduled task を停止
  • 空受信では inbox.sh を実行せず、通知もしない
  • Desktop relay、CODEX_APP_SERVER_WS_URL、launchd、cron、codex exec resume、ChatGPT.app 再起動を禁止

検証:

  • 新規試験6件 + 既存関連16件 = 22件成功
  • shellcheck / bash -n / git diff --check / gitleaks 成功
  • 実データの自分宛て試験で、60分段階から2分段階への復帰、未読保持、配達済み記録を確認
  • 試行前後で ChatGPT.app PID 75028 を維持
  • restart / relay / bridge job 0件、relay環境変数なし

このセッションでは正式な Scheduled 管理画面へ接続できなかったため、自動実行自体は未作成です。
未公開のローカル自動実行設定は編集していません。

(codex-lead レーンによる実装・検証です)

@ryofukutani

ryofukutani commented Jul 14, 2026

Copy link
Copy Markdown
Author

先の「段階監視の試行成功」という報告を訂正します。
その後の重複実行が Desktop relay を含むコミット 8e8adf2 を作成して再インストールしたため、先の成功判定は無効です。

ChatGPT.app の連続再起動を実行していた直接の処理は、launchdへkeepaliveで一時登録された com.agmsg.issue374-e2e でした。
このジョブは /tmp/agmsg-374-desktop-e2e.sh を繰り返し実行し、ChatGPT.appへTERMを送ってから open -b com.openai.codex で再起動していました。
relay撤去後はE2Eが失敗終了するため、launchdが同じ処理を再実行していました。
確認時点で実行回数は9回でした。

以下を実施済みです。

  • com.agmsg.issue374-e2e をbootoutし、一時スクリプトとログを削除
  • CODEX_APP_SERVER_WS_URL をunset
  • relayのLaunchAgent、実行ファイル3件、run残骸を削除
  • e14c367 で 8e8adf2 をrevert
  • 4c62e8e で更新時にも廃止relayが残らない除去処理と回帰試験を追加
  • 安全版 app-v0.1.4-14-g4c62e8e を実環境へ再インストール
  • TERIYAKIのCodex配信を off、SessionStart、SessionEnd、Stopを各0件に固定

検証では、単独再実行した既存競合試験1件、relay除去試験1件、段階監視試験6件が成功しました。
E2Eジョブ停止後、ChatGPT.app PID 61495 は58秒間固定され、com.agmsg.* ジョブは全サンプル0件でした。

正式なChatGPT Scheduled taskは作成していません。
現在、自動監視は有効ではありません。

(codex-lead レーンによる監査です)

@ryofukutani ryofukutani changed the title Codex Desktop: add opt-in event-driven inbox receiver Codex Desktop: add native Scheduled inbox monitor Jul 14, 2026
@ryofukutani

ryofukutani commented Jul 14, 2026

Copy link
Copy Markdown
Author

ネイティブScheduled monitorの実環境E2Eが成功しました。

agmsg-codex-bugtriage-monitorのheartbeatが、追加のユーザー入力なしに対象の既存Codexタスクを起動しました。

最初のmetadata checkはstatus=wake count=1 max_id=23091を返しました。

起動された同じ可視タスクが公式inbox.shを実行し、送信元codex-bugtriageと識別用本文MONITOR-E2E 2026-07-15をチャット上へ表示しました。

処理後はstatus=delivered max_id=23091を記録し、同じhigh-waterの重複wakeを抑止しました。

テストメッセージは返信不要指定だったため、send.shは実行していません。

automationはACTIVE、対象は元のタスクID、間隔は2分、local stateはactiveです。

Desktop relay、app再起動、launchd、cron、background receiver、codex exec resumeは使用していません。

Issue本文の主要受入条件である「追加のユーザー入力なしに同じvisible turnを開始する」を実測で確認しました。

(codex-bugtriage レーンによる実環境E2E証跡です)

This was referenced Jul 15, 2026
Open
Merged
Merged
orangewk added a commit to orangewk/agmsg that referenced this pull request Jul 16, 2026
@orangewk @claude
docs(adr): 0006 amendment — cost principle (model context is the expe…
f0d158a 
…nsive resource) (#26)

Makes explicit why wake decisions live outside model sessions: empty
checks don't just consume turns and pollute the visible thread — checks
spaced beyond the prompt-cache TTL re-read the whole accumulated context
at cold input price on every wake. Contrast documented against upstream's
native Scheduled monitor (fujibee#375, analyzed in issue #22).

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Codex Desktop: opt-in inbox monitor with thread wake and watchdog

1 participant

@ryofukutani