@uniformdev/mesh-edgehancer-sdk 20.63.0 → 20.63.1-alpha.18

package/dist/index.js

@@ -59,7 +59,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // ../../lib/ai-sdk/src/InvocationContexts.ts
-var z = __toESM(require("zod/v3"), 1);
+var z = __toESM(require("zod"), 1);
 var invocationContextsSchema = z.enum([
   "composition",
   "compositionPattern",
@@ -69,14 +69,46 @@ var invocationContextsSchema = z.enum([
   "general"
 ]);
 var invocationContextInfoSchema = z.object({
-  context: invocationContextsSchema,
-  id: z.string(),
-  displayName: z.string().optional(),
-  icon: z.string().optional()
+  /** The invocation context type ('composition', 'entry', 'general', etc.) */
+  context: invocationContextsSchema.optional(),
+  /** Entity ID being edited */
+  entityId: z.string().optional(),
+  /** Display name of the entity */
+  entityName: z.string().optional(),
+  /** Project map path of the entity (e.g., "/", "/about", "/products/shoes"). Only for compositions attached to project map. */
+  entityPath: z.string().optional(),
+  /** Edition ID if editing a non-default edition */
+  editionId: z.string().optional(),
+  /** Component node ID selected by the user within the entity's component tree.
+   * Only applicable when context is 'composition', 'compositionPattern', or 'componentPattern'. */
+  entitySelectedNodeId: z.string().optional(),
+  /** Parameter or field ID the user has focused within the selected node.
+   * Applicable to all entity types. */
+  entitySelectedPropertyId: z.string().optional(),
+  /** Current locale */
+  locale: z.string().optional(),
+  /** Release ID if working within a release context; null means editing base content (not in a release) */
+  releaseId: z.string().nullable().optional(),
+  /** Display name of the release */
+  releaseName: z.string().optional(),
+  /** Project display name */
+  projectName: z.string().optional(),
+  /** User display name */
+  userDisplayName: z.string().optional(),
+  /** Username (e.g. for creator/author filters in search); prefer identity name from member profile */
+  username: z.string().optional(),
+  /** Current date (ISO string for reliable parsing). Only updated when >5min apart. */
+  currentDate: z.string().optional(),
+  /** Current date in user's locale format with timezone */
+  currentLocaleDate: z.string().optional(),
+  /** Agent-readable description of how entity mutations behave in the current context */
+  editBehavior: z.string().optional(),
+  /** Summary of pending changes applied/discarded since the last turn */
+  pendingChangesUpdates: z.string().optional()
 });
 
 // src/afterAIDataResourceEdit.ts
-var z2 = __toESM(require("zod/v3"));
+var z2 = __toESM(require("zod"));
 var afterAIDataResourceEditResultSchema = z2.strictObject({
   newValue: z2.record(z2.string(), z2.string()),
   success: z2.boolean(),
@@ -114,63 +146,70 @@ var afterAIDataResourceEditContextSchema = z2.strictObject({
 });
 
 // ../../lib/ai-sdk/src/toolDefinitions/editing/createPropertyEdit.ts
-var z3 = __toESM(require("zod/v3"), 1);
+var z4 = __toESM(require("zod"), 1);
+
+// ../../lib/ai-sdk/src/utils/normalizeOptionalAIString.ts
+var z3 = __toESM(require("zod"), 1);
+var optionalAIStringSchema = z3.string().optional();
+
+// ../../lib/ai-sdk/src/toolDefinitions/editing/createPropertyEdit.ts
 var createPropertyEdit = {
-  displayName: "Create Property Edit",
+  displayName: "Create property edit",
   description: "Edits a property on a composition, entry, or pattern with AI. This is a callable tool NOT FOR AGENT USE - agents use applyPropertyEdit to broker client-side application of the edit.",
-  inputSchema: z3.object({
-    edit: z3.string().describe("Describe the edit to be made to the property"),
-    currentValue: z3.unknown().describe("Current value of the property (if any exists)").optional(),
-    projectGuidance: z3.string().describe("Guidance prompt for the project (if any exists)").optional(),
-    componentGuidance: z3.string().describe("Guidance prompt for the parent component").optional(),
-    audienceGuidance: z3.string().describe(
+  inputSchema: z4.object({
+    edit: z4.string().describe("Describe the edit to be made to the property"),
+    currentValue: z4.unknown().describe("Current value of the property (if any exists)").optional(),
+    projectGuidance: z4.string().describe("Guidance prompt for the project (if any exists)").optional(),
+    componentGuidance: z4.string().describe("Guidance prompt for the parent component").optional(),
+    audienceGuidance: z4.string().describe(
       "Guidance prompt for the target audience of a personalized variation. Omit for non-variation edits."
     ).optional(),
-    propertyDefinition: z3.object({
-      id: z3.string(),
-      name: z3.string(),
-      type: z3.string(),
-      guidance: z3.string().describe("Guidance prompt from the property definition (if any exists)").optional(),
-      typeConfig: z3.unknown().optional().describe("Type-specific configuration for the property")
+    propertyDefinition: z4.object({
+      id: z4.string(),
+      name: z4.string(),
+      type: z4.string(),
+      guidance: z4.string().describe("Guidance prompt from the property definition (if any exists)").optional(),
+      typeConfig: z4.unknown().optional().describe("Type-specific configuration for the property")
     }),
-    outputLocale: z3.string().optional().describe("The locale to use when writing the edited value"),
-    documentContext: z3.string().describe("Content of the surrounding document the property is part of").optional()
+    outputLocale: optionalAIStringSchema.describe(
+      "The locale to use when writing the edited value. Use an empty string for locale-independent values."
+    ),
+    documentContext: z4.string().describe("Content of the surrounding document the property is part of").optional()
   }),
-  outputSchema: z3.object({
-    newValue: z3.string().describe(
-      "The new value of the property. When the action is clear or resetOverride, this should be empty."
+  outputSchema: z4.object({
+    newValue: z4.string().describe(
+      "The new value of the property. When the action is clearValue, resetOverride, or nothing, this should be empty."
     ),
-    treatNewValueAsJson: z3.boolean().describe("Whether the newValue is a JSON string"),
-    summary: z3.string().describe(
-      "A completion message to the user that summarizes the action taken. This should be 1 sentence, in English."
-    ).optional(),
-    action: z3.enum(["setValue", "clearValue", "resetOverride"]).describe(
-      "setValue = update the value, clearValue = remove the value/set to empty, resetOverride = remove a pattern override and inherit the pattern value. Only use resetOverride if the prompt asks for it. If the prompt is specifically talking about asset parameter title/description overrides, use setValue instead."
+    treatNewValueAsJson: z4.boolean().describe("Whether the newValue is a JSON string"),
+    summary: z4.string().describe(
+      'A completion message to the user that summarizes the action taken. One sentence, in English. Use e.g. "Done." when no detail is needed.'
+    ),
+    action: z4.enum(["setValue", "clearValue", "resetOverride", "nothing"]).describe(
+      "setValue = update the value, clearValue = remove the value/set to empty, resetOverride = remove a pattern override and inherit the pattern value, nothing = leave the value unchanged (use when instructed to keep existing value, make no changes, or leave unchanged). Only use resetOverride if the prompt asks for it. If the prompt is specifically talking about asset parameter title/description overrides, use setValue instead."
     ),
-    success: z3.boolean().describe("Whether the edit could be completed successfully")
+    success: z4.boolean().describe("Whether the edit could be completed successfully")
   }),
-  runsAt: "server",
   timeout: 100,
-  callable: true
+  toolClass: "edit"
 };
 
 // src/afterAIEdit.ts
-var z4 = __toESM(require("zod/v3"));
-var afterAIEditResultSchema = z4.strictObject({
-  newValue: z4.unknown(),
-  success: z4.boolean(),
-  summary: z4.string().optional()
+var z5 = __toESM(require("zod"));
+var afterAIEditResultSchema = z5.strictObject({
+  newValue: z5.unknown().optional(),
+  success: z5.boolean(),
+  summary: z5.string().optional()
 });
-var afterAIEditContextSchema = z4.strictObject({
+var afterAIEditContextSchema = z5.strictObject({
   editRequest: createPropertyEdit.inputSchema,
   invocationContext: invocationContextsSchema,
-  userId: z4.string(),
-  currentLocale: z4.string().optional(),
-  projectId: z4.string(),
-  newValue: z4.unknown(),
-  result: z4.object({
-    success: z4.boolean(),
-    summary: z4.string().optional()
+  userId: z5.string(),
+  currentLocale: z5.string().optional(),
+  projectId: z5.string(),
+  newValue: z5.unknown(),
+  result: z5.object({
+    success: z5.boolean(),
+    summary: z5.string().optional()
   })
 });
 
@@ -234,49 +273,49 @@ var COLLECTION_MAX_LIMIT = 50;
 var COLLECTION_DEFAULT_OFFSET = 0;
 
 // src/createAIDataResourceEdit.ts
-var z5 = __toESM(require("zod/v3"));
-var createAIDataResourceEditContextSchema = z5.strictObject({
+var z6 = __toESM(require("zod"));
+var createAIDataResourceEditContextSchema = z6.strictObject({
   /**
    * The the data type of the data resource being edited (merged with its data source)
    * NOTE: this can contain secrets, API keys, etc. Do not directly expose it to the AI agent!
    * NOTE: this does not include the current value's variables, if any
    */
-  mergedDataType: z5.custom(),
+  mergedDataType: z6.custom(),
   /** Which data source variant is currently active (undefined = published data) */
-  dataSourceVariant: z5.custom().optional(),
+  dataSourceVariant: z6.custom().optional(),
   /** The edit request details */
-  editRequest: z5.object({
+  editRequest: z6.object({
     /** The edit instruction from the AI agent */
-    edit: z5.string(),
+    edit: z6.string(),
     /** Current value of the data resource's variables (if any) */
-    currentValue: z5.record(z5.string(), z5.string()).optional()
+    currentValue: z6.record(z6.string(), z6.string()).optional()
   }),
   /** AI invocation context */
   invocationContext: invocationContextsSchema,
   /** User ID making the edit */
-  userId: z5.string(),
+  userId: z6.string(),
   /** Project ID */
-  projectId: z5.string()
+  projectId: z6.string()
 });
-var createAIDataResourceEditResultSchema = z5.strictObject({
-  outputJsonSchema: z5.record(z5.string(), z5.any()).describe("JSON schema (draft-07) for the edited data resource result"),
-  instructions: z5.string().describe(
+var createAIDataResourceEditResultSchema = z6.strictObject({
+  outputJsonSchema: z6.record(z6.string(), z6.any()).describe("JSON schema (draft-07) for the edited data resource result"),
+  instructions: z6.string().describe(
     "Instructions for the AI editor LLM to follow when editing this data resource (e.g. conventions/rules, allowed values, data format expectations, etc). Describe how to transform or edit the data resource content."
   )
 });
 
 // src/createAIEdit.ts
-var z6 = __toESM(require("zod/v3"));
-var createAIEditContextSchema = z6.strictObject({
+var z7 = __toESM(require("zod"));
+var createAIEditContextSchema = z7.strictObject({
   editRequest: createPropertyEdit.inputSchema,
   invocationContext: invocationContextsSchema,
-  userId: z6.string(),
-  currentLocale: z6.string().optional(),
-  projectId: z6.string()
+  userId: z7.string(),
+  currentLocale: z7.string().optional(),
+  projectId: z7.string()
 });
-var createAIEditResultSchema = z6.strictObject({
-  outputJsonSchema: z6.record(z6.string(), z6.any()).describe("JSON schema (draft-07) for the edited content result"),
-  instructions: z6.string().describe(
+var createAIEditResultSchema = z7.strictObject({
+  outputJsonSchema: z7.record(z7.string(), z7.any()).describe("JSON schema (draft-07) for the edited content result"),
+  instructions: z7.string().describe(
     "Instructions for the AI editor LLM to follow (e.g. conventions/rules, allowed values, etc). Just describe your value type, do not give guiding instructions. There is no need to worry about clearing or resetting values, that is automatically handled."
   )
 });
@@ -320,81 +359,81 @@ function copyKeyValuePairs(source, target) {
 }
 
 // src/preRequest.ts
-var z8 = __toESM(require("zod/v3"));
+var z9 = __toESM(require("zod"));
 
 // src/shared.ts
 var import_tsafe = require("tsafe");
-var z7 = __toESM(require("zod/v3"));
-var parameterDefinitionSchema = z7.object({
-  key: z7.string(),
-  value: z7.string(),
-  omitIfEmpty: z7.boolean().optional()
+var z8 = __toESM(require("zod"));
+var parameterDefinitionSchema = z8.object({
+  key: z8.string(),
+  value: z8.string(),
+  omitIfEmpty: z8.boolean().optional()
 });
-var resolvingIssueSchema = z7.union([
-  z7.string(),
-  z7.object({
-    message: z7.string(),
-    subType: z7.enum(["unpublishedData", "configuration"]).optional(),
-    issueReference: z7.string().optional(),
-    deepLink: z7.string().optional(),
-    statusCode: z7.number().int().optional()
+var resolvingIssueSchema = z8.union([
+  z8.string(),
+  z8.object({
+    message: z8.string(),
+    subType: z8.enum(["unpublishedData", "configuration"]).optional(),
+    issueReference: z8.string().optional(),
+    deepLink: z8.string().optional(),
+    statusCode: z8.number().int().optional()
   })
 ]);
-var variableDefinitionSchema = z7.object({
-  displayName: z7.string().optional(),
-  type: z7.string().optional(),
-  default: z7.string(),
-  helpText: z7.string().optional(),
-  order: z7.number().optional(),
-  source: z7.string().optional()
+var variableDefinitionSchema = z8.object({
+  displayName: z8.string().optional(),
+  type: z8.string().optional(),
+  default: z8.string(),
+  helpText: z8.string().optional(),
+  order: z8.number().optional(),
+  source: z8.string().optional()
 });
-var customEdgehancerDefinitionSchema = z7.object({
-  preRequest: z7.string().optional(),
-  request: z7.string().optional(),
-  createAIDataResourceEdit: z7.string().optional(),
-  afterAIDataResourceEdit: z7.string().optional()
+var customEdgehancerDefinitionSchema = z8.object({
+  preRequest: z8.string().optional(),
+  request: z8.string().optional(),
+  createAIDataResourceEdit: z8.string().optional(),
+  afterAIDataResourceEdit: z8.string().optional()
 });
-var dataSourceVariantSchema = z7.intersection(
-  z7.object({
-    headers: z7.array(parameterDefinitionSchema).optional(),
-    parameters: z7.array(parameterDefinitionSchema).optional(),
-    variables: z7.record(variableDefinitionSchema).optional()
+var dataSourceVariantSchema = z8.intersection(
+  z8.object({
+    headers: z8.array(parameterDefinitionSchema).optional(),
+    parameters: z8.array(parameterDefinitionSchema).optional(),
+    variables: z8.record(z8.string(), variableDefinitionSchema).optional()
   }),
-  z7.object({ url: z7.string() })
+  z8.object({ url: z8.string() })
 );
-var mergedDataTypeSchema = z7.object({
-  id: z7.string(),
-  displayName: z7.string(),
-  archetype: z7.string().optional(),
-  allowedOnComponents: z7.array(z7.string()).optional(),
-  badgeIconUrl: z7.string().optional(),
-  connectorType: z7.string(),
-  url: z7.string(),
-  headers: z7.array(parameterDefinitionSchema).optional(),
-  parameters: z7.array(parameterDefinitionSchema).optional(),
-  body: z7.string().optional(),
-  method: z7.enum(["GET", "POST", "HEAD"]),
-  variables: z7.record(variableDefinitionSchema).optional(),
-  custom: z7.record(z7.unknown()).optional(),
-  customPublic: z7.record(z7.unknown()).optional(),
-  ttl: z7.number().optional(),
-  purgeKey: z7.string().optional(),
-  localeMapping: z7.record(z7.string()).optional(),
+var mergedDataTypeSchema = z8.object({
+  id: z8.string(),
+  displayName: z8.string(),
+  archetype: z8.string().optional(),
+  allowedOnComponents: z8.array(z8.string()).optional(),
+  badgeIconUrl: z8.string().optional(),
+  connectorType: z8.string(),
+  url: z8.string(),
+  headers: z8.array(parameterDefinitionSchema).optional(),
+  parameters: z8.array(parameterDefinitionSchema).optional(),
+  body: z8.string().optional(),
+  method: z8.enum(["GET", "POST", "HEAD"]),
+  variables: z8.record(z8.string(), variableDefinitionSchema).optional(),
+  custom: z8.record(z8.string(), z8.unknown()).optional(),
+  customPublic: z8.record(z8.string(), z8.unknown()).optional(),
+  ttl: z8.number().optional(),
+  purgeKey: z8.string().optional(),
+  localeMapping: z8.record(z8.string(), z8.string()).optional(),
   edgehancer: customEdgehancerDefinitionSchema.optional(),
-  uiBadgeText: z7.string().max(12).optional(),
-  variants: z7.object({
+  uiBadgeText: z8.string().max(12).optional(),
+  variants: z8.object({
     unpublished: dataSourceVariantSchema.optional()
   }).optional(),
-  enableUnpublishedMode: z7.boolean().optional()
+  enableUnpublishedMode: z8.boolean().optional()
 });
 (0, import_tsafe.assert)();
-var dataResourceSchema = z7.union([
-  z7.string(),
-  z7.object({}).catchall(z7.unknown()),
-  z7.number(),
-  z7.boolean(),
-  z7.array(z7.unknown()),
-  z7.undefined()
+var dataResourceSchema = z8.union([
+  z8.string(),
+  z8.object({}).catchall(z8.unknown()),
+  z8.number(),
+  z8.boolean(),
+  z8.array(z8.unknown()),
+  z8.undefined()
 ]);
 
 // src/preRequest.ts
@@ -406,33 +445,33 @@ var edgehancerMergedDataTypeSchema = mergedDataTypeSchema.omit({
   id: true,
   purgeKey: true
 });
-var preRequestEdgehancerDataResourceResultSchema = z8.strictObject({
-  errors: z8.array(resolvingIssueSchema).optional(),
-  warnings: z8.array(resolvingIssueSchema).optional(),
-  infos: z8.array(resolvingIssueSchema).optional(),
+var preRequestEdgehancerDataResourceResultSchema = z9.strictObject({
+  errors: z9.array(resolvingIssueSchema).optional(),
+  warnings: z9.array(resolvingIssueSchema).optional(),
+  infos: z9.array(resolvingIssueSchema).optional(),
   dataResource: edgehancerMergedDataTypeSchema
 });
-var preRequestEdgehancerResultSchema = z8.strictObject({
-  dataResources: z8.array(preRequestEdgehancerDataResourceResultSchema)
+var preRequestEdgehancerResultSchema = z9.strictObject({
+  dataResources: z9.array(preRequestEdgehancerDataResourceResultSchema)
 });
 
 // src/request.ts
-var z9 = __toESM(require("zod/v3"));
-var requestEdgehancerDataResourceResolutionResultSchema = z9.strictObject({
-  errors: z9.array(resolvingIssueSchema).optional().describe(
+var z10 = __toESM(require("zod"));
+var requestEdgehancerDataResourceResolutionResultSchema = z10.strictObject({
+  errors: z10.array(resolvingIssueSchema).optional().describe(
     "Errors that occurred while running your code to return with the API response, if any. Unhandled exceptions will be captured automatically."
   ),
-  warnings: z9.array(resolvingIssueSchema).optional().describe("Warnings that occurred while running your code to return with the API response, if any."),
-  infos: z9.array(resolvingIssueSchema).optional().describe(
+  warnings: z10.array(resolvingIssueSchema).optional().describe("Warnings that occurred while running your code to return with the API response, if any."),
+  infos: z10.array(resolvingIssueSchema).optional().describe(
     "Informational messages that occurred while running your code to return with the API response, if any."
   ),
-  surrogateKeys: z9.array(z9.string()).optional().describe(
+  surrogateKeys: z10.array(z10.string()).optional().describe(
     "Extra surrogate keys for the data that was fetched. These act as auxiliary cache keys that can allow granular purging of cached data."
   ),
-  result: dataResourceSchema.describe("The result of fetching the data resource")
+  result: dataResourceSchema.describe("The result of fetching the data resource").optional()
 });
-var requestEdgehancerResultSchema = z9.strictObject({
-  results: z9.array(requestEdgehancerDataResourceResolutionResultSchema)
+var requestEdgehancerResultSchema = z10.strictObject({
+  results: z10.array(requestEdgehancerDataResourceResolutionResultSchema)
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {