@api-client/core 0.19.0 → 0.19.2

package/build/src/modeling/ai/domain_response_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_response_schema.d.ts","sourceRoot":"","sources":["../../../../src/modeling/ai/domain_response_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AA0MjC;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FzB,CAAA"}

package/build/src/modeling/ai/domain_response_schema.js

@@ -0,0 +1,289 @@
+import { Type } from './types.js';
+const SemanticSchema = {
+    type: Type.OBJECT,
+    properties: {
+        id: { type: Type.STRING },
+        config: { type: Type.OBJECT },
+    },
+    required: ['id'],
+};
+const SchemaDefaultValue = {
+    type: Type.OBJECT,
+    properties: {
+        type: {
+            type: Type.STRING,
+            description: 'Enum: literal, function',
+        },
+        value: {
+            type: Type.STRING,
+            description: 'The default value of the property',
+        },
+    },
+    required: ['type'],
+};
+const PropertySchemaShape = {
+    type: Type.OBJECT,
+    properties: {
+        minimum: { type: Type.NUMBER },
+        maximum: { type: Type.NUMBER },
+        exclusiveMinimum: { type: Type.BOOLEAN },
+        exclusiveMaximum: { type: Type.BOOLEAN },
+        multipleOf: { type: Type.NUMBER },
+        enum: { type: Type.ARRAY, items: { type: Type.STRING } },
+        examples: { type: Type.ARRAY, items: { type: Type.STRING } },
+        defaultValue: SchemaDefaultValue,
+        pattern: { type: Type.STRING },
+    },
+};
+const PropertyConstraintsSchema = {
+    type: Type.OBJECT,
+    properties: {
+        required: { type: Type.BOOLEAN },
+        unique: { type: Type.BOOLEAN },
+        index: { type: Type.BOOLEAN },
+        primary: { type: Type.BOOLEAN },
+        multiple: { type: Type.BOOLEAN },
+        readOnly: { type: Type.BOOLEAN },
+        writeOnly: { type: Type.BOOLEAN },
+    },
+};
+/**
+ * Must comply with the `AiDomainProperty` type.
+ */
+const PropertySchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        name: { type: Type.STRING },
+        displayName: { type: Type.STRING },
+        description: { type: Type.STRING },
+        type: {
+            type: Type.STRING,
+            description: 'Enum: string, number, boolean, date, datetime, time, binary',
+        },
+        constraints: PropertyConstraintsSchema,
+        deprecated: { type: Type.BOOLEAN },
+        schema: PropertySchemaShape,
+        semantics: {
+            type: Type.ARRAY,
+            items: SemanticSchema,
+            description: "List of semantics applied to this property. Note: ONLY use semantics with scope='property'.",
+        },
+        tags: { type: Type.ARRAY, items: { type: Type.STRING } },
+    },
+    required: ['key', 'name', 'type', 'displayName', 'description'],
+};
+const AssociationSchemaShape = {
+    type: Type.OBJECT,
+    properties: {
+        linked: { type: Type.BOOLEAN },
+        unionType: { type: Type.STRING, description: 'Enum: allOf, anyOf, oneOf, not' },
+    },
+};
+/**
+ * Must comply with the `AiDomainAssociation` type.
+ */
+const AssociationSchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        name: { type: Type.STRING },
+        displayName: { type: Type.STRING },
+        description: { type: Type.STRING },
+        targets: { type: Type.ARRAY, items: { type: Type.STRING }, description: 'List of target entity keys' },
+        required: { type: Type.BOOLEAN },
+        multiple: {
+            type: Type.BOOLEAN,
+            description: 'Whether the association can have multiple targets (like User has multiple addresses)',
+        },
+        onDelete: { type: Type.STRING, description: 'Enum: restrict, cascade, setNull, doNothing' },
+        semantics: {
+            type: Type.ARRAY,
+            items: SemanticSchema,
+            description: "List of semantics applied to this association. Note: ONLY use semantics with scope='association'.",
+        },
+        schema: AssociationSchemaShape,
+    },
+    required: ['key', 'name', 'targets', 'displayName', 'description'],
+};
+/**
+ * Must comply with the `AiDataModel` type.
+ */
+const ModelSchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        name: { type: Type.STRING },
+        description: { type: Type.STRING },
+    },
+    required: ['key', 'name'],
+};
+/**
+ * Must comply with the `AiDomainEntityResponseSchema` type.
+ */
+const EntitySchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        modelKey: { type: Type.STRING, description: 'The Domain Model this entity belongs to (e.g. "users", "shipping")' },
+        name: { type: Type.STRING },
+        displayName: { type: Type.STRING },
+        description: { type: Type.STRING },
+        tags: { type: Type.ARRAY, items: { type: Type.STRING } },
+        semantics: {
+            type: Type.ARRAY,
+            items: SemanticSchema,
+            description: "List of semantics applied to this entity. Note: ONLY use semantics with scope='entity'.",
+        },
+        properties: { type: Type.ARRAY, items: PropertySchema },
+        associations: { type: Type.ARRAY, items: AssociationSchema },
+    },
+    required: ['key', 'name', 'modelKey', 'displayName', 'description'],
+};
+const PropertyDeltaSchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        name: { type: Type.STRING },
+        displayName: { type: Type.STRING },
+        description: { type: Type.STRING },
+        type: {
+            type: Type.STRING,
+            description: 'Enum: string, number, boolean, date, datetime, time, binary',
+        },
+        constraints: PropertyConstraintsSchema,
+        deprecated: { type: Type.BOOLEAN },
+        schema: PropertySchemaShape,
+        addedSemantics: {
+            type: Type.ARRAY,
+            items: SemanticSchema,
+            description: "Semantics to add. Note: ONLY use semantics with scope='property'.",
+        },
+        modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },
+        deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },
+    },
+    required: ['key'],
+};
+const AssociationDeltaSchema = {
+    type: Type.OBJECT,
+    properties: {
+        key: { type: Type.STRING },
+        name: { type: Type.STRING },
+        displayName: { type: Type.STRING },
+        description: { type: Type.STRING },
+        targets: { type: Type.ARRAY, items: { type: Type.STRING } },
+        required: { type: Type.BOOLEAN },
+        multiple: {
+            type: Type.BOOLEAN,
+            description: 'Whether the association can have multiple targets (like User has multiple addresses)',
+        },
+        onDelete: { type: Type.STRING, description: 'Enum: restrict, cascade, setNull, doNothing' },
+        addedSemantics: {
+            type: Type.ARRAY,
+            items: SemanticSchema,
+            description: "Semantics to add. Note: ONLY use semantics with scope='association'.",
+        },
+        modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },
+        deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },
+    },
+    required: ['key'],
+};
+/**
+ * Must comply with the `AiDomainDeltaResponse` type.
+ */
+export const DOMAIN_SCHEMA = {
+    type: Type.OBJECT,
+    properties: {
+        sessionTitle: {
+            type: Type.STRING,
+            description: 'A short, 3-to-5 word descriptive title for this data modeling session.',
+        },
+        reasoning: {
+            type: Type.STRING,
+            description: 'Conversational response analyzing the request or explaining changes, in markdown format',
+        },
+        delta: {
+            type: Type.OBJECT,
+            properties: {
+                addedModels: {
+                    type: Type.ARRAY,
+                    items: ModelSchema,
+                    description: 'Brand new models to create',
+                },
+                deletedModelKeys: {
+                    type: Type.ARRAY,
+                    items: { type: Type.STRING },
+                    description: 'Keys of completely removed models. This also removes all entities and associations in the model.',
+                },
+                modifiedModels: {
+                    type: Type.ARRAY,
+                    items: ModelSchema,
+                    description: 'Models to modify in the domain',
+                },
+                addedEntities: {
+                    type: Type.ARRAY,
+                    items: EntitySchema,
+                    description: 'Brand new entities to create',
+                },
+                deletedEntityKeys: {
+                    type: Type.ARRAY,
+                    items: { type: Type.STRING },
+                    description: 'Keys of completely removed entities',
+                },
+                modifiedEntities: {
+                    type: Type.ARRAY,
+                    items: {
+                        type: Type.OBJECT,
+                        properties: {
+                            key: { type: Type.STRING, description: 'The original key of the existing entity being modified' },
+                            modelKey: {
+                                type: Type.STRING,
+                                description: 'Change this to migrate the entity to a different model (boundary)',
+                            },
+                            name: { type: Type.STRING },
+                            displayName: { type: Type.STRING },
+                            description: { type: Type.STRING },
+                            tags: { type: Type.ARRAY, items: { type: Type.STRING } },
+                            addedSemantics: {
+                                type: Type.ARRAY,
+                                items: SemanticSchema,
+                                description: "Semantics to add. Note: ONLY use semantics with scope='entity'.",
+                            },
+                            modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },
+                            deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },
+                            addedProperties: { type: Type.ARRAY, items: PropertySchema },
+                            modifiedProperties: { type: Type.ARRAY, items: PropertyDeltaSchema },
+                            deletedPropertyKeys: { type: Type.ARRAY, items: { type: Type.STRING } },
+                            addedAssociations: { type: Type.ARRAY, items: AssociationSchema },
+                            modifiedAssociations: { type: Type.ARRAY, items: AssociationDeltaSchema },
+                            deletedAssociationKeys: { type: Type.ARRAY, items: { type: Type.STRING } },
+                        },
+                        required: [
+                            'key',
+                            // 'addedSemantics',
+                            // 'modifiedSemantics',
+                            // 'deletedSemanticIds',
+                            // 'addedProperties',
+                            // 'modifiedProperties',
+                            // 'deletedPropertyKeys',
+                            // 'addedAssociations',
+                            // 'modifiedAssociations',
+                            // 'deletedAssociationKeys',
+                        ],
+                    },
+                    description: 'Modifications to existing entities like adding, removing, or changing properties/associations',
+                },
+            },
+            required: [
+                'addedModels',
+                'deletedModelKeys',
+                'modifiedModels',
+                'addedEntities',
+                'deletedEntityKeys',
+                'modifiedEntities',
+            ],
+        },
+    },
+    required: ['reasoning', 'delta'],
+};
+//# sourceMappingURL=domain_response_schema.js.map

