Nestack Agent Care
Industries / Mining / Royalty returns

Mining AI agent · Royalty returns

Mineral Royalty Return AI Agent

Assemble the support behind a royalty return — quantities reconciled from weighbridge to invoice, deductions evidenced, the amendment history — for the named officer who lodges. The fiscal filing, not the tenement clock.

4–6 weeksTypical delivery
Your stackDeployment
Support onlyOfficer lodges
Agent CareAfter launch

What this agent does

Assembles the support, not the liability

In
01

A load crosses the weighbridge, and the record is pulled from supported despatch, shipping and sales sources.

02

A wet tonne is carried with the moisture certificate behind it, not converted on a standing factor.

Reason
03

A return falls due, and the period is read against the calendar the revenue authority publishes, not a vendor table.

04

A deduction is claimed, and the contract or invoice that evidences it is attached to the line it supports.

05

A provisional invoice settles, and the price movement is raised against the period it belongs to.

Decide
06

A sale goes to a related party, and the line is held until the valuation decision on file is produced.

07

A determination governs the base, and the shipment is checked against the product it was made for.

Out
08

A period is retained as a dated version, beside the records behind it and what the lodging officer was shown.

09

A write action runs only inside the approval boundaries agreed during implementation.

Product statement

The agent assembles and reconciles the support; a named officer lodges the return, and the tenement holder or royalty payer carries the liability.

Example workflow

One period, tonne to lodgement

AgentHuman
1Records receivedWeighbridge, despatch, shipping and sales-invoice records
2Support assembledQuantities, deductions, price adjustments and prior amendments, each with its named source
3Return pack draftedReconciled quantities, deduction basis, open items and confidence
4Controls appliedQuantity reconciliation, deduction-evidence tests, calendar checks and confidence threshold
No human action required

Stages 1 to 4 run unaided, and nothing is lodged at any of them — the agent is assembling support, and the officer lane opens at the confidence gate.

5DecisionBranches at the confidence threshold
High confidence

Goes to the royalty officer.

Low confidence

Adds a commercial read first.

Officer review

The pack is held with its records, its open items and the confidence.

Approve · Amend · Send to commercial review
Approved — released to lodge
6Royalty records updatedOnly where write access and approval policy allow it
7Outcome evaluatedAmendment distance, open-item outcomes, reassessments and post-lodgement corrections
Amendments

Every officer amendment is counted in the evaluation.

What should not run autonomously

Human approval stays in control

Outside the boundary — human approval required8 items
Lodging the return — a named officer does that.
Determining the royalty liability for a period.
Deciding whether a deduction is allowable.
Valuing a related-party or non-market sale.
Automation boundaryAgent acts unaided
Reconcile production and sales quantities to the invoiced tonnes.
Carry each deduction claimed with the evidence held on file behind that claim.
Track provisional-to-final pricing and raise what has moved.
Assemble the audit pack and hold it for the named officer.
Writes run only inside the boundaries agreed at implementation, and never ahead of the officer.
Applying for a valuation decision or determination.
Certifying or verifying the lodged statement.
Notifying the Commissioner of an understated liability.
Changes to deduction, calendar or approval rules.

Example output

One return line, annotated

Everything the agent assembles is attached to the record it was drawn from.

Return support output · single lineIllustrative example
Commodity
Return line
Reconciled quantity
Source of record
Confidence
Basis of record
Concentrate shipment
Wet despatch tonnes converted on the certificate for this shipment
1,284 dry t
Moisture certificate
88%
Weighbridge and shipping records
As receivedTaken from the weighbridge record and the moisture certificate — nothing on this side is written by the agent.
Source facts used Weighbridge record Moisture certificate Shipping documents
Why this is openThe invoice is struck on dry tonnes and a person still decides.
ActionApproveAmendSend to commercial review
What the score decidesBelow the configured threshold the line picks up a commercial read before the officer sees it.

Value

Where AI adds value

The same four claims, placed at the point in the workflow where each one applies.

Where the value landsValue 01 – 04
Every periodFrom the despatch and sales records
03Assembly

Reconcile the tonnes to the invoice

Quantities are set against the records already on file; what the return states stays with the officer who lodges it.

01Approved path

Lodging is the assessment

In Queensland, lodging the return makes the assessment — Taxation Administration Act 2001 s.14.

02Human review

This is not the tenement clock

The shipped tenement agent tracks what a tenement obliges you to do. This page asks whether the lodged number is defensible.

