@vertesia/common 1.6.0-dev.20261008.064737Z → 1.6.0-dev.20261009.095813Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/common",
-  "version": "1.6.0-dev.20261008.064737Z",
+  "version": "1.6.0-dev.20261009.095813Z",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./lib/index.js",
@@ -38,7 +38,7 @@
     "vitest": "5.0.2"
   },
   "dependencies": {
-    "@llumiverse/common": "1.6.0-dev.20261008.064411Z",
+    "@llumiverse/common": "1.6.0-dev.20261009.095504Z",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "zod": "4.6.5"
@@ -56,7 +56,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "8ee3a33e9a7c3dbcd13937e971cbdcc5fad56717",
+  "gitHead": "e45bc09ecf2de4c8fe8a8d39fb52c1521980e7b9",
   "scripts": {
     "lint": "biome lint src",
     "test": "vitest run",

package/src/api-contract/components.generated.json

@@ -888,6 +888,12 @@
           "type": "string"
         },
         "description": "Projects this group is allowed to be used in. When empty or absent the group is org-wide (usable in any project). When set, the group may only be used to grant permissions in the listed projects."
+      },
+      "member_count": {
+        "type": "integer",
+        "minimum": -9007199254740991,
+        "maximum": 9007199254740991,
+        "description": "Number of users in the group. Returned by the group listing only."
       }
     },
     "required": [

package/src/api-contract/engine.ts

@@ -294,6 +294,9 @@ export function createApiContract<T extends object>(ApiSchemaComponents: Readonl
         // would document a constraint nothing checks — the exact spec/enforcement gap this design is
         // meant to close.
         addFormats(ajv);
+        // Zod's `.startsWith()` emits `format: "starts_with"` next to a `pattern` that already enforces
+        // the prefix. Declared as a no-op so AJV stops logging it as an unknown format on every compile.
+        ajv.addFormat('starts_with', true);
         ajv.addSchema({ $id: AJV_SCHEMA_ID, components: { schemas: toAjvComponents() } });
         ajvInstance = ajv;
         return ajv;

package/src/api-contract/index.ts

@@ -1,8 +1,8 @@
 /** Public runtime contracts use prebuilt JSON Schema and never load Zod. */
 import type { JsonObject } from '../api-schemas/adapter.js';
-import type { ApiComponentName, ApiComponentType } from '../api-schemas/registry.js';
 import API_SCHEMA_COMPONENTS from './components.generated.json' with { type: 'json' };
 import { createApiContract } from './engine.js';
+import type { ApiComponentName, ApiComponentType } from './types.js';
 
 export type { JsonObject } from '../api-schemas/adapter.js';
 export type {
@@ -10,9 +10,9 @@ export type {
     NormalizedApiParameters,
     RawApiParameters,
 } from '../api-schemas/parameters.js';
-export type { ApiComponentName, ApiComponentType } from '../api-schemas/registry.js';
 export type { ApiValidationIssue, PruneAndValidateResult, ValidateApiPayloadResult } from './engine.js';
 export { createApiContract } from './engine.js';
+export type { ApiComponentName, ApiComponentType } from './types.js';
 
 export const ApiSchemaComponents: Readonly<Record<string, JsonObject>> = API_SCHEMA_COMPONENTS;
 

package/src/api-contract/types.ts

@@ -0,0 +1,108 @@
+import type {
+    CreateEventSubscriptionPayload,
+    EventDeliveryTarget,
+    EventDeliveryTargetInput,
+    EventSubscription,
+    EventSubscriptionMutationResponse,
+    ProcessEventDeliveryTarget,
+    UpdateEventSubscriptionPayload,
+} from '../platform-event.js';
+import type {
+    AgentRunInternals,
+    AgentRunResponse,
+    BindRunWorkflowPayload,
+    ListAgentRunsResponse,
+    ProgrammaticRunResponse,
+    RecordRunPayload,
+    SupervisedRunResponse,
+    UpdateAgentRunStatusPayload,
+} from '../store/agent-run.js';
+import type * as DSLWorkflowTypes from '../store/dsl-workflow.js';
+import type {
+    DSLChildWorkflowStep,
+    DSLWorkflowDefinition,
+    DSLWorkflowDefinitionResponse,
+    DSLWorkflowSpec,
+    DSLWorkflowSpecWithSteps,
+    DSLWorkflowStep,
+} from '../store/dsl-workflow.js';
+import type {
+    BranchNodeBranchDefinition,
+    CreateProcessDefinitionPayload,
+    NodeDefinition,
+    ProcessDefinition,
+    ProcessDefinitionBody,
+    UpdateProcessDefinitionPayload,
+} from '../store/process.js';
+import type { ViewNavigationNode } from '../views.js';
+import type { ApiComponentTypes } from '../wire-types.generated.js';
+
+export type ApiComponentName = keyof ApiComponentTypes;
+
+/**
+ * Explicit TypeScript recursion boundary for schemas whose runtime graph is lazy.
+ *
+ * Zod cannot infer a finite named type through a mutually-recursive graph. The schemas remain the
+ * runtime and OpenAPI authority; these names preserve the recursive TypeScript declarations until
+ * TypeScript can infer recursive aliases without collapsing them to `unknown`.
+ */
+interface ZenoRecursiveComponentTypes {
+    ViewNavigationNode: ViewNavigationNode;
+    AgentRunResponse: AgentRunResponse;
+    AgentRunInternals: AgentRunInternals;
+    BindRunWorkflowPayload: BindRunWorkflowPayload;
+    BranchNodeBranchDefinition: BranchNodeBranchDefinition;
+    CreateEventSubscriptionPayload: CreateEventSubscriptionPayload;
+    CreateProcessDefinitionPayload: CreateProcessDefinitionPayload;
+    DSLChildWorkflowStep: DSLChildWorkflowStep;
+    DSLWorkflowDefinition: DSLWorkflowDefinition;
+    DSLWorkflowDefinitionResponse: DSLWorkflowDefinitionResponse;
+    DSLWorkflowSpec: DSLWorkflowSpec;
+    DSLWorkflowSpecWithActivities: DSLWorkflowTypes.DSLWorkflowSpecWithActivities;
+    DSLWorkflowSpecWithSteps: DSLWorkflowSpecWithSteps;
+    DSLWorkflowStep: DSLWorkflowStep;
+    EventDeliveryTarget: EventDeliveryTarget;
+    EventDeliveryTargetInput: EventDeliveryTargetInput;
+    EventSubscription: EventSubscription;
+    EventSubscriptionArray: EventSubscription[];
+    EventSubscriptionMutationResponse: EventSubscriptionMutationResponse;
+    ListAgentRunsResponse: ListAgentRunsResponse;
+    NodeDefinition: NodeDefinition;
+    NodeDefinitionMap: Record<string, NodeDefinition>;
+    ProcessDefinition: ProcessDefinition;
+    ProcessDefinitionArray: ProcessDefinition[];
+    ProcessDefinitionBody: ProcessDefinitionBody;
+    ProcessEventDeliveryTarget: ProcessEventDeliveryTarget;
+    ProgrammaticRunResponse: ProgrammaticRunResponse;
+    RecordRunPayload: RecordRunPayload;
+    SupervisedRunResponse: SupervisedRunResponse;
+    UpdateAgentRunStatusPayload: UpdateAgentRunStatusPayload;
+    UpdateEventSubscriptionPayload: UpdateEventSubscriptionPayload;
+    UpdateProcessDefinitionPayload: UpdateProcessDefinitionPayload;
+    WorkflowDefinitionPayload: DSLWorkflowTypes.WorkflowDefinitionPayload;
+    WorkflowDefinitionPayloadWithActivities: DSLWorkflowTypes.WorkflowDefinitionPayloadWithActivities;
+    WorkflowDefinitionPayloadWithSteps: DSLWorkflowTypes.WorkflowDefinitionPayloadWithSteps;
+}
+
+/**
+ * The wire type a component publishes.
+ *
+ * `ApiComponentType<'Account'>` is the plain type `gen:schemas` writes for `AccountSchema` into
+ * `ApiComponentTypes`, which `wire-types.generated.test.ts` proves identical to its `z.infer`. Indexing
+ * that map rather than `z.infer<ApiSchemaMap[N]>` keeps Zod's inference out of every program that names
+ * a component. A component the generator has not seen yet resolves to `never`, which
+ * `registry-groups.test.ts` rejects.
+ *
+ * It is wrapped in `NoInfer` because `N` always comes from a component-name argument and can never be
+ * recovered from the wire type. Without it, a call whose result has a contextual type — a destructuring
+ * `const { file } = validatedQuery(ctx, 'FileMetadataQuery')`, an `await`, a typed `return` — makes the
+ * checker infer `N` from that context while `N` is still unresolved, which evaluates `z.infer` across
+ * every component in the registry: about 500k types, 1 GB and 2 s of `tsc` in each consuming program.
+ */
+export type ApiComponentType<N extends ApiComponentName> = NoInfer<
+    N extends keyof ZenoRecursiveComponentTypes
+        ? ZenoRecursiveComponentTypes[N]
+        : N extends keyof ApiComponentTypes
+          ? ApiComponentTypes[N]
+          : never
+>;

package/src/api-schemas/group.ts

@@ -55,6 +55,11 @@ export const UserGroupSchema = z
                     '(usable in any project). When set, the group may only be used to grant permissions in the ' +
                     'listed projects.',
             }),
+        member_count: z
+            .number()
+            .int()
+            .optional()
+            .meta({ description: 'Number of users in the group. Returned by the group listing only.' }),
     })
     .meta({ id: 'UserGroup' });
 

package/src/api-schemas/registry.ts

@@ -32,44 +32,10 @@ import {
     VideoResultSchema,
 } from '@llumiverse/common/schemas';
 import type { z } from 'zod';
-import type {
-    CreateEventSubscriptionPayload,
-    EventDeliveryTarget,
-    EventDeliveryTargetInput,
-    EventSubscription,
-    EventSubscriptionMutationResponse,
-    ProcessEventDeliveryTarget,
-    UpdateEventSubscriptionPayload,
-} from '../platform-event.js';
-import type {
-    AgentRunInternals,
-    AgentRunResponse,
-    BindRunWorkflowPayload,
-    ListAgentRunsResponse,
-    ProgrammaticRunResponse,
-    RecordRunPayload,
-    SupervisedRunResponse,
-    UpdateAgentRunStatusPayload,
-} from '../store/agent-run.js';
-import type * as DSLWorkflowTypes from '../store/dsl-workflow.js';
-import type {
-    DSLChildWorkflowStep,
-    DSLWorkflowDefinition,
-    DSLWorkflowDefinitionResponse,
-    DSLWorkflowSpec,
-    DSLWorkflowSpecWithSteps,
-    DSLWorkflowStep,
-} from '../store/dsl-workflow.js';
-import type {
-    BranchNodeBranchDefinition,
-    CreateProcessDefinitionPayload,
-    NodeDefinition,
-    ProcessDefinition,
-    ProcessDefinitionBody,
-    UpdateProcessDefinitionPayload,
-} from '../store/process.js';
-import type { ViewNavigationNode } from '../views.js';
-import type { ApiComponentTypes } from '../wire-types.generated.js';
+import type { ApiComponentType } from '../api-contract/types.js';
+
+export type { ApiComponentType } from '../api-contract/types.js';
+
 import {
     ACECreatePayloadSchema,
     ACEUpdatePayloadSchema,
@@ -3651,74 +3617,6 @@ export function buildApiSchemaComponents(): Readonly<Record<string, JsonObject>>
     return toOpenApiComponents(emitRawSchemas(), { strictComponents: STRICT_COMPONENTS });
 }
 
