# `@netscript/runtime-config`

Hot-reloadable NetScript runtime override types, loaders, watchers, and diagnostics. This page is written against the package's public surface reported by `deno doc`. For the full index of packages and plugins return to the [reference overview](https://rickylabs.github.io/netscript/reference/).

Runtime config files live under the configured runtime directory and are loaded through a version pointer named `current`. Missing files produce empty defaults so service startup can continue while operators roll out runtime overrides independently. The package exposes a single root entrypoint (`@netscript/runtime-config`); there are no sub-path exports.

## Loaders and watchers

| Symbol | Signature | Description |
| --- | --- | --- |
| `loadRuntimeConfig` | `async function loadRuntimeConfig(): Promise<RuntimeConfig>` | Load runtime overrides from the configured runtime config directory. Returns empty defaults when the directory, pointer file, or topic files are missing. |
| `watchRuntimeConfig` | `function watchRuntimeConfig(onChange: (config: RuntimeConfig) => Promise<void>, options: { signal?: AbortSignal; prefix?: string }): void` | Watch runtime config files and invoke `onChange` after debounced reloads. |

## Override accessors

| Symbol | Signature | Description |
| --- | --- | --- |
| `getJobOverride` | `function getJobOverride(config: RuntimeConfig, jobId: string): JobOverride \| undefined` | Get the override for a specific job ID. |
| `getSagaOverride` | `function getSagaOverride(config: RuntimeConfig, sagaId: string): SagaOverride \| undefined` | Get the override for a specific saga ID. |
| `getTriggerOverride` | `function getTriggerOverride(config: RuntimeConfig, triggerId: string): TriggerOverride \| undefined` | Get the override for a specific trigger ID. |
| `getRuntimeTask` | `function getRuntimeTask(config: RuntimeConfig, taskId: string): RuntimeTask \| undefined` | Get a runtime task definition by ID. |
| `isFeatureEnabled` | `function isFeatureEnabled(config: RuntimeConfig, flagId: string, defaultValue: boolean): boolean` | Check whether a feature flag is enabled, falling back when the flag is absent. |

## Diagnostics

| Symbol | Signature | Description |
| --- | --- | --- |
| `summarizeRuntimeConfig` | `function summarizeRuntimeConfig(config: RuntimeConfig, prefix: string): RuntimeConfigSummary` | Summarize active runtime overrides without emitting presentation output. |

## Configuration types

| Symbol | Kind | Description |
| --- | --- | --- |
| `RuntimeConfig` | interface | Complete runtime override snapshot (jobs, sagas, triggers, features, tasks). |
| `JobOverride` | interface | Job-level runtime override loaded from `runtime/jobs/*.json`. |
| `SagaOverride` | interface | Saga-level runtime override loaded from `runtime/sagas/*.json`. |
| `TriggerOverride` | interface | Trigger-level runtime override loaded from `runtime/triggers/*.json`. |
| `FeatureFlag` | interface | Feature flag loaded from `runtime/features/*.json`. |
| `RuntimeTask` | interface | Task definition that can be added or overridden at runtime. |

## Diagnostics types

| Symbol | Kind | Description |
| --- | --- | --- |
| `RuntimeConfigSummary` | interface | Structured summary of active runtime overrides. |
| `RuntimeConfigTriggerPathOverride` | interface | Trigger path override included in a runtime config summary. |

## Topic constants and aliases

| Symbol | Kind | Description |
| --- | --- | --- |
| `RUNTIME_CONFIG_TOPICS` | variable | Runtime config topic names backed by versioned JSON files (`jobs`, `sagas`, `triggers`, `features`, `tasks`). |
| `RUNTIME_TASK_RUNTIMES` | variable | Supported runtime task execution kinds (`deno`, `python`, `dotnet`, `cmd`, `powershell`, `shell`, `executable`). |
| `RuntimeConfigTopic` | type alias | Runtime config topic name (a member of `RUNTIME_CONFIG_TOPICS`). |
| `RuntimeTaskRuntime` | type alias | Runtime task execution kind (a member of `RUNTIME_TASK_RUNTIMES`). |

---

Back to the [reference overview](https://rickylabs.github.io/netscript/reference/).