LuxoAILuxoAIdocs
Welcome
InvoiceAgentInternalSupplyAgentBetaLearnAgentBeta
OverviewAgent Corev0.11.0StableObservabilityv0.6.0StableLuxo Assistantv0.6.0BetaFeedback UIv0.2.0BetaLuxo MLScaffold
API Console
All systemsv0.8.1
LuxoAILuxoAIdocs
DocsAgentic PackagesLuxo ML

luxo-ml

Luxo ML

Scaffold

The model operations layer for versioned domain models. Defines schemas, artifacts, evaluation reports, and promotion rules before model outputs influence runtime behavior.

At a glance
Package
luxo-ml
Layer
Model contract layer
Used by
invoice.router · invoice.extractor · future supplier ranking · future learning personalization

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

Luxo ML

The model operations layer for versioned domain models. Defines schemas, artifacts, evaluation reports, and promotion rules before model outputs influence runtime behavior.

→

Outcome

Agent outcome

Approved actions, responses, feedback, metrics, or model signals flow back to the product.

Capabilities

The contract surface, summarized.

CapabilityDetail
01Versioned contracts for routers, extractors, rankers, and personalization models.
02Evaluation artifacts that separate candidate experiments from production behavior.
03Typed model interfaces so agents consume model outputs as soft signals.
04Promotion paths that keep model changes auditable before deployment.

Used by

Concrete consumers in the LuxoAI fleet.

invoice.routerinvoice.extractorfuture supplier rankingfuture learning personalization

Integration shape

Drop into a host app. The host keeps auth, persistence, and side effects.

src/luxo_ml/contracts/invoice_router.tsTypeScriptContractScaffold
1
2
3
4
5
6
7
8
9
10
11
12
13
type LuxoModelTask = {
  id: string;
  inputSchema: string;
  outputSchema: string;
  promotion: "candidate" | "stable";
};

export const invoiceRouterTask: LuxoModelTask = {
  id: "invoice.router",
  inputSchema: "DocumentRouterInput",
  outputSchema: "DocumentRouterOutput",
  promotion: "candidate",
};

Scaffold — contracts may evolve

Pin a specific task_id + version from the registry; never depend on current_stable in production code.

Related

Browse the full package map for adjacent runtime modules and integration boundaries.

PreviousFeedback UIReusable React feedback widget with optional opinionated styles.