-/**
- * Explicit TypeScript recursion boundary for schemas whose runtime graph is lazy.
- *
- * Zod cannot infer a finite named type through a mutually-recursive graph. The schemas remain the
- * runtime and OpenAPI authority; these names preserve the recursive TypeScript declarations until
- * TypeScript can infer recursive aliases without collapsing them to `unknown`.
- */
-interface ZenoRecursiveComponentTypes {
-    ViewNavigationNode: ViewNavigationNode;
-    AgentRunResponse: AgentRunResponse;
-    AgentRunInternals: AgentRunInternals;
-    BindRunWorkflowPayload: BindRunWorkflowPayload;
-    BranchNodeBranchDefinition: BranchNodeBranchDefinition;
-    CreateEventSubscriptionPayload: CreateEventSubscriptionPayload;
-    CreateProcessDefinitionPayload: CreateProcessDefinitionPayload;
-    DSLChildWorkflowStep: DSLChildWorkflowStep;
-    DSLWorkflowDefinition: DSLWorkflowDefinition;
-    DSLWorkflowDefinitionResponse: DSLWorkflowDefinitionResponse;
-    DSLWorkflowSpec: DSLWorkflowSpec;
-    DSLWorkflowSpecWithActivities: DSLWorkflowTypes.DSLWorkflowSpecWithActivities;
-    DSLWorkflowSpecWithSteps: DSLWorkflowSpecWithSteps;
-    DSLWorkflowStep: DSLWorkflowStep;
-    EventDeliveryTarget: EventDeliveryTarget;
-    EventDeliveryTargetInput: EventDeliveryTargetInput;
-    EventSubscription: EventSubscription;
-    EventSubscriptionArray: EventSubscription[];
-    EventSubscriptionMutationResponse: EventSubscriptionMutationResponse;
-    ListAgentRunsResponse: ListAgentRunsResponse;
-    NodeDefinition: NodeDefinition;
-    NodeDefinitionMap: Record<string, NodeDefinition>;
-    ProcessDefinition: ProcessDefinition;
-    ProcessDefinitionArray: ProcessDefinition[];
-    ProcessDefinitionBody: ProcessDefinitionBody;
-    ProcessEventDeliveryTarget: ProcessEventDeliveryTarget;
-    ProgrammaticRunResponse: ProgrammaticRunResponse;
-    RecordRunPayload: RecordRunPayload;
-    SupervisedRunResponse: SupervisedRunResponse;
-    UpdateAgentRunStatusPayload: UpdateAgentRunStatusPayload;
-    UpdateEventSubscriptionPayload: UpdateEventSubscriptionPayload;
-    UpdateProcessDefinitionPayload: UpdateProcessDefinitionPayload;
-    WorkflowDefinitionPayload: DSLWorkflowTypes.WorkflowDefinitionPayload;
-    WorkflowDefinitionPayloadWithActivities: DSLWorkflowTypes.WorkflowDefinitionPayloadWithActivities;
-    WorkflowDefinitionPayloadWithSteps: DSLWorkflowTypes.WorkflowDefinitionPayloadWithSteps;
-}
-
-/**
- * The wire type a component publishes.
- *
- * `ApiComponentType<'Account'>` is the plain type `gen:schemas` writes for `AccountSchema` into
- * `ApiComponentTypes`, which `wire-types.generated.test.ts` proves identical to its `z.infer`. Indexing
- * that map rather than `z.infer<ApiSchemaMap[N]>` keeps Zod's inference out of every program that names
- * a component. A component the generator has not seen yet resolves to `never`, which
- * `registry-groups.test.ts` rejects.
- *
- * It is wrapped in `NoInfer` because `N` always comes from a component-name argument and can never be
- * recovered from the wire type. Without it, a call whose result has a contextual type — a destructuring
- * `const { file } = validatedQuery(ctx, 'FileMetadataQuery')`, an `await`, a typed `return` — makes the
- * checker infer `N` from that context while `N` is still unresolved, which evaluates `z.infer` across
- * every component in the registry: about 500k types, 1 GB and 2 s of `tsc` in each consuming program.
- */
-export type ApiComponentType<N extends ApiComponentName> = NoInfer<
-    N extends keyof ZenoRecursiveComponentTypes
-        ? ZenoRecursiveComponentTypes[N]
-        : N extends keyof ApiComponentTypes
-          ? ApiComponentTypes[N]
-          : never
->;
-
 /**
  * Names a published component from inside a handler signature:
  * `Promise<ApiSchemaOf<'Account'>>`.

package/src/wire-types.generated.ts

@@ -3514,6 +3514,7 @@ export type UserGroup = {
     clearance?: number | undefined;
     compartments?: string[] | undefined;
     allowed_projects?: string[] | undefined;
+    member_count?: number | undefined;
 };
 export type CreateUserGroupPayload = {
     name: string;