CoreRasurae 4fe14c5b77 feat(agents): add offset-based pagination to file_read ...

`file_read` always read from position 0; `max_chars` (ADR-2030 D-3) only
bounded where the returned content stopped, so once a large file was
truncated there was no way to retrieve the next chunk short of falling
back to the `shell` tool (`tail -c +N`, `sed -n`, `dd skip=...`) — the
same class of awkward, error-prone detour ADR-2030 D-4 already eliminated
for file paths mistaken for shell commands.

Adds an optional `offset` character-position argument (default 0,
byte-for-byte identical output when omitted) to both the tool schema
(`llm_tools._BUILTIN_TOOL_SCHEMAS["file_read"]`) and the implementation
(`ToolAgent._file_read_tool`). Combined with `max_chars` it returns the
window `[offset, offset + max_chars)`, and the `[FILE_READ_SUCCESS]`
header now signals continuation: `MORE_CONTENT_AT_OFFSET: N` when more
content remains (N is the exact next offset, so callers never compute
`offset + max_chars` themselves), or `NO_MORE_CONTENT_AT_OFFSET: N` when
the requested offset is at or beyond end-of-file — a success response
with empty content, not an error, since that is the expected terminal
state of a correctly-paginating caller. Negative or non-integer offsets
raise `ExecutionError`, mirroring the existing `max_chars` validation
pattern.

See docs/adr/ADR-2033-file-read-offset-pagination.md for the full set of
design decisions, including why directory-listing pagination and
byte-level seeking are deferred to a future issue.

ISSUES CLOSED: #83

2026-07-31 08:53:31 +00:00

..

mocks

feat(ActorResult): implement ActorResult and NodeUsage types; capture per-node token counts from LangChain responses

2026-06-11 03:05:20 +00:00

steps

feat(agents): add offset-based pagination to file_read

2026-07-31 08:53:31 +00:00

actor_result_token_counting.feature

feat(ActorResult): implement ActorResult and NodeUsage types; capture per-node token counts from LangChain responses

2026-06-11 03:05:20 +00:00

agent_modules_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

agent_templates_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

agents_base_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

agents_base_final_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

application_core_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

application_coverage_gaps.feature

feat(agents): add tool_agent_class parameter to AgentFactory and create_executor

2026-07-08 09:23:34 +00:00

application_direct_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

application_interactive_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

application_missing_lines_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

application_utilities.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

bridge_coverage_gaps.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

bridge_final_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

bridge_remaining_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

bridge_source_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

cache_coverage.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

chain_agent_comprehensive.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

complex_templates.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

composite_agent_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_core_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_module_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_parser_comprehensive_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_parser_coverage_gaps.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_parser_missing_lines_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

config_specific_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

configuration_management.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

context_manager.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

coverage_final.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

coverage_gaps.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

credential_executor_validation.feature

feat(credentials): refactor LLMAgent/AgentFactory for per-request credential injection and extended provider routing

2026-06-08 11:10:46 +00:00

credential_injection.feature

fix(llmagent): do not close shared cached httpx clients in cleanup()

2026-06-17 17:19:44 +00:00

decorators_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

deferred_template_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

dynamic_router_coverage.feature

test(coverage): add BDD unit tests to close coverage gap toward 97%

2026-06-09 16:06:32 +01:00

enhanced_registry_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

environment.py

fix(graph): enforce USD budget at each agent invocation with pre-flight gate

2026-07-12 19:51:39 +01:00

error_verbosity.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

execute_stream.feature

fix(graph): enforce USD budget at each agent invocation with pre-flight gate

2026-07-12 19:51:39 +01:00

execution_limits.feature

fix(graph): enforce USD budget at each agent invocation with pre-flight gate

2026-07-12 19:51:39 +01:00

final_coverage_push.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

graph_templates_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

graph_templates_direct_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

graph_tool_node_execution.feature

feat(langgraph): implement real type:tool graph node execution via ToolAgent dispatch

2026-07-09 14:06:59 +00:00

inline_jinja_handler_direct.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

inline_jinja_handler_specific.feature.backup

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

inline_yaml_jinja_complete_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

inline_yaml_jinja_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

inline_yaml_jinja_coverage.feature.backup

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

inline_yaml_jinja_enhanced_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

jinja_yaml_preprocessor_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

jinja_yaml_preprocessor_focused.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

langgraph_agent_nodes.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_bridge_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

langgraph_bridge_direct_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

langgraph_conditional_routing.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_core_fixed.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_core.feature.disabled

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_graph_comprehensive.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_graph_edge_cases.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_graph_final_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_nodes_optimized.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

langgraph_rxpy_operator.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_state_management.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

langgraph_visualization.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

llm_agent_config_validation.feature

test(unit): increase BDD coverage to 97% for registry, LLM, YAML template error branches

2026-06-15 23:13:46 +01:00

llm_agent_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

llm_agent_retry.feature

feat(agents): add LLM agent retry mechanisms with exponential backoff

2026-07-03 16:00:11 +01:00

llm_agent_stream_tool_calls.feature

feat(agents): add tool-call support to LLMAgent.stream_message

2026-07-02 07:47:39 +00:00

llm_agent_tool_calling.feature

fix(actors): llm token consumption undercounted

2026-07-01 14:55:58 +01:00

llm_agent_tool_loop.feature

fix(graph): enforce USD budget at each agent invocation with pre-flight gate

