Function resolveEntityNumber

actions/setup/js/close_entity_helpers.cjs:154–200

* Resolve the entity number based on target configuration and context * @param {EntityConfig} config - Entity configuration * @param {string} target - Target configuration ("triggering", "*", or explicit number) * @param {any} item - The agent output item * @param {boolean} isEntityContext - Whe

(config, target, item, isEntityContext)

 * @returns {{success: true, number: number} | {success: false, message: string}}
 */
function resolveEntityNumber(config, target, item, isEntityContext) {
  if (target === "*") {
    const targetNumber = item[config.numberField];
    if (targetNumber) {
      const parsed = parseInt(targetNumber, 10);
      if (isNaN(parsed) || parsed <= 0) {
        return {
          success: false,
          message: `Invalid ${config.displayName} number specified: ${targetNumber}`,
        };
      }
      return { success: true, number: parsed };
    }
    return {
      success: false,
      message: `Target is "*" but no ${config.numberField} specified in ${config.itemTypeDisplay} item`,
    };
  }

  if (target !== "triggering") {
    const parsed = parseInt(target, 10);
    if (isNaN(parsed) || parsed <= 0) {
      return {
        success: false,
        message: `Invalid ${config.displayName} number in target configuration: ${target}`,
      };
    }
    return { success: true, number: parsed };
  }

  // Default behavior: use triggering entity
  if (isEntityContext) {
    const number = context.payload[config.contextPayloadField]?.number;
    if (!number) {
      return {
        success: false,
        message: `${config.displayNameCapitalized} context detected but no ${config.displayName} found in payload`,
      };
    }
    return { success: true, number };
  }

  return {
    success: false,
    message: `Not in ${config.displayName} context and no explicit target specified`,
  };
}

/**
 * Escape special markdown characters in a title