Skip to content

feat: add Codex thread reference tools - #443

Open
nikita-ashihmin wants to merge 4 commits into
agentclientprotocol:mainfrom
nikita-ashihmin:nikita.ashikhmin/air-chat-references
Open

feat: add Codex thread reference tools#443
nikita-ashihmin wants to merge 4 commits into
agentclientprotocol:mainfrom
nikita-ashihmin:nikita.ashikhmin/air-chat-references

Conversation

@nikita-ashihmin

@nikita-ashihmin nikita-ashihmin commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Convert AIR session resource links to Codex thread deep links.
  • Provide Codex thread tools through an authenticated local MCP server.
  • Use the reserved codex_acp MCP namespace and reject configuration conflicts.
  • Keep one MCP endpoint across app-server restarts.
  • Preserve the full config for delegated tasks, but limit resume and fork overrides to codex_acp.
  • Support paginated history with legacy app-server fallbacks.
  • Keep polling usable when turn history is unavailable.
  • Normalize structured function output before reading delegation metadata.
  • Isolate the transport, config policy, execution, content mapping, and compatibility calls in src/thread-tools-mcp.
  • Pin the Codex schema generator and verify generated types in CI.

The adapter does not copy another thread into the prompt. Codex reads a referenced thread only when it calls read_thread.

Verification

  • npm run typecheck
  • npm run check:generated-types
  • npm test — 507 passed, 26 skipped
  • npm run build
  • Real Codex ACP smoke with list_threadsend_turn

@nikita-ashihmin
nikita-ashihmin force-pushed the nikita.ashikhmin/air-chat-references branch 5 times, most recently from 9283056 to 70e4f27 Compare August 28, 2026 11:34
@nikita-ashihmin nikita-ashihmin changed the title feat: resolve cross-session ACP resource links feat: add ACP session reference metadata Aug 28, 2026
@nikita-ashihmin
nikita-ashihmin force-pushed the nikita.ashikhmin/air-chat-references branch from 70e4f27 to c82c7ac Compare August 28, 2026 11:37
@nikita-ashihmin nikita-ashihmin changed the title feat: add ACP session reference metadata feat: pass Codex thread deep links Aug 28, 2026
@nikita-ashihmin
nikita-ashihmin force-pushed the nikita.ashikhmin/air-chat-references branch 2 times, most recently from 6855476 to ab09765 Compare August 28, 2026 11:57
@nikita-ashihmin nikita-ashihmin changed the title feat: pass Codex thread deep links feat: add Codex thread reference tools Aug 28, 2026
Convert an ACP session reference to a Codex thread deep link. Let Codex resolve the referenced thread without copying its history.
Expose the Codex TUI thread tools through a private local MCP server.
Read referenced threads only when Codex requests their content.
Preserve the full ACP session config for delegated tasks. Match the TUI history fallbacks, wait behavior, response limits, and MCP lifecycle.

Keep the new app-server calls in one compatibility module until stable generated types expose them.
@nikita-ashihmin
nikita-ashihmin force-pushed the nikita.ashikhmin/air-chat-references branch from 96f29b0 to 7b285c2 Compare September 2, 2026 19:01
Keep one authenticated MCP endpoint across app-server restarts. Reject reserved namespace conflicts and managed policy violations.

Limit resume and fork overrides to the adapter MCP server. Preserve polling when turn history is unavailable and normalize structured tool output.

Pin the schema generator and verify generated types in CI. Declare Node.js 20 as the minimum runtime.
@nikita-ashihmin
nikita-ashihmin force-pushed the nikita.ashikhmin/air-chat-references branch from 7b285c2 to 2f4edc6 Compare September 2, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant