@acorex-platform/extension-ai-platform-management-client 0.0.46

package/fesm2022/acorex-platform-extension-ai-platform-management-client-contracts.mjs

@@ -0,0 +1,329 @@
+//#region ----- Reuse platform definition -----
+const AXE_APP_BUILDER_SKILL_REUSE_ID = 'e0000001-0000-4000-8000-000000000020';
+const AXE_APP_BUILDER_SKILL_REUSE_NAME = 'reuse-platform-definition';
+const AXE_APP_BUILDER_SKILL_REUSE_MARKDOWN = [
+    '## Reuse platform definition',
+    '',
+    'Follow this playbook **before** any insert, when the user wants a new module, entity, or relationship (Persian: ماژول بساز، موجودیت، ارتباط با کاربر).',
+    '',
+    '### Hard rules',
+    '- Your **first** action is a **tool call**. Do not invent `Module.Entity` keys or a new Owner/User entity.',
+    '- This assist **has** `PlatformManagement:ListRegisteredEntities` and `Entity:Query:Default`. It does **not** write TypeScript, menus, or i18n JSON files.',
+    '- A **module** is a row of `PlatformManagement.ModuleDefinition`. An **entity** is a row of `PlatformManagement.EntityDefinition` whose stored `name` is `Module.Entity`.',
+    '- A relationship to something that already exists is a **lookup property**, not a new entity.',
+    '- Identifiers (`name`) are PascalCase English (`RentManagement`, `Vehicle`). Titles are human text in the user language. `name` must match `^[A-Za-z][A-Za-z0-9]*$` — no spaces, hyphens, or Persian.',
+    '',
+    '### Worked prompt',
+    'User: «می‌خواهم یک ماژول rent ماشین داشته باشم».',
+    '',
+    'Decide:',
+    '- Module `name`: `RentManagement` (not `rent`, not `CarRental`). `i18n`: `rent-management`. `type`: `domain`. `domain`: `operations`.',
+    '- New entities: `Vehicle` (the car) and `Rental` (the agreement).',
+    '- **Do not** create `Owner`, `User`, or `Car`. The owner is `ownerId` on `Rental`, a lookup to the existing user entity.',
+    '- Find that user entity with `ListRegisteredEntities` `search`: `user`. Expect `SecurityManagement.User`. Read `properties` and use a real title field (`displayName`, `title`, or `name`) as `textField`. If `matchStatus` is `none`, stop and say the user entity is missing. Do not invent the key.',
+    '- `Rental.vehicleId` looks up `RentManagement.Vehicle` **after** Vehicle is stored.',
+    '- After both entities exist, Vehicle can list its rentals (`relatedEntities` → `RentManagement.Rental`, `foreignKeyField`: `vehicleId`). That is an update, not a third entity.',
+    '',
+    '### Steps',
+    '1. **Modules.** `Entity:Query:Default` with `entity`: `PlatformManagement.ModuleDefinition` and `quickSearch` set to the intended module name. If `items[].name` already equals that name, reuse it. Do not insert a second module.',
+    '2. **Entities.** `ListRegisteredEntities` with `search` for each noun (vehicle, rental, user, and any name the user used). `matchStatus` `single` or a clear `fullName` means reuse. `multiple` means pick or ask. `none` means it can be created.',
+    '3. **Schema of a lookup target.** Call `ListRegisteredEntities` with `entityFullName` before choosing `textField` or `expose`.',
+    '4. **Hand off.** Tell the next skills the module name, the entity list, and which fields are lookups. Do not insert in this skill.',
+].join('\n');
+//#endregion
+
+//#region ----- Compose AXPEntity -----
+const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_ID = 'e0000001-0000-4000-8000-000000000023';
+const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME = 'compose-axp-entity';
+const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_MARKDOWN = [
+    '## Compose AXPEntity',
+    '',
+    'Follow this playbook whenever you build an entity. You do **not** have the platform source. The object you put in `content` **is** `AXPEntity`. **write-entity-definition** only stores that object. Do not invent a second schema.',
+    '',
+    '### Stored shape',
+    '`content` keys:',
+    '- `module`, `name` (short PascalCase), `title`, `icon`',
+    '- `searchTags`: string keywords in any language. Not i18n keys.',
+    '- `formats`: `{ individual, plural, displayName?, searchResult: { title, description } }`. `searchResult.title` is usually `{{ title }}`.',
+    '- `groups`: `{ id, title, description?, icon? }[]`',
+    '- `properties`: see below. Always include hidden `id`.',
+    '- `columns`: list columns `{ name, title?, showAs?: { type }, options?: { width, order } }`',
+    '- `interfaces.master`: `list`, `create`, `update`, `single`',
+    '- `relatedEntities?`, `plugins?`, `category?`, `pages?`, `rules?`, `validations?`, `commands?`, `queries?`, `parentKey?`',
+    '',
+    'Do **not** emit `AXPEntityV2`, aggregates, or TypeScript helpers (`entityMasterCrudActions`, `createAllQueryView`). Write the JSON those helpers would have produced.',
+    '',
+    '### Property',
+    'Each property:',
+    '`{ name, title, description?, groupId, schema: { dataType, nullable?, readonly?, visible?, defaultValue?, unique?: { enabled }, interface?: { type, options?, children?, mode? } }, options?: { sort: { enabled }, filter: { inline: { enabled }, advance: { enabled } } }, validations? }`',
+    '',
+    '`validations` entries: `{ rule: "required" }`, `{ rule: "minLength", options: { minLength } }`, `{ rule: "maxLength", options: { maxLength } }`, `{ rule: "regex", options: { value } }`, `{ rule: "equal", options: { value } }`.',
+    '',
+    'Hidden primary key on every entity:',
+    '`{ "name": "id", "title": "Id", "groupId": "basic-info", "schema": { "dataType": "uuid", "visible": false, "readonly": true, "unique": { "enabled": true } } }`',
+    '',
+    '### Widget `interface.type` and `dataType`',
+    'Use only these registry names for fields:',
+    '- short text → `text-editor` / `string`',
+    '- notes → `large-text-editor` / `string`',
+    '- rich text → `rich-text-editor` / `string`',
+    '- money, count, measurement → `number-editor` / `number`',
+    '- number plus unit → `number-unit-editor` / `number`',
+    '- date or time → `date-time-editor` / `date`',
+    '- yes/no → `toggle-editor` or `checkbox-editor` / `boolean`',
+    '- closed list → `select-editor` / `string`. `options.dataSource` is `[{ value, text }]`, plus `valueField` and `textField`.',
+    '- multi closed list → `selection-list-editor` / `string`',
+    '- relation to another entity → `lookup-editor` / `string`',
+    '- phone/email composite → `contact-editor` / `string`',
+    '- secret → `password-editor` / `string`',
+    '- files → `attachments`',
+    '- map → `map`',
+    '- signature → `signature`',
+    '- rating → `rate-picker-editor`',
+    '',
+    'Never use `text-editor` for a date, a number, or a relation. Never invent a widget name.',
+    '',
+    '### Lookup',
+    '`schema.interface` may also hold `triggers` (`[{ "event", "action", "disabled"? }]`) and `valueTransforms`. Put them on the interface inside `content`. Omit both unless the user asked. Do not send them as designer rows.',
+    '',
+    '`schema.interface`:',
+    '`{ "type": "lookup-editor", "options": { "entity": "Module.Entity", "multiple": false, "valueField": "id", "textField": "<property that ListRegisteredEntities returned>", "look": "select", "columns": ["<textField>"], "expose": [{ "source": "id", "target": "<alias>.id" }, { "source": "<textField>", "target": "<alias>.<textField>" }] } }`',
+    '',
+    '`options.entity` must be a `fullName` you already saw. `textField` must be one of that entity\'s `properties[].name`. Property `name` is the FK (`ownerId`, `vehicleId`).',
+    '',
+    '### List, create, update, single',
+    'Section: `{ "id": "basic-info", "layout": { "positions": { "lg": { "colSpan": 12 } } } }`',
+    'Field placement: `{ "name": "<property>", "layout": { "positions": { "lg": { "colSpan": 6, "order": 1 } } } }`. Wide fields (`large-text-editor`, `map`, `attachments`) use `colSpan` 12.',
+    '',
+    '`interfaces.master.list`:',
+    '- `views`: `[{ "name": "all", "title": "@general:terms.interface.selection.all-items", "fixed": true, "columns": [], "conditions": [], "sorts": [{ "name": "title", "dir": "asc" }] }]`',
+    '- `actions` — copy this array. Create uses a command **object**. Delete and view use a command **string**.',
+    '`[{ "title": "@general:actions.create.title", "command": { "name": "Entity:Create" }, "priority": "primary", "type": "create", "scope": "typeLevel" }, { "title": "@general:actions.delete-items.title", "command": "Entity:Remove", "priority": "primary", "type": "delete", "scope": "selected", "order": 100 }, { "title": "@general:actions.delete.title", "command": "Entity:Remove", "priority": "secondary", "type": "delete", "scope": "individual", "order": 100, "shortcuts": ["ctrl+shift+delete"] }, { "title": "@general:actions.view.title", "command": "Entity:OpenDetails", "priority": "secondary", "type": "view", "scope": "individual", "default": true }]`',
+    '- `interfaces.master.single.actions` is only the individual delete object from that array.',
+    '',
+    '`interfaces.master.create` and `update`: `{ sections, properties: <placements> }`.',
+    '`interfaces.master.single`: `{ "title": "{{ title }}", "sections", "properties": <placements>, "actions": [the individual Entity:Remove action] }`.',
+    '',
+    'Omit `id` from create/update/single placements and from `columns`.',
+    '',
+    '### Related entities, plugins, category',
+    'Child list on the parent (car shows its rentals), inside `content.relatedEntities`:',
+    '`{ "entity": "RentManagement.Rental", "title": "اجاره‌ها", "layout": { "type": "page-list", "position": "after" }, "persistence": { "strategy": "referenced", "foreignKeyField": "vehicleId" } }`',
+    'Layout `type` is `page-list`, `tab-list`, `page-detail`, `tab-detail`, or `merge-detail`. This is not a new entity.',
+    '',
+    'Plugins are `{ name, options? }`. Use only names you need: `history`, `archive`, `notes`, `clone`, `compare`, `disable`, `lock`, `attachments`, `category`. Default for a new business entity: `[{ "name": "history" }]`. Do not invent plugin names.',
+    '',
+    '`category` is `{ entity, textField, valueField }` when the user asked to classify rows by another entity. Otherwise omit it.',
+    '',
+    '`rules` change visibility: `{ name, expression, actions: [{ target: { type: "property"|"section"|"action", name }, values }] }`. Omit unless the user asked for show/hide.',
+    '`commands` and `queries` stay omitted so the platform default CRUD is used.',
+    '',
+    '### Vehicle `content` to copy',
+    'Store this object with **write-entity-definition** as `data.content`. Change titles to the user language. Do not leave any placeholder.',
+    '',
+    '```json',
+    '{',
+    '  "module": "RentManagement",',
+    '  "name": "Vehicle",',
+    '  "title": "خودرو",',
+    '  "icon": "fa-light fa-car",',
+    '  "searchTags": ["vehicle", "خودرو"],',
+    '  "formats": { "individual": "خودرو", "plural": "خودروها", "searchResult": { "title": "{{ title }}", "description": "اجاره خودرو" } },',
+    '  "plugins": [{ "name": "history" }],',
+    '  "groups": [{ "id": "basic-info", "title": "مشخصات" }],',
+    '  "properties": [',
+    '    { "name": "id", "title": "Id", "groupId": "basic-info", "schema": { "dataType": "uuid", "visible": false, "readonly": true, "unique": { "enabled": true } } },',
+    '    { "name": "title", "title": "عنوان", "groupId": "basic-info", "options": { "sort": { "enabled": true }, "filter": { "advance": { "enabled": true }, "inline": { "enabled": true } } }, "schema": { "dataType": "string", "interface": { "type": "text-editor" } }, "validations": [{ "rule": "required" }] },',
+    '    { "name": "plateNumber", "title": "پلاک", "groupId": "basic-info", "options": { "sort": { "enabled": true }, "filter": { "advance": { "enabled": true }, "inline": { "enabled": true } } }, "schema": { "dataType": "string", "unique": { "enabled": true }, "interface": { "type": "text-editor" } }, "validations": [{ "rule": "required" }] },',
+    '    { "name": "dailyRate", "title": "نرخ روزانه", "groupId": "basic-info", "options": { "sort": { "enabled": true }, "filter": { "advance": { "enabled": true }, "inline": { "enabled": true } } }, "schema": { "dataType": "number", "interface": { "type": "number-editor" } }, "validations": [{ "rule": "required" }] }',
+    '  ],',
+    '  "columns": [',
+    '    { "name": "title", "options": { "width": "220px", "order": 1 } },',
+    '    { "name": "plateNumber", "options": { "width": "160px", "order": 2 } },',
+    '    { "name": "dailyRate", "options": { "width": "140px", "order": 3 } }',
+    '  ],',
+    '  "relatedEntities": [{ "entity": "RentManagement.Rental", "title": "اجاره‌ها", "layout": { "type": "page-list", "position": "after" }, "persistence": { "strategy": "referenced", "foreignKeyField": "vehicleId" } }],',
+    '  "interfaces": {',
+    '    "master": {',
+    '      "create": { "sections": [{ "id": "basic-info", "layout": { "positions": { "lg": { "colSpan": 12 } } } }], "properties": [{ "name": "title", "layout": { "positions": { "lg": { "colSpan": 6, "order": 1 } } } }, { "name": "plateNumber", "layout": { "positions": { "lg": { "colSpan": 6, "order": 2 } } } }, { "name": "dailyRate", "layout": { "positions": { "lg": { "colSpan": 6, "order": 3 } } } }] },',
+    '      "update": { "sections": [{ "id": "basic-info", "layout": { "positions": { "lg": { "colSpan": 12 } } } }], "properties": [{ "name": "title", "layout": { "positions": { "lg": { "colSpan": 6, "order": 1 } } } }, { "name": "plateNumber", "layout": { "positions": { "lg": { "colSpan": 6, "order": 2 } } } }, { "name": "dailyRate", "layout": { "positions": { "lg": { "colSpan": 6, "order": 3 } } } }] },',
+    '      "single": { "title": "{{ title }}", "sections": [{ "id": "basic-info", "layout": { "positions": { "lg": { "colSpan": 12 } } } }], "properties": [{ "name": "title", "layout": { "positions": { "lg": { "colSpan": 6, "order": 1 } } } }, { "name": "plateNumber", "layout": { "positions": { "lg": { "colSpan": 6, "order": 2 } } } }, { "name": "dailyRate", "layout": { "positions": { "lg": { "colSpan": 6, "order": 3 } } } }], "actions": [{ "title": "@general:actions.delete.title", "command": "Entity:Remove", "priority": "secondary", "type": "delete", "scope": "individual", "order": 100, "shortcuts": ["ctrl+shift+delete"] }] },',
+    '      "list": { "actions": [{ "title": "@general:actions.create.title", "command": { "name": "Entity:Create" }, "priority": "primary", "type": "create", "scope": "typeLevel" }, { "title": "@general:actions.delete-items.title", "command": "Entity:Remove", "priority": "primary", "type": "delete", "scope": "selected", "order": 100 }, { "title": "@general:actions.delete.title", "command": "Entity:Remove", "priority": "secondary", "type": "delete", "scope": "individual", "order": 100, "shortcuts": ["ctrl+shift+delete"] }, { "title": "@general:actions.view.title", "command": "Entity:OpenDetails", "priority": "secondary", "type": "view", "scope": "individual", "default": true }], "views": [{ "name": "all", "title": "@general:terms.interface.selection.all-items", "fixed": true, "columns": [], "conditions": [], "sorts": [{ "name": "title", "dir": "asc" }] }] }',
+    '    }',
+    '  }',
+    '}',
+    '```',
+    '',
+    '### Rental lookups',
+    'Same skeleton, `name` `Rental`. Add `startDate` and `endDate` (`date-time-editor` / `date`). No `relatedEntities` unless asked.',
+    '',
+    'Vehicle lookup property:',
+    '`{ "name": "vehicleId", "title": "خودرو", "groupId": "basic-info", "options": { "sort": { "enabled": true }, "filter": { "advance": { "enabled": true }, "inline": { "enabled": true } } }, "schema": { "dataType": "string", "interface": { "type": "lookup-editor", "options": { "entity": "RentManagement.Vehicle", "multiple": false, "valueField": "id", "textField": "title", "look": "select", "columns": ["title"], "expose": [{ "source": "id", "target": "vehicle.id" }, { "source": "title", "target": "vehicle.title" }] } } }, "validations": [{ "rule": "required" }] }`',
+    '',
+    'Owner lookup is the same with `name` `ownerId`, `entity` `SecurityManagement.User`, and `textField` / expose source taken from `ListRegisteredEntities`. Do not guess `displayName` if that call did not return it.',
+].join('\n');
+//#endregion
+
+//#region ----- Write entity definition -----
+const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_ID = 'e0000001-0000-4000-8000-000000000022';
+const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME = 'write-entity-definition';
+const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_MARKDOWN = [
+    '## Write entity definition',
+    '',
+    'Follow this playbook to store one `AXPEntity` built by **compose-axp-entity**. The module row must already exist.',
+    '',
+    '### Hard rules',
+    '- Insert into `PlatformManagement.EntityDefinition` with `Entity:Insert:Default`. `data` is a JSON object.',
+    '- `data.module` is the module name (`RentManagement`). `data.name` is the short entity name (`Vehicle`), matching `^[A-Za-z][A-Za-z0-9]*$`. Also set `data.title` and `data.icon`.',
+    '- `data.content` is the full `AXPEntity` from **compose-axp-entity**. `content.module` and `content.name` match `data.module` and `data.name`.',
+    '- Do **not** also send designer keys `properties`, `groups`, `columns`, `plugins`, `relatedEntities`, `pages`, `rules`, `listActions`, or `singleActions` on the same insert. Those keys are a thin overlay and **replace** the matching part of `content`. A designer `properties` array drops `schema`, `validations`, and lookup `expose`.',
+    '- Do **not** call `Entity:Create` or emit a chat widget tree.',
+    '- On duplicate name, `Entity:Query:Default` the existing `PlatformManagement.EntityDefinition` row and `Entity:Update:Default` that `id`. An update ignores a new `content` object if the row already has one. To change one slice, send only that designer key (`relatedEntities`, `columns`, …) and accept that a `properties` update flattens every property.',
+    '',
+    '### Order',
+    '1. Build each `content` with **compose-axp-entity** before any insert.',
+    '2. Insert the parent first (`Vehicle`), including `content.relatedEntities` that point at the child key you will insert next.',
+    '3. Insert the child (`Rental`) with lookups to entities that already exist (`RentManagement.Vehicle`, `SecurityManagement.User`).',
+    '4. One entity per call. Read `success`. Stored `name` must be `RentManagement.Vehicle` or `RentManagement.Rental`. If `success` is false, fix `data` from `message` and retry. Do not claim the entity exists.',
+    '5. Tell the user the definition is stored. This skill does not add a menu or a code package.',
+].join('\n');
+//#endregion
+
+//#region ----- Write module definition -----
+const AXE_APP_BUILDER_SKILL_WRITE_MODULE_ID = 'e0000001-0000-4000-8000-000000000021';
+const AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME = 'write-module-definition';
+const AXE_APP_BUILDER_SKILL_WRITE_MODULE_MARKDOWN = [
+    '## Write module definition',
+    '',
+    'Follow this playbook when **reuse-platform-definition** decided a module row must be stored. This writes `PlatformManagement.ModuleDefinition` only.',
+    '',
+    '### Hard rules',
+    '- Persist with `Entity:Insert:Default`. `data` is a JSON **object**, never a string, and never a TypeScript manifest.',
+    '- Do **not** call `Entity:Create`. Do **not** send a `content` document.',
+    '- Required `data` fields: `name`, `title`, `version` (`1.0.0`), `type` (`domain` unless the user asked for a platform or integration module), `domain` (one of `general`, `operations`, `finance-commerce`, `customer-supplier`, `asset-maintenance`, `human-capital`).',
+    '- Also set `icon` (Font Awesome class), `i18n` (kebab-case of the module name), `description`, `required`: false, `dependencies`: module **names** you actually found (for the car-rental example, `SecurityManagement` because Rental looks up User).',
+    '- If Query already returned that `name`, skip insert. To change title or description, `Entity:Update:Default` with that row `id` and only the changed fields.',
+    '',
+    '### Example (`RentManagement`)',
+    '`Entity:Insert:Default`:',
+    '- `entity`: `PlatformManagement.ModuleDefinition`',
+    '- `data`: `{ "name": "RentManagement", "title": "اجاره خودرو", "version": "1.0.0", "type": "domain", "domain": "operations", "icon": "fa-light fa-car", "i18n": "rent-management", "description": "خودرو و قرارداد اجاره", "required": false, "dependencies": ["SecurityManagement"] }`',
+    '',
+    'Use the user language for `title` and `description`. Keep `name` as decided by **reuse-platform-definition**.',
+    '',
+    '### Steps',
+    '1. Confirm the module name is still absent (`Entity:Query:Default` / `quickSearch`) unless reuse already did.',
+    '2. Insert once.',
+    '3. If `success` is false, read `message` and fix `data`. Do not claim the module exists.',
+    '4. Then write entities with **write-entity-definition**. A module row alone does not create cars or rentals.',
+].join('\n');
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Skill rows -----
+/** Playbooks attached to `app-builder-assist`. Seeded as `AiManagement.Skill` rows. */
+const AXE_APP_BUILDER_SKILL_ROWS = [
+    {
+        id: AXE_APP_BUILDER_SKILL_REUSE_ID,
+        name: AXE_APP_BUILDER_SKILL_REUSE_NAME,
+        title: {
+            'en-US': 'Reuse Platform Definition',
+            'fa-IR': 'استفاده از تعریف موجود',
+        },
+        description: {
+            'en-US': 'Use before creating a module or entity. Find existing modules, entities, and lookup targets such as User. Do not insert.',
+            'fa-IR': 'قبل از ساخت ماژول یا موجودیت استفاده کن. ماژول، موجودیت و مقصد lookup مثل کاربر را پیدا کن. درج نکن.',
+        },
+        markdown: AXE_APP_BUILDER_SKILL_REUSE_MARKDOWN,
+    },
+    {
+        id: AXE_APP_BUILDER_SKILL_WRITE_MODULE_ID,
+        name: AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,
+        title: {
+            'en-US': 'Write Module Definition',
+            'fa-IR': 'نوشتن تعریف ماژول',
+        },
+        description: {
+            'en-US': 'Use to store a PlatformManagement.ModuleDefinition row with Entity:Insert:Default. Do not use for entities, menus, or TypeScript.',
+            'fa-IR': 'برای ذخیره ردیف PlatformManagement.ModuleDefinition با Entity:Insert:Default استفاده کن. برای موجودیت، منو یا TypeScript استفاده نکن.',
+        },
+        markdown: AXE_APP_BUILDER_SKILL_WRITE_MODULE_MARKDOWN,
+    },
+    {
+        id: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_ID,
+        name: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,
+        title: {
+            'en-US': 'Write Entity Definition',
+            'fa-IR': 'نوشتن تعریف موجودیت',
+        },
+        description: {
+            'en-US': 'Use to store one AXPEntity in PlatformManagement.EntityDefinition via content. Do not send designer property rows on the same insert.',
+            'fa-IR': 'برای ذخیره یک AXPEntity در PlatformManagement.EntityDefinition از راه content استفاده کن. در همان درج ردیف‌های طراح property نفرست.',
+        },
+        markdown: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_MARKDOWN,
+    },
+    {
+        id: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_ID,
+        name: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,
+        title: {
+            'en-US': 'Compose AXPEntity',
+            'fa-IR': 'نگارش AXPEntity',
+        },
+        description: {
+            'en-US': 'Use to build the AXPEntity content object: properties, widgets, lookups, columns, master interfaces, related entities, and plugins. Do not insert.',
+            'fa-IR': 'برای ساختن آبجکت content از نوع AXPEntity استفاده کن: property، ویجت، lookup، ستون، اینترفیس master، موجودیت مرتبط و پلاگین. درج نکن.',
+        },
+        markdown: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_MARKDOWN,
+    },
+];
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Identity -----
+/** Stable `AiManagement.Assist` id for the platform-definition author. */
+const AXE_APP_BUILDER_ASSIST_ID = 'b0000001-0000-4000-8000-000000000005';
+/** Programmatic assist name (`AiManagement.Assist.name`). */
+const AXE_APP_BUILDER_ASSIST_NAME = 'app-builder-assist';
+//#endregion
+//#region ----- Metadata -----
+/**
+ * App Builder Assist metadata for Platform Definition.
+ * Entity names match `PlatformManagement` `ModuleDefinition` and `EntityDefinition`.
+ * Playbooks: reuse-platform-definition, write-module-definition, compose-axp-entity, write-entity-definition.
+ */
+const AXE_APP_BUILDER_ASSIST = {
+    id: AXE_APP_BUILDER_ASSIST_ID,
+    name: AXE_APP_BUILDER_ASSIST_NAME,
+    title: {
+        'en-US': 'App Builder Assist',
+        'fa-IR': 'دستیار ساخت اپ',
+    },
+    description: {
+        'en-US': 'Authors module and entity definitions in Platform Definition, and reuses modules and entities that already exist.',
+        'fa-IR': 'تعریف ماژول و موجودیت را در Platform Definition می‌سازد و از ماژول و موجودیت موجود استفاده می‌کند.',
+    },
+    planningMode: 'off',
+    skillNames: [
+        AXE_APP_BUILDER_SKILL_REUSE_NAME,
+        AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,
+        AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,
+        AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,
+    ],
+    platformDefinitionEntities: [
+        { module: 'PlatformManagement', name: 'ModuleDefinition' },
+        { module: 'PlatformManagement', name: 'EntityDefinition' },
+    ],
+};
+//#endregion
+
+//#region ---- Contracts barrel ----
+//#endregion
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AXE_APP_BUILDER_ASSIST, AXE_APP_BUILDER_ASSIST_ID, AXE_APP_BUILDER_ASSIST_NAME, AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME, AXE_APP_BUILDER_SKILL_REUSE_NAME, AXE_APP_BUILDER_SKILL_ROWS, AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME, AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME };
+//# sourceMappingURL=acorex-platform-extension-ai-platform-management-client-contracts.mjs.map

