@luxoai-dev/agent-core
Agent Core
Stablev0.11.0The execution boundary for LuxoAI agents. Converts model intent into typed proposals, checks risk and role policy, runs a centralized LLM gateway with SSE streaming and audit, and lets the host application execute only approved work.
- Package
- @luxoai-dev/agent-core
- Layer
- Policy runtime
- Version
- v0.11.0
- Used by
- SupplyAgent assistant actions · Luxo Assistant directives · future tool-routing gates
Architecture
The package sits between the host application and runtime outputs. The host owns auth, data, and side effects; the package validates and shapes flow.
Host
Application workflow
Auth, data, product state, and side effects stay owned by the host app.
Package
Agent Core
The execution boundary for LuxoAI agents. Converts model intent into typed proposals, checks risk and role policy, runs a centralized LLM gateway with SSE streaming and audit, and lets the host application execute only approved work.
Outcome
Agent outcome
Approved actions, responses, feedback, metrics, or model signals flow back to the product.
Capabilities
The contract surface, summarized.
| Capability | Detail |
|---|---|
| 01 | Action registries with safe, confirm, and restricted risk classes. |
| 02 | Directive parsing for navigation, follow-ups, tool proposals, and product actions. |
| 03 | Actor roles, feature gates, availability rules, allow-lists, and policy blocks. |
| 04 | LLM gateway with SSE streaming, reasoning-delta chunks, audit sink, and tool allow-lists. |
| 05 | Reusable feedback route handler (validate → persist → telemetry) and LLM-as-judge primitives. |
Used by
Concrete consumers in the LuxoAI fleet.
Integration shape
Drop into a host app. The host keeps auth, persistence, and side effects.
import {
createActionRegistry,
defineAction,
} from "@luxoai-dev/agent-core";
export const registry = createActionRegistry([
defineAction({
id: "workflow.approve",
risk: "confirm",
availability: "admin",
description: "Approve a reviewed workflow proposal.",
}),
]);API Reference
Every export, every signature, every parameter. The production-grade reference your code or your agent needs to call this package without reading source.
Open Agent Core API reference