codex-agent-view 0.5.3 → 0.5.5

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "codex-agent-view",
-  "version": "0.5.3",
-  "description": "A lightweight, read-only Codex companion plugin for monitoring live tasks and subagent activity locally in your browser, without additional ongoing model calls for monitoring.",
+  "version": "0.5.5",
+  "description": "A read-only Codex plugin for monitoring live tasks and subagents in your browser. Open each view with one lightweight @codex-agent-view invocation. Once open, live monitoring runs locally with no additional model calls.",
   "author": {
     "name": "Junho Yoon",
     "url": "https://github.com/JunhoYoon95"
@@ -12,8 +12,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "Codex Agent View",
-    "shortDescription": "Live tasks and agent activity.",
-    "longDescription": "Open a lightweight, read-only live view of active Codex work, privacy-minimized request summaries, participating agents, and progress locally in your default browser. Invoke @codex-agent-view directly; no separate skill picker or $ command is required, and no starter text is inserted. The initial invocation may use a normal Codex turn, and monitored Codex tasks and subagents continue to use their normal tokens. After the live view opens, monitoring itself adds no ongoing model or external API calls.",
+    "shortDescription": "Live Codex agent dashboard.",
+    "longDescription": "Open a lightweight, read-only dashboard of active Codex work, privacy-minimized request summaries, participating agents, and progress locally in your default browser. Invoke @codex-agent-view directly; no separate skill picker or $ command is required, and no starter text is inserted. Open each view with one lightweight @codex-agent-view invocation. Once open, live monitoring runs locally with no additional model calls. A new invocation may be needed after the browser tab is closed or its credential expires. Each invocation is a normal Codex turn, and monitored tasks and subagents continue to use their normal tokens. The live monitoring path does not resend observed task data to a model.",
     "developerName": "Junho Yoon",
     "category": "Productivity",
     "brandColor": "#123F35",

package/README.ko.md

@@ -4,7 +4,7 @@
 
 Codex Agent View는 Codex의 실시간 작업과 subagent 활동을 브라우저에서 로컬로 확인하는 가벼운 비공식 읽기 전용 companion plugin입니다. Codex가 처리하는 작업, 참여 중인 에이전트, 확인 가능한 할당 작업과 최근 관찰 활동을 보여줍니다. Hook 데이터는 이 기기의 제한된 process memory 안에만 유지되며, `@codex-agent-view` 한 번으로 운영체제 기본 브라우저에 실시간 화면을 엽니다.
 
-화면을 연 뒤의 실시간 갱신은 local hook data를 사용하며 모니터링을 위한 추가적인 지속 model 또는 외부 API inference call을 만들지 않습니다. 다만 `@codex-agent-view`를 실행하는 최초 요청은 일반 Codex turn이므로 token을 사용할 수 있고, 관찰 대상인 Codex task와 subagent도 작업 수행에 필요한 token을 평소처럼 사용합니다.
+각 화면은 가벼운 `@codex-agent-view` 실행 한 번으로 엽니다. 화면이 열린 뒤 실시간 모니터링은 추가 모델 호출 없이 로컬에서 작동합니다. 모니터링 중인 Codex task와 subagent의 일반적인 모델·token 사용은 계속됩니다.
 
 Codex를 대체하거나 작업·에이전트를 제어하지 않으며, 외부 서버·telemetry·영구 작업 기록을 사용하지 않습니다.
 
@@ -13,7 +13,7 @@ Codex를 대체하거나 작업·에이전트를 제어하지 않으며, 외부
 일반 터미널에서 현재 릴리스를 설치합니다.
 
 ```bash
-npm install --global codex-agent-view@0.5.3
+npm install --global codex-agent-view@0.5.5
 codex-agent-view install
 ```
 
@@ -45,11 +45,11 @@ Codex 앱의 작업 입력창에서 다음 plugin을 선택해 그대로 전송
 
 ## 화면에 표시되는 정보
 
-실시간 화면의 기본 언어는 영어이며 한국어와 스페인어도 선택할 수 있습니다. 에이전트 상세 내용을 접지 않은 상태로 2초마다 갱신합니다.
+실시간 화면의 기본 언어는 영어이며 한국어와 스페인어도 선택할 수 있습니다. 에이전트 상세 내용을 접지 않은 상태로 2초마다 갱신합니다. **작업 상태 필터**는 각 상위 작업의 현재 상태만 기준으로 삼으며, 하위 에이전트 상태나 최근 활동 기록 때문에 다른 상태의 작업 카드가 섞이지 않습니다.
 
 각 작업에는 짧게 정제된 요청 개요가 표시될 수 있습니다. 각 에이전트 카드에는 다음 정보가 표시될 수 있습니다.
 
-- **할당 작업** — 검증된 spawn 후보 하나와 새 에이전트 하나를 모호함 없이 연결할 수 있을 때만 제한된 요약을 표시합니다. 현재 관찰한 공식 앱 payload에서는 보호된 spawn message가 불투명하므로 사람이 읽도록 안전하게 정리한 task label을 주 근거로 사용합니다. 동시 실행, 모호함, 만료 또는 보호된 값은 추측하거나 표시하지 않습니다.
+- **할당 작업** — 이 연결에 사용할 공식 exact correlation ID는 아직 확인되지 않았습니다. 따라서 제한된 시간창에 검증된 spawn 후보 하나와 새 에이전트 하나만 존재할 때 bounded best-effort 방식으로 제한된 요약을 연결합니다. 현재 관찰한 공식 앱 payload에서는 보호된 spawn message가 불투명하므로 사람이 읽도록 안전하게 정리한 task label을 주 근거로 사용합니다. 여러 에이전트가 동시에 생성돼 연결 관계가 모호하면 할당 설명을 추측하지 않고 의도적으로 확인 불가로 두며, 만료되거나 보호된 값도 표시하지 않습니다.
 - **현재 활동** — 파일 수정 진행 중이나 최근 터미널 작업 완료처럼 사람이 읽을 수 있는 문구입니다. 관찰된 tool lifecycle의 정확한 `turn_id`가 단 하나의 에이전트와 일치할 때만 표시합니다.
 
 이 정보는 관찰 가능한 할당 및 tool lifecycle 신호이며 에이전트의 내부 생각이 아닙니다. Monitor는 원본 spawn message, 전체 prompt, 전체 tool input 또는 전체 tool output을 보관하거나 표시하지 않습니다. 정보가 없거나 연결이 모호하면 발생 시각으로 추측하지 않고 확인 불가로 둡니다.

package/README.md

@@ -4,7 +4,7 @@
 
 Codex Agent View is a lightweight, unofficial, read-only companion plugin for monitoring live Codex tasks and subagent activity locally in your browser. It shows the work Codex is handling, the participating agents, their assigned work when it can be verified, and their latest observable activity. Hook data stays on this device in bounded process memory, and one `@codex-agent-view` invocation opens the live view in the operating system's default browser.
 
-Once the view is open, its live refreshes use local hook data and create no additional ongoing model or external API inference calls for monitoring. Invoking `@codex-agent-view` is still a normal Codex turn and can use tokens, and the Codex tasks and subagents being observed continue their normal token usage.
+Open each view with one lightweight `@codex-agent-view` invocation. Once open, live monitoring runs locally with no additional model calls. The Codex tasks and subagents being monitored continue their normal model and token usage.
 
 It does not replace Codex, control tasks or agents, run a hosted service, send telemetry, or keep a persistent event history.
 
@@ -13,7 +13,7 @@ It does not replace Codex, control tasks or agents, run a hosted service, send t
 Install the current release from a regular terminal:
 
 ```bash
-npm install --global codex-agent-view@0.5.3
+npm install --global codex-agent-view@0.5.5
 codex-agent-view install
 ```
 
@@ -45,11 +45,11 @@ The public Codex plugin API does not provide a reliable automatic app sidebar or
 
 ## What the view shows
 
-The live view defaults to English and also supports Korean and Spanish. It refreshes every two seconds without collapsing agent details.
+The live view defaults to English and also supports Korean and Spanish. It refreshes every two seconds without collapsing agent details. The **Work status filter** matches each parent work item's current status only; nested agent statuses and recent activity history do not cause a card to match a different status.
 
 Each work item can include a short, redacted request summary. Each agent card can show:
 
-- **Assigned work** — a bounded summary is shown only when one verified spawn candidate can be correlated unambiguously with one newly observed agent. In the currently observed official-app payload, the protected spawn message is opaque, so a safely humanized task label is the primary usable source. Ambiguous, concurrent, expired, or protected values are not guessed or displayed.
+- **Assigned work** — no exact upstream correlation ID has been observed for this mapping. A bounded summary is therefore matched on a best-effort basis only when one verified spawn candidate and one newly observed agent are the sole candidates in the bounded window. In the currently observed official-app payload, the protected spawn message is opaque, so a safely humanized task label is the primary usable source. When several agents are spawned concurrently and the mapping is ambiguous, assignment details intentionally remain unavailable instead of being guessed; expired or protected values are likewise not displayed.
 - **Current activity** — a human-readable description such as a file edit in progress or a recently completed terminal action. It is shown only when the observed tool lifecycle has the exact `turn_id` of one and only one agent.
 
 These fields describe observable assignment and tool lifecycle signals, not an agent's internal reasoning. The monitor does not retain or display raw spawn messages, full prompts, full tool input, or full tool output. Missing or ambiguous information remains unavailable instead of being inferred from timing.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codex-agent-view",
-  "version": "0.5.3",
-  "description": "A lightweight, read-only Codex companion plugin for monitoring live tasks and subagent activity locally in your browser, without additional ongoing model calls for monitoring.",
+  "version": "0.5.5",
+  "description": "A read-only Codex plugin for monitoring live tasks and subagents in your browser. Open each view with one lightweight @codex-agent-view invocation. Once open, live monitoring runs locally with no additional model calls.",
   "type": "module",
   "main": "./src/core/index.mjs",
   "exports": "./src/core/index.mjs",

package/public/app.js

@@ -58,7 +58,7 @@ const MESSAGES = Object.freeze({
     toolbarAria: "Filter automatically observed work and participating agents",
     searchLabel: "Filter list (optional)",
     searchPlaceholder: "Find work or an agent",
-    statusFilterLabel: "Status filter (optional)",
+    statusFilterLabel: "Work status filter (optional)",
     statusAll: "All statuses",
     statusRunning: "Running",
     statusWaiting: "Waiting",
@@ -213,7 +213,7 @@ const MESSAGES = Object.freeze({
     toolbarAria: "자동 수신된 작업과 참여 에이전트 목록 필터",
     searchLabel: "목록 필터 (선택)",
     searchPlaceholder: "작업 또는 에이전트 찾기",
-    statusFilterLabel: "상태 필터 (선택)",
+    statusFilterLabel: "작업 상태 필터 (선택)",
     statusAll: "모든 상태",
     statusRunning: "실행 중",
     statusWaiting: "대기",
@@ -368,7 +368,7 @@ const MESSAGES = Object.freeze({
     toolbarAria: "Filtrar trabajos y agentes participantes observados automáticamente",
     searchLabel: "Filtrar lista (opcional)",
     searchPlaceholder: "Buscar un trabajo o agente",
-    statusFilterLabel: "Filtrar por estado (opcional)",
+    statusFilterLabel: "Filtro por estado del trabajo (opcional)",
     statusAll: "Todos los estados",
     statusRunning: "En ejecución",
     statusWaiting: "En espera",
@@ -1562,15 +1562,10 @@ function sessionMatchesQuery(session, query) {
 }
 
 function sessionMatchesStatus(session, status) {
-  const matchesStatus = (candidate) => (
-    candidate === status ||
-    (status === "completion_not_observed" && candidate === "stale")
-  );
   return (
     status === "all" ||
-    matchesStatus(session.status) ||
-    session.agents.some((agent) => matchesStatus(agent.status)) ||
-    session.recentActivities.some((activity) => matchesStatus(activity.status))
+    session.status === status ||
+    (status === "completion_not_observed" && session.status === "stale")
   );
 }
 

package/public/index.html

@@ -123,7 +123,7 @@
               >
             </div>
             <div class="field">
-              <label for="status-filter" data-i18n="statusFilterLabel">Status filter (optional)</label>
+              <label for="status-filter" data-i18n="statusFilterLabel">Work status filter (optional)</label>
               <select id="status-filter" name="status">
                 <option value="all" data-i18n="statusAll">All statuses</option>
                 <option value="running" data-i18n="statusRunning">Running</option>