package/fesm2022/acorex-platform-extension-ai-platform-management-client-contracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-extension-ai-platform-management-client-contracts.mjs","sources":["../../../../libs/extensions/ai/platform-management/contracts/src/skills/reuse-platform-definition.skill.ts","../../../../libs/extensions/ai/platform-management/contracts/src/skills/compose-axp-entity.skill.ts","../../../../libs/extensions/ai/platform-management/contracts/src/skills/write-entity-definition.skill.ts","../../../../libs/extensions/ai/platform-management/contracts/src/skills/write-module-definition.skill.ts","../../../../libs/extensions/ai/platform-management/contracts/src/skills/index.ts","../../../../libs/extensions/ai/platform-management/contracts/src/app-builder-assist.metadata.ts","../../../../libs/extensions/ai/platform-management/contracts/src/index.ts","../../../../libs/extensions/ai/platform-management/contracts/src/acorex-platform-extension-ai-platform-management-client-contracts.ts"],"sourcesContent":["//#region ----- Reuse platform definition -----\n\nexport const AXE_APP_BUILDER_SKILL_REUSE_ID = 'e0000001-0000-4000-8000-000000000020';\n\nexport const AXE_APP_BUILDER_SKILL_REUSE_NAME = 'reuse-platform-definition';\n\nexport const AXE_APP_BUILDER_SKILL_REUSE_MARKDOWN = [\n  '## Reuse platform definition',\n  '',\n  'Follow this playbook **before** any insert, when the user wants a new module, entity, or relationship (Persian: ماژول بساز، موجودیت، ارتباط با کاربر).',\n  '',\n  '### Hard rules',\n  '- Your **first** action is a **tool call**. Do not invent `Module.Entity` keys or a new Owner/User entity.',\n  '- This assist **has** `PlatformManagement:ListRegisteredEntities` and `Entity:Query:Default`. It does **not** write TypeScript, menus, or i18n JSON files.',\n  '- A **module** is a row of `PlatformManagement.ModuleDefinition`. An **entity** is a row of `PlatformManagement.EntityDefinition` whose stored `name` is `Module.Entity`.',\n  '- A relationship to something that already exists is a **lookup property**, not a new entity.',\n  '- Identifiers (`name`) are PascalCase English (`RentManagement`, `Vehicle`). Titles are human text in the user language. `name` must match `^[A-Za-z][A-Za-z0-9]*$` — no spaces, hyphens, or Persian.',\n  '',\n  '### Worked prompt',\n  'User: «می‌خواهم یک ماژول rent ماشین داشته باشم».',\n  '',\n  'Decide:',\n  '- Module `name`: `RentManagement` (not `rent`, not `CarRental`). `i18n`: `rent-management`. `type`: `domain`. `domain`: `operations`.',\n  '- New entities: `Vehicle` (the car) and `Rental` (the agreement).',\n  '- **Do not** create `Owner`, `User`, or `Car`. The owner is `ownerId` on `Rental`, a lookup to the existing user entity.',\n  '- Find that user entity with `ListRegisteredEntities` `search`: `user`. Expect `SecurityManagement.User`. Read `properties` and use a real title field (`displayName`, `title`, or `name`) as `textField`. If `matchStatus` is `none`, stop and say the user entity is missing. Do not invent the key.',\n  '- `Rental.vehicleId` looks up `RentManagement.Vehicle` **after** Vehicle is stored.',\n  '- After both entities exist, Vehicle can list its rentals (`relatedEntities` → `RentManagement.Rental`, `foreignKeyField`: `vehicleId`). That is an update, not a third entity.',\n  '',\n  '### Steps',\n  '1. **Modules.** `Entity:Query:Default` with `entity`: `PlatformManagement.ModuleDefinition` and `quickSearch` set to the intended module name. If `items[].name` already equals that name, reuse it. Do not insert a second module.',\n  '2. **Entities.** `ListRegisteredEntities` with `search` for each noun (vehicle, rental, user, and any name the user used). `matchStatus` `single` or a clear `fullName` means reuse. `multiple` means pick or ask. `none` means it can be created.',\n  '3. **Schema of a lookup target.** Call `ListRegisteredEntities` with `entityFullName` before choosing `textField` or `expose`.',\n  '4. **Hand off.** Tell the next skills the module name, the entity list, and which fields are lookups. Do not insert in this skill.',\n].join('\\n');\n\n//#endregion\n","//#region ----- Compose AXPEntity -----\n\nexport const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_ID = 'e0000001-0000-4000-8000-000000000023';\n\nexport const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME = 'compose-axp-entity';\n\nexport const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_MARKDOWN = [\n  '## Compose AXPEntity',\n  '',\n  'Follow this playbook whenever you build an entity. You do **not** have the platform source. The object you put in `content` **is** `AXPEntity`. **write-entity-definition** only stores that object. Do not invent a second schema.',\n  '',\n  '### Stored shape',\n  '`content` keys:',\n  '- `module`, `name` (short PascalCase), `title`, `icon`',\n  '- `searchTags`: string keywords in any language. Not i18n keys.',\n  '- `formats`: `{ individual, plural, displayName?, searchResult: { title, description } }`. `searchResult.title` is usually `{{ title }}`.',\n  '- `groups`: `{ id, title, description?, icon? }[]`',\n  '- `properties`: see below. Always include hidden `id`.',\n  '- `columns`: list columns `{ name, title?, showAs?: { type }, options?: { width, order } }`',\n  '- `interfaces.master`: `list`, `create`, `update`, `single`',\n  '- `relatedEntities?`, `plugins?`, `category?`, `pages?`, `rules?`, `validations?`, `commands?`, `queries?`, `parentKey?`',\n  '',\n  'Do **not** emit `AXPEntityV2`, aggregates, or TypeScript helpers (`entityMasterCrudActions`, `createAllQueryView`). Write the JSON those helpers would have produced.',\n  '',\n  '### Property',\n  'Each property:',\n  '`{ name, title, description?, groupId, schema: { dataType, nullable?, readonly?, visible?, defaultValue?, unique?: { enabled }, interface?: { type, options?, children?, mode? } }, options?: { sort: { enabled }, filter: { inline: { enabled }, advance: { enabled } } }, validations? }`',\n  '',\n  '`validations` entries: `{ rule: \"required\" }`, `{ rule: \"minLength\", options: { minLength } }`, `{ rule: \"maxLength\", options: { maxLength } }`, `{ rule: \"regex\", options: { value } }`, `{ rule: \"equal\", options: { value } }`.',\n  '',\n  'Hidden primary key on every entity:',\n  '`{ \"name\": \"id\", \"title\": \"Id\", \"groupId\": \"basic-info\", \"schema\": { \"dataType\": \"uuid\", \"visible\": false, \"readonly\": true, \"unique\": { \"enabled\": true } } }`',\n  '',\n  '### Widget `interface.type` and `dataType`',\n  'Use only these registry names for fields:',\n  '- short text → `text-editor` / `string`',\n  '- notes → `large-text-editor` / `string`',\n  '- rich text → `rich-text-editor` / `string`',\n  '- money, count, measurement → `number-editor` / `number`',\n  '- number plus unit → `number-unit-editor` / `number`',\n  '- date or time → `date-time-editor` / `date`',\n  '- yes/no → `toggle-editor` or `checkbox-editor` / `boolean`',\n  '- closed list → `select-editor` / `string`. `options.dataSource` is `[{ value, text }]`, plus `valueField` and `textField`.',\n  '- multi closed list → `selection-list-editor` / `string`',\n  '- relation to another entity → `lookup-editor` / `string`',\n  '- phone/email composite → `contact-editor` / `string`',\n  '- secret → `password-editor` / `string`',\n  '- files → `attachments`',\n  '- map → `map`',\n  '- signature → `signature`',\n  '- rating → `rate-picker-editor`',\n  '',\n  'Never use `text-editor` for a date, a number, or a relation. Never invent a widget name.',\n  '',\n  '### Lookup',\n  '`schema.interface` may also hold `triggers` (`[{ \"event\", \"action\", \"disabled\"? }]`) and `valueTransforms`. Put them on the interface inside `content`. Omit both unless the user asked. Do not send them as designer rows.',\n  '',\n  '`schema.interface`:',\n  '`{ \"type\": \"lookup-editor\", \"options\": { \"entity\": \"Module.Entity\", \"multiple\": false, \"valueField\": \"id\", \"textField\": \"<property that ListRegisteredEntities returned>\", \"look\": \"select\", \"columns\": [\"<textField>\"], \"expose\": [{ \"source\": \"id\", \"target\": \"<alias>.id\" }, { \"source\": \"<textField>\", \"target\": \"<alias>.<textField>\" }] } }`',\n  '',\n  '`options.entity` must be a `fullName` you already saw. `textField` must be one of that entity\\'s `properties[].name`. Property `name` is the FK (`ownerId`, `vehicleId`).',\n  '',\n  '### List, create, update, single',\n  'Section: `{ \"id\": \"basic-info\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 12 } } } }`',\n  'Field placement: `{ \"name\": \"<property>\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 1 } } } }`. Wide fields (`large-text-editor`, `map`, `attachments`) use `colSpan` 12.',\n  '',\n  '`interfaces.master.list`:',\n  '- `views`: `[{ \"name\": \"all\", \"title\": \"@general:terms.interface.selection.all-items\", \"fixed\": true, \"columns\": [], \"conditions\": [], \"sorts\": [{ \"name\": \"title\", \"dir\": \"asc\" }] }]`',\n  '- `actions` — copy this array. Create uses a command **object**. Delete and view use a command **string**.',\n  '`[{ \"title\": \"@general:actions.create.title\", \"command\": { \"name\": \"Entity:Create\" }, \"priority\": \"primary\", \"type\": \"create\", \"scope\": \"typeLevel\" }, { \"title\": \"@general:actions.delete-items.title\", \"command\": \"Entity:Remove\", \"priority\": \"primary\", \"type\": \"delete\", \"scope\": \"selected\", \"order\": 100 }, { \"title\": \"@general:actions.delete.title\", \"command\": \"Entity:Remove\", \"priority\": \"secondary\", \"type\": \"delete\", \"scope\": \"individual\", \"order\": 100, \"shortcuts\": [\"ctrl+shift+delete\"] }, { \"title\": \"@general:actions.view.title\", \"command\": \"Entity:OpenDetails\", \"priority\": \"secondary\", \"type\": \"view\", \"scope\": \"individual\", \"default\": true }]`',\n  '- `interfaces.master.single.actions` is only the individual delete object from that array.',\n  '',\n  '`interfaces.master.create` and `update`: `{ sections, properties: <placements> }`.',\n  '`interfaces.master.single`: `{ \"title\": \"{{ title }}\", \"sections\", \"properties\": <placements>, \"actions\": [the individual Entity:Remove action] }`.',\n  '',\n  'Omit `id` from create/update/single placements and from `columns`.',\n  '',\n  '### Related entities, plugins, category',\n  'Child list on the parent (car shows its rentals), inside `content.relatedEntities`:',\n  '`{ \"entity\": \"RentManagement.Rental\", \"title\": \"اجاره‌ها\", \"layout\": { \"type\": \"page-list\", \"position\": \"after\" }, \"persistence\": { \"strategy\": \"referenced\", \"foreignKeyField\": \"vehicleId\" } }`',\n  'Layout `type` is `page-list`, `tab-list`, `page-detail`, `tab-detail`, or `merge-detail`. This is not a new entity.',\n  '',\n  'Plugins are `{ name, options? }`. Use only names you need: `history`, `archive`, `notes`, `clone`, `compare`, `disable`, `lock`, `attachments`, `category`. Default for a new business entity: `[{ \"name\": \"history\" }]`. Do not invent plugin names.',\n  '',\n  '`category` is `{ entity, textField, valueField }` when the user asked to classify rows by another entity. Otherwise omit it.',\n  '',\n  '`rules` change visibility: `{ name, expression, actions: [{ target: { type: \"property\"|\"section\"|\"action\", name }, values }] }`. Omit unless the user asked for show/hide.',\n  '`commands` and `queries` stay omitted so the platform default CRUD is used.',\n  '',\n  '### Vehicle `content` to copy',\n  'Store this object with **write-entity-definition** as `data.content`. Change titles to the user language. Do not leave any placeholder.',\n  '',\n  '```json',\n  '{',\n  '  \"module\": \"RentManagement\",',\n  '  \"name\": \"Vehicle\",',\n  '  \"title\": \"خودرو\",',\n  '  \"icon\": \"fa-light fa-car\",',\n  '  \"searchTags\": [\"vehicle\", \"خودرو\"],',\n  '  \"formats\": { \"individual\": \"خودرو\", \"plural\": \"خودروها\", \"searchResult\": { \"title\": \"{{ title }}\", \"description\": \"اجاره خودرو\" } },',\n  '  \"plugins\": [{ \"name\": \"history\" }],',\n  '  \"groups\": [{ \"id\": \"basic-info\", \"title\": \"مشخصات\" }],',\n  '  \"properties\": [',\n  '    { \"name\": \"id\", \"title\": \"Id\", \"groupId\": \"basic-info\", \"schema\": { \"dataType\": \"uuid\", \"visible\": false, \"readonly\": true, \"unique\": { \"enabled\": true } } },',\n  '    { \"name\": \"title\", \"title\": \"عنوان\", \"groupId\": \"basic-info\", \"options\": { \"sort\": { \"enabled\": true }, \"filter\": { \"advance\": { \"enabled\": true }, \"inline\": { \"enabled\": true } } }, \"schema\": { \"dataType\": \"string\", \"interface\": { \"type\": \"text-editor\" } }, \"validations\": [{ \"rule\": \"required\" }] },',\n  '    { \"name\": \"plateNumber\", \"title\": \"پلاک\", \"groupId\": \"basic-info\", \"options\": { \"sort\": { \"enabled\": true }, \"filter\": { \"advance\": { \"enabled\": true }, \"inline\": { \"enabled\": true } } }, \"schema\": { \"dataType\": \"string\", \"unique\": { \"enabled\": true }, \"interface\": { \"type\": \"text-editor\" } }, \"validations\": [{ \"rule\": \"required\" }] },',\n  '    { \"name\": \"dailyRate\", \"title\": \"نرخ روزانه\", \"groupId\": \"basic-info\", \"options\": { \"sort\": { \"enabled\": true }, \"filter\": { \"advance\": { \"enabled\": true }, \"inline\": { \"enabled\": true } } }, \"schema\": { \"dataType\": \"number\", \"interface\": { \"type\": \"number-editor\" } }, \"validations\": [{ \"rule\": \"required\" }] }',\n  '  ],',\n  '  \"columns\": [',\n  '    { \"name\": \"title\", \"options\": { \"width\": \"220px\", \"order\": 1 } },',\n  '    { \"name\": \"plateNumber\", \"options\": { \"width\": \"160px\", \"order\": 2 } },',\n  '    { \"name\": \"dailyRate\", \"options\": { \"width\": \"140px\", \"order\": 3 } }',\n  '  ],',\n  '  \"relatedEntities\": [{ \"entity\": \"RentManagement.Rental\", \"title\": \"اجاره‌ها\", \"layout\": { \"type\": \"page-list\", \"position\": \"after\" }, \"persistence\": { \"strategy\": \"referenced\", \"foreignKeyField\": \"vehicleId\" } }],',\n  '  \"interfaces\": {',\n  '    \"master\": {',\n  '      \"create\": { \"sections\": [{ \"id\": \"basic-info\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 12 } } } }], \"properties\": [{ \"name\": \"title\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 1 } } } }, { \"name\": \"plateNumber\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 2 } } } }, { \"name\": \"dailyRate\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 3 } } } }] },',\n  '      \"update\": { \"sections\": [{ \"id\": \"basic-info\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 12 } } } }], \"properties\": [{ \"name\": \"title\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 1 } } } }, { \"name\": \"plateNumber\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 2 } } } }, { \"name\": \"dailyRate\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 3 } } } }] },',\n  '      \"single\": { \"title\": \"{{ title }}\", \"sections\": [{ \"id\": \"basic-info\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 12 } } } }], \"properties\": [{ \"name\": \"title\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 1 } } } }, { \"name\": \"plateNumber\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 2 } } } }, { \"name\": \"dailyRate\", \"layout\": { \"positions\": { \"lg\": { \"colSpan\": 6, \"order\": 3 } } } }], \"actions\": [{ \"title\": \"@general:actions.delete.title\", \"command\": \"Entity:Remove\", \"priority\": \"secondary\", \"type\": \"delete\", \"scope\": \"individual\", \"order\": 100, \"shortcuts\": [\"ctrl+shift+delete\"] }] },',\n  '      \"list\": { \"actions\": [{ \"title\": \"@general:actions.create.title\", \"command\": { \"name\": \"Entity:Create\" }, \"priority\": \"primary\", \"type\": \"create\", \"scope\": \"typeLevel\" }, { \"title\": \"@general:actions.delete-items.title\", \"command\": \"Entity:Remove\", \"priority\": \"primary\", \"type\": \"delete\", \"scope\": \"selected\", \"order\": 100 }, { \"title\": \"@general:actions.delete.title\", \"command\": \"Entity:Remove\", \"priority\": \"secondary\", \"type\": \"delete\", \"scope\": \"individual\", \"order\": 100, \"shortcuts\": [\"ctrl+shift+delete\"] }, { \"title\": \"@general:actions.view.title\", \"command\": \"Entity:OpenDetails\", \"priority\": \"secondary\", \"type\": \"view\", \"scope\": \"individual\", \"default\": true }], \"views\": [{ \"name\": \"all\", \"title\": \"@general:terms.interface.selection.all-items\", \"fixed\": true, \"columns\": [], \"conditions\": [], \"sorts\": [{ \"name\": \"title\", \"dir\": \"asc\" }] }] }',\n  '    }',\n  '  }',\n  '}',\n  '```',\n  '',\n  '### Rental lookups',\n  'Same skeleton, `name` `Rental`. Add `startDate` and `endDate` (`date-time-editor` / `date`). No `relatedEntities` unless asked.',\n  '',\n  'Vehicle lookup property:',\n  '`{ \"name\": \"vehicleId\", \"title\": \"خودرو\", \"groupId\": \"basic-info\", \"options\": { \"sort\": { \"enabled\": true }, \"filter\": { \"advance\": { \"enabled\": true }, \"inline\": { \"enabled\": true } } }, \"schema\": { \"dataType\": \"string\", \"interface\": { \"type\": \"lookup-editor\", \"options\": { \"entity\": \"RentManagement.Vehicle\", \"multiple\": false, \"valueField\": \"id\", \"textField\": \"title\", \"look\": \"select\", \"columns\": [\"title\"], \"expose\": [{ \"source\": \"id\", \"target\": \"vehicle.id\" }, { \"source\": \"title\", \"target\": \"vehicle.title\" }] } } }, \"validations\": [{ \"rule\": \"required\" }] }`',\n  '',\n  'Owner lookup is the same with `name` `ownerId`, `entity` `SecurityManagement.User`, and `textField` / expose source taken from `ListRegisteredEntities`. Do not guess `displayName` if that call did not return it.',\n].join('\\n');\n\n//#endregion\n","//#region ----- Write entity definition -----\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_ID = 'e0000001-0000-4000-8000-000000000022';\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME = 'write-entity-definition';\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_MARKDOWN = [\n  '## Write entity definition',\n  '',\n  'Follow this playbook to store one `AXPEntity` built by **compose-axp-entity**. The module row must already exist.',\n  '',\n  '### Hard rules',\n  '- Insert into `PlatformManagement.EntityDefinition` with `Entity:Insert:Default`. `data` is a JSON object.',\n  '- `data.module` is the module name (`RentManagement`). `data.name` is the short entity name (`Vehicle`), matching `^[A-Za-z][A-Za-z0-9]*$`. Also set `data.title` and `data.icon`.',\n  '- `data.content` is the full `AXPEntity` from **compose-axp-entity**. `content.module` and `content.name` match `data.module` and `data.name`.',\n  '- Do **not** also send designer keys `properties`, `groups`, `columns`, `plugins`, `relatedEntities`, `pages`, `rules`, `listActions`, or `singleActions` on the same insert. Those keys are a thin overlay and **replace** the matching part of `content`. A designer `properties` array drops `schema`, `validations`, and lookup `expose`.',\n  '- Do **not** call `Entity:Create` or emit a chat widget tree.',\n  '- On duplicate name, `Entity:Query:Default` the existing `PlatformManagement.EntityDefinition` row and `Entity:Update:Default` that `id`. An update ignores a new `content` object if the row already has one. To change one slice, send only that designer key (`relatedEntities`, `columns`, …) and accept that a `properties` update flattens every property.',\n  '',\n  '### Order',\n  '1. Build each `content` with **compose-axp-entity** before any insert.',\n  '2. Insert the parent first (`Vehicle`), including `content.relatedEntities` that point at the child key you will insert next.',\n  '3. Insert the child (`Rental`) with lookups to entities that already exist (`RentManagement.Vehicle`, `SecurityManagement.User`).',\n  '4. One entity per call. Read `success`. Stored `name` must be `RentManagement.Vehicle` or `RentManagement.Rental`. If `success` is false, fix `data` from `message` and retry. Do not claim the entity exists.',\n  '5. Tell the user the definition is stored. This skill does not add a menu or a code package.',\n].join('\\n');\n\n//#endregion\n","//#region ----- Write module definition -----\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_MODULE_ID = 'e0000001-0000-4000-8000-000000000021';\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME = 'write-module-definition';\n\nexport const AXE_APP_BUILDER_SKILL_WRITE_MODULE_MARKDOWN = [\n  '## Write module definition',\n  '',\n  'Follow this playbook when **reuse-platform-definition** decided a module row must be stored. This writes `PlatformManagement.ModuleDefinition` only.',\n  '',\n  '### Hard rules',\n  '- Persist with `Entity:Insert:Default`. `data` is a JSON **object**, never a string, and never a TypeScript manifest.',\n  '- Do **not** call `Entity:Create`. Do **not** send a `content` document.',\n  '- Required `data` fields: `name`, `title`, `version` (`1.0.0`), `type` (`domain` unless the user asked for a platform or integration module), `domain` (one of `general`, `operations`, `finance-commerce`, `customer-supplier`, `asset-maintenance`, `human-capital`).',\n  '- Also set `icon` (Font Awesome class), `i18n` (kebab-case of the module name), `description`, `required`: false, `dependencies`: module **names** you actually found (for the car-rental example, `SecurityManagement` because Rental looks up User).',\n  '- If Query already returned that `name`, skip insert. To change title or description, `Entity:Update:Default` with that row `id` and only the changed fields.',\n  '',\n  '### Example (`RentManagement`)',\n  '`Entity:Insert:Default`:',\n  '- `entity`: `PlatformManagement.ModuleDefinition`',\n  '- `data`: `{ \"name\": \"RentManagement\", \"title\": \"اجاره خودرو\", \"version\": \"1.0.0\", \"type\": \"domain\", \"domain\": \"operations\", \"icon\": \"fa-light fa-car\", \"i18n\": \"rent-management\", \"description\": \"خودرو و قرارداد اجاره\", \"required\": false, \"dependencies\": [\"SecurityManagement\"] }`',\n  '',\n  'Use the user language for `title` and `description`. Keep `name` as decided by **reuse-platform-definition**.',\n  '',\n  '### Steps',\n  '1. Confirm the module name is still absent (`Entity:Query:Default` / `quickSearch`) unless reuse already did.',\n  '2. Insert once.',\n  '3. If `success` is false, read `message` and fix `data`. Do not claim the module exists.',\n  '4. Then write entities with **write-entity-definition**. A module row alone does not create cars or rentals.',\n].join('\\n');\n\n//#endregion\n","//#region ----- Imports -----\n\nimport {\n  AXE_APP_BUILDER_SKILL_REUSE_ID,\n  AXE_APP_BUILDER_SKILL_REUSE_MARKDOWN,\n  AXE_APP_BUILDER_SKILL_REUSE_NAME,\n} from './reuse-platform-definition.skill';\nimport {\n  AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_ID,\n  AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_MARKDOWN,\n  AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,\n} from './compose-axp-entity.skill';\nimport {\n  AXE_APP_BUILDER_SKILL_WRITE_ENTITY_ID,\n  AXE_APP_BUILDER_SKILL_WRITE_ENTITY_MARKDOWN,\n  AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,\n} from './write-entity-definition.skill';\nimport {\n  AXE_APP_BUILDER_SKILL_WRITE_MODULE_ID,\n  AXE_APP_BUILDER_SKILL_WRITE_MODULE_MARKDOWN,\n  AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,\n} from './write-module-definition.skill';\n\n//#endregion\n\n//#region ----- Skill rows -----\n\n/** Playbooks attached to `app-builder-assist`. Seeded as `AiManagement.Skill` rows. */\nexport const AXE_APP_BUILDER_SKILL_ROWS = [\n  {\n    id: AXE_APP_BUILDER_SKILL_REUSE_ID,\n    name: AXE_APP_BUILDER_SKILL_REUSE_NAME,\n    title: {\n      'en-US': 'Reuse Platform Definition',\n      'fa-IR': 'استفاده از تعریف موجود',\n    },\n    description: {\n      'en-US':\n        'Use before creating a module or entity. Find existing modules, entities, and lookup targets such as User. Do not insert.',\n      'fa-IR':\n        'قبل از ساخت ماژول یا موجودیت استفاده کن. ماژول، موجودیت و مقصد lookup مثل کاربر را پیدا کن. درج نکن.',\n    },\n    markdown: AXE_APP_BUILDER_SKILL_REUSE_MARKDOWN,\n  },\n  {\n    id: AXE_APP_BUILDER_SKILL_WRITE_MODULE_ID,\n    name: AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,\n    title: {\n      'en-US': 'Write Module Definition',\n      'fa-IR': 'نوشتن تعریف ماژول',\n    },\n    description: {\n      'en-US':\n        'Use to store a PlatformManagement.ModuleDefinition row with Entity:Insert:Default. Do not use for entities, menus, or TypeScript.',\n      'fa-IR':\n        'برای ذخیره ردیف PlatformManagement.ModuleDefinition با Entity:Insert:Default استفاده کن. برای موجودیت، منو یا TypeScript استفاده نکن.',\n    },\n    markdown: AXE_APP_BUILDER_SKILL_WRITE_MODULE_MARKDOWN,\n  },\n  {\n    id: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_ID,\n    name: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,\n    title: {\n      'en-US': 'Write Entity Definition',\n      'fa-IR': 'نوشتن تعریف موجودیت',\n    },\n    description: {\n      'en-US':\n        'Use to store one AXPEntity in PlatformManagement.EntityDefinition via content. Do not send designer property rows on the same insert.',\n      'fa-IR':\n        'برای ذخیره یک AXPEntity در PlatformManagement.EntityDefinition از راه content استفاده کن. در همان درج ردیف‌های طراح property نفرست.',\n    },\n    markdown: AXE_APP_BUILDER_SKILL_WRITE_ENTITY_MARKDOWN,\n  },\n  {\n    id: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_ID,\n    name: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,\n    title: {\n      'en-US': 'Compose AXPEntity',\n      'fa-IR': 'نگارش AXPEntity',\n    },\n    description: {\n      'en-US':\n        'Use to build the AXPEntity content object: properties, widgets, lookups, columns, master interfaces, related entities, and plugins. Do not insert.',\n      'fa-IR':\n        'برای ساختن آبجکت content از نوع AXPEntity استفاده کن: property، ویجت، lookup، ستون، اینترفیس master، موجودیت مرتبط و پلاگین. درج نکن.',\n    },\n    markdown: AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_MARKDOWN,\n  },\n];\n\nexport {\n  AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,\n  AXE_APP_BUILDER_SKILL_REUSE_NAME,\n  AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,\n  AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,\n};\n\n//#endregion\n","//#region ----- Imports -----\n\nimport {\n  AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,\n  AXE_APP_BUILDER_SKILL_REUSE_NAME,\n  AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,\n  AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,\n} from './skills';\n\n//#endregion\n\n//#region ----- Identity -----\n\n/** Stable `AiManagement.Assist` id for the platform-definition author. */\nexport const AXE_APP_BUILDER_ASSIST_ID = 'b0000001-0000-4000-8000-000000000005';\n\n/** Programmatic assist name (`AiManagement.Assist.name`). */\nexport const AXE_APP_BUILDER_ASSIST_NAME = 'app-builder-assist';\n\n//#endregion\n\n//#region ----- Metadata -----\n\n/**\n * App Builder Assist metadata for Platform Definition.\n * Entity names match `PlatformManagement` `ModuleDefinition` and `EntityDefinition`.\n * Playbooks: reuse-platform-definition, write-module-definition, compose-axp-entity, write-entity-definition.\n */\nexport const AXE_APP_BUILDER_ASSIST = {\n  id: AXE_APP_BUILDER_ASSIST_ID,\n  name: AXE_APP_BUILDER_ASSIST_NAME,\n  title: {\n    'en-US': 'App Builder Assist',\n    'fa-IR': 'دستیار ساخت اپ',\n  },\n  description: {\n    'en-US':\n      'Authors module and entity definitions in Platform Definition, and reuses modules and entities that already exist.',\n    'fa-IR':\n      'تعریف ماژول و موجودیت را در Platform Definition می‌سازد و از ماژول و موجودیت موجود استفاده می‌کند.',\n  },\n  planningMode: 'off',\n  skillNames: [\n    AXE_APP_BUILDER_SKILL_REUSE_NAME,\n    AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME,\n    AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME,\n    AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME,\n  ],\n  platformDefinitionEntities: [\n    { module: 'PlatformManagement', name: 'ModuleDefinition' },\n    { module: 'PlatformManagement', name: 'EntityDefinition' },\n  ],\n} as const;\n\n//#endregion\n","//#region ---- Contracts barrel ----\n\nexport * from './app-builder-assist.metadata';\nexport * from './skills';\n\n//#endregion\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/acorex-platform-extension-ai-platform-management-client.mjs

