Documentation

Everything needed to run, extend and audit the platform.

Documentation is provided to design partners with the deployment. This page describes what it covers so a plant can judge the depth before signing anything.

Get documentation access Developer overview

Eight sectionsProvided to design partnersRunbooks included

run_scn_01 · agent graph · scenario 10 nodes · 1 approval gate
01 · orchestrator order.receive ✓ SUCCEEDED 02 · orchestrator twin.simulate ✓ SUCCEEDED 03 · dose_disperse disperse.mill ✓ SUCCEEDED 04 · letdown_thin letdown.thin ✓ SUCCEEDED 05 · tint_color tint.match ✓ SUCCEEDED 06 · defect_inspect inspect.spectral ✓ SUCCEEDED 07 · orchestrator approve.human ◆ APPROVAL 08 · filter_fill filter.fill ✓ SUCCEEDED 09 · robot_handling handle.palletize ✓ SUCCEEDED 10 · quality_conf release.genealogy ✓ SUCCEEDED

Illustrative scenario: Plant run · one architectural deep tint base from dosing to pallet · bead mill, let-down tank, tint station, filling line. Not a measured run.

Getting started

The first hour

  1. Inventory the line. Systems, tags, feeds and the access each needs.
  2. Bring up the edge node. Plant-edge runtime, connectors in read-only mode.
  3. Declare the policy. Stage per loop, allow-lists, limits, approvers.
  4. Open the review console. See predictions beside lab, draw-down and QA results in shadow mode.
Reference

Reference sections

Connectors

Mill and disperser PLCs, tint dispensers, spectrophotometers, inline rheometers, filling lines, inspection, lab, MES, cameras and meters: what is read, what can be written, and how allow-lists and limits are declared.

The agent loop

Sense, reason, act with human checkpoints: how a run is planned, how the policy engine evaluates each write and how exceptions escalate.

Review console

Approving, correcting and annotating recommendations; how corrections become training events.

Audit log and genealogy

The immutable record of every reading, recommendation, write, approval and release, and how it maps to ISO 9001, VOC and REACH and customer color-standard records.

Model management

Versioning, per-plant validation, evaluation gates in CI, rollback, and the router that picks the model for each step.

Autonomy policy

Declaring the stage per loop, the tag allow-list, rate, magnitude and retint limits and the named approvers.

Coatwin

Twin formats, calibration against as-made batches, path and envelope search, and how synthetic scenarios are validated.

Deployment

Plant-edge runtime, cloud or private-cloud training loop, on-prem option, tenant isolation.

Developers

Every action is a record

There is no SDK to download yet. What design partners get is the integration surface: connectors, an autonomy policy declared per loop, and an audit record for every reading, recommendation, write and approval. This is the shape of one record, illustrative.

What the surface gives you

  • Connectors to mill and disperser PLCs, tint dispensers, spectrophotometers, inline rheometers, filling lines, lab systems, MES, cameras and meters, with declared allow-lists and limits
  • An autonomy policy per loop: stage, tags, rate, magnitude and retint limits, named approvers
  • Citations on every recommendation to the formula, color standard, spec or procedure it relied on
  • Model versions named in every record, with rollback by version
  • Export of the audit log and batch genealogy to your quality system

What the docs cover Developer overview

audit record · illustrative 
// one write, as the audit log would hold it
{
  "run": "run_scn_01",
  "step": "tint.match",
  "agent": "agent.tint_color",
  "stage": "bounded",
  "action": { "tool": "dispenser.write", "tag": "TINT2.COLORANT_B" },
  "limits": { "max_addition": "declared per colorant", "retints": "1 remaining" },
  "evidence": ["spectro.read_curve", "colorant.predict_dose"],
  "citation": "std:STD-2210 tolerance v4 §2",
  "policy": "permitted",
  "models": { "color_match": "versioned", "policy": "versioned" },
  "human": null,
  "outcome": "inside Delta-E tolerance · one retint remaining"
}
Run timeline

Reading a run record

Every Tinteon run is an ordered, inspectable sequence. This is run_scn_01, an illustrative scenario: Plant run · one architectural deep tint base from dosing to pallet · bead mill, let-down tank, tint station, filling line. Scenario complete · batch inside spec · one human approval at the tint station.