04Build an evidence trail

The tonne, the weighbridge record under it and the officer who lodged stay on the return.

Integrations

Typical integrations

Five system groups connect to the same agent. Which of them are in scope is decided in discovery.

Weighbridge and productionWeighbridge · scale systems
Production reporting
Despatch and shippingRail and port despatch
Bills of lading · draft survey
Sales and invoicingSAP · Oracle ERP
Offtake and settlement

Agent

Royalty return support

Reads the records
Assembles the pack
Holds for lodgement

Assay and lodgementLIMS · moisture certificates
Revenue authority portals
Observability & evaluationOpenTelemetry · Langfuse
Supported monitoring/evaluation sources

Integration availability depends on the client's existing systems and API access.

Agent controls

Six layers between the model and the return

Six layers, narrowing inward. What survives the last of them is named in the map below.

L6 · Outermost — last line of defenceInward → L1 · closest to the model
L6Rollback / safe modePull back to support assembly when evaluation or production signals degrade.Roll back
L5Version monitoringTrack model, prompt, deduction-rule and calendar-configuration changes.Track
L4TraceabilityRecord the quantities, the deduction basis, the open items and the approval time.Record
L3Officer approvalHold the pack for the named officer; it governs release, not whether the number is right.Gate
L2Policy guardrailsTest the pack against the deduction and calendar rules; a failure returns the pack.Restrict
L1Confidence thresholdsRoute low-confidence lines to a commercial read before the officer sees them.Require review
Model corePack assembled — reconciled quantities, deduction basis, open items and confidence
L1 – L2Test whether the pack may stand
L3Puts the release in the hands of an officer
L4 – L5Keep the tonne and the record behind it
L6Holds the return at unlodged when signals degrade

How Nestack evaluates it

Evaluate the assembly workflow — not only the finished return.

Coverage runs the whole depth of the workflow, and every layer is cut by slice.

Surface — the return the officer lodges
Depth of coverage ▼
E1Final-output evaluationDid every quantity trace to the record behind it?
E2Step-level evaluationDid the agent use the right calendar, rates and deduction configuration?
E3Tool evaluationDid it read and write the correct entity and the correct period?
E4Confidence calibrationDo low-confidence lines actually attract more officer amendments?
E5Slice evaluationHow does performance change across specific commodity groups?
E6Business outcomeHow many lines were amended, or corrected after the return was lodged?
Floor — the outcome the payer answers for

Failure modes

Where each failure originates in the agent

Seven failure modes, each placed where it first enters the return.

Agent lifecycleDirection of processing →
01 · Retrieval1 mode
DX-03

Certificate never ingested

The conversion runs on a standing factor.

Stage gathersWeighbridge, despatch, shipping and sales records
02 · Reasoning2 modes
DX-04

Standard moisture factor

A wet-to-dry conversion runs without its certificate.

DX-06

Deduction claimed by analogy

A cost is claimed against a rule that does not reach it.

Stage proposesReconciled quantities, deductions and confidence
03 · Tool / write2 modes
DX-02

Vendor-sourced due date

Instalment dates inside the quarter are missed.

DX-05

Final pricing never raised

The settlement moves after the period is lodged.

Stage writesOnly where write access and approval policy allow it
04 · Output1 mode
DX-01

Quantity basis mismatch

Mined tonnes are returned where disposed tonnes belong.

Stage returnsThe return the officer lodges and the auditor reads
05 · Change / Version1 mode
DX-07

Silent schedule drift

A rule change alters which rate a product attracts.

Stage tracksModel, prompt, deduction rules and calendar config
Sev-1 · a return lodged outside the boundary Sev-2 · a wrong tonne reaches the return Sev-3 · source degrades, line goes to review

Affected slices

A clean period total can hide one commodity

A period-level reconciliation figure can read as clean while a few commodity and sales-type slices carry most of the returned lines. Nestack reports the return rate by slice, not only in total.

Slice performance — reported separately, not only in aggregateIllustrative example
SliceFailure rateLift Lift vs. thresholdStatus
Related-party concentrate sales7.4%3.6× Review
Provisionally priced shipments5.1%2.5× Review
Iron ore under determination3.8%1.9× Watch
Final-priced domestic sales2.5%1.2× Normal
Bar: return-rate lift vs. domestic final-priced baseline · scale 0–4.0× · tick marks the 2.0× review threshold 2 of 4 slices over threshold

Evidence-linked improvement

Each cycle leaves one more test behind

