How should delivery, versioning and reset work for a resold pack?
A resold pack needs versioned deliveries, namespaced identifiers, a manifest per release and a deterministic environment reset, so customers can reproduce results and apply updates cleanly.
When a pack passes through a reseller, three things decide whether customers can rely on it: versioning, identifiers and reset.
**Versioning.** Each delivery carries a `release_id` and a `schema_version` in `manifest.json`. Changes to field meaning increment the schema version. Corrections to records produce a new release with a change list by `case_id`. Customers should be able to pin a release when they report results.
**Identifiers.** Keep `case_id`, `doc_id`, `rule_id` and `gap_id` stable within a release lineage. If you combine releases from more than one source, add a namespace prefix so identifiers cannot collide.
**Formats.**
- JSONL for nested records, split by record family - Parquet for flat tables, with gaps and request items exploded to rows - a `schema.json` describing fields, enumerations and optional columns
**Environment.** If the pack includes tool actions, define `reset(seed)` so that the same seed restores the same case state. Log the seed, release and policy version with each run. Add an `export_state` call that returns the final case, request and audit records for scoring.
**Passing it on.** Include the manifest and schema in every customer delivery, along with any restrictions you are required to pass on.
All content is generated. Agree in scoping how corrections and withdrawals will be communicated to customers.
Version pinning and deterministic reset let your customers reproduce results, which cuts support load on your side.
- Audience:
- Licensed resellers
- Content type:
- Integration
- Buyer question:
- Scope and getting started
Content release: r-a220eb6e099b243b
Related questions
- How do environment reset, seeds and versioning work for a sufficiency environment?
- What licence terms and limits should I expect for a sufficiency release?
- How should I scope a sufficiency dataset, task pack or environment?
- What does a useful first pilot look like for a team building a utility onboarding agent?
- What should I ask for in a sufficiency sample or pilot?
- What should a first handoff package contain and how do we integrate it?