Skip to main content

Crate runx_runtime

Crate runx_runtime 

Source
Expand description

Native Rust runtime skeleton for runx execution.

The runtime owns impure boundaries: filesystem reads, subprocess execution, sandbox preparation, host reporting, and receipt emission. Pure parser/core/receipt crates stay upstream of this crate.

The root exports are a facade for CLI, SDK, and test consumers. Helper surfaces stay under their owning modules: harness replay under harness, receipt stores under receipts, adapter protocol under adapter, and runtime orchestration under runner or orchestrator.

Re-exports§

pub use execution::harness;
pub use execution::orchestrator;
pub use execution::runner;
pub use execution::skill_front;
pub use adapter::FanoutExecutionMode;
pub use adapter::InvocationStatus;
pub use adapter::SkillAdapter;
pub use adapter::SkillInvocation;
pub use adapter::SkillOutput;
pub use approval::ApprovalError;
pub use approval::LocalApprovalGateResolver;
pub use approval::request_approval;
pub use config::ConfigError;
pub use config::ConfigKey;
pub use config::LocalProfileSource;
pub use config::ManagedAgentConfig;
pub use config::RunxAgentConfig;
pub use config::RunxConfigFile;
pub use config::RunxPublicConfig;
pub use config::load_local_agent_api_key;
pub use config::load_local_public_api_token;
pub use config::load_managed_agent_config;
pub use config::load_runx_config_file;
pub use config::lookup_runx_config_value;
pub use config::managed_agent_provider;
pub use config::mask_runx_config_file;
pub use config::parse_config_key;
pub use config::resolve_local_skill_profile;
pub use config::resolve_path_from_user_input;
pub use config::resolve_runx_global_home_dir;
pub use config::resolve_runx_home_dir;
pub use config::resolve_runx_workspace_base;
pub use config::update_runx_config_value;
pub use config::write_runx_config_file;
pub use credentials::CredentialDelivery;
pub use credentials::CredentialDeliveryError;
pub use credentials::CredentialDeliveryProfile;
pub use credentials::CredentialMaterialRole;
pub use credentials::CredentialResolution;
pub use credentials::CredentialResolutionRequest;
pub use credentials::CredentialSupervisor;
pub use credentials::InMemoryMaterialResolver;
pub use credentials::MaterialCredentialSupervisor;
pub use credentials::MaterialResolver;
pub use credentials::ResolvedCredentialMaterial;
pub use credentials::SecretEnv;
pub use credentials::SecretString;
pub use dev::DevLoopOptions;
pub use dev::DevWatchOptions;
pub use dev::DevWatchTrigger;
pub use dev::PollingDevWatcher;
pub use dev::dev_receipt_metadata;
pub use dev::discover_fixture_paths;
pub use dev::render_dev_result;
pub use dev::run_dev_once;
pub use dev::should_ignore_dev_watch_path;
pub use doctor::DoctorOptions;
pub use doctor::default_doctor_options;
pub use doctor::run_doctor;
pub use effects::EffectAdmission;
pub use effects::EffectMetadataRefreshRequest;
pub use effects::EffectOutputRequest;
pub use effects::EffectReceiptRequest;
pub use effects::EffectReplay;
pub use effects::EffectReplayOutputRequest;
pub use effects::EffectReplayReceiptRequest;
pub use effects::EffectStepRequest;
pub use effects::PROVIDER_PERMISSION_EFFECT_FAMILY;
pub use effects::PROVIDER_PERMISSION_GRANT_ID_ENV;
pub use effects::PROVIDER_PERMISSION_GRANTED_SCOPES_ENV;
pub use effects::ProviderPermissionAdmission;
pub use effects::ProviderPermissionEffect;
pub use effects::RuntimeEffect;
pub use effects::RuntimeEffectError;
pub use effects::RuntimeEffectRegistry;
pub use effects::insert_effect_verification_ref;
pub use error::RuntimeError;
pub use harness::HarnessExpectedStatus;
pub use harness::HarnessFixtureError;
pub use harness::HarnessFixtureKind;
pub use harness::HarnessReplayError;
pub use harness::HarnessReplayOutput;
pub use harness::load_harness_fixture;
pub use harness::parse_harness_fixture;
pub use harness::run_harness_fixture;
pub use harness::run_harness_fixture_with_adapter;
pub use harness::run_harness_fixture_with_env;
pub use host::Host;
pub use host::NoopHost;
pub use journal::ExecutionJournal;
pub use list::RunxListOptions;
pub use list::list_authoring_primitives;
pub use orchestrator::GraphRunRequest;
pub use orchestrator::HarnessRunRequest;
pub use orchestrator::InlineHarnessRequest;
pub use orchestrator::LocalOrchestrator;
pub use orchestrator::OrchestratorError;
pub use orchestrator::RunContinuation;
pub use orchestrator::RunRequest;
pub use orchestrator::RunResult;
pub use orchestrator::RunStatus;
pub use orchestrator::SkillRunRequest;
pub use parser_eval::ParserEvalError;
pub use parser_eval::ParserEvalOutput;
pub use parser_eval::evaluate_parser_document_str;
pub use receipts::paths::INIT_CWD_ENV;
pub use receipts::paths::RUNTIME_RECEIPTS_DIR_CONFIG_KEY;
pub use receipts::paths::RUNX_CWD_ENV;
pub use receipts::paths::RUNX_PROJECT_DIR_ENV;
pub use receipts::paths::RUNX_RECEIPT_DIR_ENV;
pub use receipts::paths::ReceiptPathInputs;
pub use receipts::paths::ReceiptPathSource;
pub use receipts::paths::ReceiptStoreLabel;
pub use receipts::paths::ResolvedReceiptPath;
pub use receipts::paths::RuntimeReceiptConfig;
pub use receipts::paths::resolve_project_runx_dir;
pub use receipts::paths::resolve_receipt_path;
pub use receipts::paths::resolve_workspace_base;
pub use receipts::paths::safe_receipt_store_label;
pub use receipts::store::LocalReceiptStore;
pub use receipts::store::ReceiptStoreError;
pub use receipts::store::ReceiptStoreIndex;
pub use receipts::store::ReceiptStoreIndexEntry;
pub use receipts::tree::RuntimeReceiptResolver;
pub use receipts::tree::validate_runtime_receipt_tree;
pub use receipts::tree::verify_runtime_receipt_tree;
pub use receipts::tree::verify_runtime_receipt_tree_with_policy;
pub use receipts::Ed25519ReceiptSigner;
pub use receipts::Ed25519ReceiptVerifier;
pub use receipts::ProductionReceiptKey;
pub use receipts::RUNX_RECEIPT_SIGN_ED25519_SEED_BASE64_ENV;
pub use receipts::RUNX_RECEIPT_SIGN_ISSUER_TYPE_ENV;
pub use receipts::RUNX_RECEIPT_SIGN_KID_ENV;
pub use receipts::RuntimeReceiptSignatureConfig;
pub use receipts::RuntimeReceiptSignaturePolicy;
pub use receipts::RuntimeReceiptSigner;
pub use receipts::RuntimeReceiptSigningError;
pub use redaction::redact_sensitive_text;
pub use registry::RegistryInstallMetadataInput;
pub use registry::registry_install_receipt_metadata;
pub use runner::GraphCheckpoint;
pub use runner::GraphRun;
pub use runner::RUNX_MAX_FANOUT_CONCURRENCY_ENV;
pub use runner::RUNX_RUN_ID_ENV;
pub use runner::Runtime;
pub use runner::RuntimeOptions;
pub use runner::StepRun;
pub use scaffold::InitAction;
pub use scaffold::InitGeneratedValues;
pub use scaffold::RunxInitOptions;
pub use scaffold::RunxInitResult;
pub use scaffold::RunxNewOptions;
pub use scaffold::RunxNewResult;
pub use scaffold::ScaffoldError;
pub use scaffold::runx_init;
pub use scaffold::sanitize_runx_package_name;
pub use scaffold::scaffold_runx_package;
pub use skill_front::InlineHarnessReport;
pub use tool_catalogs::ToolBuildOptions;
pub use tool_catalogs::ToolCatalogError;
pub use tool_catalogs::ToolInspectOptions;
pub use tool_catalogs::ToolSearchOptions;
pub use tool_catalogs::build_tool_catalogs;
pub use tool_catalogs::inspect_tool;
pub use tool_catalogs::search_tools;

Modules§

adapter
approval
config
credentials
dev
Native runtime support for runx dev fixture loops.
doctor
effects
error
execution
Execution cluster.
export
host
journal
kernel_eval
list
parser_eval
receipts
Receipts cluster.
redaction
registry
sandbox
scaffold
tool_catalogs

Structs§

DevFixtureResult
DevReport
ReceiptTreeConfig
RunxListItem
SkillSource

Enums§

DevFixtureStatus
DevReportStatus
RunxListItemKind
RunxListRequestedKind
RunxListStatus

Constants§

PACKAGE_NAME

Functions§

parse_runner_manifest_yaml
validate_runner_manifest