run_scn_01 scenario · not measured SUCCEEDED
  1. 01 order.receive SUCCEEDED 0.8 s

    Plant Orchestrator · Pulled the formula, the customer color standard and its tolerance, the viscosity and solids spec, the raw-material lot records and the product's VOC limit from the coatings MES and the lab system; locked the target envelope for the run.

  2. 02 twin.simulate SUCCEEDED 41 s

    Plant Orchestrator · Simulated 24 candidate dispersion, let-down and tint paths on the Coatwin as-made twin; ranked them on predicted Delta-E, fineness margin, viscosity, solvent use, energy and takt, and discarded every candidate that moved outside the customer tolerance or the VOC limit.

  3. 03 disperse.mill SUCCEEDED 1 h 48 m

    Dose-and-Disperse · Held mill energy, media temperature and residence to the predicted fineness curve from mill power and spectral reflectance, trimming inside the formula window instead of grinding to a fixed time and checking the Hegman gauge afterward.

  4. 04 letdown.thin SUCCEEDED 26 m

    Letdown-and-Thin · Predicted viscosity from inline rheology, temperature and solids during let-down and converged on spec with two resin additions and one solvent addition instead of the standing four, inside the formula window; no stability risk was flagged.

  5. 05 tint.match SUCCEEDED 14 m

    Tint-and-Color · Read the batch's spectral curve against the customer standard, predicted the colorant additions and dosed the first pass; the draw-down read inside tolerance on Delta-E after one addition, with one retint still available under the declared limit.

  6. 06 inspect.spectral SUCCEEDED continuous

    Defect-and-Inspect · 12 camera and spectral streams at the plant edge: color, gloss, hiding power, fineness and seed checks on the batch, fill-weight and label checks on every pail; two seeds were attributed to one filter cartridge and Filter-and-Fill scheduled the change.

  7. 07 approve.human APPROVAL 2 m 10 s

    Plant Orchestrator · The lowest-solvent candidate wanted a second colorant addition beyond the declared retint limit to tighten Delta-E further. Held for the shift color-matcher, who kept the customer tolerance untouched and approved one bounded addition with a tighter draw-down check.

  8. 08 filter.fill SUCCEEDED continuous

    Filter-and-Fill · Filtered through the fresh cartridge and filled pails to exact weight using fill-weight and foam feedback from inspection; the filler corrected upstream instead of rejecting downstream.

  9. 09 handle.palletize SUCCEEDED continuous

    Robot-and-Handling · Moved filled pails to the pallet inside the declared safety zone with a simulation-validated handling policy; one pallet-pattern change was executed after the zone check cleared.

  10. 10 release.genealogy SUCCEEDED 58 s

    Quality-and-Conformance · Batch released: raw-material lots, grind profile, let-down moves, colorant additions and spectral curves, inspection outcomes, VOC and solvent use and every human decision written to the batch genealogy and checked against spec.

Tool calls

Reading the tool log

Every tool invocation, argument and result is written to an immutable, human-readable log, and every reasoning step is expandable. Nothing about a run is hidden from the plant. The log below is the scenario run, not a measured one.

tool-call stream · run_scn_01
  1. 05:40:02mes.read_order({ batch: "B-4471", product: "TB-DEEP-07", standard: "STD-2210" })
  2. 05:40:02ok formula locked · tolerance Delta-E v4 · VOC limit on product
  3. 05:40:03lab.read_results({ lot: "PIG-8831", test: "incoming pigment" })
  4. 05:40:03ok lot inside spec · accepted for dosing
  5. 05:40:04twin.simulate({ candidates: 24, horizon: "batch" })
  6. 05:40:45ok best path #9 · tolerance held · lowest solvent and energy per batch
  7. 05:40:46policy.evaluate({ plan: 9, stage: "bounded" })
  8. 05:40:46ok 7 writes permitted · 1 write requires human approval
  9. 05:40:47plc.write_setpoint({ tag: "MILL2.ENERGY", basis: "power+spectral" })
  10. 07:28:30ok Hegman on target · color strength on target · no re-mill
  11. 07:29:00viscosity.predict({ tank: "LD-3", basis: "inline rheology+solids" })
  12. 07:29:00ok two resin and one solvent addition predicted · stability clear
  13. 07:29:01plc.write_setpoint({ tag: "LD3.SOLVENT_DOSE", window: "formula" })
  14. 07:55:10ok viscosity on spec · no overshoot
  15. 07:56:00spectro.read_curve({ station: "TINT-2", standard: "STD-2210" })
  16. 07:56:01dispenser.write({ colorant: "B", basis: "spectral prediction", retint_limit: 1 })
  17. 08:10:12ok draw-down inside Delta-E tolerance · one retint remaining
  18. 08:10:13vision.stream({ cameras: 12, models: ["color_gloss", "hiding_power", "seed_foam", "fill_label"] })
  19. 08:21:48flag: seed · pail 0417 · attributed to filter cartridge F-2 loading
  20. 08:21:49defect.attribute({ event: "seed", cause: "filter.cartridge_F2" })
  21. 08:21:49ok filter_fill notified · cartridge change scheduled · fill held 40 s
  22. 08:21:52approval.request({ action: "retint.beyond_limit", reason: "tighter Delta-E on lowest-solvent path" })
  23. 08:24:02ok approved by the shift color-matcher · tolerance untouched · one bounded addition
  24. 08:24:03plc.write_setpoint({ tag: "FIL1.TARGET_WEIGHT", basis: "fill-weight+foam feedback" })
  25. 09:48:40ok pails on weight · no spills · labels verified
  26. 09:49:38mes.release_batch({ batch: "B-4471", genealogy: "full" })
  27. 09:50:36ok batch released · scenario complete

