@kindgi/types 0.1.4-rc.0 → 0.1.4-rc.2

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export type * from './filter.js';
 export type * from './hash.js';
 export type * from './ids.js';
+export type * from './live.js';
 export type * from './refs.js';
 export type * from './result.js';
 export type * from './temporal.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,cAAc,CAAC;AAKlC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,UAAU,CAAC;AAC9B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,cAAc,CAAC;AAKlC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAUjC,uEAAuE;AACvE,qEAAqE;AACrE,+DAA+D;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAWjC,uEAAuE;AACvE,qEAAqE;AACrE,+DAA+D;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/live.d.ts

@@ -0,0 +1,39 @@
+import type { OrgId, ProjectId } from './ids.js';
+/**
+ * One step of an app-defined finer scope, below a project: the app passes
+ * them with a run as an ordered path from coarse to fine, e.g.
+ * `company=acme` then `role=cfo`.
+ */
+export interface ScopeSegment {
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Where a live version is pinned, from least to most specific: the
+ * agent's default for the tenant, an org, a project, or a segment path
+ * within a project. A run takes the most specific pin that covers it; a
+ * segment pin covers every run whose path starts with it.
+ */
+export type LiveScope = {
+    readonly kind: 'tenant';
+} | {
+    readonly kind: 'org';
+    readonly orgId: OrgId;
+} | {
+    readonly kind: 'project';
+    readonly projectId: ProjectId;
+} | {
+    readonly kind: 'segment';
+    readonly projectId: ProjectId;
+    readonly path: readonly ScopeSegment[];
+};
+/**
+ * Why a run used its agent version: named by the caller (`explicit`), held
+ * by the flow version a flow's agent step runs in (`flow-pin`: its node's
+ * `config.version`, else the version the flow version pinned when it was
+ * published), the conversation's own (`conversation`), the version live
+ * for the run's scope (`live`), or the latest registered, nothing being
+ * live (`latest`).
+ */
+export type AgentVersionVia = 'explicit' | 'flow-pin' | 'conversation' | 'live' | 'latest';
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;CAAE,GAC3D;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/dist/live.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=live.js.map

package/dist/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../src/live.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kindgi/types",
-  "version": "0.1.4-rc.0",
+  "version": "0.1.4-rc.2",
   "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/index.ts

@@ -4,6 +4,7 @@
 export type * from './filter.js';
 export type * from './hash.js';
 export type * from './ids.js';
+export type * from './live.js';
 export type * from './refs.js';
 export type * from './result.js';
 export type * from './temporal.js';

package/src/live.ts

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+
+import type { OrgId, ProjectId } from './ids.js';
+
+/**
+ * One step of an app-defined finer scope, below a project: the app passes
+ * them with a run as an ordered path from coarse to fine, e.g.
+ * `company=acme` then `role=cfo`.
+ */
+export interface ScopeSegment {
+  readonly key: string;
+  readonly value: string;
+}
+
+/**
+ * Where a live version is pinned, from least to most specific: the
+ * agent's default for the tenant, an org, a project, or a segment path
+ * within a project. A run takes the most specific pin that covers it; a
+ * segment pin covers every run whose path starts with it.
+ */
+export type LiveScope =
+  | { readonly kind: 'tenant' }
+  | { readonly kind: 'org'; readonly orgId: OrgId }
+  | { readonly kind: 'project'; readonly projectId: ProjectId }
+  | {
+      readonly kind: 'segment';
+      readonly projectId: ProjectId;
+      readonly path: readonly ScopeSegment[];
+    };
+
+/**
+ * Why a run used its agent version: named by the caller (`explicit`), held
+ * by the flow version a flow's agent step runs in (`flow-pin`: its node's
+ * `config.version`, else the version the flow version pinned when it was
+ * published), the conversation's own (`conversation`), the version live
+ * for the run's scope (`live`), or the latest registered, nothing being
+ * live (`latest`).
+ */
+export type AgentVersionVia = 'explicit' | 'flow-pin' | 'conversation' | 'live' | 'latest';