mirror of
https://github.com/morluto/rea.git
synced 2026-11-15 19:23:24 +00:00
118 lines
4.9 KiB
TypeScript
118 lines
4.9 KiB
TypeScript
/** Runtime policy overrides, separate from target state and launch environment. */
|
|
export interface AnalysisSettingValues {
|
|
readonly "asar.max_header_bytes": number;
|
|
readonly "asar.max_listing_bytes": number;
|
|
readonly "ghidra.value_flow_max_operations": number;
|
|
readonly "ghidra.value_flow_max_inputs_per_operation": number;
|
|
readonly "ghidra.value_flow_max_edges": number;
|
|
readonly "ghidra.startup_timeout_ms": number;
|
|
readonly "hopper.startup_timeout_ms": number;
|
|
readonly "ghidra.decompile_timeout_seconds": number | null;
|
|
readonly "ghidra.decompile_max_payload_mib": number | null;
|
|
readonly "jadx.operation_timeout_ms": number;
|
|
readonly "regex.matching_deadline_ms": number;
|
|
readonly "regex.worker_heap_request_mib": number;
|
|
readonly "capture.decoder_old_generation_mib": number;
|
|
readonly "capture.packet_json_expansion_bytes": number;
|
|
readonly "javascript.analysis_timeout_ms": number;
|
|
readonly "javascript.max_heap_mb": number;
|
|
readonly "wasm.command_timeout_ms": number;
|
|
readonly "native.matching_representation_bytes": number;
|
|
readonly "bridge.max_request_bytes": number;
|
|
readonly "bridge.max_reply_bytes": number;
|
|
readonly "debugger.command_deadline_ms": number;
|
|
readonly "debugger.max_command_output_bytes": number;
|
|
readonly "hopper.caller_scan_budget_ms": number;
|
|
readonly "jeb.mcp_timeout_ms": number;
|
|
readonly "kuna.project_timeout_ms": number;
|
|
readonly "kuna.function_timeout_ms": number;
|
|
readonly "pwntools.max_input_bytes": number;
|
|
readonly "windows.change_time_drift_ms": number;
|
|
readonly "windows.change_time_settle_poll_ms": number;
|
|
readonly "windows.change_time_settle_max_polls": number;
|
|
}
|
|
export type AnalysisSettingId = keyof AnalysisSettingValues;
|
|
export interface AnalysisSettingsSnapshot {
|
|
readonly revision: number;
|
|
readonly overrides: Readonly<Partial<AnalysisSettingValues>>;
|
|
}
|
|
/** Injected by the runtime owner; reads the accepted operation's immutable snapshot. */
|
|
export type AnalysisSettingsReader = () => AnalysisSettingsSnapshot;
|
|
|
|
/**
|
|
* Whether `update_analysis_settings` can change the active value.
|
|
* `runtime` applies inside this process. `restart` stays at the value this
|
|
* process already started with. A limit fact uses `parameter` when its value
|
|
* is adjustable through a per-call argument; its source is recorded separately.
|
|
*/
|
|
export type AnalysisSettingUpdateMode = "runtime" | "restart";
|
|
|
|
/** Limit facts supplied by the failing owner, never inferred from error prose. */
|
|
export interface AnalysisSettingLimit {
|
|
readonly setting: AnalysisSettingId;
|
|
readonly effective_value: number | null;
|
|
readonly unit: "bytes" | "ms" | "seconds" | "MiB" | "count";
|
|
readonly minimum: number;
|
|
readonly maximum: number;
|
|
readonly source?: "default" | "setting" | "runtime" | "request";
|
|
readonly applies_at: "next_operation" | "next_worker" | "next_startup";
|
|
readonly agent_editable: true;
|
|
readonly scope: "rea-runtime";
|
|
readonly update_mode: AnalysisSettingUpdateMode | "parameter";
|
|
/**
|
|
* True only when a configured value is not the one this process is using.
|
|
* The reported effective value is active, so limit errors leave this false.
|
|
*/
|
|
readonly pending_restart: false;
|
|
readonly required_value?: number;
|
|
readonly parameter?: string;
|
|
}
|
|
|
|
/**
|
|
* The same limit for a caller whose REA runtime ended with one invocation. No
|
|
* runtime override can reach it; a new invocation reads the launch
|
|
* environment seed or the per-call argument. The caller can still choose that
|
|
* value, and no running REA process needs a restart.
|
|
*/
|
|
export interface AnalysisInvocationSettingLimit extends Omit<
|
|
AnalysisSettingLimit,
|
|
"applies_at" | "scope"
|
|
> {
|
|
readonly applies_at: "next_invocation";
|
|
readonly scope: "rea-invocation";
|
|
/** Launch-environment seed that a new invocation reads, when one exists. */
|
|
readonly environment?: string;
|
|
}
|
|
|
|
/**
|
|
* A limit whose control is not a registered analysis setting: a per-call
|
|
* request parameter, or an environment variable REA reads when it starts. A
|
|
* limit without `control_kind` is an `AnalysisSettingLimit` named by
|
|
* `setting`. `update_analysis_settings` changes neither control.
|
|
*/
|
|
export type AnalysisControlLimit = {
|
|
readonly effective_value: number;
|
|
readonly unit: AnalysisSettingLimit["unit"];
|
|
readonly minimum: number;
|
|
readonly maximum: number;
|
|
/** Value used when the control is omitted. */
|
|
readonly default_value: number;
|
|
} & (
|
|
| {
|
|
readonly control_kind: "parameter";
|
|
readonly parameter: string;
|
|
/** CLI spelling of the same per-call parameter. */
|
|
readonly cli_flag: string;
|
|
readonly applies_at: "next_call";
|
|
}
|
|
| {
|
|
readonly control_kind: "environment";
|
|
readonly environment: string;
|
|
/** A one-invocation caller's next invocation reads it without a restart. */
|
|
readonly applies_at: "next_startup" | "next_invocation";
|
|
}
|
|
);
|
|
|
|
/** The limit an error binds: a registered setting, or a parameter or environment control. */
|
|
export type AnalysisLimit = AnalysisSettingLimit | AnalysisControlLimit;
|