Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
Merge remote-tracking branch 'origin/dev' into fix/issue-825-storage-layout-v2
Alfredo Lopezd6a8ecb861a3
diff --cc docs/README.mdindex b5cbba95d,d60084a68..312256884--- a/docs/README.md+++ b/docs/README.md@@@ -46,26 -47,43 +47,44 @@@ say so. [Design records](#design-record## How-to guides- | Doc | Description |- | ----------------------------------------------------------------------------- | ---------------------------------------------------------- |- | [Connect Telegram](how-to/connect-telegram.md) | Minikube env or CRD channel path |- | [Connect Slack](how-to/connect-slack.md) | Slack app scopes, request URL, conversation verification |- | [Connect Microsoft Teams](how-to/connect-teams.md) | Teams CLI bot registration, endpoint, conversation verify |- | [Configure approvals](how-to/configure-approvals.md) | Human-in-the-loop tool gates |- | [Add an MCP server](how-to/add-mcp-server.md) | Dev-mode JSON or CRD allowlist path |- | [LLM providers overview](llm-providers/README.md) | Which providers are supported and how they fit together |- | [Configure LLM providers](deploy/llm-providers.md) | Credentials, model allowlist, per-session selector |- | [Add an LLM provider](llm-providers/adding-a-provider.md) | Data-only vs driver-based integration paths |- | [Desktop setup & updates](how-to/desktop-setup-and-updates.md) | Environments, invitation setup, updates |- | [Member invitations on self-hosted](how-to/member-invitations-self-hosted.md) | Hosted mode zero-config emails vs running your own service |- | [Track usage & set budgets](how-to/token-budgets-and-usage.md) | Enable budgets, scope, block vs warn |- | [Connect to the registry](how-to/connect-to-registry.md) | Self-hosted registry connect flow |- | [Publish a plugin](how-to/publish-plugin-to-registry.md) | Publish under your org with an `efrk_` key |- | [Shared & global files](how-to/shared-and-global-files.md) | Team workspaces (SFS) and the brokered drive (GFS) |- | [Minikube full stack](deploy/minikube.md) | Local Kubernetes platform |- | [Production notes](deploy/production.md) | Checklist and in-repo deploy assets |- | [Host PVC layout upgrade](deploy/host-pvc-layout-upgrade.md) | Upgrading stateless Hosts from v0.10.x / v0.11.x |- | [WorkflowRecipes operations](deploy/workflow-recipes-guide.md) | Recipe ops, RBAC, debugging |+ | Doc | Description |+ | ----------------------------------------------------------------------------- | -------------------------------------------------------------- |+ | [Connect Telegram](how-to/connect-telegram.md) | Minikube env or CRD channel path |+ | [Connect Slack](how-to/connect-slack.md) | Slack app scopes, request URL, conversation verification |+ | [Connect Microsoft Teams](how-to/connect-teams.md) | Teams CLI bot registration, endpoint, conversation verify |+ | [Configure approvals](how-to/configure-approvals.md) | Human-in-the-loop tool gates |+ | [Add an MCP server](how-to/add-mcp-server.md) | Dev-mode JSON, CRD, or Control UI path |+ | [Desktop setup & updates](how-to/desktop-setup-and-updates.md) | Environments, invitation setup, updates |+ | [Member invitations on self-hosted](how-to/member-invitations-self-hosted.md) | Hosted mode zero-config emails vs running your own service |+ | [Track usage & set budgets](how-to/token-budgets-and-usage.md) | Enable budgets, scope, block vs warn |+ | [Connect to the registry](how-to/connect-to-registry.md) | Self-hosted registry connect flow |+ | [Publish a plugin](how-to/publish-plugin-to-registry.md) | Publish under your org with an `efrk_` key |+ | [Shared & global files](how-to/shared-and-global-files.md) | Team workspaces (SFS) and the brokered drive (EvenDrive / GFS) |++ ## LLM providers++ | Doc | Description |+ | --------------------------------------------------------- | ---------------------------------------------------------------------- |+ | [LLM providers overview](llm-providers/README.md) | The 24 providers, mental model, support matrix, request flow, fallback |+ | [Configure LLM providers](deploy/llm-providers.md) | Operator guide: credentials, Vertex/Bedrock/Azure, allowlist, selector |+ | [Add an LLM provider](llm-providers/adding-a-provider.md) | Data-only vs driver-based integration paths |++ ## Deploy & operate++ | Doc | Description |+ | -------------------------------------------------------------------------------- | ---------------------------------------------------------------- |+ | [Minikube full stack](deploy/minikube.md) | In-depth reference for the local platform |+ | [Production notes](deploy/production.md) | Checklist and in-repo deploy assets |+ | [WorkflowRecipes operations](deploy/workflow-recipes-guide.md) | Recipe ops, RBAC, debugging |+ | **Upgrade notes** | |+ | [Workflow output PVC upgrade](deploy/workflow-output-pvc-upgrade.md) | Per-recipe output PVC ownership change |+ | [Plugin Workload SDK upgrade](deploy/plugin-workload-sdk-upgrade.md) | promptBridge / clientNotifications rollout order and migration |++| [Host PVC layout upgrade](deploy/host-pvc-layout-upgrade.md) | Upgrading stateless Hosts from v0.10.x / v0.11.x |+ | **Runbooks** | |+ | [GFS permission store](deploy/gfs-permission-store.md) | `gfs_controller` DB credential: provisioning, rotation, recovery |+ | [Password work ownership recovery](how-to/password-work-ownership-recovery.md) | Recover the bcrypt work-bounding singleton |+ | [MCP secret rollback permits](how-to/control-api-mcp-secret-rollback-permits.md) | Short-lived permits for the legacy MCP secret rollback path |+ | [GFS large-file downloads](operations/gfs-large-file-host-downloads.md) | GFS admission limits vs visual model input |## Reference@@@ -76,13 -94,44 +95,45 @@@| [llms.txt](llms.txt) | Machine-readable doc map for coding agents || Service READMEs | One-line map per component in the root [README components list](../README.md#docs-and-components) |- ## Testing-- | Doc | Description |- | --------------------------------------------------------------------------- | -------------------------------------- |- | [E2E guide](testing/e2e-guide.md) | Cluster E2E suites, approvals, desktop |- | [Custom coordinator E2E gates](testing/custom-coordinator-e2e-gates.md) | Gates for custom coordinator images |- | [Desktop observation smoke test](testing/desktop-observation-smoke-test.md) | Desktop surface smoke check |+ ## Architecture deep dives++ Design-level explanations of specific subsystems. Read the overview first.++ | Doc | Description |+ | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |+ | [Diagrams](architecture/diagrams/) | Excalidraw sources |+ | [Stateless agent invariants](architecture/stateless-invariants.md) | Guardrails for the suspend/wake agent lifecycle |++| [Host storage layout](architecture/host-storage-layout.md) | Workspace PVC layout, merge init, database failures, rollback rule |+ | [HCC readiness flows](architecture/hcc-readiness-flows.md) | Probe vs data-path readiness in host-context-controller |+ | [Live entity-change semantics](architecture/live-entity-change-consumer-semantics.md) | Latest-state convergence contract for live UI updates |+ | [Governed tracing](architecture/governed-tracing.md) | Control-plane evidence of what agents, admins, controllers did |+ | [Administrative rate limits](architecture/administrative-rate-limits.md) | Control API quotas and how the UIs handle throttling |+ | [GFS desktop operator parity](architecture/gfs-desktop-operator-parity.md) | Initial Desktop identity as EvenDrive operator on self-hosted |+ | [Registry pull secrets: self-provisioning](architecture/registry-pull-secret-self-provisioning.md) | How a self-hosted install provisions its registry image-pull Secret |+ | [Registry pull secrets: recipe workloads](architecture/registry-pull-secret-recipe-workloads.md) | Extending that pull Secret to WorkflowRecipe workloads |+ | [Codex subscription transport contract](architecture/codex-subscription-transport-contract.md) | Wire contract for the `codex-subscription` provider |+ | [Grok subscription transport contract](architecture/grok-subscription-transport-contract.md) | Wire contract and flags for `grok-subscription` |+ | [WorkflowRecipe naming](architecture/workflow-recipe-naming.md) | Generated resource-name rules |++ ## Testing & contributor runbooks++ Contributor-facing. Most assume a local development cluster and the lanes in+ [`CONTRIBUTING.md`](../CONTRIBUTING.md).++ | Doc | Description |+ | ------------------------------------------------------------------------------------ | --------------------------------------------------- |+ | [E2E guide](testing/e2e-guide.md) | Cluster E2E suites, approvals, desktop |+ | [Minikube T0/T1/T2 runbook](testing/minikube-t2-runbook.md) | The validation-lane contract |+ | [Custom coordinator E2E gates](testing/custom-coordinator-e2e-gates.md) | Gates for custom coordinator images |+ | [Desktop observation smoke test](testing/desktop-observation-smoke-test.md) | Desktop surface smoke check |+ | [Control UI headful journeys](testing/control-ui-headful-journeys.md) | Optional Playwright QA recorder for Control UI |+ | [Desktop headful journeys](testing/desktop-headful-journeys.md) | Optional Playwright QA recorder for the Desktop App |+ | [Codex subscription validation](testing/codex-subscription-validation.md) | Evidence lanes for `codex-subscription` |+ | [Grok subscription validation](testing/grok-subscription-validation.md) | Evidence lanes for `grok-subscription` image input |+ | [Workflow NetworkPolicy regressions](testing/workflow-network-policy-regressions.md) | Ownership rules learned from workflow policy bugs |+ | [Stateless idle calibration](testing/stateless-idle-calibration.md) | Measuring the stateless time-to-idle |+ | [Local measurements](testing/local-measurements.md) | Running benchmarks through the intake gate |+ | [CodeQL rate-limiting dispositions](how-to/codeql-js-missing-rate-limiting.md) | Audited dispositions for `js/missing-rate-limiting` |## For coding agents