@longtable/provider-codex 0.1.55 → 0.1.57

package/dist/skills.js

@@ -66,7 +66,7 @@ function baseSkillSpecs(surface = "compact") {
                 "- `$longtable-start` runs the provider-native LongTable start interview. It replaces the old CLI start questionnaire as the primary research-start surface.",
                 "- `$longtable-interview` is post-start. If `.longtable/state.json` or `CURRENT.md` lacks a usable Research Specification, route to `$longtable-start` before offering option-first follow-up choices.",
                 "- Natural references to methods, measurement, theory, reviewer, editor, ethics, venue, or voice should foreground the matching LongTable role.",
-                "- The compact visible shortcut set is methods, measure, theory, reviewer, and voice. Other roles remain available through this router when the request calls for them.",
+                "- The compact visible shortcut set is panel, methods, measure, theory, reviewer, and voice. Other roles remain available through this router when the request calls for them.",
                 "- When research responsibility is about to shift, surface a Researcher Checkpoint before closure.",
                 "- When changing LongTable product language, README positioning, or checkpoint policy, surface a Meta-Decision Checkpoint first.",
                 "- Stop before acting when the request would change the research question/scope, theory frame, measurement/coding standard, method design, or analysis strategy.",
@@ -101,8 +101,9 @@ function baseSkillSpecs(surface = "compact") {
                 "- For `$longtable-start`, use natural-language turns for the interview and reserve MCP option UI for the final research-facing Research Specification checkpoint; First Research Shape is only a shorter handle/resume layer.",
                 "- For `$longtable-interview`, use option-first follow-up choices only after a usable Research Specification exists. Always include an escape hatch such as Other, free text, or one open follow-up question.",
                 "- Do not let unrelated pending Researcher Checkpoints interrupt the interview. Mention them only as separate unresolved checkpoints, and treat them as blocking only when the researcher is confirming, saving, or recording a research decision.",
-                "- When the `mcp__longtable_state__.elicit_question` tool is available, use it first for researcher checkpoints so Codex can show the MCP elicitation UI and LongTable can record the answer as `mcp_elicitation`.",
-                "- Use `longtable question --print --provider codex --prompt \"...\"` only as a fallback when the MCP tool is unavailable, unsupported, declined, canceled, or blocked by the client.",
+                "- In attached tmux Codex sessions where the OMX question renderer is available, use the tmux popup first for researcher checkpoints; if it cannot run, disclose that transport degradation before falling back.",
+                "- When the `mcp__longtable_state__.elicit_question` tool is available, use it after the tmux popup path, or first when tmux popup is unavailable, so Codex can show the MCP elicitation UI and LongTable can record the answer as `mcp_elicitation`.",
+                "- Use `longtable question --print --provider codex --prompt \"...\"` only as a fallback when tmux popup and MCP elicitation are unavailable, unsupported, declined, canceled, or blocked by the client.",
                 "- If `CURRENT.md` shows a pending required checkpoint, ask the researcher for a selection and wait. Do not choose or record `longtable decide --question <id> --answer <value>` unless the researcher explicitly provides that value.",
                 "- Preserve open tensions and authorship instead of forcing closure.",
                 "- Label unsupported external claims as inference or estimate."
@@ -269,19 +270,18 @@ function baseSkillSpecs(surface = "compact") {
                 "",
                 "## Option UI Policy",
                 "",
-                "- Use MCP/native structured elicitation when available.",
+                "- Use attached-tmux popup transport first for Codex terminal sessions when the OMX renderer is available.",
+                "- Use MCP/native structured elicitation when available after the popup path, or first when no attached tmux popup can run.",
                 "- Use terminal selector only when the runtime has interactive TTY support.",
                 "- Use numbered/plain text fallback when structured UI is unavailable.",
                 "- Treat UI as transport. The durable product contract remains `QuestionRecord -> DecisionRecord`.",
-                "- Do not require tmux. If a future Codex popup transport is tmux-only, label it as optional and provide fallback.",
+                "- Do not copy OMX renderer code or make OMX runtime state the LongTable contract; disclose no-tmux degradation and provide fallback.",
                 "",
                 "## Fallback",
                 "",
                 "If MCP tools are unavailable, continue in Codex with explicit options and state that durable LongTable state could not be written."
             ]
-        }
-    ];
-    const fullOnly = [
+        },
         {
             name: "longtable-panel",
             description: "Use when LongTable should run a panel review with visible role disagreement.",
@@ -310,11 +310,19 @@ function baseSkillSpecs(surface = "compact") {
                 "",
                 "- Do not collapse disagreement too early.",
                 "- Use a Researcher Checkpoint before treating a high-stakes research decision as settled.",
-                "- If the `mcp__longtable_state__.elicit_question` tool is available, prefer it for the panel checkpoint before synthesizing or revising.",
-                "- Use `longtable question --print --provider codex --prompt \"...\"` only as the numbered fallback when MCP elicitation is unavailable or not accepted.",
-                "- Use `longtable panel --print --prompt \"...\"` only as an optional canonical prompt aid, not as the user's primary interface."
+                "- `longtable panel --provider codex --native-workers` should be tried first for Codex panel execution when attached tmux and `codex` are available; add `--wait <ms>` when a bounded command should wait for terminal result files. `--native-subagents` remains a compatibility adapter for provider-native subagents.",
+                "- If terminal native workers are unavailable and Codex native subagents/Agents are available, use them as the provider-native execution adapter; if not, run the same roles sequentially and disclose the fallback.",
+                "- Sequential fallback is always the stable degradation path; native workers and native subagents must normalize final role outputs back into `PanelResult`.",
+                "- Do not use OMX `$team` or worker vocabulary as the LongTable product contract. LongTable panel records are the source of truth.",
+                "- For panel checkpoints, prefer attached-tmux popup transport when available, then `mcp__longtable_state__.elicit_question`, then numbered fallback.",
+                "- Use `longtable question --print --provider codex --prompt \"...\"` only as the numbered fallback when popup transport and MCP elicitation are unavailable or not accepted.",
+                "- Use `longtable panel --print --prompt \"...\"` only as an optional canonical prompt aid, not as the user's primary interface.",
+                "- Terminal native worker runs (`completed` or `blocked`) are recorded by `longtable panel --native-workers --wait`, `longtable panel status --wait`, or `longtable panel resume --wait`; blocked role outputs remain blocked in the handoff. For external/provider results outside that lifecycle, persist structured role outputs with `longtable panel record --invocation <id> --result-file <json>` before generating `longtable handoff`.",
+                "- A result file should contain final role summaries, claims, objections, open questions, and evidence refs only; do not persist hidden reasoning, raw tool traces, or tmux logs."
             ]
-        },
+        }
+    ];
+    const fullOnly = [
         {
             name: "longtable-explore",
             description: "Use for early LongTable research exploration, problem framing, and question narrowing.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/provider-codex",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "private": false,
   "description": "Codex adapter surface for LongTable",
   "type": "module",
@@ -15,9 +15,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.55",
-    "@longtable/core": "0.1.55",
-    "@longtable/setup": "0.1.55"
+    "@longtable/checkpoints": "0.1.57",
+    "@longtable/core": "0.1.57",
+    "@longtable/setup": "0.1.57"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",