{ "name": "jev-harness", "distribution": "apixly-jev-harness", "python_import": "apixly_jev_harness", "version": "0.1.17", "parameter_binding": "staged_candidate_choice", "argument_parsing": { "scope": "all command parsers when argparse reports an error", "failure_phase": "arguments", "failure_code": "invalid_command_arguments", "failure_exit_code": 2, "script_loaded_on_failure": false, "model_calls_on_failure": 0, "raw_argument_values": false, "raw_error_message": false, "help": "text and SystemExit(0); original precedence", "long_option_abbreviation": "unchanged", "configuration_validation": "separate after parsing", "arbitrary_argv_types_supported": false }, "tool_selection": { "scope": "next_step", "decision_stage_field": "decision_stage", "requirements_source": "caller_task_contract", "candidate_order_is_priority": false, "direct_choice_without_loop_marker": "unchanged" }, "commands": { "skill": { "offline": true }, "spec": { "offline": true }, "init-task": { "required": [ "script" ], "offline": true }, "check-task": { "required": [ "script" ], "offline": true, "scope": "parse/compile/top-level assignment only", "checks": [ "utf8_decode", "ast_parse", "python_compile", "top_level_assignment" ], "python_scope": "current_interpreter", "source_execution": false, "runtime_validation": false, "source_warning_code": "python_source_warning" }, "run": { "required": [ "script", "goal" ], "billable": true, "task_output": { "policy": "discard", "scope": "python_streams", "channels": [ "stdout", "stderr" ], "counters": [ "characters", "binary_bytes" ], "characters_unit": "Unicode code points, not encoded bytes", "metadata_field": "task_output", "metadata_when": "nonzero intercepted output", "retains_content": false, "sdk_behavior": "unchanged", "fd_isolation": false, "overlapping_cli_runs": "unsupported process-global redirection", "base_exception_terminal_guarantee": false, "interrupt_exit": { "KeyboardInterrupt": 130, "SystemExit": "exact integer 1..255 preserved; otherwise 1", "terminal_packet": false, "raw_exception_text": false, "effects_and_usage_proven": false } }, "configuration_preflight": { "before_task_module_loading": true, "shared_with_engine": true, "defaults_for": "None only", "finite_json": [ "inputs", "context", "messages" ], "failure_code": "invalid_run_configuration", "failure_phase": "configuration", "script_loaded_on_failure": false, "model_calls_on_failure": 0, "sandbox": false }, "optional": [ "inputs", "context", "messages", "required-context", "max-steps", "timeout", "archive" ] } }, "script_contract": { "export": "workflow", "type": "Task or Workflow", "trusted_python": true, "callbacks": [ "observe", "verify" ], "tool_registration": "Task.tool", "parameters": { "Parameter": [ "description", "choices", "depends_on" ], "Option": [ "id", "description", "value" ] } }, "task_action_identity": { "scope": "Task.bind_and_execute_against_latest_offered_snapshot", "action_type": "exact_Action", "id_before_lookup": "builtin_str", "fields": [ "id", "description", "params", "irreversible" ], "comparison": "shared_builtin_value_semantics", "boolean_number_equality": false, "finite_int_float_equality": true, "containers": "same_kind_recursive", "dictionary_keys": "typed_null_boolean_number_string", "unsupported_values_and_subclasses": "do_not_match; normalize_before_offering", "global_action_equality_changed": false, "object_or_byte_identity": false, "direct_errors": [ "action_not_offered", "action_not_bound" ], "engine_guard_rejection_always_failed": false, "execute_window": "existing_execution_uncertain_handling", "tool_body_not_entered_proves_global_zero_effects": false, "authorization_or_target_verification": false, "arbitrary_python_hook_execution_prohibited": false }, "wall_budget": { "policy": "cooperative_checks; callbacks_bound_their_own_io", "before_candidate_collection": "rechecked_after_false_verification", "late_verified_success": "done", "post_verification_step_limit_precedence": true, "callbacks_forcibly_interrupted": false, "strict_whole_operation_deadline": false, "prior_usage_and_effects": "preserved", "candidate_timeout_terminal": "budget_exceeded", "skipped_candidate_diagnostics": "unavailable; not guessed" }, "parameter_snapshots": { "scope": "each_valid_parameter_domain", "stage": "after_domain_validation_before_selection", "policy": "deepcopy_all_options_and_values", "strategies": [ "staged", "joint" ], "dynamic_provider_identity": "preserved", "provider_results_cached": false, "staged_preview_reused_for_binding": false, "atomic_acquisition": false, "external_target_freshness_proven": false, "custom_deepcopy_behavior_proven": false, "copy_failure": "existing error/stop handling; no aliased-domain fallback", "cost_scope": "every valid option value, including private and unselected values" }, "callbacks": { "execution": "synchronous", "roles": [ "authorize", "available", "bind", "candidates", "choices", "context_policy", "execute", "observe", "result_context", "verify" ], "rejected_declared_kinds": [ "async_generator", "coroutine", "generator" ], "generator_exception": "Workflow.candidates", "provider_positional_arguments": [ 2, 3 ], "provider_preferred_arity": 3, "provider_outer_signature": "inspect.signature(follow_wrapped=False)", "provider_generic_wrapped_contract": "advertised signature and actual bind", "provider_generic_rule": "VAR_POSITIONAL and fewer than three explicit positional parameters", "provider_explicit_signature_override": "respected; does not prove behavior", "tool_signature_registration": "unchanged", "provider_dynamic_identity": "preserved", "provider_static_choices": "deepcopied_at_registration", "provider_result_cache": false, "admission_invokes_body": false, "return_type_proven": false, "error_codes": [ "provider_signature_unsupported", "synchronous_callback_required" ], "fallback_error_code": "callback_contract_error", "terminal_error_field": "contract_error", "raw_exception_text": false, "trusted_module_loading": "may_have_effects_before_registration", "async_runtime": false }, "context": [ "goal", "facts", "messages", "observation", "history", "compacted_steps", "budgets", "decision_stage" ], "context_admission": { "scope": "loop_shared_context", "unit": "json_characters", "limit": 15000, "serialization": "json.dumps(context, ensure_ascii=False) with default separators", "maximum_is_inclusive": true, "stages": [ "context_projection", "tool_selection", "parameter_selection" ], "metadata_field": "context_budget", "metadata_fields": [ "scope", "stage", "unit", "limit", "observed" ], "failure_reason": "context_budget_exceeded", "automatic_truncation": false, "raw_context_in_failure": false, "candidate_record_text_in_budget": false, "selection_question_in_budget": false, "full_prompt_or_token_budget": false, "direct_decide_admission": "unchanged", "call_telemetry_fields": [ "context_characters", "context_character_limit", "context_bytes" ], "prior_calls_and_effects_possible": true }, "progress": { "unchanged_observation_requires": "non_none_admitted_result", "duplicate_invocation": { "scope": "single_run", "key": [ "observation", "action_id", "bound_parameters" ], "status": "blocked", "reason": "repeated_action_state", "effect": "not_executed" }, "identical_fixed_observation_polling": false }, "verification": { "independent": true, "strict_bool": true, "helper": "verify_state", "helper_requires": "nonempty_text_or_control_condition", "missing_control_fields": "do_not_match", "observed_text_requires": "str; otherwise does not match", "helper_expected_text_requires": "built-in str or None; subclasses rejected before strip", "boolean_number_equality": false, "numeric_int_float_equality": true, "helper_value_types": [ "None", "bool", "int", "finite float", "str", "list", "tuple", "dict" ], "helper_type_scope": "exact built-in types; subclasses are unsupported", "helper_container_comparison": "recursive; list and tuple do not cross-match", "helper_dictionary_keys": "typed None/bool/finite number/str; bool distinct from number", "helper_control_records": "built-in dict with built-in str field keys", "helper_expected_control_label": "built-in str", "helper_unknown_control_record": "does not match; not filtered to establish uniqueness", "helper_observation_root": "built-in dict with built-in str field keys; otherwise does not match", "unsupported_helper_values": "do not match; custom verifier required", "custom_verifier": "unchanged caller-owned strict bool" }, "execution_reconciliation": { "action_id_scope": "current_pending_bound_action", "decision_stop_during_execution": "execution_uncertain_with_action_id", "infer_action_id_from_history": false, "action_id_proves_effect_success": false, "action_id_is_idempotency_key": false, "automatic_retry": false, "prior_usage": "retained including unknown", "recovery": "inspect private journal and target state before a new run" }, "transport_counters": { "metadata_field": "telemetry.owned_transport", "scope": "run_owned_provider_client", "snapshot": "terminal_finish", "snapshot_timing": "before journal terminal write and client close", "counters": [ "request_attempts", "clients_created", "client_reuses" ], "measurement": "Client.stats difference from Session start; includes SDK retries", "requests_semantics": "unchanged sum of decision telemetry.requests; native Choice reports packed requests", "missing_or_invalid_counter": "null; never inferred zero", "decreasing_counter": "null when below start or a witnessed Session.run snapshot", "no_active_session": "metadata omitted; no zero inference", "server_received_or_billable_proof": false, "includes_other_tool_network": false, "tcp_connection_proof": false, "usage_handling": "unchanged; unknown usage remains unknown" }, "request_planning": { "scope": "current_selection", "metadata_field": "telemetry.planning or telemetry.calls[].planning", "phase": "request_planning", "empty_plan_inference_dispatched": false, "reason_codes": [ "request_needs_context", "request_needs_narrowing", "request_planning_review" ], "typed_statuses": [ "NEEDS_CONTEXT", "NEEDS_NARROWING" ], "unknown_status": "UNAVAILABLE with request_planning_review", "whole_run_zero_calls_or_effects": false, "arbitrary_validation_error_classification": false, "raw_context_or_error_text": false, "automatic_retry": false, "planner_admission_limits": "pinned upstream rules unchanged" }, "diagnostic": { "optional": true, "scope": "selection_calls", "stages": [ "tool_selection", "parameter_selection" ], "fields": [ "stage", "tool_id", "parameter", "reason_codes", "automatic_retry" ], "reason_codes": [ "below_min_confidence", "below_min_margin", "below_min_top_probability", "client_closed", "credential_file_permissions", "credentials_invalid", "credentials_missing", "decision_failed", "invalid_selection", "model_review", "no_matching_candidate", "provider_unavailable", "request_needs_context", "request_needs_narrowing", "request_planning_review", "response_invalid_usage_unknown", "response_too_large", "retry_exhausted", "selected_option_not_top", "transport_failed_usage_unknown", "unresolved_selection" ], "http_code_pattern": "http_[1-5][0-9]{2}_body_suppressed", "automatic_retry": false, "call_telemetry_stage": true, "raw_exception_text": false, "bound_values": false, "provider_transport_retry": "pinned SDK bounded policy unchanged" }, "statuses": [ "done", "needs_context", "needs_review", "needs_confirmation", "blocked", "stale", "max_steps", "budget_exceeded", "execution_uncertain", "failed" ], "exit_codes": { "0": "done or offline operation successful", "2": "parse_terminal_packet" }, "adoption": "Use for bounded tasks with semantic choices and an independent verifier. Keep exact/fixed work in code. Inspect spec, generate template, check script, run once, consume terminal result. Reconcile uncertain effects before any rerun.", "limits": { "tools": 250, "parameter_options": 253, "independent_inference_workers": 30, "max_steps_default": 20, "timeout_seconds_default": 120, "result_cache": false, "decision_context_characters": 15000 } }