Reasoning trace

Goal, plan, thought, action, observation, exactly as the orchestrator would record it.

GoalDisperse batch B-4471 to Hegman fineness, let it down to visco…

Disperse batch B-4471 to Hegman fineness, let it down to viscosity spec, tint it inside Delta-E of standard STD-2210, filter and fill it to exact weight and release it with full genealogy.

PlanSimulate the whole batch on the twin first. Lead with fineness…

Simulate the whole batch on the twin first. Lead with fineness so the let-down gets the right mill base and the tint station gets the right color strength. Keep the customer tolerance and the VOC limit as hard constraints. Let the dispenser converge only inside the declared retint limit; hold anything beyond it for a human.

ThoughtThe standing practice grinds to a fixed time, lets down by fou…

The standing practice grinds to a fixed time, lets down by four additions and tints by draw-down loops. With live fineness and viscosity prediction and a spectral color-match model the batch can land on the first pass. The saving is rework, colorant and solvent, not tolerance: the customer standard is never a candidate for optimization.

Actiontwin.simulate(candidates=24) → path #9: Hegman on target in on…

twin.simulate(candidates=24) → path #9: Hegman on target in one grind, three let-down additions, one colorant pass, lowest predicted solvent and energy per batch, takt met.

ObservationPath #9 wants a second colorant addition beyond the declared r…

Path #9 wants a second colorant addition beyond the declared retint limit to tighten Delta-E further. The policy engine routes that single move to the shift color-matcher and permits the other seven writes.

ActionExecute path #9 at the bounded stage: mill energy, let-down do…

Execute path #9 at the bounded stage: mill energy, let-down dosing and the first colorant pass proceed; inspection runs continuously; the extra addition waits.

ObservationApproval granted at 08:24:02 with the tolerance untouched and …

Approval granted at 08:24:02 with the tolerance untouched and a tighter draw-down check. Two seeds were attributed to filter cartridge F-2 and Filter-and-Fill scheduled the change with a 40 second hold.

OutcomeScenario complete. The batch is released with raw-material lot…

Scenario complete. The batch is released with raw-material lots, grind profile, let-down moves, colorant additions, spectral curves, inspection outcomes, VOC and solvent use and the human decision in the genealogy. No measured plant result is claimed; this is the run the platform is designed to execute.

Operations

Runbooks

Runbook

Edge node loss

What the plant sees, what keeps running (everything, on existing control), how the node rejoins and how the gap is recorded in the audit log.

Runbook

Model rollback

Rolling a loop back to a previous model version, re-validating against the lab and the spectrophotometer, and recording the reason.

Runbook

Stage change

Moving a loop between shadow, assist and bounded, the gates required and who signs.

Limits

Platform limits and defaults

Limits and defaults
ItemLimit or default
WritesOnly to tags on the plant's allow-list, inside declared rate, magnitude and retint limits, at the declared autonomy stage
Customer standards and VOC limitsRead and cited, never written; tolerance and permit limits included
Release decisionsPrepared by the conformance agent, taken by a person
Edge decision latencyDesign target of 50 to 150 ms per frame, under 250 ms for holds
Training budgetDesign target of 2,000 to 5,000 GPU-hours per major model family
Tenant isolationPer-plant data, memory and models; cross-plant learning only federated and IP-isolated
Autonomy

Four stages, set per loop

A plant does not go from manual to bounded control in one step. Tinteon makes the stage explicit per loop, auditable and reversible at any time, and some decisions never leave the person.