2026-07-12 19:51:39 +01:00

llm_cleanup_shared_client.feature

fix(llmagent): do not close shared cached httpx clients in cleanup()

2026-06-17 17:19:44 +00:00

llm_imports_coverage.feature

feat(credentials): refactor LLMAgent/AgentFactory for per-request credential injection and extended provider routing

2026-06-08 11:10:46 +00:00

llm_missing_coverage.feature

feat(agents): implement multi-turn tool-call loop and sandbox improvements

2026-06-23 12:39:20 +01:00

llm_provider_url_canonicalization.feature

test(unit): increase BDD coverage to 97% for registry, LLM, YAML template error branches

2026-06-15 23:13:46 +01:00

llm_system_prompt_context_rendering.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

llm_tools_coverage.feature

feat(agents): surface timeout budget in tool schemas and errors

2026-07-30 19:29:54 +01:00

massive_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

merge_configs.feature

feat(merge_configs): expose public merge_configs(*dicts) API per §3.1 deep-merge algorithm

2026-06-03 14:44:18 +00:00

network_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

nodes_coverage_gaps.feature

fix(nodes): propagate ExecutionError from retry mechanism instead of swallowing it

2026-07-07 13:47:02 +01:00

nodes_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

progress_coverage.feature

test(coverage): add BDD unit tests to close coverage gap toward 97%

2026-06-09 16:06:32 +01:00

pure_graph_coverage_gaps_v2.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

pure_graph_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

reactive_agents.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

reactive_application.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

reactive_streams.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

registry_cache.feature

feat(registry): implement RegistryCache with LRU eviction and TTL

2026-06-11 19:26:04 +01:00

registry_canonicalization.feature

feat(registry): implement Canonicalizer with NFC normalization and SHA-1 hashing

2026-06-10 11:33:50 +01:00

registry_core_types.feature

feat(registry): add PackageType, PackageId, PackageReference, PackageContent core types

2026-06-06 19:21:22 +01:00

registry_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

registry_exceptions.feature

feat(registry): implement RegistryError hierarchy with typed exceptions

2026-06-11 20:44:54 +01:00

registry_http_client.feature

feat(registry): implement RegistryError hierarchy with typed exceptions

2026-06-11 20:44:54 +01:00

registry_local_store.feature

feat(registry): implement local namespace reference resolution

2026-06-12 17:11:35 +01:00

registry_reference_resolver_coverage.feature

feat(registry): extend TemplateType and integrate PackageReference into template system

2026-06-10 12:50:38 +01:00

registry_reference_resolver.feature

feat(registry): implement local namespace reference resolution

2026-06-12 17:11:35 +01:00

registry_resolver_errors.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

registry_template_integration.feature

feat(registry): implement local namespace reference resolution

2026-06-12 17:11:35 +01:00

road_to_97.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

route_bridge_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

route_coverage_comprehensive.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

route_graph_config_coverage.feature

test(coverage): add BDD unit tests to close coverage gap toward 97%

2026-06-09 16:06:32 +01:00

route_missing_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

routing_prefix_stripping.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

runtime_coverage.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

runtime_dispatch_coverage.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

runtime_extended_coverage.feature

feat(create_executor): implement create_executor() factory and Executor.execute() returning ActorResult

2026-06-10 09:41:39 +00:00

simple_loaders.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

smart_yaml_loader_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

state_comprehensive_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

state_missing_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

stderr_suppression.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

stream_router_advanced.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

stream_router_comprehensive.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

stream_router_coverage_gaps.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

stream_router_final_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

stream_templates_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

template_configurations.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

template_loaders_coverage.feature.disabled

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

template_renderer_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

template_store_coverage.feature

feat(registry): extend TemplateType and integrate PackageReference into template system

2026-06-10 12:50:38 +01:00

templates_base_coverage.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

templates_base_remaining.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

templates_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

tool_agent_class_injection.feature

feat(agents): add tool_agent_class parameter to AgentFactory and create_executor

2026-07-08 09:23:34 +00:00

tool_agent_context_updates.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

tool_agent_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

tool_agent.feature

feat(agents): surface timeout budget in tool schemas and errors

2026-07-30 19:29:54 +01:00

tool_coverage_gaps.feature

feat(agents): add offset-based pagination to file_read

2026-07-31 08:53:31 +00:00

unified_routes.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

unit_json_sanitization.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

unit_temperature_override.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

unit_tool_command_processing.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

validate_dict.feature

feat(validate_dict): expose public validate_dict(config_dict, platform_limits) API

2026-06-05 09:23:44 +00:00

validation_actor_coverage.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

verbose_logging_levels.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_jinja_loader_specific.feature

test(coverage): add coverage scenarios for pre-existing code paths

2026-06-23 10:49:16 +01:00

yaml_preprocessor_comprehensive.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00

yaml_template_engine_comprehensive.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_engine_coverage_gaps.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_engine_missing_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_engine_specific_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_engine_targeted_coverage.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_engine.feature

style: apply end-of-file and whitespace fixes across feature files

2026-05-27 21:41:03 +00:00

yaml_template_non_dict_errors.feature

test(unit): increase BDD coverage to 97% for registry, LLM, YAML template error branches

2026-06-15 23:13:46 +01:00

yte_remaining_coverage.feature

test: add coverage gap tests improving coverage from 81.4% to 96.90%

2026-06-02 20:02:01 +01:00