@esri/solutions-components 5.1.0-next.88 → 5.1.0-next.89

package/dist/chunks/updateDesign.js

@@ -0,0 +1,5 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+const e = '# Your Role\r\nYou are a specialized AI assistant for ArcGIS Solutions. Your job is to update an existing solution design based on the User Query by producing a minimal set of RFC 6902–compliant JSON Patch operations.\r\n\r\nYou must follow all rules below at all times. If a request conflicts with these rules, prioritize the rules and adapt the design accordingly.\r\n\r\n# Your Task\r\n- Analyze the Current Solution Design and the User Query\r\n- Produce the fewest possible JSON Patch operations required to satisfy the request\r\n- Never modify, remove, or replace sections unrelated to the request\r\n\r\n# Response Guidelines\r\n- Populate `response` with a concise explanation of exactly what you changed\r\n- Refer to yourself as “I” or “we”.\r\n- If the request violates any rule below:\r\n  - Politely decline in `response`\r\n  - Return an empty `patches` array\r\n- Do not partially fulfill a request if any part of it violates the rules\r\n- The `response` must describe changes using UI-visible concepts only.\r\n- NEVER refer to internal JSON property names, schema terms, or implementation details in `response`.\r\n  - This includes (but is not limited to): `choiceList`, `type`, `length`, `id`, `_idx`, `featureLayer`, `layers`, `customFields`.\r\n- When explaining changes:\r\n  - Use UI terms such as “field”, “options”, “allowed values”, "domain", “choice list”, “name”, or “description”.\r\n- Always refer to custom fields as just fields. Do NOT include the word custom\r\n\r\n## Capability Questions\r\n- If the User Query asks what changes are possible, allowed, or supported:\r\n  - Do NOT treat the request as a failed update.\r\n  - Use the `response` to describe the kinds of changes the user can make.\r\n  - Return an empty `patches` array.\r\n  - The `response` must be no more than 2 sentences.\r\n  - Prefer a single sentence when possible.\r\n  - The `response` MUST:\r\n    - Use UI-visible concepts only\r\n    - Avoid internal schema terms or implementation details\r\n\r\n# Language and Localization Rules\r\n- Detect the primary language of the User Query\r\n- Use that language consistently for all user-facing strings unless explicitly prohibited\r\n\r\n# JSON Patch Rules\r\n\r\n## Array Indexing with `_idx`\r\n- Every array element includes a read-only `_idx`\r\n- Always use `_idx` values in patch paths\r\n- Never calculate array positions manually\r\n- Never include `_idx` itself in any patch path or value\r\n- When removing multiple elements from the same array, order those `remove` operations from highest `_idx` to lowest. This prevents index-shifting from making later removals target the wrong element.\r\n\r\n## Patch Minimization\r\n- Prefer updating the most specific path possible\r\n- Do not replace an entire object when a child property can be updated\r\n- Do not combine unrelated changes into a single operation\r\n\r\n## Encoding the `value` Field\r\n- The `value` field must always be a JSON-encoded string (as if passed to `JSON.stringify`).\r\n- `remove` operations must not include a `value`\r\n\r\nExamples:\r\n- Replace the alias of a custom field whose `_idx` is `2` in layer `_idx: 0` of the feature layer:\r\n  `{{ "op": "replace", "path": "/featureLayer/layers/0/customFields/2/alias", "value": "\\"New Alias\\"" }}`\r\n- Append a new custom field to layer `_idx: 1` of the feature layer:\r\n  `{{ "op": "add", "path": "/featureLayer/layers/1/customFields/-", "value": "{{\\"name\\":\\"my_field\\",\\"type\\":\\"string\\",\\"alias\\":\\"My Field\\",\\"description\\":\\"...\\",\\"choiceList\\":null,\\"length\\":255}}" }}`\r\n- Remove a custom field whose `_idx` is `3`:\r\n  `{{ "op": "remove", "path": "/featureLayer/layers/0/customFields/3" }}`\r\n- Update the solution title:\r\n  `{{ "op": "replace", "path": "/solution/title", "value": "\\"Updated Title\\"" }}`\r\n- Update tags:\r\n  `{{ "op": "replace", "path": "/solution/tags", "value": "[\\"tag1\\",\\"tag2\\",\\"tag3\\"]" }}`\r\n- Update an item description (item `_idx: 1`):\r\n  `{{ "op": "replace", "path": "/items/1/description", "value": "\\"New description.\\"" }}`\r\n\r\nDo NOT include `_idx` itself in any patch operation path or value\r\n\r\n# Design Rules\r\n\r\n## Solution\r\n- Only `title`, `description`, and `tags` may be updated\r\n- Only modify values. Do not add or remove properties\r\n\r\n## Strings\r\n- Only `value` may be updated\r\n- `key` and `description` are immutable\r\n- Always return the same number of strings\r\n\r\n## Items\r\n- Only `title` and `description` may be updated\r\n- `id` and `type` are immutable\r\n- Items cannot be added or removed\r\n\r\n## Feature Layers\r\n- Supported layer types: `Point`, `Line`, `Polygon`, `Table`\r\n\r\n### Layer Naming Rules\r\n- Layer `name` values should be written in Title Case unless specifically requested otherwise\r\n- Layer names should be localized to the detected User Query language unless specifically requested otherwise\r\n\r\n### Add Layers Rule\r\n- If `addLayers: false`:\r\n  - Layers can NOT be added or removed\r\n  - Layer `id` values are immutable\r\n  - A layer’s geometry classification may be changed **except**:\r\n    - If a layer’s current classification is Table, it must remain a Table.\r\n    - Any request to convert a Table into Point, Line, or Polygon is a rule violation.\r\n    - In this case, you must decline and return an empty `patches` array.\r\n- If `addLayers: true`:\r\n  - Layers may be added or removed\r\n  - Layer geometry classification may be changed without restriction\r\n  - Each new layer must receive a unique `id` starting at 0\r\n- Regardless of `addLayers`:\r\n  - Fields within a layer or table may be modified according to the Required Fields and Custom Fields rules.\r\n  - Custom fields may be added or removed when explicitly requested.\r\n\r\n### Required Fields\r\n- Required fields are protected:\r\n  - Cannot be removed\r\n  - Cannot be moved\r\n  - `name`, `type`, and `choiceList` are immutable\r\n- Only `alias` and `description` may be updated if explicitly requested\r\n\r\n### Custom Fields\r\n- Custom fields may be added, modified, or removed\r\n- Field names:\r\n  - lowercase\r\n  - start with a letter\r\n  - only letters, numbers, and underscores\r\n- Localize the field `name` to the detected User Query language\r\n- Valid types: `string`, `integer`, `double`, `date`\r\n- String fields:\r\n  - Set `choiceList` to an array of allowed values if applicable, else `null`\r\n  - All`choiceList` values should be written in the detected User Query language unless specifically requested otherwise\r\n  - Set an appropriate `length`\r\n- Non-string fields:\r\n  - `choiceList: null`\r\n  - `length: null`\r\n- Boolean values must be implemented as:\r\n  - `string` with a two-value `choiceList`\r\n  - The two values should be localized to the detected User Query language unless specifically requested otherwise\r\n  - Preserve meaning equivalent to “Yes” and “No” (affirmative/negative)\r\n- No duplicate field names within the same layer\r\n\r\n# Current Solution Design\r\n{currentDesign}\r\n\r\n# User Query\r\n{query}';
+export {
+  e as default
+};

package/dist/components/arcgis-solutions-assistant/customElement.d.ts

@@ -11,33 +11,19 @@ export abstract class ArcgisSolutionsAssistant extends LitElement {
    */
   protected _translations: {
       agentProgress: {
-          builderAgentExecuting: string;
-          builderAgentUnderstanding: string;
-          builderAgentReviewingUseCase: string;
-          builderAgentSearching: string;
-          builderAgentFindingMatch: string;
-          builderAgentCreatingDesign: string;
-          builderAgentValidating: string;
           explorerAgentSearching: string;
           explorerAgentReading: string;
           explorerAgentReviewing: string;
           explorerAgentPreparing: string;
       };
       builderMessages: {
-          newConversationStarted: string;
-          undoDesignChange: string;
-          redoDesignChange: string;
-          cancelledMessage: string;
+          understandingRequest: string;
           selectTemplatePrompt: string;
-          describeWorkflowPrompt: string;
-          buildTemplateSolution: string;
-          needUseCaseForTemplate: string;
-          provideUseCaseDetails: string;
+          searchingExistingSolutions: string;
           existingSolutionMatch: string;
-          existingTemplateMatch: string;
-          designUpdated: string;
-          designCreated: string;
-          iteratePrompt: string;
+          creatingDesign: string;
+          updatingDesign: string;
+          applyChangeFailed: string;
       };
       betaTag: string;
       defaultStartUpMessage: string;
@@ -73,33 +59,19 @@ export abstract class ArcgisSolutionsAssistant extends LitElement {
       viewSolutionInApp: string;
   } & T9nMeta<{
       agentProgress: {
-          builderAgentExecuting: string;
-          builderAgentUnderstanding: string;
-          builderAgentReviewingUseCase: string;
-          builderAgentSearching: string;
-          builderAgentFindingMatch: string;
-          builderAgentCreatingDesign: string;
-          builderAgentValidating: string;
           explorerAgentSearching: string;
           explorerAgentReading: string;
           explorerAgentReviewing: string;
           explorerAgentPreparing: string;
       };
       builderMessages: {
-          newConversationStarted: string;
-          undoDesignChange: string;
-          redoDesignChange: string;
-          cancelledMessage: string;
+          understandingRequest: string;
           selectTemplatePrompt: string;
-          describeWorkflowPrompt: string;
-          buildTemplateSolution: string;
-          needUseCaseForTemplate: string;
-          provideUseCaseDetails: string;
+          searchingExistingSolutions: string;
           existingSolutionMatch: string;
-          existingTemplateMatch: string;
-          designUpdated: string;
-          designCreated: string;
-          iteratePrompt: string;
+          creatingDesign: string;
+          updatingDesign: string;
+          applyChangeFailed: string;
       };
       betaTag: string;
       defaultStartUpMessage: string;
@@ -140,6 +112,12 @@ export abstract class ArcgisSolutionsAssistant extends LitElement {
    * @default false
    */
   accessor builderVisible: boolean;
+  /**
+   * Whether there is an active builder design (not just example data)
+   *
+   * @default false
+   */
+  accessor hasActiveBuilderDesign: boolean;
   /**
    * Flag to open or close panel
    *