ores.shell.api

ores.shell.api holds the parts of the shell that every command unit uses and that depend on no other part of the shell. A command unit parses its tokens with command_args, writes errors through command_feedback, tracks paging through pagination_context, and issues its NATS call through the do_auth_request helper in request_helpers.hpp. The part also carries history_diff_renderer, which renders the version-diff output shared by the history verbs.

The part links ores.nats and ores.history.api and nothing above them. It does not link ores.shell.application, so a new adapter part can depend on the shell plumbing without pulling in the REPL host.

• Free-form token vectors from the command layer, parsed by parse_args.
• The logged-in NATS session, passed by reference into every helper.
• Pagination state the caller owns and threads through a request.

• command_args — the parsed positional and option token set.
• command_feedback — the stream state that marks a message as an error.
• pagination_context — per-entity page offset, total count, and list callbacks.
• do_auth_request — one typed authenticated request/response round trip.
• history_diff_renderer — formatted version-history output.

• include/ores.shell/app/command_args.hpp — token parsing.
• include/ores.shell/app/command_feedback.hpp — error stream marker.
• include/ores.shell/app/pagination_context.hpp — paging state.
• include/ores.shell/app/request_helpers.hpp — authenticated request helper.
• include/ores.shell/app/commands/history_diff_renderer.hpp — history rendering.

• ores.nats — NATS transport and the request/timeout helpers.
• ores.history.api — history protocol types for the diff renderer.
• ores.logging — logger factory.
• cli — the menu and handler types the command layer registers against.

• ores.shell — the composite this part belongs to.
• Shell recipes — the how-to recipes for ores-shell usage, and the single source of truth for the generated .ores script library (projects/ores.shell/scripts/library/).