Versioning

The @gocommotion/copilot-sdk follows semantic versioning (MAJOR.MINOR.PATCH).

Segment	Meaning
MAJOR	Breaking changes to component props or API behavior.
MINOR	New features added in a backward-compatible way.
PATCH	Bug fixes and non-breaking improvements.

Managing versions

When installing the package, npm respects the version specification in package.json:

{
  "dependencies": {
    "@gocommotion/copilot-sdk": "^1.2.3"
  }
}

Syntax	Updates allowed	Example
^1.2.3	Minor and patch	^1.2.3
~1.2.3	Patch only	~1.2.3
1.2.3	Exact version only	1.2.3

Production vs UAT builds

The SDK is published under two dist-tags:

Tag	Install command	Use case
prod	npm install @gocommotion/copilot-sdk@prod	Production deployments.
uat	npm install @gocommotion/copilot-sdk@uat	Pre-release testing and QA validation.

Caution

UAT builds may include experimental features and are not recommended for production environments. Pin to a specific version (e.g. 1.2.3 instead of ^1.2.3) when shipping production code to avoid picking up unintended changes.