@kindgi/types 0.1.3 → 0.1.4-rc.0

package/dist/version.d.ts

@@ -33,4 +33,29 @@ export interface VersionedRef<Id extends string> {
     readonly id: Id;
     readonly version: Semver;
 }
+/**
+ * Why the runtime registered a version of an agent or flow under another
+ * number than its definition names. Versions never change, so a deploy
+ * whose definition's version is registered already with other content
+ * registers the next free version in its line instead:
+ *
+ * - `pins-changed`: the definition's version is registered with other
+ *   pins (a block it uses has a new version);
+ * - `unpinned`: the definition's version was published before pins
+ *   existed, so it has none;
+ * - `version-taken`: the definition's version holds another definition;
+ * - `edited`: derived from an existing version with some data-block pins
+ *   swapped (an expert's edit), not from a definition at all.
+ */
+export type VersionDerivationReason = 'pins-changed' | 'unpinned' | 'version-taken' | 'edited';
+/** The version a version was registered in place of (or derived from), and why. */
+export interface VersionDerivation {
+    /** The version the definition names, or the one an edit derived from. */
+    readonly version: string;
+    readonly reason: VersionDerivationReason;
+    /** For an edit: a short label for the version (e.g. "warmer tone"). */
+    readonly label?: string;
+    /** For an edit: who made it (`user:<id>`, or the token for a key). */
+    readonly by?: string;
+}
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM;IAC7C,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,MAAM;IAC7C,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,uBAAuB,GAAG,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE/F,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kindgi/types",
-  "version": "0.1.3",
+  "version": "0.1.4-rc.0",
   "description": "Foundational TypeScript types shared across Kindgi. Branded IDs, timestamps, hashes, refs, Result, list filter / page shapes. Zero runtime dependencies; the only runtime export is the makeEnvName validator.",
   "license": "Apache-2.0",
   "repository": {

package/src/version.ts

@@ -39,3 +39,30 @@ export interface VersionedRef<Id extends string> {
   readonly id: Id;
   readonly version: Semver;
 }
+
+/**
+ * Why the runtime registered a version of an agent or flow under another
+ * number than its definition names. Versions never change, so a deploy
+ * whose definition's version is registered already with other content
+ * registers the next free version in its line instead:
+ *
+ * - `pins-changed`: the definition's version is registered with other
+ *   pins (a block it uses has a new version);
+ * - `unpinned`: the definition's version was published before pins
+ *   existed, so it has none;
+ * - `version-taken`: the definition's version holds another definition;
+ * - `edited`: derived from an existing version with some data-block pins
+ *   swapped (an expert's edit), not from a definition at all.
+ */
+export type VersionDerivationReason = 'pins-changed' | 'unpinned' | 'version-taken' | 'edited';
+
+/** The version a version was registered in place of (or derived from), and why. */
+export interface VersionDerivation {
+  /** The version the definition names, or the one an edit derived from. */
+  readonly version: string;
+  readonly reason: VersionDerivationReason;
+  /** For an edit: a short label for the version (e.g. "warmer tone"). */
+  readonly label?: string;
+  /** For an edit: who made it (`user:<id>`, or the token for a key). */
+  readonly by?: string;
+}