A cycle closes when the amended return is a regression case. That suite is what the next return lodged is measured against.

Improvement cycle · five stagesSwitchback — the path turns at Improve and returns at Learn
01Detect

Return rate rises for one commodity slice.

02Diagnose

The quarter that was lodged on time and re-opened long after the team had moved on is read back until the cause narrows to one.

03Improve

The change goes out with a number, and the returns behind it travel with it.

04Verify

Nothing lodges while one touched return case is still red.

05Learn

It is kept for good, and the deduction rules are amended in the same commit.

Learn → DetectThe return edge. Detection next period starts from a suite one case longer.

Typical build scope

Twelve workstreams across six weeks

The build scope read against the delivery timeline. Week structure follows the six-week plan — discovery, sources, return workflow, evaluation, integration, then production validation and handover.

Workstream Week 1Week 2Week 3Week 4Week 5Week 6
01Royalty workflow discovery and boundary mapping.
02Weighbridge and sales source assessment.
03Quantity, deduction and lodgement-calendar mapping.
04Record ingestion and reconciliation.
05Pack assembly and source binding.
06Confidence scoring and exception routing.
07Officer review workflow.
08Weighbridge and sales-system integration.
09Quantity and deduction cases.
10Guardrails and lodgement controls.
11Return-trail instrumentation.
12Deployment, documentation and Agent Care handover.
12 workstreams · 6 weeks · bar shows the weeks a workstream is active — several run in parallel Final scope and sequence confirmed in discovery

Engagement tiers

What each tier includes

Rows are the capabilities named in each tier's scope. Higher tiers include everything below them.

Capability✓ in scope · — not at this tier PilotOne commodity, one period ProductionProduction source systems AdvancedMultiple states / entities
Introduced at Pilot
Return support and reconciliation
Officer lodgement approval
Quantity-reconciliation baseline
Introduced at Production
Reporting by commodity
Exception workflow in your systems
Approved write-back
Weighbridge-and-sales integration
Introduced at Advanced
Multi-jurisdiction deduction rules
Multi-stage commercial approvals
High shipment volume
Multi-state return controls
Build price From $5,000 From $8,000 Custom quote
Final build priceConfirmed after discovery based on integrations, workflow complexity, transaction volume, approval controls and deployment requirements.
Separate from buildBuild pricing is separate from recurring Agent Care, which covers managed monitoring, evaluations, incidents and verified improvements after launch.

What we need from you

What you bring, and what we build with it

Each input maps to a piece of build scope and a week in the delivery timeline.

You bringWe build with it
01Your commodity list and return periods Quantity, deduction and calendar rule mappingWeek 1
02Representative prior lodged returns Record ingestion, reconciliation and the assembly baselineWeek 2
03Your deduction policy and evidence standards Return-support mapping and automation-boundary definitionWeek 1
04Access to relevant APIs, feeds or exports Weighbridge and sales-system assessment, then integration setupWeek 2
05Returns you would not want audited Amendment cases and failure-mode testingWeek 4
06What no lodged return may leave unsupported Confidence scoring, exception routing, guardrails and lodgement controlsWeek 3
07Named officers to review the return pack Officer review workflow, then pilot and production validationWeeks 5–6
Nothing else is required Deployment, documentation and Agent Care handover are ours.

Delivery timeline

Four phases across six weeks

Bands here are measured in weeks of real work, and that measurement is what puts two into week five.

Phase W1W2W3W4W5W6
Discovery W1
Build W2 – W3
Evaluate W4 – W5
Pilot & Launch W5 – W6
Week focus W1Royalty workflow discovery, rule mapping and the automation boundary W2Source integration and the reconciliation baseline W3Assembly workflow, confidence logic and lodgement controls W4Evaluation suite, deduction checks and failure-mode testing W5Sales-system integration, a pilot period and targeted corrections W6One return period run under the commercial manager, then Agent Care handover
Reading the bandA bar covers only the weeks its own work is named in. The week 5 overlap is real, not padding.
At the end of W6When the return period validates, Agent Care takes the agent on.
DurationSix-week plan shown · typical delivery 4–6 weeks depending on scope confirmed in discovery.

Next step · Mining AI agent

Build the support behind the return before the period closes.

Show us your despatch records, your deduction basis and who lodges. The commercial manager who presses submit is the person an auditor will ask, years later, what each tonne on that return was drawn from.

Nestack Agents · Mineral royalty returnsAGT-MN-15 · Agent Care available after launch