Autonomy stages and the human role at each
StageWhat the agent doesWhat the person doesWhen
ShadowPredicts fineness, viscosity, Delta-E, hiding power, contamination and fill faults; writes nothingRuns the plant as today; compares predictions to the lab, the spectrophotometer and PLC outcomesFirst phase with every design partner
AssistRecommends bounded mill, let-down, colorant, filtration and fill moves with the evidenceA formulator, color-matcher or quality manager approves or rejects each oneAfter accuracy is proven against the baseline
BoundedWrites low-risk dispersion, tinting and inspection setpoints inside documented formula, tolerance, VOC, equipment and rollback limitsApproves anything above the limits; reviews the shift recordAfter the quality and ROI gates agreed up front
ExceptionsEscalates anything outside its envelope, any move against a customer standard or VOC limit, and release decisionsAlways decides these; the agent never doesPermanent
Guardrails

An agent that can move a setpoint needs a leash

Tinteon writes to production equipment in a chemical plant. Every capability is scoped, every write is policy-checked, every output is cited, and every action is written to an append-only audit log the plant owns.

  • Bounded action space. Each agent can only write to an explicit tag allow-list, inside per-tag rate, magnitude and retint limits, at the autonomy stage the plant has set.
  • Standards and limits are read, never written. The customer color standard and its tolerance, the VOC and solvent limits under the plant's permit and the batch release decision stay with the quality system and the people who own it.
  • Policy engine before every write. Autonomy stage, interlock state, product, formula, shift and operator presence are evaluated before a setpoint or a colorant addition moves.
  • Grounded and cited. Every recommendation carries a citation to the formula, color standard, spec or procedure it relied on. Retrieval is tenant-isolated and permission-aware.
  • Immutable audit log. Append-only, exportable and retained on the plant's own storage, aligned to ISO 9001, VOC and REACH and customer color-standard record-keeping.
  • Hard fallback. If the edge node, the network or a model stops, the plant keeps running on its existing mill, dispenser and filling-line control and interlocks.
  • Tenant and IP isolation. Formulas, color standards, raw-material data and tolerance models never cross a customer boundary. On-prem deployment available.

Assurance posture

ItemScopeStatus
SOC 2 Type ICloud control plane QUEUED Roadmap, first 6 months
SOC 2 Type IICloud control plane QUEUED Roadmap, 6 to 12 months
ISO 9001 · VOC and REACH · customer color standardsGrounding and record-keeping RUNNING Design basis for retrieval and the audit log
Per-tenant isolationData, memory, models RUNNING Design rule
On-prem deploymentFormula-sensitive producers RUNNING Design option

Tinteon supports your quality and VOC records. It is not a certification and it does not replace your quality system or your permit.

Read the security overview

Integrations

It speaks plant, not cloud

Tinteon reads and writes through the systems already on the floor. No parallel historian, no new HMI, no rip-and-replace. Connectors are built against each design partner's stack first; long-tail integrations are out of scope for the first release.

Dispersion and milling

PLC and controls of dispersers, bead, basket and horizontal mills, with mill power, media temperature and residence telemetry

Setpoint reads, guarded writes, interlocks untouched

Tinting and dispensing

Tint dispensers and colorant dosing systems

Colorant additions inside declared retint and additive limits

Spectrophotometry and color management

Spectrophotometers, draw-down cameras and color-standard libraries

Spectral curves and Delta-E in; cited matches out

Inline rheology and lab

Inline rheometers and viscometers, temperature and solids sensors, LIMS results

Continuous viscosity and stability state

Filtration and filling

Filtration skids, filling lines, fill-weight scales, labelers

Telemetry in; fill-weight and hold commands inside approved windows

Inspection

Multi-camera and spectral stations for color, gloss, hiding power, seeds, foam, fill and label faults

Frames, fault events, hold recommendations

Coatings MES, formulation and traceability

Orders, formulas, color standards, product specs, batch genealogy

Targets in, release records out

Energy, solvent, robots

Plant and asset meters, solvent and VOC accounting; Isaac-driven drum, pail and tote cells

Hard constraints for scheduling; bounded handling

See all integrations

FAQ

Straight answers

The questions plant directors, formulators, color-matchers and quality managers ask in the first meeting.

Only at the autonomy stage your plant has set, and only to an explicit allow-list of low-risk loops inside documented limits. Every design partner starts in shadow mode, where Tinteon predicts and writes nothing. Assist mode follows, where a formulator or color-matcher approves each recommendation. Bounded autonomy on dispersion, tinting and inspection loops comes after the quality and ROI gates agreed up front.

Get started

Get documentation access

Documentation ships with a design-partner deployment. Ask and we will walk you through it first.

Book a line review See pricing