package/build/src/modeling/ai/domain_response_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_response_schema.js","sourceRoot":"","sources":["../../../../src/modeling/ai/domain_response_schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type } from './types.js'\n\nconst SemanticSchema = {\n  type: Type.OBJECT,\n  properties: {\n    id: { type: Type.STRING },\n    config: { type: Type.OBJECT },\n  },\n  required: ['id'],\n}\n\nconst SchemaDefaultValue = {\n  type: Type.OBJECT,\n  properties: {\n    type: {\n      type: Type.STRING,\n      description: 'Enum: literal, function',\n    },\n    value: {\n      type: Type.STRING,\n      description: 'The default value of the property',\n    },\n  },\n  required: ['type'],\n}\n\nconst PropertySchemaShape = {\n  type: Type.OBJECT,\n  properties: {\n    minimum: { type: Type.NUMBER },\n    maximum: { type: Type.NUMBER },\n    exclusiveMinimum: { type: Type.BOOLEAN },\n    exclusiveMaximum: { type: Type.BOOLEAN },\n    multipleOf: { type: Type.NUMBER },\n    enum: { type: Type.ARRAY, items: { type: Type.STRING } },\n    examples: { type: Type.ARRAY, items: { type: Type.STRING } },\n    defaultValue: SchemaDefaultValue,\n    pattern: { type: Type.STRING },\n  },\n}\n\nconst PropertyConstraintsSchema = {\n  type: Type.OBJECT,\n  properties: {\n    required: { type: Type.BOOLEAN },\n    unique: { type: Type.BOOLEAN },\n    index: { type: Type.BOOLEAN },\n    primary: { type: Type.BOOLEAN },\n    multiple: { type: Type.BOOLEAN },\n    readOnly: { type: Type.BOOLEAN },\n    writeOnly: { type: Type.BOOLEAN },\n  },\n}\n\n/**\n * Must comply with the `AiDomainProperty` type.\n */\nconst PropertySchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    name: { type: Type.STRING },\n    displayName: { type: Type.STRING },\n    description: { type: Type.STRING },\n    type: {\n      type: Type.STRING,\n      description: 'Enum: string, number, boolean, date, datetime, time, binary',\n    },\n    constraints: PropertyConstraintsSchema,\n    deprecated: { type: Type.BOOLEAN },\n    schema: PropertySchemaShape,\n    semantics: {\n      type: Type.ARRAY,\n      items: SemanticSchema,\n      description: \"List of semantics applied to this property. Note: ONLY use semantics with scope='property'.\",\n    },\n    tags: { type: Type.ARRAY, items: { type: Type.STRING } },\n  },\n  required: ['key', 'name', 'type', 'displayName', 'description'],\n}\n\nconst AssociationSchemaShape = {\n  type: Type.OBJECT,\n  properties: {\n    linked: { type: Type.BOOLEAN },\n    unionType: { type: Type.STRING, description: 'Enum: allOf, anyOf, oneOf, not' },\n  },\n}\n\n/**\n * Must comply with the `AiDomainAssociation` type.\n */\nconst AssociationSchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    name: { type: Type.STRING },\n    displayName: { type: Type.STRING },\n    description: { type: Type.STRING },\n    targets: { type: Type.ARRAY, items: { type: Type.STRING }, description: 'List of target entity keys' },\n    required: { type: Type.BOOLEAN },\n    multiple: {\n      type: Type.BOOLEAN,\n      description: 'Whether the association can have multiple targets (like User has multiple addresses)',\n    },\n    onDelete: { type: Type.STRING, description: 'Enum: restrict, cascade, setNull, doNothing' },\n    semantics: {\n      type: Type.ARRAY,\n      items: SemanticSchema,\n      description: \"List of semantics applied to this association. Note: ONLY use semantics with scope='association'.\",\n    },\n    schema: AssociationSchemaShape,\n  },\n  required: ['key', 'name', 'targets', 'displayName', 'description'],\n}\n\n/**\n * Must comply with the `AiDataModel` type.\n */\nconst ModelSchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    name: { type: Type.STRING },\n    description: { type: Type.STRING },\n  },\n  required: ['key', 'name'],\n}\n\n/**\n * Must comply with the `AiDomainEntityResponseSchema` type.\n */\nconst EntitySchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    modelKey: { type: Type.STRING, description: 'The Domain Model this entity belongs to (e.g. \"users\", \"shipping\")' },\n    name: { type: Type.STRING },\n    displayName: { type: Type.STRING },\n    description: { type: Type.STRING },\n    tags: { type: Type.ARRAY, items: { type: Type.STRING } },\n    semantics: {\n      type: Type.ARRAY,\n      items: SemanticSchema,\n      description: \"List of semantics applied to this entity. Note: ONLY use semantics with scope='entity'.\",\n    },\n    properties: { type: Type.ARRAY, items: PropertySchema },\n    associations: { type: Type.ARRAY, items: AssociationSchema },\n  },\n  required: ['key', 'name', 'modelKey', 'displayName', 'description'],\n}\n\nconst PropertyDeltaSchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    name: { type: Type.STRING },\n    displayName: { type: Type.STRING },\n    description: { type: Type.STRING },\n    type: {\n      type: Type.STRING,\n      description: 'Enum: string, number, boolean, date, datetime, time, binary',\n    },\n    constraints: PropertyConstraintsSchema,\n    deprecated: { type: Type.BOOLEAN },\n    schema: PropertySchemaShape,\n    addedSemantics: {\n      type: Type.ARRAY,\n      items: SemanticSchema,\n      description: \"Semantics to add. Note: ONLY use semantics with scope='property'.\",\n    },\n    modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },\n    deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },\n  },\n  required: ['key'],\n}\n\nconst AssociationDeltaSchema = {\n  type: Type.OBJECT,\n  properties: {\n    key: { type: Type.STRING },\n    name: { type: Type.STRING },\n    displayName: { type: Type.STRING },\n    description: { type: Type.STRING },\n    targets: { type: Type.ARRAY, items: { type: Type.STRING } },\n    required: { type: Type.BOOLEAN },\n    multiple: {\n      type: Type.BOOLEAN,\n      description: 'Whether the association can have multiple targets (like User has multiple addresses)',\n    },\n    onDelete: { type: Type.STRING, description: 'Enum: restrict, cascade, setNull, doNothing' },\n    addedSemantics: {\n      type: Type.ARRAY,\n      items: SemanticSchema,\n      description: \"Semantics to add. Note: ONLY use semantics with scope='association'.\",\n    },\n    modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },\n    deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },\n  },\n  required: ['key'],\n}\n\n/**\n * Must comply with the `AiDomainDeltaResponse` type.\n */\nexport const DOMAIN_SCHEMA = {\n  type: Type.OBJECT,\n  properties: {\n    sessionTitle: {\n      type: Type.STRING,\n      description: 'A short, 3-to-5 word descriptive title for this data modeling session.',\n    },\n    reasoning: {\n      type: Type.STRING,\n      description: 'Conversational response analyzing the request or explaining changes, in markdown format',\n    },\n    delta: {\n      type: Type.OBJECT,\n      properties: {\n        addedModels: {\n          type: Type.ARRAY,\n          items: ModelSchema,\n          description: 'Brand new models to create',\n        },\n        deletedModelKeys: {\n          type: Type.ARRAY,\n          items: { type: Type.STRING },\n          description:\n            'Keys of completely removed models. This also removes all entities and associations in the model.',\n        },\n        modifiedModels: {\n          type: Type.ARRAY,\n          items: ModelSchema,\n          description: 'Models to modify in the domain',\n        },\n        addedEntities: {\n          type: Type.ARRAY,\n          items: EntitySchema,\n          description: 'Brand new entities to create',\n        },\n        deletedEntityKeys: {\n          type: Type.ARRAY,\n          items: { type: Type.STRING },\n          description: 'Keys of completely removed entities',\n        },\n        modifiedEntities: {\n          type: Type.ARRAY,\n          items: {\n            type: Type.OBJECT,\n            properties: {\n              key: { type: Type.STRING, description: 'The original key of the existing entity being modified' },\n              modelKey: {\n                type: Type.STRING,\n                description: 'Change this to migrate the entity to a different model (boundary)',\n              },\n              name: { type: Type.STRING },\n              displayName: { type: Type.STRING },\n              description: { type: Type.STRING },\n              tags: { type: Type.ARRAY, items: { type: Type.STRING } },\n              addedSemantics: {\n                type: Type.ARRAY,\n                items: SemanticSchema,\n                description: \"Semantics to add. Note: ONLY use semantics with scope='entity'.\",\n              },\n              modifiedSemantics: { type: Type.ARRAY, items: SemanticSchema },\n              deletedSemanticIds: { type: Type.ARRAY, items: { type: Type.STRING } },\n              addedProperties: { type: Type.ARRAY, items: PropertySchema },\n              modifiedProperties: { type: Type.ARRAY, items: PropertyDeltaSchema },\n              deletedPropertyKeys: { type: Type.ARRAY, items: { type: Type.STRING } },\n              addedAssociations: { type: Type.ARRAY, items: AssociationSchema },\n              modifiedAssociations: { type: Type.ARRAY, items: AssociationDeltaSchema },\n              deletedAssociationKeys: { type: Type.ARRAY, items: { type: Type.STRING } },\n            },\n            required: [\n              'key',\n              // 'addedSemantics',\n              // 'modifiedSemantics',\n              // 'deletedSemanticIds',\n              // 'addedProperties',\n              // 'modifiedProperties',\n              // 'deletedPropertyKeys',\n              // 'addedAssociations',\n              // 'modifiedAssociations',\n              // 'deletedAssociationKeys',\n            ],\n          },\n          description: 'Modifications to existing entities like adding, removing, or changing properties/associations',\n        },\n      },\n      required: [\n        'addedModels',\n        'deletedModelKeys',\n        'modifiedModels',\n        'addedEntities',\n        'deletedEntityKeys',\n        'modifiedEntities',\n      ],\n    },\n  },\n  required: ['reasoning', 'delta'],\n}\n"]}