@@ -0,0 +1,82 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, NgModule } from '@angular/core';
+import { AXP_ENTITY_MODIFIER } from '@acorex-platform/framework-client/layout/entity';
+import { AXMAiManagementModule } from '@acorex-platform/module-ai-management-client';
+import { AXMPlatformManagementModule } from '@acorex-platform/module-platform-management-client';
+import { AXE_APP_BUILDER_ASSIST } from '@acorex-platform/extension-ai-platform-management-client/contracts';
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Modifier -----
+const PLATFORM_DEFINITION_ENTITY_NAME = new RegExp(`^(${AXE_APP_BUILDER_ASSIST.platformDefinitionEntities.map((entity) => entity.name).join('|')})$`);
+/**
+ * Marks Module Definition and Entity Definition with the App Builder Assist name.
+ * Runs after the platform catalog layout overlay (order 30).
+ */
+const AXEAppBuilderAssistPlatformDefinitionModifier = {
+    entityName: PLATFORM_DEFINITION_ENTITY_NAME,
+    order: 40,
+    modifier: (ctx) => {
+        const covered = AXE_APP_BUILDER_ASSIST.platformDefinitionEntities.some((entity) => entity.module === ctx.module.get() && entity.name === ctx.name.get());
+        if (!covered) {
+            return;
+        }
+        const tags = ctx.entity.searchTags ?? [];
+        if (tags.includes(AXE_APP_BUILDER_ASSIST.name)) {
+            return;
+        }
+        ctx.entity.searchTags = [...tags, AXE_APP_BUILDER_ASSIST.name];
+    },
+};
+//#endregion
+
+//#region ----- Imports -----
+//#endregion
+//#region ----- Token -----
+/** App Builder Assist metadata for Platform Definition screens. */
+const AXE_APP_BUILDER_ASSIST_METADATA = new InjectionToken('AXE_APP_BUILDER_ASSIST_METADATA');
+//#endregion
+//#region ----- Module -----
+/**
+ * Optional AI author for Platform Definition (module and entity definitions).
+ * Register next to {@link AXMPlatformManagementModule} and {@link AXMAiManagementModule}.
+ */
+class AXEAIPlatformManagementExtensionModule {
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIPlatformManagementExtensionModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXEAIPlatformManagementExtensionModule, imports: [AXMAiManagementModule, AXMPlatformManagementModule] }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIPlatformManagementExtensionModule, providers: [
+            {
+                provide: AXE_APP_BUILDER_ASSIST_METADATA,
+                useValue: AXE_APP_BUILDER_ASSIST,
+            },
+            {
+                provide: AXP_ENTITY_MODIFIER,
+                useValue: AXEAppBuilderAssistPlatformDefinitionModifier,
+                multi: true,
+            },
+        ], imports: [AXMAiManagementModule, AXMPlatformManagementModule] }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXEAIPlatformManagementExtensionModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    imports: [AXMAiManagementModule, AXMPlatformManagementModule],
+                    providers: [
+                        {
+                            provide: AXE_APP_BUILDER_ASSIST_METADATA,
+                            useValue: AXE_APP_BUILDER_ASSIST,
+                        },
+                        {
+                            provide: AXP_ENTITY_MODIFIER,
+                            useValue: AXEAppBuilderAssistPlatformDefinitionModifier,
+                            multi: true,
+                        },
+                    ],
+                }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AXEAIPlatformManagementExtensionModule, AXE_APP_BUILDER_ASSIST_METADATA };
+//# sourceMappingURL=acorex-platform-extension-ai-platform-management-client.mjs.map