package/build/src/modeling/ai/domain_tools.d.ts

@@ -0,0 +1,68 @@
+import { Type } from './types.js';
+import { ToolConfig } from './tools/config.js';
+/**
+ * All tools available for the AI to use when modeling a domain.
+ */
+export declare const tools: {
+    functionDeclarations: ({
+        name: string;
+        description: string;
+        parametersJsonSchema: {
+            type: Type;
+            properties: {
+                semanticId?: undefined;
+                entityKey?: undefined;
+                dataType?: undefined;
+            };
+            required: never[];
+        };
+    } | {
+        name: string;
+        description: string;
+        parametersJsonSchema: {
+            type: Type;
+            properties: {
+                semanticId: {
+                    type: Type;
+                    description: string;
+                };
+                entityKey?: undefined;
+                dataType?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        parametersJsonSchema: {
+            type: Type;
+            properties: {
+                entityKey: {
+                    type: Type;
+                    description: string;
+                };
+                semanticId?: undefined;
+                dataType?: undefined;
+            };
+            required: string[];
+        };
+    } | {
+        name: string;
+        description: string;
+        parametersJsonSchema: {
+            type: Type;
+            properties: {
+                dataType: {
+                    type: Type;
+                    description: string;
+                };
+                semanticId?: undefined;
+                entityKey?: undefined;
+            };
+            required: string[];
+        };
+    })[];
+}[];
+export type ToolFunction = (config: ToolConfig, args: Record<string, unknown>) => unknown | Promise<unknown>;
+export declare const functions: Record<string, ToolFunction>;
+//# sourceMappingURL=domain_tools.d.ts.map

package/build/src/modeling/ai/domain_tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_tools.d.ts","sourceRoot":"","sources":["../../../../src/modeling/ai/domain_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DjB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE5G,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKlD,CAAA"}

package/build/src/modeling/ai/domain_tools.js

@@ -0,0 +1,71 @@
+import { Type } from './types.js';
+import { get_semantic_details, list_semantics } from './tools/Semantic.tools.js';
+import { explain_schema, get_entity_details } from './tools/DataDomain.tools.js';
+/**
+ * All tools available for the AI to use when modeling a domain.
+ */
+export const tools = [
+    {
+        functionDeclarations: [
+            {
+                name: 'list_semantics',
+                description: 'List all available data semantics, their scopes, and whether they have configuration options.',
+                parametersJsonSchema: {
+                    type: Type.OBJECT,
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: 'get_semantic_details',
+                description: 'Get detailed information about a specific data semantic, notably its JSON ' +
+                    'configuration schema properties, to determine what additional config you might want to provide.',
+                parametersJsonSchema: {
+                    type: Type.OBJECT,
+                    properties: {
+                        semanticId: {
+                            type: Type.STRING,
+                            description: 'The exact ID of the semantic (e.g. Semantic#Password, Semantic#Tags)',
+                        },
+                    },
+                    required: ['semanticId'],
+                },
+            },
+            {
+                name: 'get_entity_details',
+                description: 'Get the full details of an entity given its key, including properties, associations, and tags.',
+                parametersJsonSchema: {
+                    type: Type.OBJECT,
+                    properties: {
+                        entityKey: {
+                            type: Type.STRING,
+                            description: 'The exact key/ID of the entity to fetch details for.',
+                        },
+                    },
+                    required: ['entityKey'],
+                },
+            },
+            {
+                name: 'explain_schema',
+                description: 'Explains the schema of a data type.',
+                parametersJsonSchema: {
+                    type: Type.OBJECT,
+                    properties: {
+                        dataType: {
+                            type: Type.STRING,
+                            description: 'The data type (e.g. string, number, boolean, date, datetime, time, binary)',
+                        },
+                    },
+                    required: ['dataType'],
+                },
+            },
+        ],
+    },
+];
+export const functions = {
+    list_semantics,
+    get_semantic_details,
+    explain_schema,
+    get_entity_details,
+};
+//# sourceMappingURL=domain_tools.js.map

package/build/src/modeling/ai/domain_tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain_tools.js","sourceRoot":"","sources":["../../../../src/modeling/ai/domain_tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGhF;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB;QACE,oBAAoB,EAAE;YACpB;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,+FAA+F;gBAC5G,oBAAoB,EAAE;oBACpB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EACT,4EAA4E;oBAC5E,iGAAiG;gBACnG,oBAAoB,EAAE;oBACpB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,UAAU,EAAE;wBACV,UAAU,EAAE;4BACV,IAAI,EAAE,IAAI,CAAC,MAAM;4BACjB,WAAW,EAAE,sEAAsE;yBACpF;qBACF;oBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;iBACzB;aACF;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,gGAAgG;gBAC7G,oBAAoB,EAAE;oBACpB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,UAAU,EAAE;wBACV,SAAS,EAAE;4BACT,IAAI,EAAE,IAAI,CAAC,MAAM;4BACjB,WAAW,EAAE,sDAAsD;yBACpE;qBACF;oBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;iBACxB;aACF;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,qCAAqC;gBAClD,oBAAoB,EAAE;oBACpB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,UAAU,EAAE;wBACV,QAAQ,EAAE;4BACR,IAAI,EAAE,IAAI,CAAC,MAAM;4BACjB,WAAW,EAAE,4EAA4E;yBAC1F;qBACF;oBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;iBACvB;aACF;SACF;KACF;CACF,CAAA;AAID,MAAM,CAAC,MAAM,SAAS,GAAiC;IACrD,cAAc;IACd,oBAAoB;IACpB,cAAc;IACd,kBAAkB;CACnB,CAAA","sourcesContent":["import { Type } from './types.js'\nimport { get_semantic_details, list_semantics } from './tools/Semantic.tools.js'\nimport { explain_schema, get_entity_details } from './tools/DataDomain.tools.js'\nimport { ToolConfig } from './tools/config.js'\n\n/**\n * All tools available for the AI to use when modeling a domain.\n */\nexport const tools = [\n  {\n    functionDeclarations: [\n      {\n        name: 'list_semantics',\n        description: 'List all available data semantics, their scopes, and whether they have configuration options.',\n        parametersJsonSchema: {\n          type: Type.OBJECT,\n          properties: {},\n          required: [],\n        },\n      },\n      {\n        name: 'get_semantic_details',\n        description:\n          'Get detailed information about a specific data semantic, notably its JSON ' +\n          'configuration schema properties, to determine what additional config you might want to provide.',\n        parametersJsonSchema: {\n          type: Type.OBJECT,\n          properties: {\n            semanticId: {\n              type: Type.STRING,\n              description: 'The exact ID of the semantic (e.g. Semantic#Password, Semantic#Tags)',\n            },\n          },\n          required: ['semanticId'],\n        },\n      },\n      {\n        name: 'get_entity_details',\n        description: 'Get the full details of an entity given its key, including properties, associations, and tags.',\n        parametersJsonSchema: {\n          type: Type.OBJECT,\n          properties: {\n            entityKey: {\n              type: Type.STRING,\n              description: 'The exact key/ID of the entity to fetch details for.',\n            },\n          },\n          required: ['entityKey'],\n        },\n      },\n      {\n        name: 'explain_schema',\n        description: 'Explains the schema of a data type.',\n        parametersJsonSchema: {\n          type: Type.OBJECT,\n          properties: {\n            dataType: {\n              type: Type.STRING,\n              description: 'The data type (e.g. string, number, boolean, date, datetime, time, binary)',\n            },\n          },\n          required: ['dataType'],\n        },\n      },\n    ],\n  },\n]\n\nexport type ToolFunction = (config: ToolConfig, args: Record<string, unknown>) => unknown | Promise<unknown>\n\nexport const functions: Record<string, ToolFunction> = {\n  list_semantics,\n  get_semantic_details,\n  explain_schema,\n  get_entity_details,\n}\n"]}

package/build/src/modeling/ai/index.d.ts

@@ -0,0 +1,10 @@
+export { default as domainSystemInstructions } from './prompts/domain_system.js';
+export { functions as domainFunctions, tools as domainTools } from './domain_tools.js';
+export * from './types.js';
+export { DataDomainDelta } from './DataDomainDelta.js';
+export { serializeDomainForAi, serializeEntity } from './DomainSerialization.js';
+export { DOMAIN_SCHEMA } from './domain_response_schema.js';
+export { detectReasoning, parseAiChatMessage } from './message_parser.js';
+export { AiSemanticsConfig } from './Semantics.js';
+export type { ToolConfig } from './tools/config.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/modeling/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modeling/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACtF,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA"}

package/build/src/modeling/ai/index.js

@@ -0,0 +1,9 @@
+export { default as domainSystemInstructions } from './prompts/domain_system.js';
+export { functions as domainFunctions, tools as domainTools } from './domain_tools.js';
+export * from './types.js';
+export { DataDomainDelta } from './DataDomainDelta.js';
+export { serializeDomainForAi, serializeEntity } from './DomainSerialization.js';
+export { DOMAIN_SCHEMA } from './domain_response_schema.js';
+export { detectReasoning, parseAiChatMessage } from './message_parser.js';
+export { AiSemanticsConfig } from './Semantics.js';
+//# sourceMappingURL=index.js.map

package/build/src/modeling/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modeling/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACtF,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA","sourcesContent":["export { default as domainSystemInstructions } from './prompts/domain_system.js'\nexport { functions as domainFunctions, tools as domainTools } from './domain_tools.js'\nexport * from './types.js'\nexport { DataDomainDelta } from './DataDomainDelta.js'\nexport { serializeDomainForAi, serializeEntity } from './DomainSerialization.js'\nexport { DOMAIN_SCHEMA } from './domain_response_schema.js'\nexport { detectReasoning, parseAiChatMessage } from './message_parser.js'\nexport { AiSemanticsConfig } from './Semantics.js'\nexport type { ToolConfig } from './tools/config.js'\n"]}

package/build/src/modeling/ai/message_parser.d.ts

@@ -0,0 +1,23 @@
+import type { AiModelMessageWithDelta } from './types.js';
+import type { AiMessageSchema, AiUserMessage } from '../../models/AiMessage.js';
+/**
+ * Parses an incoming `AiMessage` and maps it directly into its runtime
+ * representations `AiUserMessage` or `AiModelMessageWithDelta`.
+ *
+ * If the message is a model message, it attempts to parse the structured JSON
+ * contents in `msg.text` and sets the `delta` field accordingly. The `text` field
+ * is replaced with the reasoning text, or remains original if parsing fails/is omitted.
+ *
+ * @param msg The generic AI chat message.
+ * @returns The parsed in-memory wrapper context message.
+ */
+export declare function parseAiChatMessage(msg: AiMessageSchema): AiUserMessage | AiModelMessageWithDelta;
+/**
+ * When a model response is generated it may contain the `reasoning` property. But because
+ * that property might still be generated it might not be a valid JSON. This function checks
+ * if the text contains reasoning and returns it if it does.
+ * @param text The text to check.
+ * @returns The reasoning string if it exists, otherwise undefined.
+ */
+export declare function detectReasoning(text: string): string | undefined;
+//# sourceMappingURL=message_parser.d.ts.map

package/build/src/modeling/ai/message_parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_parser.d.ts","sourceRoot":"","sources":["../../../../src/modeling/ai/message_parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAG/E;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa,GAAG,uBAAuB,CAoBhG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwDhE"}

package/build/src/modeling/ai/message_parser.js

@@ -0,0 +1,93 @@
+import { DataDomainDelta } from './DataDomainDelta.js';
+/**
+ * Parses an incoming `AiMessage` and maps it directly into its runtime
+ * representations `AiUserMessage` or `AiModelMessageWithDelta`.
+ *
+ * If the message is a model message, it attempts to parse the structured JSON
+ * contents in `msg.text` and sets the `delta` field accordingly. The `text` field
+ * is replaced with the reasoning text, or remains original if parsing fails/is omitted.
+ *
+ * @param msg The generic AI chat message.
+ * @returns The parsed in-memory wrapper context message.
+ */
+export function parseAiChatMessage(msg) {
+    if (msg.role === 'user') {
+        return msg;
+    }
+    const modelMsg = { ...msg };
+    // Try to parse the delta structure
+    if (modelMsg.state === 'complete' && modelMsg.text) {
+        try {
+            const parsedJSON = JSON.parse(modelMsg.text);
+            modelMsg.delta = parsedJSON.delta ? DataDomainDelta.normalize(parsedJSON.delta) : undefined;
+            modelMsg.text = parsedJSON.reasoning || modelMsg.text;
+        }
+        catch {
+            // It might legitimately not be valid JSON yet if it crashed mid-stream,
+            // fallback to retaining original shape.
+        }
+    }
+    return modelMsg;
+}
+/**
+ * When a model response is generated it may contain the `reasoning` property. But because
+ * that property might still be generated it might not be a valid JSON. This function checks
+ * if the text contains reasoning and returns it if it does.
+ * @param text The text to check.
+ * @returns The reasoning string if it exists, otherwise undefined.
+ */
+export function detectReasoning(text) {
+    try {
+        const parsedJSON = JSON.parse(text);
+        return parsedJSON.reasoning;
+    }
+    catch {
+        // Continue below
+    }
+    const searchStr = '"reasoning"';
+    const keyIndex = text.indexOf(searchStr);
+    if (keyIndex === -1) {
+        return undefined;
+    }
+    const afterKey = text.substring(keyIndex + searchStr.length);
+    const colonIndex = afterKey.indexOf(':');
+    if (colonIndex === -1) {
+        return undefined;
+    }
+    const afterColon = afterKey.substring(colonIndex + 1);
+    const quoteIndex = afterColon.indexOf('"');
+    if (quoteIndex === -1) {
+        return undefined;
+    }
+    const valueStr = afterColon.substring(quoteIndex + 1);
+    let isEscaped = false;
+    let endIndex = -1;
+    for (let i = 0; i < valueStr.length; i++) {
+        const char = valueStr[i];
+        if (char === '\\' && !isEscaped) {
+            isEscaped = true;
+        }
+        else if (char === '"' && !isEscaped) {
+            endIndex = i;
+            break;
+        }
+        else {
+            isEscaped = false;
+        }
+    }
+    const extracted = endIndex !== -1 ? valueStr.substring(0, endIndex) : valueStr;
+    try {
+        // Try to safely parse the literal string value.
+        return JSON.parse('"' + extracted + '"');
+    }
+    catch {
+        // string replace fallback
+        return extracted
+            .replace(/\\n/g, '\n')
+            .replace(/\\r/g, '\r')
+            .replace(/\\t/g, '\t')
+            .replace(/\\"/g, '"')
+            .replace(/\\\\/g, '\\');
+    }
+}
+//# sourceMappingURL=message_parser.js.map