package/fesm2022/acorex-platform-extension-ai-platform-management-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-extension-ai-platform-management-client.mjs","sources":["../../../../libs/extensions/ai/platform-management/client/src/lib/app-builder-assist-platform-definition.entity-modifier.ts","../../../../libs/extensions/ai/platform-management/client/src/lib/ai-platform-management-extension.module.ts","../../../../libs/extensions/ai/platform-management/client/src/acorex-platform-extension-ai-platform-management-client.ts"],"sourcesContent":["//#region ----- Imports -----\n\nimport { AXPEntityModifierProvider } from '@acorex-platform/framework-client/layout/entity';\nimport { AXE_APP_BUILDER_ASSIST } from '@acorex-platform/extension-ai-platform-management-client/contracts';\n\n//#endregion\n\n//#region ----- Modifier -----\n\nconst PLATFORM_DEFINITION_ENTITY_NAME = new RegExp(\n  `^(${AXE_APP_BUILDER_ASSIST.platformDefinitionEntities.map((entity) => entity.name).join('|')})$`,\n);\n\n/**\n * Marks Module Definition and Entity Definition with the App Builder Assist name.\n * Runs after the platform catalog layout overlay (order 30).\n */\nexport const AXEAppBuilderAssistPlatformDefinitionModifier: AXPEntityModifierProvider = {\n  entityName: PLATFORM_DEFINITION_ENTITY_NAME,\n  order: 40,\n  modifier: (ctx) => {\n    const covered = AXE_APP_BUILDER_ASSIST.platformDefinitionEntities.some(\n      (entity) => entity.module === ctx.module.get() && entity.name === ctx.name.get(),\n    );\n    if (!covered) {\n      return;\n    }\n\n    const tags = ctx.entity.searchTags ?? [];\n    if (tags.includes(AXE_APP_BUILDER_ASSIST.name)) {\n      return;\n    }\n    ctx.entity.searchTags = [...tags, AXE_APP_BUILDER_ASSIST.name];\n  },\n};\n\n//#endregion\n","//#region ----- Imports -----\n\nimport { InjectionToken, NgModule } from '@angular/core';\nimport { AXP_ENTITY_MODIFIER } from '@acorex-platform/framework-client/layout/entity';\nimport { AXMAiManagementModule } from '@acorex-platform/module-ai-management-client';\nimport { AXMPlatformManagementModule } from '@acorex-platform/module-platform-management-client';\nimport { AXE_APP_BUILDER_ASSIST } from '@acorex-platform/extension-ai-platform-management-client/contracts';\n\nimport { AXEAppBuilderAssistPlatformDefinitionModifier } from './app-builder-assist-platform-definition.entity-modifier';\n\n//#endregion\n\n//#region ----- Token -----\n\n/** App Builder Assist metadata for Platform Definition screens. */\nexport const AXE_APP_BUILDER_ASSIST_METADATA = new InjectionToken<typeof AXE_APP_BUILDER_ASSIST>(\n  'AXE_APP_BUILDER_ASSIST_METADATA',\n);\n\n//#endregion\n\n//#region ----- Module -----\n\n/**\n * Optional AI author for Platform Definition (module and entity definitions).\n * Register next to {@link AXMPlatformManagementModule} and {@link AXMAiManagementModule}.\n */\n@NgModule({\n  imports: [AXMAiManagementModule, AXMPlatformManagementModule],\n  providers: [\n    {\n      provide: AXE_APP_BUILDER_ASSIST_METADATA,\n      useValue: AXE_APP_BUILDER_ASSIST,\n    },\n    {\n      provide: AXP_ENTITY_MODIFIER,\n      useValue: AXEAppBuilderAssistPlatformDefinitionModifier,\n      multi: true,\n    },\n  ],\n})\nexport class AXEAIPlatformManagementExtensionModule {}\n\n//#endregion\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAAA;AAKA;AAEA;AAEA,MAAM,+BAA+B,GAAG,IAAI,MAAM,CAChD,CAAA,EAAA,EAAK,sBAAsB,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA,EAAA,CAAI,CAClG;AAED;;;AAGG;AACI,MAAM,6CAA6C,GAA8B;AACtF,IAAA,UAAU,EAAE,+BAA+B;AAC3C,IAAA,KAAK,EAAE,EAAE;AACT,IAAA,QAAQ,EAAE,CAAC,GAAG,KAAI;AAChB,QAAA,MAAM,OAAO,GAAG,sBAAsB,CAAC,0BAA0B,CAAC,IAAI,CACpE,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CACjF;QACD,IAAI,CAAC,OAAO,EAAE;YACZ;QACF;QAEA,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE;QACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE;YAC9C;QACF;AACA,QAAA,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,GAAG,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;IAChE,CAAC;CACF;AAED;;ACpCA;AAUA;AAEA;AAEA;MACa,+BAA+B,GAAG,IAAI,cAAc,CAC/D,iCAAiC;AAGnC;AAEA;AAEA;;;AAGG;MAeU,sCAAsC,CAAA;8GAAtC,sCAAsC,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA,CAAA;+GAAtC,sCAAsC,EAAA,OAAA,EAAA,CAbvC,qBAAqB,EAAE,2BAA2B,CAAA,EAAA,CAAA,CAAA;AAajD,IAAA,SAAA,IAAA,CAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,sCAAsC,EAAA,SAAA,EAZtC;AACT,YAAA;AACE,gBAAA,OAAO,EAAE,+BAA+B;AACxC,gBAAA,QAAQ,EAAE,sBAAsB;AACjC,aAAA;AACD,YAAA;AACE,gBAAA,OAAO,EAAE,mBAAmB;AAC5B,gBAAA,QAAQ,EAAE,6CAA6C;AACvD,gBAAA,KAAK,EAAE,IAAI;AACZ,aAAA;SACF,EAAA,OAAA,EAAA,CAXS,qBAAqB,EAAE,2BAA2B,CAAA,EAAA,CAAA,CAAA;;2FAajD,sCAAsC,EAAA,UAAA,EAAA,CAAA;kBAdlD,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,OAAO,EAAE,CAAC,qBAAqB,EAAE,2BAA2B,CAAC;AAC7D,oBAAA,SAAS,EAAE;AACT,wBAAA;AACE,4BAAA,OAAO,EAAE,+BAA+B;AACxC,4BAAA,QAAQ,EAAE,sBAAsB;AACjC,yBAAA;AACD,wBAAA;AACE,4BAAA,OAAO,EAAE,mBAAmB;AAC5B,4BAAA,QAAQ,EAAE,6CAA6C;AACvD,4BAAA,KAAK,EAAE,IAAI;AACZ,yBAAA;AACF,qBAAA;AACF,iBAAA;;;ACxCD;;AAEG;;"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@acorex-platform/extension-ai-platform-management-client",
+  "version": "0.0.46",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": "^21.0.0 || ^22.0.0",
+    "@angular/core": "^21.0.0 || ^22.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "module": "fesm2022/acorex-platform-extension-ai-platform-management-client.mjs",
+  "typings": "types/acorex-platform-extension-ai-platform-management-client.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/acorex-platform-extension-ai-platform-management-client.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-ai-platform-management-client.mjs"
+    },
+    "./contracts": {
+      "types": "./types/acorex-platform-extension-ai-platform-management-client-contracts.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-ai-platform-management-client-contracts.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/acorex-platform-extension-ai-platform-management-client-contracts.d.ts

@@ -0,0 +1,55 @@
+/** Stable `AiManagement.Assist` id for the platform-definition author. */
+declare const AXE_APP_BUILDER_ASSIST_ID = "b0000001-0000-4000-8000-000000000005";
+/** Programmatic assist name (`AiManagement.Assist.name`). */
+declare const AXE_APP_BUILDER_ASSIST_NAME = "app-builder-assist";
+/**
+ * App Builder Assist metadata for Platform Definition.
+ * Entity names match `PlatformManagement` `ModuleDefinition` and `EntityDefinition`.
+ * Playbooks: reuse-platform-definition, write-module-definition, compose-axp-entity, write-entity-definition.
+ */
+declare const AXE_APP_BUILDER_ASSIST: {
+    readonly id: "b0000001-0000-4000-8000-000000000005";
+    readonly name: "app-builder-assist";
+    readonly title: {
+        readonly 'en-US': "App Builder Assist";
+        readonly 'fa-IR': "دستیار ساخت اپ";
+    };
+    readonly description: {
+        readonly 'en-US': "Authors module and entity definitions in Platform Definition, and reuses modules and entities that already exist.";
+        readonly 'fa-IR': "تعریف ماژول و موجودیت را در Platform Definition می‌سازد و از ماژول و موجودیت موجود استفاده می‌کند.";
+    };
+    readonly planningMode: "off";
+    readonly skillNames: readonly ["reuse-platform-definition", "write-module-definition", "compose-axp-entity", "write-entity-definition"];
+    readonly platformDefinitionEntities: readonly [{
+        readonly module: "PlatformManagement";
+        readonly name: "ModuleDefinition";
+    }, {
+        readonly module: "PlatformManagement";
+        readonly name: "EntityDefinition";
+    }];
+};
+
+declare const AXE_APP_BUILDER_SKILL_REUSE_NAME = "reuse-platform-definition";
+
+declare const AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME = "compose-axp-entity";
+
+declare const AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME = "write-entity-definition";
+
+declare const AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME = "write-module-definition";
+
+/** Playbooks attached to `app-builder-assist`. Seeded as `AiManagement.Skill` rows. */
+declare const AXE_APP_BUILDER_SKILL_ROWS: {
+    id: string;
+    name: string;
+    title: {
+        'en-US': string;
+        'fa-IR': string;
+    };
+    description: {
+        'en-US': string;
+        'fa-IR': string;
+    };
+    markdown: string;
+}[];
+
+export { AXE_APP_BUILDER_ASSIST, AXE_APP_BUILDER_ASSIST_ID, AXE_APP_BUILDER_ASSIST_NAME, AXE_APP_BUILDER_SKILL_COMPOSE_ENTITY_NAME, AXE_APP_BUILDER_SKILL_REUSE_NAME, AXE_APP_BUILDER_SKILL_ROWS, AXE_APP_BUILDER_SKILL_WRITE_ENTITY_NAME, AXE_APP_BUILDER_SKILL_WRITE_MODULE_NAME };

package/types/acorex-platform-extension-ai-platform-management-client.d.ts

@@ -0,0 +1,38 @@
+import * as i0 from '@angular/core';
+import { InjectionToken } from '@angular/core';
+import * as i1 from '@acorex-platform/module-ai-management-client';
+import * as i2 from '@acorex-platform/module-platform-management-client';
+
+/** App Builder Assist metadata for Platform Definition screens. */
+declare const AXE_APP_BUILDER_ASSIST_METADATA: InjectionToken<{
+    readonly id: "b0000001-0000-4000-8000-000000000005";
+    readonly name: "app-builder-assist";
+    readonly title: {
+        readonly "en-US": "App Builder Assist";
+        readonly "fa-IR": "\u062F\u0633\u062A\u06CC\u0627\u0631 \u0633\u0627\u062E\u062A \u0627\u067E";
+    };
+    readonly description: {
+        readonly "en-US": "Authors module and entity definitions in Platform Definition, and reuses modules and entities that already exist.";
+        readonly "fa-IR": "\u062A\u0639\u0631\u06CC\u0641 \u0645\u0627\u0698\u0648\u0644 \u0648 \u0645\u0648\u062C\u0648\u062F\u06CC\u062A \u0631\u0627 \u062F\u0631 Platform Definition \u0645\u06CC\u200C\u0633\u0627\u0632\u062F \u0648 \u0627\u0632 \u0645\u0627\u0698\u0648\u0644 \u0648 \u0645\u0648\u062C\u0648\u062F\u06CC\u062A \u0645\u0648\u062C\u0648\u062F \u0627\u0633\u062A\u0641\u0627\u062F\u0647 \u0645\u06CC\u200C\u06A9\u0646\u062F.";
+    };
+    readonly planningMode: "off";
+    readonly skillNames: readonly ["reuse-platform-definition", "write-module-definition", "compose-axp-entity", "write-entity-definition"];
+    readonly platformDefinitionEntities: readonly [{
+        readonly module: "PlatformManagement";
+        readonly name: "ModuleDefinition";
+    }, {
+        readonly module: "PlatformManagement";
+        readonly name: "EntityDefinition";
+    }];
+}>;
+/**
+ * Optional AI author for Platform Definition (module and entity definitions).
+ * Register next to {@link AXMPlatformManagementModule} and {@link AXMAiManagementModule}.
+ */
+declare class AXEAIPlatformManagementExtensionModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXEAIPlatformManagementExtensionModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AXEAIPlatformManagementExtensionModule, never, [typeof i1.AXMAiManagementModule, typeof i2.AXMPlatformManagementModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AXEAIPlatformManagementExtensionModule>;
+}
+
+export { AXEAIPlatformManagementExtensionModule, AXE_APP_BUILDER_ASSIST_METADATA };